콘텐츠로 이동

HyperAccel Driver

ha.ko는 HyperAccel LPU를 Linux에 노출하는 커널 드라이버입니다. 이 문서는 드라이버를 설치하고 운영하는 서버 운영자 및 관리자를 위해, LPU의 커널 드라이버가 제공하는 운영 기능을 설명합니다. 이 문서에서 다루는 기능은 텔레메트리, hang 감지, 디바이스 복구, 펌웨어 업데이트, 모듈 파라미터, 드라이버 운영 도구이며, 드라이버를 관리하면서 자주 접하는 운영 작업은 예제 스크립트와 함께 튜토리얼로 정리했습니다.

애플리케이션 개발자라면

애플리케이션 수준에서 디바이스를 쓰는 방법(메모리 할당/해제, 커널 실행, 스트림/이벤트 사용)은 Runtime 문서에 있습니다. 애플리케이션은 runtime API를 통해 디바이스를 쓰고, 이 문서는 더 낮은 관점에서 드라이버를 운영하는 방법을 다룹니다.


스택 내 위치

1
2
3
4
5
애플리케이션
  └─ HyperAccel SDK
       └─ /dev/haN
            └─ ha.ko (커널 드라이버) ── 운영 표면: sysfs 텔레메트리, 모듈 파라미터, 도구
                 └─ LPU 디바이스와 펌웨어

한눈에 보기

커널 모듈 ha.ko
디바이스 노드 /dev/ha0, /dev/ha1, … 디바이스마다 하나
텔레메트리 /sys/class/ha/haN/ 아래 읽기 전용 노드와 hwmon
모듈 파라미터 /sys/module/ha/parameters/
도구 hyperaccel-smi, ha-hotreset, ha-fw-update, ha-led, ha-wipe
배포물 deb 패키지(hyperdriver-dkms)
컨테이너 CDI 스펙(ha-container-toolkit이 관리)
이 문서의 버전 2.6.0
상태 Beta

서버에 설치된 드라이버의 버전은 이렇게 확인합니다.

1
cat /sys/module/ha/version

기능

기능 하는 일 문서
텔레메트리 온도, 전력, 사용률, 메모리 사용량, 디바이스의 현재 상태 확인 텔레메트리, sysfs 노드
hang 감지 응답 대기 상한, 워치독, hang 진단 기록 hang 감지와 워치독
디바이스 복구 자동 리셋, 애플리케이션 리셋, 호스트 서버에서 거는 카드 리셋 FATAL과 복구, ha-hotreset
펌웨어 업데이트 카드의 부트 플래시를 갱신 펌웨어 업데이트, ha-fw-update
모니터링 카드 상태를 표나 JSON으로 관측하고, 모니터링 시스템과 헬스체크에 연결 hyperaccel-smi, Prometheus로 텔레메트리 수집하기, 카드 상태 헬스체크 만들기
설정 워치독, 자동 리셋, 텔레메트리 주기 등의 설정 항목 파라미터 설정과 사용법, 파라미터 레퍼런스
여러 디바이스 디바이스 간에 경로 관측 여러 디바이스
컨테이너 노드 권한과 CDI 스펙 디바이스 노드 권한과 udev 규칙, 컨테이너 지원

신뢰 경계(Trust Boundary)

같은 디바이스 노드를 열 수 있는 프로세스끼리는 디바이스 메모리가 서로 격리되지 않습니다. 기본 udev 규칙은 노드를 모든 로컬 사용자에게 엽니다(0666). 서로 격리해야 하는 워크로드는 디바이스 노드 접근 권한으로 나누십시오. 여러 디바이스 사이의 경로는 여러 디바이스를 확인해 주십시오.


문서 구성

구성 내용
개요와 릴리즈 노트 드라이버 소개와 버전별 변경
설치와 설정 지원 환경, 설치, 설치 확인, 업그레이드와 제거
운영 가이드 텔레메트리, hang 감지, 복구, 펌웨어 업데이트, 여러 디바이스, 드라이버 운영 도구, sysfs 노드와 커널 로그 메시지, 문제 해결
커널 모듈 파라미터 파라미터를 바꾸는 방법, 자주 쓰는 설정, 파라미터별 정의
예제와 튜토리얼 모니터링 연동, 헬스체크, 진단 정보 수집, 카드 복구, 여러 카드의 펌웨어 업데이트