Restrictions and guidelines
1.Before updating the software version, it is strongly recommended that you understand the changes in software features between versions, evaluate the possible impact of the changes on your business, and also check the relevant supporting information.
2.The following changes in DOCA 2.9.1 (BSP 4.9.1) and BMC 24.10-LTSU1 break backward compatibility and therefore require customers to upgrade all DOCA software components to the latest available version to avoid unexpected behavior:
BMC: IPMB Channel Relocation – BlueField BMC The IPMB channel used to retrieve data from the BlueField Arm now uses a dedicated I2C interface. This change is intended to improve the maintainability of the interface.
FlexIO: Fix for mandatory hardware limitations when it was discovered that newer firmware versions broke backward compatibility between software layers.
3.If the driver package is named doca-host_xxxxx.zip and the compressed package contains only one rpm/deb package (doca-host-xxxxx.rpm/deb), please follow the steps in Chapter doca-host_xxxxx.zip driver package for installation.
4.If the driver package is named doca-ofed-xxxxx.zip and the compressed package contains two rpm/deb packages (doca-host-xxxxx.rpm/deb, doca-kernel-repo-xxxxx.rpm/deb), please follow the steps in Chapter doca-ofed-xxxxx.zip driver package for installation.
5.If the driver package is named MLNX_OFED_LINUX-xxxxx.tgz, please follow the steps in Chapter MLNX_OFED_LINUX-xxxxx.tgz driver package for installation.
6.On openEuler 20.03 LTS, openEuler 20.03 LTS SP1 for x86_64, openEuler 20.03 LTS SP2 for x86_64, and openEuler 20.03 LTS SP4 systems, please use the command “./mlnxofedinstall --without-fw-update --force --distro openeuler20.03sp3” for driver installation.
7.On openEuler 22.03 LTS, openEuler 22.03 LTS SP2 for x86_64, and NingOS V3 1.0 systems, please use the command “./mlnxofedinstall --without-fw-update --force --distro openeuler22.03sp1” for driver installation.
8.On统信UOS服务器版V20 (1020e)、统信UOS服务器版V20 (1060e) systems, please use the command “./mlnxofedinstall --without-depcheck --skip-distro-check --distro uos20.1060 --without-fw-update --force --kernel-sources /lib/modules/$kernel/build/ --kernel $kernel” for driver installation; on Tongxin UOS Server Edition V20 (1050e) systems, please use the command “./mlnxofedinstall --without-fw-update --force --distro uos20.1060” for driver installation.
9. On凝思安全操作系统V6.0.99、红旗Asianux服务器操作系统V8.5、方德高可信服务器操作系统V4.0 systems, please use the command “./mlnxofedinstall --without-depcheck --skip-distro-check --distro rhel8.0 --without-fw-update --force --kernel-sources /lib/modules/$kernel/build/ --kernel $kernel” for driver installation.
10.On BigCloud Enterprise Linux 8.2 (x86_64) (Kernel: 4.19.0-240.23.11.el8_2.bclinux.x86_64) and BigCloud Enterprise Linux oe21.10 (x86_64) systems, please use the command “./mlnxofedinstall --without-depcheck --skip-distro-check --distro bclinux21.10sp2 --without-fw-update --force --kernel-sources /lib/modules/$kernel/build/ --kernel $kernel” for driver installation.
11.On 湖南麒麟安全服务器操作系统V3 system, please use the command “./mlnxofedinstall --without-depcheck --skip-distro-check --distro kylin10sp2 --without-fw-update --force --kernel-sources /lib/modules/$kernel/build/ --kernel $kernel” for driver installation.
12.On CULinux 4.0 system, please use the command “./mlnxofedinstall --without-fw-update --force --distro openeuler22.03sp3” for driver installation.
Installation steps
doca-host_xxxxx.zip driver package
1.If there is an older version of the DOCA driver, you need to uninstall the old DOCA-OFED version first by executing the following commands:
for f in $(rpm -qa | grep -i doca); do yum -y remove $f; done
/usr/sbin/ofed_uninstall.sh --force
yum autoremove
( Different Linux distributions have different software package management commands. Please use apt-get for Ubuntu, zypper for SLES, and yum for RedHat. Select the command based on the different systems, and the subsequent steps will use yum as an example.)
2.Log in to the server system by using the administrator account and upload the DOCA driver package file.zip to the system.
3.Decompress the driver package by executing the following command: unzip file.zip.
(Note: The common commands for decompressing a compressed package are as follows:
tar -xvf file.tar
tar -zxvf file.tgz
tar -jxvf file.bz2
unrar e file.rar
unzip file.zip)
4.Execute the command chmod -R 777 * to grant execute permission for decompressed files.
5.To install the rpm package, execute the command: rpm -ivh doca-xxx.rpm. To update the rpm package, execute the command: rpm -Uvh doca-xxx.rpm.
6.Execute the command sudo dnf clean all to clear the DNF cache.
7.Execute the command dnf install doca-ofed to install or update the driver.
Note：During the installation process, the installer will automatically check if the necessary tools for the current operating system environment are present. If any packages are missing, a prompt will appear in the command line. Please follow the instructions provided.
(If there is a prompt mentioning the --allowerasing keyword, you can use dnf install doca-ofed --allowerasing to install)
8.After the driver update is completed, restart the system and execute the ethtool -i ethx command to check the network card driver version again to ensure that the new driver still takes effect after the system restarts.
doca-ofed-xxxxx.zip driver package
1.If there is an older version of the DOCA driver, you need to uninstall the old DOCA-OFED version first by executing the following commands:
for f in $(rpm -qa | grep -i doca); do yum -y remove $f; done
/usr/sbin/ofed_uninstall.sh --force
yum autoremove
(Different Linux distributions have different software package management commands. Please use apt-get for Ubuntu, zypper for SLES, and yum for RedHat. Select the command based on the different systems, and the subsequent steps will use yum as an example.)
2.Log in to the server system by using the administrator account and upload the DOCA driver package file.zip to the system.
3.Decompress the driver package by executing the following command: unzip file.zip.
(Note: The common commands for decompressing a compressed package are as follows:
tar -xvf file.tar
tar -zxvf file.tgz
tar -jxvf file.bz2
unrar e file.rar
unzip file.zip)
4.Execute the command chmod -R 777 * to grant execute permission for decompressed files.
5.To install the rpm package, execute the command: rpm -ivh doca-xxx.rpm. To update the rpm package, execute the command: rpm -Uvh doca-xxx.rpm.
6.Execute the command sudo dnf clean all to clear the DNF cache.
7.Execute the command rpm -ivh doca-kernel-repo-xxx.rpm to install the doca-kernel package.
8.Execute dnf install doca-ofed to install or update the driver.
Note:During the installation process, the installer will automatically check if the necessary tools for the current operating system environment are present. If any packages are missing, a prompt will appear in the command line. Please follow the instructions provided.
(If there is a prompt mentioning the --allowerasing keyword, you can use dnf install doca-ofed --allowerasing to install)
9.After the driver update is completed, restart the system and execute the ethtool -i ethx command to check the network card driver version again to ensure that the new driver still takes effect after the system restarts.
MLNX_OFED_LINUX-xxxxx.tgz driver package
1.Log in to the server system by using the administrator account and upload the driver package file.tar.gz to the system.
2.Decompress the driver source code package by executing the following command: tar -zxvf file.tar.gz.
(Note: The common commands for decompressing a compressed package are as follows:
tar -xvf file.tar
tar -zxvf file.tgz
tar -jxvf file.bz2
unrar e file.rar
unzip file.zip)
3.Execute the command chmod -R 777 * to grant execute permission for decompressed files.
4.Execute the command ./mlnxofedinstall --without-fw-update --force to upgrade driver.
The following prompts may appear when the driver is installed
This may be caused by a system kernel version upgrade. Please add the --add-kernel-support parameter to compile and install the driver based on the current kernel version.
5.During the installation process, the installer will automatically check whether the required tools for the current operating system environment are present. If any missing packages are detected, a command prompt will be displayed, and you will be prompted to follow the instructions.
6.After the driver update is complete, restart the system, and run the command "ethtool -i ethx" again to check the network card driver version to ensure that the new driver is still in effect after the system restart.
Login