콘텐츠로 이동

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 명령은 두 조건이 모두 맞아야 동작합니다.

  1. 드라이버 버전은 2.5.0 이상, 펌웨어 버전은 1.0.6(프로토콜 v8) 이상이어야 합니다.
  2. 카드의 보드에 LED가 있어야 합니다. 드라이버, 펌웨어 버전은 명령이 있다는 뜻이지 보드에 LED가 있다는 뜻은 아닙니다. LED가 없는 보드용 펌웨어는 명령을 거부합니다.

드라이버는 카드를 인식할 때 펌웨어의 프로토콜을 커널 로그에 남깁니다.

1
sudo dmesg | grep 'ABI protocol'
1
ha 0000:65:00.0: ABI protocol v8 (driver v9, min v6)

ABI protocol 바로 뒤의 숫자(v8)가 펌웨어의 프로토콜입니다. 펌웨어의 버전 번호와 함께 이 줄로 판단하십시오. 프로토콜이 8보다 낮으면 ha-fw-update로 펌웨어를 업데이트하십시오.

시놉시스

1
2
ha-led -d BDF [on | off]
ha-led -h

인자와 옵션

인자 설명
-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를 모두 생략한 기본 모드는 다음 순서로 진행합니다.

  1. 카드에 깜빡임 명령을 보내고, 성공하면 한 줄을 출력합니다.
  2. 10초 동안 기다립니다. 기다리는 중에 SIGINT(Ctrl-C), SIGTERM, SIGHUP을 받으면 기다림을 바로 끝냅니다.
  3. 카드에 끄기 명령을 보내고 한 줄을 출력한 뒤 끝납니다. 끄기 명령은 기다림이 어떻게 끝났든 보내며, 출력이 실패해도(파이프가 끊긴 경우 등) 보냅니다.

펌웨어는 깜빡임 명령을 받으면 끄기 명령이 올 때까지 계속 깜빡입니다. 그래서 끄는 일은 호스트의 몫이며, 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
$ sudo ha-led -d 0000:65:00.0
ha1 0000:65:00.0: LED blinking for 10 s (Ctrl-C turns it off now)
ha1 0000:65:00.0: LED off

첫 줄은 깜빡임 명령이 성공하면 바로, 둘째 줄은 10초가 지나거나 기다림이 신호로 끝날 때 나옵니다.

1
2
3
4
$ sudo ha-led -d 0000:65:00.0 on
ha1 0000:65:00.0: LED blinking until `ha-led -d 0000:65:00.0 off`
$ sudo ha-led -d 0000:65:00.0 off
ha1 0000:65:00.0: LED off

LED가 켜진 채 남는 경우

다음 경우에는 끄기 명령이 카드에 가지 못해 LED가 계속 깜빡일 수 있습니다.

  • 10초를 기다리는 중에 ha-led를 SIGKILL로 끝냈거나 호스트가 종료되었습니다. 도구를 끝낼 때는 SIGKILL 대신 Ctrl-C나 SIGTERM을 쓰십시오. 그러면 LED를 끄고 끝납니다.
  • 카드를 리셋했습니다. SDK 디바이스 리셋과 자동 리셋은 깜빡임을 끄지 않습니다. SBR이나 ha-hotreset 뒤에는 핀 상태가 정해져 있지 않습니다.
  • 끄기 명령이 실패했습니다. 오류 메시지를 보십시오.

어느 경우든 카드가 다시 응답하면 off로 끄십시오.

1
sudo ha-led -d 0000:65:00.0 off

종료 코드

코드 뜻
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에 영향이 없습니다. 자세한 내용은 텔레메트리를 보십시오.

사용 예

섀시에서 카드 찾기:

  1. hyperaccel-smi로 찾으려는 카드의 Bus-Id를 확인합니다.
  2. 그 주소를 주고 실행합니다. LED가 10초 동안 깜빡입니다.

    1
    sudo ha-led -d 0000:65:00.0
    
  3. 섀시 앞에서 카드를 찾을 시간이 더 필요하면 on으로 깜빡이게 두고, 찾은 뒤 off로 끕니다.

    1
    2
    sudo ha-led -d 0000:65:00.0 on
    sudo ha-led -d 0000:65:00.0 off
    

함께 보기