콘텐츠로 이동

예제와 튜토리얼

드라이버를 운영하면서 자주 하는 작업을 처음부터 끝까지 따라 할 수 있게 정리했습니다. 튜토리얼마다 그대로 쓰거나 고쳐 쓸 수 있는 예제 스크립트와 설정이 들어 있습니다. 기능이 왜 그렇게 동작하는지는 운영 가이드에, 명령의 옵션과 종료 코드는 각 도구 페이지(hyperaccel-smi, ha-hotreset, ha-fw-update)에, 노드의 정의는 sysfs 노드에 있습니다.


튜토리얼

튜토리얼 할 수 있게 되는 것 예제
Prometheus로 텔레메트리 수집하기 hwmon 센서 값과 카드의 상태, 메모리, 오류 카운터, 사용률을 Prometheus로 모으고 경보를 겁니다 ha-prom-textfile.sh, systemd 타이머, 경보 규칙
카드 상태 헬스체크 만들기 드라이버 적재, 카드 수, 카드마다의 health와 fw_version을 확인해 종료 코드로 알립니다 ha-healthcheck.sh, systemd 타이머
문제 상황의 진단 정보 모으기 카드를 리셋하기 전에 지원팀에 보낼 정보를 아카이브 하나로 저장합니다 ha-collect-diag.sh
응답하지 않는 카드 복구하기 증상 확인부터 ha-hotreset으로 카드 한 장을 리셋하고 복구를 확인하기까지 따라갑니다 명령 예
여러 카드의 펌웨어를 차례로 업데이트하기 카드를 한 장씩 같은 펌웨어로 업데이트하고, 문제가 생기면 그 자리에서 멈춥니다 ha-fw-update-all.sh

카드에 문제가 생겼을 때는 진단 정보를 먼저 모은 뒤 카드를 복구합니다. 리셋하면 원인을 보여 주는 상태가 사라지기 때문입니다.


예제 스크립트를 쓰기 전에

  • 예제 스크립트는 드라이버 패키지에 들어 있지 않습니다. 페이지의 내용을 파일로 저장해 쓰십시오.
  • POSIX sh 문법으로 작성했으므로 bash가 없는 /bin/sh(예: dash)에서도 동작합니다.
  • 헬스체크와 모니터링 예제는 sysfs를 읽기만 하고 디바이스 노드를 열지 않으므로 워크로드와 함께 실행할 수 있습니다. 헬스체크는 root 권한 없이도 실행됩니다.
  • 호스트의 /sys를 다른 경로에 마운트한 환경(예: 컨테이너)에서는 환경 변수 SYSFS로 그 경로를 알려 줄 수 있습니다.
  • 경로, 카드 수, 주기 같은 값은 운영 환경에 맞게 고쳐 쓰십시오.

함께 보기