예제와 튜토리얼¶
드라이버를 운영하면서 자주 하는 작업을 처음부터 끝까지 따라 할 수 있게 정리했습니다. 튜토리얼마다 그대로 쓰거나 고쳐 쓸 수 있는 예제 스크립트와 설정이 들어 있습니다. 기능이 왜 그렇게 동작하는지는 운영 가이드에, 명령의 옵션과 종료 코드는 각 도구 페이지(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로 그 경로를 알려 줄 수 있습니다. - 경로, 카드 수, 주기 같은 값은 운영 환경에 맞게 고쳐 쓰십시오.