Skip to main content

DPU Firmware Update

FW update on Hardware → NIC writes a firmware image to a MangoBoost DPU and resets the card to load it without rebooting the server.

Check the image and the target card

A wrong image can leave the card needing hardware recovery, which MAC does not provide. Use the image MangoBoost recommends for the card model and port configuration.

Before You Start​

  • You need the operator or admin role, and the node must be Online.
  • If FW update is disabled, hover over it for the reason.
  • Stop workloads that use the card; all its ports go down during the reset.
  • RHEL-family hosts need an RPM-capable SDK agent image.
  • If the dialog shows the card is managed by an Automatic Kubernetes RNIC NicFirmwareTemplate, update it from one place only.

Check the Deployed Firmware​

NIC page with two cards on different firmwareNIC page with two cards on different firmware

Each card shows its firmware version. Differs marks cards not on the most common version.

Update DPU Firmware​

Use a .pdi card image or a .tgz card OS bundle. Provide it in one of two ways:

  • URL: the node downloads the image over HTTP(S). Put any token in Bearer token, never in the URL; the Audit log records URLs but hides bearer tokens.
  • File upload: choose or drop the file when the node cannot reach a URL.

Firmware update dialog with a firmware URLFirmware update dialog with a firmware URL

Firmware update dialog with a selected upload fileFirmware update dialog with a selected upload file

Update One DPU Card​

  1. Open Hardware → NIC and select the node.
  2. Select FW update on the card.
  3. Provide the image and select Start update.
  4. Select the card's Updating… status to follow progress until Completed.

Running firmware update job with write progressRunning firmware update job with write progress

The update continues if you close the browser. If the job shows Failed with "Job no longer trackable" or "Status polling timed out", check the card's firmware version before retrying; the update may have finished.

Do not interrupt a running update

Keep MAC and the node running and powered until the update finishes. Interrupting a write can leave the card without a bootable image.

Update Multiple DPU Cards in Multiple Servers​

  1. On the NIC page, select Update all DPUs to update every card on the node.
  2. To include other nodes, select them under Also apply to all DPUs on.
  3. Provide the image and select Start on N nodes.
  4. Keep the page open until every node has started.

With One node at a time, a failure leaves the remaining nodes Not started. Stop remaining nodes skips nodes that have not started.

Firmware update for this node and two more, one node at a timeFirmware update for this node and two more, one node at a time

Finished multi-node firmware updateFinished multi-node firmware update

Check the Result​

  1. Wait a minute, then reload the NIC page.
  2. Confirm each card's Firmware shows the intended version.
  3. If the version is unchanged or the card's function changed (such as base NIC to RDMA), power-cycle the server. A warm reboot does not reload the image.
  4. Reapply runtime network settings such as IP address or MTU if your configuration does not, and verify links in Performance.

Troubleshooting​

MessageAction
Download or write failed: …Check the URL and Bearer token, or upload the file.
Error: the image is not a PDI, invalid image file size or Missing expected file in archiveGet the correct image file.
An error ending in ; reflash itVerification failed and the card was not reset. Update it again before any reset or power cycle.