HyperAccel Driver¶
ha.ko는 HyperAccel LPU를 Linux에 노출하는 커널 드라이버입니다. 이 문서는 드라이버를 설치하고 운영하는 서버 운영자 및 관리자를 위해, LPU의 커널 드라이버가 제공하는 운영 기능을 설명합니다. 이 문서에서 다루는 기능은 텔레메트리, hang 감지, 디바이스 복구, 펌웨어 업데이트, 모듈 파라미터, 드라이버 운영 도구이며, 드라이버를 관리하면서 자주 접하는 운영 작업은 예제 스크립트와 함께 튜토리얼로 정리했습니다.
애플리케이션 개발자라면
애플리케이션 수준에서 디바이스를 쓰는 방법(메모리 할당/해제, 커널 실행, 스트림/이벤트 사용)은 Runtime 문서에 있습니다. 애플리케이션은 runtime API를 통해 디바이스를 쓰고, 이 문서는 더 낮은 관점에서 드라이버를 운영하는 방법을 다룹니다.
스택 내 위치¶
1 2 3 4 5 | |
한눈에 보기¶
| 커널 모듈 | 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 | |
기능¶
| 기능 | 하는 일 | 문서 |
|---|---|---|
| 텔레메트리 | 온도, 전력, 사용률, 메모리 사용량, 디바이스의 현재 상태 확인 | 텔레메트리, sysfs 노드 |
| hang 감지 | 응답 대기 상한, 워치독, hang 진단 기록 | hang 감지와 워치독 |
| 디바이스 복구 | 자동 리셋, 애플리케이션 리셋, 호스트 서버에서 거는 카드 리셋 | FATAL과 복구, ha-hotreset |
| 펌웨어 업데이트 | 카드의 부트 플래시를 갱신 | 펌웨어 업데이트, ha-fw-update |
| 모니터링 | 카드 상태를 표나 JSON으로 관측하고, 모니터링 시스템과 헬스체크에 연결 | hyperaccel-smi, Prometheus로 텔레메트리 수집하기, 카드 상태 헬스체크 만들기 |
| 설정 | 워치독, 자동 리셋, 텔레메트리 주기 등의 설정 항목 | 파라미터 설정과 사용법, 파라미터 레퍼런스 |
| 여러 디바이스 | 디바이스 간에 경로 관측 | 여러 디바이스 |
| 컨테이너 | 노드 권한과 CDI 스펙 | 디바이스 노드 권한과 udev 규칙, 컨테이너 지원 |
신뢰 경계(Trust Boundary)
같은 디바이스 노드를 열 수 있는 프로세스끼리는 디바이스 메모리가 서로 격리되지 않습니다. 기본 udev 규칙은 노드를 모든 로컬 사용자에게 엽니다(0666). 서로 격리해야 하는 워크로드는 디바이스 노드 접근 권한으로 나누십시오. 여러 디바이스 사이의 경로는 여러 디바이스를 확인해 주십시오.
문서 구성¶
| 구성 | 내용 |
|---|---|
| 개요와 릴리즈 노트 | 드라이버 소개와 버전별 변경 |
| 설치와 설정 | 지원 환경, 설치, 설치 확인, 업그레이드와 제거 |
| 운영 가이드 | 텔레메트리, hang 감지, 복구, 펌웨어 업데이트, 여러 디바이스, 드라이버 운영 도구, sysfs 노드와 커널 로그 메시지, 문제 해결 |
| 커널 모듈 파라미터 | 파라미터를 바꾸는 방법, 자주 쓰는 설정, 파라미터별 정의 |
| 예제와 튜토리얼 | 모니터링 연동, 헬스체크, 진단 정보 수집, 카드 복구, 여러 카드의 펌웨어 업데이트 |