드라이버, 펌웨어, 런타임 설치 가이드

이 장에서는 FuriosaAI가 제공하는 다양한 소프트웨어 컴포넌트를 사용하기 위해 반드시 설치해야 하는 패키지들의 설치 방법을 설명한다. 이 필수 패키지들은 커널 드라이버, 펌웨어, 런타임 라이브러리이며 다운로드 센터에서 로그인하여 직접 다운 받거나 개발자 사이트에서 발급한 APT 서버와 PIP 서버를 통해 다운로드 받을 수 있다.

참고

다운로드 센터나 개발자 사이트는 FuriosaAI의 평가 프로그램 등록하면 제공 되며 현재는 contact@furiosa.ai로 문의하여 평가 프로그램을 요청할 수 있다.

SDK 설치를 위한 최소 요구사항

Ubuntu 20.04 LTS (Focal Fossa) 또는 Debian bullseye 또는 상위 버전
시스템의 관리자 권한 (root)
인터넷 접근이 가능한 네트워크

APT 서버 설정

FuriosaAI에서 제공하는 APT 서버를 사용하려면 아래 설명에 따라 APT 서버를 Ubuntu 또는 Debian 리눅스에 설정한다. APT를 사용하지 않고 다운로드 센터를 사용한다면 이 섹션을 건너뛰어도 좋다.

HTTPS 기반의 APT 서버 접근을 위해 필요 패키지를 설치 한다.

sudo apt update
sudo apt install -y ca-certificates apt-transport-https gnupg

FuriosaAI의 공개 Signing 키를 등록 한다.

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key 5F03AFA423A751913F249259814F888B20B09A7E

FuriosaAI 개발자 센터에서 API 키를 발급하고 발급한 API 키를 아래와 같이 설정한다.

sudo tee -a /etc/apt/auth.conf.d/furiosa.conf > /dev/null <<EOT
  machine archive.furiosa.ai
  login xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  password xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
EOT

sudo chmod 400 /etc/apt/auth.conf.d/furiosa.conf

리눅스 배포판 버전에 따른 탭을 선택하여 설명을 따라 APT 서버를 설정한다.

아래 커맨드를 통해 APT 서버를 등록합니다.

sudo tee -a /etc/apt/sources.list.d/furiosa.list <<EOT
deb [arch=amd64] https://archive.furiosa.ai/ubuntu focal restricted
EOT

아래 커맨드를 통해 APT 서버를 등록합니다.

sudo tee -a /etc/apt/sources.list.d/furiosa.list <<EOT
deb [arch=amd64] https://archive.furiosa.ai/ubuntu jammy restricted
EOT

필수 패키지 설치

위에 설명에 따라 APT 서버를 등록했거나 다운로드 사이트에 가입했다면 필수 패키지인 NPU 커널 드라이버, 펌웨어, 런타임을 설치할 수 있다.

아래 패키지를 설치하면 의존된 패키지들은 자동으로 설치된다.

sudo apt-get update && sudo apt-get install -y furiosa-driver-warboy furiosa-libnux

유저를 `furiosa` 그룹에 추가

리눅스는 다중 사용자 운영체제로 소유자(owner)와 그룹에 속한 사용자만 파일과 장치 접근이 허용된다. NPU 디바이스 드라이버도 설치 시 자동으로 furiosa 그룹을 생성하고 이 그룹에 속한 사용자만 접근을 허용하고 있다. 따라서 NPU를 사용하려는 유저는 자신을 furiosa 그룹에 추가해야 한다. 이를 위해 다음 명령어를 사용할 수 있다.

sudo usermod -aG furiosa <username>

위 명령어에서 <username> 부분에 furiosa 그룹에 추가하려는 사용자의 이름을 입력하면 된다. 예를 들어, 현재 로그인된 사용자를 furiosa 그룹에 추가하려면, 다음 명령어를 입력한다.

sudo usermod -aG furiosa $USER

그룹 권한을 활성화하기 위해서는 로그아웃한 후 다시 로그인해야 한다.

설치된 버전 고정 및 해제

패키지 설치 이후 안정적인 운영환경을 유지하기 위해 설치된 패키지의 버전을 고정할 필요가 있다. 아래 명령어를 이용하면 현재 설치된 버전을 고정 할 수 있다.

sudo apt-mark hold furiosa-driver-warboy furiosa-libhal-warboy furiosa-libnux libonnxruntime

고정된 패키지 버전을 해제하여 업데이트 하기 위해서는 apt-mark unhold 명령과 함께 원하는 패키지를 지정한다. 이때 패키지 이름을 적어 선택적으로 특정 패키지의 버전 고정을 해제할 수 있으며 이미 고정된 패키지 정보를 보기 위해서는 apt-mark showhold 명령을 사용한다.

sudo apt-mark unhold furiosa-driver-warboy furiosa-libhal-warboy furiosa-libnux libonnxruntime

특정 버전 설치 방법

특정 버전을 지정하여 설치해야 하는 경우 아래와 같이 버전을 지정하여 설치한다.

apt list 로 설치 가능한 버전을 확인한다.

sudo apt list -a furiosa-libnux

apt-get install 명령에 옵션으로 패키지 이름과 버전을 지정한다.

sudo apt-get install -y furiosa-libnux=0.9.0-?