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

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

참고

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

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

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

APT 서버 설정

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

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

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

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

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

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 bionic restricted
EOT

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

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

필수 패키지 설치

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

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

아래 패키지들의 최신 버전을 선택하여 다운 받아 명령에 쓰여진 순서대로 설치한다.

NPU Driver (furiosa-driver-pdma)
Hardware Abstraction Layer (furiosa-libhal)
Runtime library (furiosa-libnux)
Onnxruntime (libonnxruntime)

sudo apt-get install -y ./furiosa-driver-pdma-x.y.z-?.deb
sudo apt-get install -y ./furiosa-libhal-warboy-x.y.z-?.deb
sudo apt-get install -y ./libonnxruntime-x.y.z-?.deb
sudo apt-get install -y ./furiosa-libnux-x.y.z-?.deb

설치된 버전 고정 및 해제

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

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

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

sudo apt-mark unhold furiosa-driver-pdma 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.6.3-2