What can I help you with?
NVIDIA BlueField Virtio-net v24.10

Live Update

Live update minimizes network interface downtime by performing online upgrade of the virtio-net controller without necessitating a full restart.

To perform a live update, the user must install a newer version of the controller either using the rpm or deb package (depending on the OS distro used). Run:

For Ubuntu/Debian

Copy
Copied!
            

[dpu]# dpkg --force-all -i virtio-net-controller-x.y.z-1.mlnx.aarch64.deb

For CentOS/RedHat

Copy
Copied!
            

[dpu]# rpm -Uvh virtio-net-controller-x.y.z-1.mlnx.aarch64.rpm --force

Before staring live update, the following command can be used to check the version of the original and destination controllers:

Copy
Copied!
            

[dpu]# virtnet version { "Original Controller": "v24.10.13" }, { "Destination Controller": "v24.10.16" }

If no errors occur, issue the following command to start the live update process:

Copy
Copied!
            

[dpu]# virtnet update -s

Note

If an error indicates that the update command is unsupported, this means the controller version you are attempting to install is outdated. Reinstalling the correct version resolves the issue.

During the update process, the following command may be used to check the update status:

Copy
Copied!
            

[dpu]# virtnet update -t

Example output:

Copy
Copied!
            

{ "status": "inactive", # updating status, whether live update is finished or ongoing "last live update status": "success", # last live update status "time_used (s)": 1.655439 # time cost for last live update }

Note

During the update, it is recommended to not issue any virtnet CLI command.

When the update process completes successfully, the command virtnet update status reflects the status accordingly

Note

If a device is actively migrating, the existing virtnet commands appear as "migrating" for that specific device so that the user can retry later.

Note

When live update is in progress, hotplug/unplug and VF creation/deletion are not supported.

© Copyright 2024, NVIDIA. Last updated on Nov 12, 2024.