ha-fw-update¶
ha-fw-update는 카드의 부트 플래시에 새 펌웨어 이미지를 쓰고, 카드를 핫 리셋해 새 펌웨어로 부팅시키는 도구입니다. 이 페이지는 설치 위치, 인자와 옵션, 사전 점검, 화면 출력, 종료 코드, JSON 출력, 이미지 요구 사항, 리셋 명령을 정의합니다. 언제 어떤 순서로 쓰는지와 실패했을 때의 대응은 펌웨어 업데이트에 있습니다.
설치 위치¶
ha-fw-update는 hyperdriver-dkms 드라이버 패키지가 /usr/bin/ha-fw-update에 설치합니다. ha-hotreset(/usr/bin/ha-hotreset)과 함께 설치되고, 드라이버를 제거할 때(패키지 제거) 함께 지워집니다. 설치 절차는 설치에 있습니다.
요구 사항:
- root 권한
- Python 3.7 이상. 표준 라이브러리만 씁니다. 도구는
PATH의python3로 실행되므로,python3 --version이 3.7보다 낮으면 3.7 이상의 인터프리터로 직접 실행합니다(예:sudo python3.9 /usr/bin/ha-fw-update ...) - 리셋 단계에는 리셋 명령이 필요하고,
ha-hotreset은pciutils(lspci,setpci)를 씁니다
시놉시스¶
1 2 | |
ha-fw-update --help는 옵션과 함께 안전 항목(SAFETY)과 종료 코드(EXIT CODES)를 출력합니다.
인자와 옵션¶
| 인자·옵션 | 기본값 | 뜻 |
|---|---|---|
IMAGE |
필수 | 새로 쓸 이미지 파일의 경로. 이미지 파일을 보십시오 |
-d BDF, --bdf BDF |
없음 | 카드의 PCI 주소. hyperaccel-smi의 Bus-Id 값(0000:01:00.0)을 그대로 씁니다. 카드 지정을 보십시오 |
-i N, --index N |
없음 | /dev/haN의 번호 N. 핫 리셋이나 카드 추가 뒤에 바뀔 수 있으므로 -d를 권장합니다 |
--scope full, --scope app |
full |
쓸 범위. full은 플래시의 처음부터 이미지 크기만큼, 즉 이미지 전체를 씁니다. app은 이미지의 일부 파티션(펌웨어 애플리케이션, FIP) 범위만 씁니다 |
--rewrite |
꺼짐 | 범위 안의 모든 섹터를 플래시와 비교하지 않고 지우고 다시 씁니다. 꺼져 있으면 플래시와 내용이 다른 부분만 쓰며, 같은 이미지는 거의 바로 끝납니다 |
-y, --yes |
꺼짐 | 확인 프롬프트를 건너뜁니다 |
--dry-run |
꺼짐 | 사전 점검만 하고 아무것도 쓰지 않습니다 |
--no-reset |
꺼짐 | 플래시만 쓰고 리셋과 확인 단계를 건너뜁니다. 카드는 다시 시작될 때까지(핫 리셋, 호스트 재부팅, 전원 재인가) 이전 펌웨어로 동작합니다 |
--force |
꺼짐 | 다른 프로세스가 /dev/haN을 열고 있어도 진행합니다. 이때는 --no-reset이 함께 있어야 합니다(옵션 조합) |
--hotreset PATH |
리셋 명령의 탐색 순서 | 리셋 단계에서 실행할 명령의 경로 |
--boot-timeout SEC |
60 |
리셋 뒤 카드가 돌아오기를 기다리는 시간(초, 정수). 0 이하이면 기다리지 않으므로 확인 단계가 종료 코드 6으로 끝납니다 |
--json |
꺼짐 | 화면 출력 대신 결과 JSON 하나를 표준 출력에 냅니다 |
-h, --help |
없음 | 도움말을 출력하고 끝냅니다 |
-d와 -i 중 하나를 정확히 주어야 합니다.
카드 지정¶
-d의 값은dddd:bb:dd.f(도메인:버스:디바이스.기능) 형식의 16진수이며, 대소문자를 가리지 않습니다.- 그
bb:dd.f를 가진 HyperAccel 카드가 모든 PCI 도메인을 통틀어 하나뿐이면bb:dd.f처럼 도메인을 생략할 수 있습니다. 같은bb:dd.f를 가진 카드가 여러 도메인에 있으면 후보를 보여 주고 종료 코드 2로 끝납니다. - 형식이 맞지 않으면 종료 코드 1로 끝납니다. 그 주소에 카드가 없으면 있는 카드의 목록을 보여 주고 종료 코드 2로 끝납니다.
-i N이면/dev/haN과 그 카드의 PCI 주소가 있는지 확인합니다. 없으면 종료 코드 2입니다.
옵션 조합¶
| 조합 | 결과 |
|---|---|
-d와 -i를 함께 주거나 둘 다 주지 않음 |
명령행 구문 오류. 종료 코드 2 |
--json에 -y도 --dry-run도 없음 |
종료 코드 1. 경고와 프롬프트를 보여 줄 수 없기 때문입니다 |
다른 프로세스가 카드를 열었고 --force가 없음 |
종료 코드 2 |
다른 프로세스가 카드를 열었고 --force만 있음 |
플래시를 쓰기 전에 종료 코드 2. ha-hotreset은 열린 핸들이 있는 카드를 리셋하지 않기 때문입니다 |
다른 프로세스가 카드를 열었고 --force --no-reset |
경고를 내고 진행합니다. 그 프로세스를 끝낸 뒤 직접 ha-hotreset --bdf <BDF>를 실행합니다 |
카드를 연 다른 프로세스가 없고 --force |
효과가 없습니다 |
--no-reset과 --hotreset 또는 --boot-timeout |
--hotreset과 --boot-timeout은 쓰이지 않습니다 |
--scope app과 16 MiB 이미지 |
종료 코드 3 |
확인 프롬프트¶
요약을 출력한 뒤 표준 오류에 Proceed? [y/N]을 출력하고 표준 입력에서 답을 읽습니다. -y나 --dry-run을 주면 묻지 않습니다.
y나yes(대소문자 무관)이면 진행합니다.- 그 밖의 입력, 빈 줄, 입력 끝(EOF)이면
ERROR: aborted를 출력하고 종료 코드 1로 끝납니다. 아무것도 쓰지 않습니다. - 프롬프트는 표준 오류(
stderr)로 나가므로, 표준 출력(stdout)을 파일로 보내도 화면에 보입니다.
사전 점검¶
다음 순서로 확인하며, 하나라도 실패하면 플래시에 아무것도 쓰지 않고 끝납니다.
| 순서 | 확인 | 실패하면 |
|---|---|---|
| 1 | 명령행 값: -d의 형식, --json과 -y·--dry-run의 조합 |
종료 코드 1 |
| 2 | root 권한 | 종료 코드 1 |
| 3 | 이미지 파일을 읽을 수 있는가 | 종료 코드 1 |
| 4 | 이미지의 형식과 크기, 범위와의 조합(이미지 파일). 통과하면 이미지 전체의 CRC-32를 계산합니다 | 종료 코드 3 |
| 5 | 카드가 있는가(-d면 그 PCI 주소, -i면 /dev/haN) |
종료 코드 2 |
| 6 | 같은 카드에서 다른 ha-fw-update가 실행 중이지 않은가 |
종료 코드 2 |
| 7 | sysfs fw_version이 unknown이 아닌가 |
종료 코드 2 |
| 8 | 다른 프로세스가 /dev/haN을 열고 있지 않은가 |
종료 코드 2. 옵션 조합의 --force를 보십시오 |
| 9 | 리셋 명령이 있고 실행할 수 있는가(--no-reset이면 건너뜀). 부모 포트가 root port가 아니면 경고만 냅니다 |
종료 코드 1 |
| 10 | /dev/haN을 열고 이미지를 올릴 카드 메모리를 확보합니다. 카드가 요청을 받을 수 있는지 여기서 확인합니다 |
종료 코드 2 |
--dry-run은 10번까지 마치고 요약과 Dry run: nothing written.을 출력한 뒤 종료 코드 0으로 끝납니다. 확보한 카드 메모리는 도구가 끝날 때 반환됩니다.
화면 출력¶
요약¶
사전 점검을 통과하면 다음 줄을 출력합니다.
| 줄 | 내용 |
|---|---|
Device |
노드 이름, PCI 주소, 현재 펌웨어 버전 |
Image |
이미지 경로, 크기(바이트), 종류(gpt 또는 full-flash), CRC-32 |
Scope |
쓸 플래시 범위. full이면 full -> flash 0x000000-<끝 주소>, app이면 fip 파티션의 범위와 크기(KiB)입니다. --rewrite이면 (rewrite all sectors)가 붙습니다. 16 MiB 이미지이면 다음 줄에 (16 MiB image: the TPDS region at 0x800000 is overwritten too)가 나와, 0x800000의 TPDS 영역까지 덮어쓴다는 것을 알립니다 |
Estimate |
device timeout: 드라이버가 펌웨어의 응답을 기다리는 상한(초). 이미지 크기로 정한 기한에 모듈 파라미터 ha_devcmd_ceiling_ms의 기본값(12초)을 더한 값이므로, 이 파라미터를 바꾸었다면 실제 상한은 그만큼 다릅니다. 예상 소요 시간이 아닙니다 |
Reset |
리셋 방법. SBR via <명령 이름> (parent is a root port) 또는 (parent is NOT a root port)이고, --no-reset이면 skipped (--no-reset)입니다 |
WARNING: Do not power off or reboot this host during the update. Recovery requires a debug tool (e.g., Trace32). |
업데이트 중 전원 차단과 재부팅을 하지 말라는 안내 |
단계¶
| 줄 | 내용 | 실패하면 |
|---|---|---|
[1/5] Pre-flight |
사전 점검을 모두 통과했다는 표시 | 해당 없음 |
[2/5] Upload |
이미지를 카드 메모리에 복사합니다. 크기(MiB)와 걸린 시간을 표시합니다 | 종료 코드 2 또는 3 |
[3/5] Flash (device) |
펌웨어가 이미지 검사, 플래시 비교, 쓰기, 되읽기 확인을 끝낼 때까지 기다립니다. 끝나면 걸린 시간과 <끝난 섹터>/<전체 섹터> sectors를 표시합니다 |
종료 코드 2, 3, 4 |
[4/5] Reset (SBR) |
/dev/haN을 닫고 리셋 명령을 실행합니다. --no-reset이면 skipped (--no-reset)과 함께 나중에 실행할 ha-hotreset 명령을 보여 주고 끝납니다 |
종료 코드 5 |
[5/5] Verify |
같은 PCI 주소의 노드가 fw_version을 보고할 때까지 1초 간격으로 최대 --boot-timeout 동안 기다리고, firmware <이전> -> <새> (haN)을 표시합니다 |
종료 코드 6 |
진행률¶
[3/5] 동안 표준 출력이 터미널이면 같은 줄을 계속 다시 그립니다. 상황에 따라 다음 형식 중 하나입니다.
1 2 3 | |
- 첫째 줄: sysfs
fw_update_progress에서 읽은 진행률입니다. 섹터는 4 KiB 단위이고, 플래시와 같아서 건너뛴 섹터도 끝난 것으로 셉니다. - 둘째 줄: 진행률을 읽을 수 없고
--rewrite를 준 경우입니다. 이미지 크기로 계산한 추정치이며 진행률이 아닙니다. - 셋째 줄: 진행률을 읽을 수 없는 경우의 경과 시간입니다.
펌웨어가 쓰기를 시작하기 전에는 fw_update_progress가 0 0이므로 둘째나 셋째 형식으로 표시되다가, 쓰기가 시작되면 첫째 형식으로 바뀝니다.
[3/5] 동안 진행률을 한 번도 읽지 못했으면 끝났을 때 섹터 수 대신 no progress counter (old firmware)가 나옵니다. 표준 출력이 터미널이 아니면 다시 그리지 않고 단계 이름만 한 번 출력하며, --json이면 아무것도 그리지 않습니다.
경고¶
| 경고 | 뜻 |
|---|---|
WARNING: /dev/haN is open by pid(s) <PID> (--force --no-reset): reset it yourself after closing them |
--force --no-reset으로 진행합니다. 그 프로세스를 끝낸 뒤 직접 리셋해야 합니다 |
WARNING: <BDF> is not directly under a root port; if the parent port leaves Surprise Down unmasked, ha-hotreset masks the switch path for the SBR, and where it cannot, the new image needs a power cycle |
부모 포트가 root port가 아닙니다. 그 포트가 Surprise Down 오류를 마스킹하지 않으면 리셋 단계에서 ha-hotreset이 경로를 마스킹하고 리셋합니다. 경로를 마스킹할 수 없으면 리셋이 거부되므로, 새 이미지로 부팅하려면 전원을 재인가해야 합니다. 리셋할 수 있는지는 sudo ha-hotreset --list로 확인합니다 |
WARNING: same version -- confirm the new image on the UART boot log. |
업데이트 전후의 버전 번호가 같습니다. 결과는 성공(종료 코드 0)입니다. 배포용 펌웨어는 UART에 버전을 출력하지 않으므로, UART 부팅 로그로 이미지를 구분할 수 없습니다. 기록한 이미지 파일로 구분하십시오. 새 펌웨어로 부팅되었는지 확인을 보십시오 |
종료 코드¶
| 코드 | 뜻 | 플래시 | 대표 원인 |
|---|---|---|---|
0 |
성공 | 새 이미지(--dry-run이면 바뀌지 않음) |
업데이트, 리셋, 확인을 모두 마침(same version 경고 포함). --dry-run 통과. --no-reset으로 플래시만 갱신 |
1 |
사용법이나 환경 문제 | 이 실행으로는 바뀌지 않음 | -d 형식 오류, --json에 -y·--dry-run 없음, root가 아님, 이미지 파일을 읽지 못함, 리셋 명령이 없음, 프롬프트에서 거절, [3/5] 전에 누른 Ctrl+C |
2 |
카드를 쓸 수 없거나 업데이트를 지원하지 않음 | 이 실행으로는 바뀌지 않음 | 카드가 없음, 같은 카드의 다른 업데이트, fw_version이 unknown, 다른 프로세스가 카드를 엶, 카드가 준비되지 않았거나 명령을 받을 수 없는 상태, 카드 메모리 부족, 드라이버가 앞선 업데이트의 응답을 기다리는 중(upload failed: Device or resource busy), 실행 중인 펌웨어나 드라이버가 업데이트를 지원하지 않음, 펌웨어가 쓰기 전에 중단함, 펌웨어가 플래시를 읽지 못함, 명령행 구문 오류 |
3 |
이미지 거부 | 이 실행으로는 바뀌지 않음 | 도구의 이미지 검사, 펌웨어의 이미지 검사(GPT, CRC), 플래시의 fip 파티션 배치가 이미지와 다름(--scope full로 다시 실행), 요청 인자 거부 |
4 |
쓰기 실패 또는 상태 불명 | 일부만 기록되었을 수 있음 | 펌웨어의 쓰기·되읽기 확인 실패, 정해진 시간 안에 펌웨어가 응답하지 않음, 업데이트 중 카드가 응답을 멈춤, 그 밖에 도구가 분류하지 못한 오류 |
5 |
플래시는 갱신했지만 리셋하지 못함 | 새 이미지 | 리셋 명령을 시작하지 못함, 리셋 명령이 실패함(그 출력이 오류 메시지에 포함됨) |
6 |
리셋했지만 확인을 마치지 못함 | 새 이미지 | --boot-timeout 안에 같은 PCI 주소의 카드가 fw_version을 보고하지 않음, [3/5] 이후에 누른 Ctrl+C |
- 종료 코드 4이면 카드를 리셋하거나 호스트를 재부팅하지 말고 같은 명령을 다시 실행합니다. 펌웨어의 응답을 받지 못해 끝났다면 펌웨어가 응답한 뒤에 다시 실행합니다. 응답을 받지 못했을 때를 보십시오.
[3/5]전(확인 프롬프트 포함)에 누른 Ctrl+C는aborted (nothing written)을 출력하고 종료 코드 1로 끝납니다.[3/5]부터 리셋이 끝날 때까지 누른 Ctrl+C는 리셋에 성공한 뒤에 처리되어 확인 단계를 건너뛰고,interrupted after flashing: ...을 출력한 뒤 종료 코드 6으로 끝납니다. 확인 단계에서 누른 Ctrl+C도 같습니다.--no-reset이거나 리셋에 실패했으면 처리되지 않고 종료 코드 0이나 5로 끝납니다.[3/5]부터 리셋이 끝날 때까지 받은SIGTERM이나SIGHUP은 리셋에 성공한 직후 도구를 종료시킵니다. 이때는 종료 코드 대신 시그널로 끝나며--json을 주었어도 JSON을 출력하지 않습니다. 플래시는 새 이미지이고 카드는 리셋되었습니다.--no-reset이거나 리셋에 실패했으면 처리되지 않습니다.- 명령행 구문 오류(알 수 없는 옵션,
IMAGE누락,-d와-i를 함께 주거나 둘 다 주지 않음, 허용되지 않는--scope값, 정수가 아닌-i나--boot-timeout)는 사용법을 표준 오류에 출력하고 종료 코드 2로 끝납니다. 이때는--json을 주었어도 JSON을 출력하지 않습니다.
JSON 출력¶
--json을 주면 다른 화면 출력을 모두 내지 않고, 끝날 때 결과 JSON 하나를 표준 출력에 냅니다. 성공과 실패 모두 같은 형식입니다. 명령행 구문 오류이면 JSON을 출력하지 않습니다. 도구가 정상적으로 끝나지 못하면 JSON이 없거나 result와 exit_code가 null일 수 있으며, 이때는 플래시 상태를 알 수 없습니다. 카드를 리셋하지 말고 같은 명령을 다시 실행하십시오.
출력 예:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 | |
필드¶
| 필드 | 형식 | 뜻 |
|---|---|---|
tool_version |
문자열 | 도구 버전. 이 릴리즈는 "1.0"입니다 |
device |
문자열 또는 null |
대상 노드 이름("ha0") |
bdf |
문자열 또는 null |
대상 카드의 PCI 주소 |
image |
문자열 | 명령행에 준 이미지 경로 |
image_kind |
문자열 또는 null |
"gpt" 또는 "full-flash" |
image_size |
정수 또는 null |
이미지 크기(바이트) |
image_crc32 |
문자열 또는 null |
이미지 전체의 CRC-32("0x07ba4d6e" 형식) |
scope |
문자열 | "full" 또는 "app" |
rewrite |
불리언 | --rewrite를 주었는지 |
result |
문자열 또는 null |
결과. result 값을 보십시오. 도구가 정상적으로 끝나지 못했으면 null |
exit_code |
정수 또는 null |
종료 코드와 같은 값. 도구가 정상적으로 끝나지 못했으면 null |
error |
문자열 또는 null |
실패 이유(사람이 읽는 문장) |
errno |
정수 또는 null |
실패한 요청이 돌려준 오류 번호. 진단용입니다 |
fw_rc |
정수 또는 null |
펌웨어가 업데이트 요청에 실패 결과를 돌려주었을 때 그 결과 코드. fw_rc 값을 보십시오 |
fw_version_before |
문자열 또는 null |
업데이트 전 fw_version |
fw_version_after |
문자열 또는 null |
리셋 뒤 fw_version. 확인 단계를 마쳤을 때만 채워집니다 |
version_changed |
불리언 또는 null |
업데이트 전후의 버전 번호가 다른지. 확인 단계를 마쳤을 때만 채워집니다 |
reset |
문자열 또는 null |
"sbr"(리셋함), "skipped"(--no-reset), "failed"(리셋하지 못함), null(리셋 단계에 이르지 않음) |
device_after |
문자열 또는 null |
리셋 뒤의 노드 이름. 리셋 전과 다를 수 있습니다 |
sectors |
정수 두 개의 배열 또는 null |
쓰기 단계가 끝났을 때의 [끝난 섹터, 전체 섹터](4 KiB 단위). 쓰기 단계를 마치지 못했거나 진행률을 읽지 못했으면 null |
elapsed_s |
객체 | 단계별로 걸린 시간(초): upload, flash, reset, verify. 거치지 않은 단계는 null |
result 값¶
| 값 | 뜻 | exit_code |
|---|---|---|
"ok" |
업데이트, 리셋, 확인을 모두 마쳤습니다 | 0 |
"dry-run" |
--dry-run의 사전 점검을 통과했습니다. 아무것도 쓰지 않았습니다 |
0 |
"updated-no-reset" |
플래시를 갱신하고 --no-reset으로 리셋을 건너뛰었습니다 |
0 |
"interrupted-after-flash" |
플래시를 갱신하고 리셋한 뒤, Ctrl+C로 확인 단계를 건너뛰었습니다 | 6 |
"aborted" |
쓰기 전에 Ctrl+C로 중단했습니다 | 1 |
"error" |
실패했습니다. exit_code와 error를 보십시오 |
1~6 |
exit_code가 6일 때 카드가 돌아오지 않은 경우("error")와 Ctrl+C로 확인을 건너뛴 경우("interrupted-after-flash")는 result로 구분합니다.
fw_rc 값¶
| 값 | 뜻 | exit_code |
|---|---|---|
2 |
실행 중인 펌웨어에 업데이트 기능이 없습니다 | 2 |
3 |
펌웨어가 요청의 인자를 거부했습니다. 플래시는 바뀌지 않았습니다 | 3 |
7 |
펌웨어가 플래시를 지우기 전에 중단했습니다. 플래시는 바뀌지 않았습니다 | 2 |
10 |
펌웨어의 이미지 검사(GPT, CRC)에 실패했습니다. 플래시는 바뀌지 않았습니다 | 3 |
11 |
--scope app에서 플래시의 GPT나 그 안의 fip 파티션을 읽을 수 없거나, fip 파티션의 위치가 이미지와 다릅니다. 플래시는 바뀌지 않았습니다. --scope full로 다시 실행합니다 |
3 |
12 |
쓰기나 되읽기 확인에 실패했습니다. 플래시가 일부만 기록되었을 수 있습니다 | 4 |
13 |
펌웨어가 플래시를 읽지 못했습니다. 지우기 전이라 플래시는 바뀌지 않았습니다 | 2 |
| 그 밖의 값 | 알 수 없는 결과입니다 | 4 |
이미지 파일¶
ha-fw-update는 두 종류의 이미지를 받습니다.
| 종류 | image_kind |
크기 | 쓸 수 있는 범위 |
|---|---|---|---|
GPT 이미지(image.gpt) |
gpt |
이미지의 GPT가 기술하는 디스크 크기와 정확히 같음 | full, app |
| 전체 플래시 이미지 | full-flash |
정확히 16 MiB | full |
GPT의 디스크 크기는 백업 GPT 헤더의 위치로 정합니다((백업 헤더의 LBA + 1) × 512 바이트). 도구는 쓰기 전에 다음을 확인하고, 맞지 않으면 종료 코드 3으로 끝납니다. 플래시는 바뀌지 않습니다.
- LBA 1(오프셋 512)에 GPT 헤더가 있고, 헤더와 파티션 항목 표의 CRC가 맞습니다.
- 파티션 항목의 크기가 128바이트이고, 항목 수가 1~128개입니다.
- 파일 크기가 512의 배수이고 16 MiB 이하입니다.
- 파일 크기가 GPT의 디스크 크기나 16 MiB와 같습니다. 디스크 크기보다 작거나, 뒤에 다른 데이터가 붙은 파일은 받지 않습니다.
--scope app이면 GPT 이미지여야 하고, fip 파티션이 있어야 합니다.
펌웨어는 카드 메모리에 올라간 이미지의 GPT와 CRC를 플래시를 지우기 전에 다시 검사합니다. --scope app이면 플래시에 있는 GPT의 fip 파티션 위치도 이미지와 같아야 하며, 다르면 fw_rc 11로 거부합니다.
리셋 명령¶
리셋 단계는 다음 순서로 찾은 명령을 <명령> --bdf <BDF> 형태로 실행합니다.
--hotreset PATH를 주었으면 그 경로만 씁니다. 실행할 수 없는 파일이면 사전 점검에서 종료 코드 1로 끝납니다.- 도구 파일의 실제 위치(심볼릭 링크를 따라간 위치)와 같은 디렉터리의
ha-hotreset.sh PATH에서 찾은ha-hotreset
설치된 /usr/bin/ha-fw-update를 실행하면 /usr/bin/ha-hotreset이 쓰입니다. 같은 디렉터리에 ha-hotreset.sh가 있으면 그것이 먼저 쓰이며, ha-hotreset과 같은 스크립트입니다. 리셋 명령의 출력은 리셋이 실패했을 때만 오류 메시지에 함께 나옵니다. 같은 호스트에서 다른 ha-hotreset이 돌고 있으면 리셋 전에 [4/5] another ha-hotreset is running on this host; waiting for it (up to 600 s)를 출력하고, 그 실행이 끝날 때까지 최대 600초 기다립니다. 리셋 조건은 ha-hotreset에 있습니다.
사용하는 파일¶
| 경로 | 용도 |
|---|---|
/dev/haN |
이미지를 올리고 업데이트를 요청합니다. 리셋 단계 전에 닫습니다 |
/sys/class/ha/haN/device |
카드의 PCI 주소를 얻습니다 |
/sys/class/ha/haN/fw_version |
업데이트 전 버전을 읽고, 리셋 뒤 카드가 준비되었는지와 새 버전을 확인합니다 |
/sys/class/ha/haN/fw_update_progress |
진행률을 읽습니다 |
/proc/<PID>/fd/ |
/dev/haN을 연 다른 프로세스를 찾습니다 |
부모 포트의 sysfs config |
부모 포트가 root port인지 확인합니다 |
/run/lock/ha-fw-update.<BDF>.lock |
같은 카드에 대한 동시 실행을 막는 잠금 파일입니다 |
함께 보기¶
- 펌웨어 업데이트 — 절차, 업데이트 중 제약, 실패했을 때의 대응
- 여러 카드의 펌웨어를 차례로 업데이트하기 —
--json결과를 이용해 여러 카드를 한 장씩 업데이트하는 예제 스크립트 - ha-hotreset — 리셋 단계에서 쓰는 핫 리셋 명령
- hyperaccel-smi — 카드의
Bus-Id와 펌웨어 버전 - sysfs —
fw_version,fw_update_progress - 커널 로그 메시지
- 지원 환경