Day 2 Management Operations
After provisioning and deploying the BlueField for the first time, there are several activities required from time-to-time throughout the BlueField's lifecycle.
Before proceeding, review section "Management Methods" to learn about the recommended management methods for specific tasks on the BlueField device.
This upgrade procedure enables upgrading DOCA components using standard Linux tools (e.g., apt update and yum update). This process utilizes native package manager repositories to upgrade BlueField networking platforms (DPUs or SuperNICs) without the need for a full installation.
This process has the following benefits :
Only updates components that include modifications
Configurable – user can select specific components (e.g., UEFI-ATF, NIC-FW)
Includes upgrade of:
DOCA drivers and libraries
DOCA reference applications
BSP (UEFI/ATF) upgrade while maintaining the configuration
NIC firmware upgrade while maintaining the configuration
Does not:
Impact user binaries
Upgrade non-Ubuntu OS kernels
Upgrade BlueField BMC firmware
After completion of BlueField upgrade:
If NIC firmware was not updated, perform BlueField Arm reset (software reset/reboot BlueField )
If NIC firmware was updated, perform firmware reset (mlxfwreset) or perform a graceful shutdown and power cycle
OS |
Action |
Instructions |
Ubuntu/ Debian |
Remove mlxbf-bootimages package |
|
Install the the GPG key |
|
|
Export the desired distribution |
Export DOCA_REPO with the relevant URL. The following is an example for Ubuntu 22.04:
|
|
Add GPG key to APT trusted keyring |
|
|
Add DOCA online repository |
|
|
Update index |
|
|
Upgrade UEFI/ATF firmware |
Run:
Then i nitiate upgrade for UEFI/ATF firmware:
|
|
Upgrade BlueField NIC firmware |
Run:
Note
This immediately starts NIC firmware upgrade.
To prevent automatic upgrade, run:
|
|
Remove old metapackages |
|
|
Install new metapackages |
|
|
Upgrade system |
|
|
Apply the new changes, NIC firmware, and UEFI/ATF |
For the upgrade to take effect, perform BlueField system reboot as explained in the "NVIDIA BlueField Reset and Reboot Procedures" troubleshooting page. Note
This step triggers immediate reboot of the BlueField Arm cores.
|
|
CentOS/RHEL/ Anolis/Rocky |
Remove mlxbf-bootimages package |
|
Export the desired distribution |
Export DOCA_REPO with the relevant URL. The following is an example for Rocky Linux 8.6:
|
|
Add DOCA online repository |
A file is created under /etc/yum.repos.d/doca.repo . |
|
Update index |
|
|
Upgrade UEFI/ATF firmware |
Run:
Then i nitiate the upgrade for UEFI/ATF firmware:
|
|
Upgrade BlueField NIC firmware |
The following command updates the firmware package and automatically attempts to flash the firmware to the NIC:
Info
This step can be used as a standalone firmware update. In any case, it is performed as part of the upgrade flow.
Note
To prevent automatic flashing of the firmware to the NIC, run the following first:
Info
Flashing the firmware to the NIC can be performed manually by running the following command, after the firmware package had been updated:
|
|
Remove old metapackages |
|
|
Install new metapackages |
|
|
Upgrade system |
|
|
Apply the new changes, NIC firmware, and UEFI/ATF |
For the upgrade to take effect, perform BlueField system reboot as explained in the "NVIDIA BlueField Reset and Reboot Procedures" troubleshooting page. Note
This step triggers immediate reboot of the BlueField Arm cores.
|
Users may want to reset the BlueField to factory defaults. To do that, it is necessary to reset to default the BlueField BMC, BlueField UEFI, NIC, and the Arm. Follow the steps in the subsections below for more.
Step 1 – Reset BlueField BMC to Factory Default
Run the following command:
curl -k -u root:'<password>' -H "Content-Type: application/json" -X POST https://<BF-BMC-IP>/redfish/v1/Managers/Bluefield_BMC/Actions/Manager.ResetToDefaults -d '{"ResetToDefaultsType": "ResetAll"}' { "@Message.ExtendedInfo": [ { "@odata.type": "#Message.v1_1_1.Message", "Message": "The request completed successfully.", "MessageArgs": [], "MessageId": "Base.1.15.0.Success", "MessageSeverity": "OK", "Resolution": "None" } ] }
Reboot the BMC for the factory reset to take effect:
> curl -k -u root:'<password>' -H "Content-Type: application/json" -X POST -d '{"ResetType": "GracefulRestart"}' https://<BF-BMC-IP>/redfish/v1/Managers/Bluefield_BMC/Actions/Manager.Reset { "@Message.ExtendedInfo": [ { "@odata.type": "#Message.v1_1_1.Message", "Message": "The request completed successfully.", "MessageArgs": [], "MessageId": "Base.1.13.0.Success", "MessageSeverity": "OK", "Resolution": "None" } ]
Step 2 – Wipe BlueField eMMC and SSD Storage
Users may wipe their eMMC and NVMe storage using the following Redfish commands:
eMMC:
curl -k -u root:<password> -X PATCH -H "Content-Type: application/json" https://<bmc_ip>/redfish/v1/Systems/Bluefield/Bios/Settings -d '{"Attributes":{"EmmcWipe": true}}'
NVMe:
curl -k -u root:<password> -X PATCH -H "Content-Type: application/json" https://<bmc_ip>/redfish/v1/Systems/Bluefield/Bios/Settings -d '{"Attributes":{"NvmeWipe": true}}'
Step 3 – Reset UEFI to Factory Default
Use the Redfish BIOS Settings PATCH command:
curl -k -u root:'<password>' -X PATCH -d '{"Attributes":{"ResetEfiVars": true}}' https://<BF-BMC-IP>/redfish/v1/Systems/<SystemID>/Bios/Settings | python3 -m json.tool
Step 4 – Reset NIC TLVs to Factory Default
Run the following from the Arm console:
bf> mlxconfig -d <device> -y reset