nicctl debug update firmware - nicctl debug update firmware - ug1854

AMD Pensando Vulcano 800 Custom AI NIC Operations Guide (ug1854)
Document_ID
ug1854
Release_Date
2026-08-03
Revision
0.8 English
isSecure
false
secureFeature
watermarking
print

Debug firmware updates.

Usage

nicctl debug update firmware [flags]

Flags

--card|-c <card-uuid-list>
Specify card UUIDs as a comma separated list.
--next-boot-image|-n fw-a|fw-b|fw-gold
Specify fw-a, fw-b, or golden firmware.

Description

This command can be used to debug firmware updates by setting the next-boot image as required.

If the next boot image is set to fw-gold from fw-a/b, or from fw-gold to fw-a/b, it will be necessary to reboot (cold or warm) the host to recover PCIe connection to the card. This is because the gold-fw and standard firmware have different PCIe modes.

Note:
  • This command is for debug purposes only. It is not required when using the nicctl update firmware command, which sets the next-boot image to the correct value at the end of its update procedure.

Examples

Set the next-boot image to be firmware B for all cards in the host:

nicctl debug update firmware --next-boot-image fw-b
Firmware next-boot-image update is in progress for device 90812683-8046-504c-3234-333930303542
Firmware next-boot-image update is in progress for device 9081267b-4046-504c-3234-333930303033
------------------------------------------------------------
Device Id Status
------------------------------------------------------------
9081267b-4046-504c-3234-333930303033 Successful
90812683-8046-504c-3234-333930303542 Successful

Set the next-boot image to be firmware B for a specific card, with more detailed logs:

nicctl debug update firmware --card 9081267b-4046-504c-3234-333930303033 \
                               --next-boot-image fw-b \ 
                               --log-file /tmp/next_boot_fw_image.log
Firmware next-boot-image update is in progress for device 9081267b-4046-504c-3234-333930303033
------------------------------------------------------------
Device Id Status
------------------------------------------------------------
9081267b-4046-504c-3234-333930303033 Successful

The resulting log file looks similar to the following:

9081267b-4046-504c-3234-333930303033:- ===> Verifying target startup image fw-b
9081267b-4046-504c-3234-333930303033:- Verify startup image in progress...
9081267b-4046-504c-3234-333930303033:- Verify startup image in progress...
9081267b-4046-504c-3234-333930303033:- ===> New startup version 1.99.0-42-1130-g34ae0890edc-dirty vs. running unknown
9081267b-4046-504c-3234-333930303033:- OK
9081267b-4046-504c-3234-333930303033:- ===> Setting startup firmware to fw-b
9081267b-4046-504c-3234-333930303033:- Boot option fw-b programmed successfully
9081267b-4046-504c-3234-333930303033:- OK

See also

nicctl update firmware