콘텐츠로 이동

RBLN 드라이버 설치 가이드

이 문서는 Linux OS에서 RBLN NPU 디바이스를 인식할 수 있도록 RBLN 드라이버(커널 드라이버 + 펌웨어)를 설치하는 절차를 설명합니다.

설치 전 지원 OS/커널 요구사항을 아래 매트릭스에서 확인하세요.

드라이버는 다음 구성 요소를 포함한 runfile로 배포됩니다.

  • 커널 드라이버 및 펌웨어
  • rbln-smi(디바이스 모니터링/관리)
  • 런타임 라이브러리(librbln-ccl, librbln-ml, librbln-thunk)

설치 전 준비

드라이버 설치 전 아래 항목을 확인하세요.

지원 Linux 배포판/커널 확인

사용 중인 배포판/버전 및 커널이 버전 매트릭스 요구사항을 만족하는지 확인하세요.

Note

Ubuntu 22.04: 드라이버 설치 전에 지원되는 HWE 커널 버전으로 업그레이드가 필요할 수 있습니다. 버전 매트릭스를 확인한 다음, 필요한 경우 아래 패키지를 설치하고 재부팅하세요.

1
2
$ sudo apt-get install -y linux-generic-hwe-22.04
$ sudo reboot

시스템 정보 확인

설치 전 기본 시스템 정보를 확인하세요.

$ hostnamectl

출력에서 다음 항목을 확인하세요.

  • Operating System(배포판 및 버전)
  • Kernel(실행 중인 커널 버전)
  • Architecture(x86_64)

커널 헤더/개발 패키지(headers/devel) 확인

DKMS 기반 드라이버 빌드를 위해 실행 중인 커널과 일치하는 헤더(headers) 또는 개발(devel) 패키지가 필요합니다.

실행 중인 커널 버전을 확인하세요.

$ uname -r

커널 헤더/개발 패키지를 설치하세요.

  • Debian/Ubuntu 계열
$ sudo apt-get update
$ sudo apt-get install -y linux-headers-$(uname -r)
  • RHEL 계열
$ sudo dnf install -y kernel-headers-$(uname -r) kernel-devel-$(uname -r)

레거시 deb/rpm 설치 사용자(pre-3.0, i.e. 2.1.0)만 해당

과거에 deb/rpm 패키지(pre-3.0)로 드라이버를 설치했다면, runfile 설치 전에 해당 패키지를 제거하세요. 해당하지 않으면 이 섹션은 건너뛰세요.

Debian/Ubuntu 계열

$ sudo apt remove -y rebellions

RHEL 계열

$ sudo dnf remove -y rebellions

드라이버 설치

설치 프로그램은 root 권한으로 실행해야 합니다.

Note

드라이버 설치 파일(*.run)은 OS 패키지 매니저로 설치되지 않으며, 별도로 제공됩니다. runfile이 없다면 지원팀에 요청한 뒤 진행하세요(참고: 문의).

runfile에 실행 권한이 없으면 아래와 같이 부여하세요.

$ chmod +x rebellions-x86_64-<version>.run

설치 프로그램을 실행하세요.

$ sudo ./rebellions-x86_64-<version>.run

설치 후 작업

GRUB 부트 파라미터 설정

rblnvs로 권장 커널 부트 파라미터를 확인하세요.

$ sudo /usr/bin/rblnvs -t grub -v

권장 파라미터를 적용한 후 재부팅하세요.

  • Debian/Ubuntu 계열
# /etc/default/grub을 편집하고 GRUB_CMDLINE_LINUX_DEFAULT에 파라미터를 추가
$ sudo update-grub
$ sudo reboot
  • RHEL 계열
$ sudo grubby --args="<parameters>" --update-kernel=/boot/vmlinuz-$(uname -r)
$ sudo reboot

udev 규칙 적용

설치 프로그램이 /etc/udev/rules.d/99-rebellions.rules에 udev 규칙을 생성합니다. 아래 명령으로 규칙을 다시 로드하고 적용하세요.

$ sudo udevadm control --reload-rules
$ sudo udevadm trigger

설치 확인

rbln-smi로 드라이버 로드 여부와 NPU 접근 가능 여부를 확인하세요.

$ rbln-smi

예시 출력은 rbln-smi를 참고하세요.

문제 해결

Pre-installation cleanup required 메시지

설치 프로그램에서 "Pre-installation cleanup required"가 표시되면 기존 드라이버/커널 모듈 설치가 충돌하고 있다는 의미입니다.

에러 메시지에 표시된 정리(cleanup) 명령을 실행한 뒤 설치를 다시 시도하세요.

예시 사전 정리 명령
=================================
Pre-installation cleanup required
=================================

Please run the following commands before installing:

$ sudo systemctl stop rbln_daemon.service 2>/dev/null || true
$ sudo modprobe -r rebellions
$ sudo apt remove rebellions-dkms

커널 모듈을 언로드할 수 없음

modprobe -r rebellions 실행 시 "module is in use"가 발생하면 데몬을 중지한 뒤 다시 시도하세요.

$ sudo systemctl stop rbln_daemon.service 2>/dev/null || true
$ sudo modprobe -r rebellions

여전히 실패하면 디바이스를 사용 중인 프로세스를 확인한 뒤 종료하세요.

$ sudo lsof /dev/rbln*