ha-led¶
ha-led는 카드 한 장의 보드 LED를 깜빡여, 섀시에서 그 카드가 꽂힌 슬롯을 찾게 해 주는 호스트용 명령행 도구입니다. hyperaccel-smi가 Bus-Id로 보여 주는 카드를 PCI 주소로 지정하면, 드라이버를 거쳐 그 카드의 펌웨어에 LED 켜기와 끄기 명령을 보냅니다. 이 페이지는 설치 위치, 요구 사항, 인자, 동작, 출력, 종료 코드와 오류 메시지를 정의합니다.
2.5.0 릴리즈부터 들어갑니다
ha-led는 2.5.0 미만 릴리즈에는 없습니다. 이 도구와, 도구가 쓰는 드라이버의 LED 명령이 2.5.0부터 릴리즈에 함께 들어갑니다.
설치 위치¶
ha-led는 드라이버 deb 패키지 hyperdriver-dkms가 /usr/bin/ha-led에 설치합니다. hyperaccel-smi, ha-hotreset, ha-fw-update와 함께 설치되고, 드라이버를 제거할 때(패키지 제거) 함께 지워집니다.
요구 사항¶
- 호스트에서 root로 실행합니다. root가 아니면 명령을 보내는 단계에서
ha-led: root required를 출력하고 종료 코드1로 끝납니다. python3가 필요합니다. 표준 라이브러리만 씁니다.- 대상 카드를 드라이버가 인식해서
/sys/class/ha/아래에haN이 있어야 합니다. - 적재된 드라이버가
ha-led와 같은 릴리즈여야 합니다. 이전 릴리즈의 드라이버는 LED 명령을 지원하지 않습니다. 적재된 버전은cat /sys/module/ha/version으로 확인합니다. - 카드의 펌웨어가 LED 명령을 지원해야 합니다. 아래 펌웨어 지원 확인을 보십시오.
펌웨어 지원 확인¶
LED 명령은 두 조건이 모두 맞아야 동작합니다.
- 드라이버 버전은 2.5.0 이상, 펌웨어 버전은 1.0.6(프로토콜 v8) 이상이어야 합니다.
- 카드의 보드에 LED가 있어야 합니다. 드라이버, 펌웨어 버전은 명령이 있다는 뜻이지 보드에 LED가 있다는 뜻은 아닙니다. LED가 없는 보드용 펌웨어는 명령을 거부합니다.
드라이버는 카드를 인식할 때 펌웨어의 프로토콜을 커널 로그에 남깁니다.
1 | |
1 | |
ABI protocol 바로 뒤의 숫자(v8)가 펌웨어의 프로토콜입니다. 펌웨어의 버전 번호와 함께 이 줄로 판단하십시오. 프로토콜이 8보다 낮으면 ha-fw-update로 펌웨어를 업데이트하십시오.
시놉시스¶
1 2 | |
인자와 옵션¶
| 인자 | 설명 |
|---|---|
-d BDF, --bdf BDF |
필수. 대상 카드의 PCI 주소입니다. 카드 한 장만 지정할 수 있습니다. 카드 지정을 보십시오 |
on |
LED를 깜빡이기 시작하고 바로 끝납니다. off를 보낼 때까지 계속 깜빡입니다 |
off |
LED를 끕니다 |
on과 off 모두 생략 |
10초 동안 깜빡인 뒤 LED를 끕니다. 10초는 바꿀 수 없습니다 |
-h, --help |
사용법을 출력하고 끝납니다 |
LED가 깜빡이는 주기는 펌웨어가 정합니다.
카드 지정¶
-d에는hyperaccel-smi가Bus-Id로 보여 주는 PCI 주소를 씁니다(카드 표).haN번호가 아니라 PCI 주소로 가리키는 것은, 번호가 카드 구성에 따라 달라질 수 있기 때문입니다.- 형식은
dddd:bb:dd.f(예:0000:65:00.0)이거나 도메인을 뺀bb:dd.f(예:65:00.0)입니다. 대소문자는 구분하지 않고 앞뒤 공백은 무시합니다. - 도메인을 뺀 주소는 그 주소의 카드가 하나뿐일 때만 받습니다. 같은 주소가 여러 PCI 도메인에 있으면 후보를 출력하고 종료 코드
2로 거부하므로, 도메인까지 쓰십시오. - 드라이버가 인식한 카드만 찾습니다. 찾지 못하면 지금 인식된 카드의 목록을 함께 출력합니다.
- 주소 형식이 맞지 않으면 종료 코드
1로 끝납니다.
동작¶
on과 off를 모두 생략한 기본 모드는 다음 순서로 진행합니다.
- 카드에 깜빡임 명령을 보내고, 성공하면 한 줄을 출력합니다.
- 10초 동안 기다립니다. 기다리는 중에 SIGINT(Ctrl-C), SIGTERM, SIGHUP을 받으면 기다림을 바로 끝냅니다.
- 카드에 끄기 명령을 보내고 한 줄을 출력한 뒤 끝납니다. 끄기 명령은 기다림이 어떻게 끝났든 보내며, 출력이 실패해도(파이프가 끊긴 경우 등) 보냅니다.
펌웨어는 깜빡임 명령을 받으면 끄기 명령이 올 때까지 계속 깜빡입니다. 그래서 끄는 일은 호스트의 몫이며, 10초 뒤에 끄는 것도 이 도구입니다.
- 도구는 실행하는 동안 SIGINT, SIGTERM, SIGHUP을 막아 두고 기다림을 끝내는 데에만 씁니다. 이 신호들은 이미 카드로 나간 명령을 끊지 않습니다.
- 명령을 보낼 때만
/dev/haN을 열고 바로 닫습니다. 디바이스 노드를 연 프로세스가 있으면 ha-hotreset이 리셋을 거부하는데,ha-led는 10초를 기다리는 동안 노드를 열어 두지 않으므로, 이 도구 때문에 리셋이 거부되지는 않습니다. - 끄기 명령은 처음에 찾은
haN이 아니라 PCI 주소로 카드를 다시 찾아 보냅니다. 기다리는 동안 카드가 리셋되어 다른haN번호를 받아도 같은 카드를 끕니다.
출력¶
진행 상황은 표준 출력에, 오류는 ha-led:로 시작하는 줄로 표준 오류에 출력합니다. 줄 앞의 ha1 0000:65:00.0은 카드의 번호와 PCI 주소입니다.
1 2 3 | |
첫 줄은 깜빡임 명령이 성공하면 바로, 둘째 줄은 10초가 지나거나 기다림이 신호로 끝날 때 나옵니다.
1 2 3 4 | |
LED가 켜진 채 남는 경우¶
다음 경우에는 끄기 명령이 카드에 가지 못해 LED가 계속 깜빡일 수 있습니다.
- 10초를 기다리는 중에
ha-led를 SIGKILL로 끝냈거나 호스트가 종료되었습니다. 도구를 끝낼 때는 SIGKILL 대신 Ctrl-C나 SIGTERM을 쓰십시오. 그러면 LED를 끄고 끝납니다. - 카드를 리셋했습니다. SDK 디바이스 리셋과 자동 리셋은 깜빡임을 끄지 않습니다. SBR이나
ha-hotreset뒤에는 핀 상태가 정해져 있지 않습니다. - 끄기 명령이 실패했습니다. 오류 메시지를 보십시오.
어느 경우든 카드가 다시 응답하면 off로 끄십시오.
1 | |
종료 코드¶
| 코드 | 뜻 |
|---|---|
0 |
명령이 성공했습니다. --help를 출력한 경우도 같습니다 |
1 |
사용법 오류이거나 root가 아닙니다. -d를 생략했거나, 주소 형식이 맞지 않거나, on과 off 외의 인자를 준 경우와, 디바이스 노드를 열 권한이 없는 경우를 포함합니다 |
2 |
카드를 쓸 수 없습니다. 카드를 찾지 못했거나, 주소가 여러 카드와 맞거나, 드라이버나 펌웨어가 LED 명령을 지원하지 않거나, 카드가 업데이트 중이거나 준비되지 않았거나 FATAL인 경우입니다 |
3 |
펌웨어에서 명령이 실패했거나 응답하지 않았습니다. 이때 LED가 어떤 상태인지 알 수 없습니다 |
오류 메시지¶
메시지는 앞부분만 적었습니다. 줄 뒤쪽에는 원인에 따라 조치가 더 붙을 수 있습니다.
| 코드 | 출력(앞부분) | 뜻과 할 일 |
|---|---|---|
1 |
ha-led: root required |
root가 아닙니다. sudo로 실행하십시오 |
1 |
ha-led: '<값>' is not a PCI address |
주소 형식이 맞지 않습니다. dddd:bb:dd.f나 bb:dd.f로 쓰십시오 |
1 |
ha-led: cannot open /dev/haN: Permission denied |
디바이스 노드를 열 권한이 없습니다. root로 실행하고 있는지 확인하십시오 |
2 |
ha-led: cannot open /dev/haN: <이유> |
노드를 열 수 없습니다. No such file or directory이면 노드가 없는 것이므로 드라이버가 카드를 인식했는지 확인하십시오 |
2 |
ha-led: no HyperAccel card at <값>; cards present: … |
그 주소에 드라이버가 인식한 카드가 없습니다. 뒤에 지금 인식된 카드가 <BDF> (ha<N>) 목록으로 나옵니다. none (is the ha driver loaded?)이면 드라이버가 적재되어 있는지 확인하십시오 |
2 |
ha-led: <값> matches more than one card: … |
도메인을 뺀 주소가 여러 카드와 맞습니다. 도메인까지 쓴 전체 주소를 주십시오 |
2 |
ha-led: this driver has no LED command |
적재된 드라이버가 LED 명령을 지원하지 않습니다. ha-led와 같은 릴리즈의 드라이버를 설치하고 적재하십시오 |
2 |
ha-led: this card cannot blink its LED |
펌웨어의 프로토콜이 8보다 낮거나, LED가 없는 보드용 펌웨어입니다. 펌웨어 지원 확인의 방법대로 확인하고, 프로토콜이 낮으면 펌웨어를 업데이트하십시오 |
2 |
ha-led: a firmware update is running on this card, or the last one got no answer |
카드에서 펌웨어 업데이트가 진행 중이거나, 마지막 업데이트가 응답을 받지 못했습니다. 업데이트가 끝난 뒤 다시 실행하십시오. 응답을 받지 못한 경우는 응답을 받지 못했을 때를 따르십시오 |
2 |
ha-led: the card is not ready |
펌웨어가 부팅 중이거나 리셋 중입니다. 잠시 뒤 다시 실행하십시오 |
2 |
ha-led: the card was reset while the command was on its way |
명령이 가는 중에 카드가 리셋되었습니다. 다시 실행하십시오 |
2 |
ha-led: the card is being removed or is gone |
카드가 제거되는 중이거나 이미 없습니다 |
2 |
ha-led: the card is in a fatal state |
카드가 FATAL 상태입니다. 도구는 먼저 ha-hotreset으로 리셋하라고 안내하지만, 복구 수단은 원인에 따라 다릅니다. FATAL과 복구를 따르십시오 |
2 |
ha-led: the driver could not map the card's control window |
드라이버가 카드의 제어 창을 매핑하지 못했습니다. 다시 실행하십시오. 반복되면 커널 로그를 모아 HyperAccel에 문의하십시오 |
2 |
ha-led: the firmware on this card was built without the LED command |
펌웨어가 LED 명령을 지원하지 않습니다. ha-fw-update로 펌웨어를 업데이트하십시오 |
3 |
ha-led: the firmware did not answer, or a reset was in progress |
펌웨어가 응답하지 않았거나 리셋 중이어서 LED 상태를 알 수 없습니다. 카드가 다시 응답하면 off를 실행하십시오. 무응답은 상한이 만료되면에 설명한 대로 기록됩니다 |
3 |
ha-led: the firmware could not start the blink (rc 4) |
펌웨어가 깜빡임을 시작하지 못했고, 그 사이 LED가 켜진 채 남았을 수 있습니다. 도구가 끄기 명령을 한 번 더 보냅니다. LED가 켜져 있으면 off를 실행하십시오 |
3 |
ha-led: the firmware refused the command (rc <N>) |
펌웨어가 명령을 거부했습니다. 반복되면 커널 로그를 모아 HyperAccel에 문의하십시오 |
3 |
ha-led: LED command failed: <이유> |
위에 없는 그 밖의 실패입니다 |
기본 모드에서 끄기 명령이 실패하면 위 메시지 뒤에 ; the LED may still be blinking: run ha-led -d <BDF> off가 붙고, 종료 코드는 그 실패의 코드입니다. 안내대로 off를 실행하십시오.
펌웨어가 오류로 응답한 경우(built without the LED command, could not start the blink, refused the command)에는 드라이버가 이를 펌웨어 오류로 셉니다. devcmd_fw_errors가 1 늘고 health가 degraded가 되며, 커널 로그에 Firmware error: resq[…]가 남습니다(펌웨어 오류 결과). 도구의 출력에도 펌웨어 오류로 집계되어 degraded가 된다는 안내가 덧붙습니다. 카드가 지금 실패하고 있다는 뜻은 아니고, 드라이버가 카드를 다시 인식할 때(핫 리셋, 모듈 재적재, 재부팅) ok로 돌아옵니다. 이 표시 때문에 카드를 리셋할 필요는 없습니다. this card cannot blink its LED는 펌웨어 오류로 세지 않으므로 health에 영향이 없습니다. 자세한 내용은 텔레메트리를 보십시오.
사용 예¶
섀시에서 카드 찾기:
hyperaccel-smi로 찾으려는 카드의Bus-Id를 확인합니다.-
그 주소를 주고 실행합니다. LED가 10초 동안 깜빡입니다.
1sudo ha-led -d 0000:65:00.0 -
섀시 앞에서 카드를 찾을 시간이 더 필요하면
on으로 깜빡이게 두고, 찾은 뒤off로 끕니다.1 2
sudo ha-led -d 0000:65:00.0 on sudo ha-led -d 0000:65:00.0 off
함께 보기¶
- hyperaccel-smi — 카드의 PCI 주소(
Bus-Id) 확인 - ha-fw-update — LED 명령을 지원하는 펌웨어로 업데이트
- ha-hotreset — 카드 리셋. SBR과 핫 리셋 뒤의 LED 핀 상태는 정해져 있지 않습니다. SDK 디바이스 리셋은 깜빡임을 끄지 않습니다
- FATAL과 복구 — 카드가 FATAL일 때
- hang 감지와 워치독 — 펌웨어가 응답하지 않을 때의 기록
- 텔레메트리 —
health와degraded - 여러 디바이스 — 카드 번호와 PCI 주소의 대응