RBLN 드라이버 설치 가이드¶

지원 배포판과 커널 확인¶

배포판 버전과 커널이 지원 버전 문서의 요구사항을 만족하는지 확인합니다.

$ hostnamectl

출력에서 다음 항목을 확인합니다.

• Operating System(배포판 및 버전)
• Kernel(실행 중인 커널 버전)
• Architecture(runfile과 같아야 함)

1

$ sudo apt-get install -y linux-generic-hwe-22.04

제품별 준비¶

호스트에 장착된 카드에 맞는 탭을 선택합니다.

$ chmod +x rbln-pciehp-hook.sh
$ sudo ./rbln-pciehp-hook.sh install

$ ./rbln-pciehp-hook.sh status

$ sudo ./rbln-pciehp-hook.sh uninstall

$ ./rbln-pciehp-hook.sh --help

1
2

# /etc/default/grub의 GRUB_CMDLINE_LINUX_DEFAULT에 pci=noats를 추가
$ sudo update-grub

1

$ sudo grubby --args="pci=noats" --update-kernel=/boot/vmlinuz-$(uname -r)

설치 전 재부팅¶

HWE 커널을 설치했거나 앞 단계에서 커널 커맨드라인을 바꿨다면 재부팅해야 합니다. 설치 프로그램은 실행 중인 커널의 커맨드라인을 검사하므로, 재부팅하지 않으면 파라미터를 추가했어도 설치가 중단됩니다.

$ sudo reboot

재부팅한 뒤 커널 버전과 파라미터가 반영되었는지 확인합니다.

$ uname -r
$ cat /proc/cmdline

커널 헤더 패키지 설치¶

DKMS로 드라이버를 빌드하려면 위에서 확인한 실행 중인 커널과 버전이 같은 헤더 패키지가 필요합니다. RHEL 계열은 kernel-devel도 함께 설치해야 합니다. 아래 명령으로 설치합니다.

• 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 드라이버 제거¶

3.0 이전에 배포된 rebellions deb/rpm 패키지가 설치되어 있다면 runfile을 설치하기 전에 제거해야 합니다.

• Debian/Ubuntu 계열

$ sudo apt remove -y rebellions

• RHEL 계열

$ sudo dnf remove -y rebellions

GRUB 부트 파라미터 설정¶

권장 파라미터가 빠져 있어도 설치는 중단되지 않고 보고만 되므로, 드라이버 설치 후 rbln-bios로 확인합니다.

$ sudo /usr/bin/rbln-bios -t grub -v

결과가 WARNING이면 Missing에 나열된 파라미터를 커널 커맨드라인에 추가합니다.

• Debian/Ubuntu 계열

# /etc/default/grub의 GRUB_CMDLINE_LINUX_DEFAULT에 <parameters>를 추가
$ sudo update-grub

• 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

Pre-installation cleanup required 메시지¶

설치 프로그램에서 "Pre-installation cleanup required"가 표시되면 이전에 설치한 드라이버 패키지가 남아 있거나 드라이버 모듈이 로드되어 있다는 뜻입니다.

출력에 표시된 정리 명령을 실행한 뒤 설치를 다시 시도합니다.

=================================
Pre-installation cleanup required
=================================

Please run the following commands before installing:

$ sudo systemctl stop rbln-smd.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-smd.service 2>/dev/null || true
$ sudo modprobe -r rebellions

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

$ sudo lsof /dev/rbln*