线上带ofed驱动的实例更换内核方案

更新时间：2025-05-13

概述

线上一些BCC/EBC镜像装有ofed驱动，用户创建带rdma网络功能的套餐的实例后即可直接使用rdma功能。但是ofed是在当前os内核版本下编译的，如果用户改变内核版本后，可能会无法识别具有rdma功能的网卡。这种情况下，就需要重新编译、安装ofed驱动。

本文档提供在不同os的实例上更换内核版本后重新安装ofed的方案。

操作步骤

CentOS 7

以升级内核到kernel-3.10.0-1160.90.1.el7.x86_64为例。

1. 安装内核、内核开发包。在实例中安装kernel-3.10.0-1160.90.1.el7.x86_64版本内核及相关内核开发包：

                Shell
                
                yum install -y kernel-3.10.0-1160.90.1.el7.x86_64 \
                kernel-devel-3.10.0-1160.90.1.el7.x86_64 \
                kernel-headers-3.10.0-1160.90.1.el7.x86_64 \
                kernel-tools-3.10.0-1160.90.1.el7.x86_64

2. 检查rdma无损配置包。需要检查实例里是否安装有rdma无损配置包rdma-userspace-config，如有，需要删除该包，等安装好ofed后再重新安装。执行命令如下：

                Shell
                
                # 检查是否安装了rdma-userspace-config
rpm -qa |grep -i rdma-userspace-config

如果检查该无损配置包已经安装，则执行命令进行删除：

Plain Text

1# rpm -e rdma-userspace-config

3. 下载ofed安装包。可以在百度软件源上下载，或者在ofed官网下载后传到实例内：

百度软件源下载，以下载5.8-2.0.3版本ofed为例，在实例内执行下面命令下载；

Shell

1wget http://mirrors.baidubce.com/mlnx-ofed/5.8-2.0.3.0/MLNX_OFED_LINUX-5.8-2.0.3.0-rhel7.9-x86_64.tgz

官网下载，在ofed官网下载对应版本的ofed安装包

4. 编译安装ofed

执行以下脚本，编译、安装ofed驱动。
整个编译、安装过程要半个小时左右。

注：将脚本和ofed安装包放到同一目录下，脚本中ofed版本和内核版本改为实际使用版本。

                Shell
                
            

                #!/usr/bin/env bash
# Update mlnx ofed drivers
# -- Prepare mlnx ofed drivers
# -- Extract and install

mlnx_ofed_version=5.8-2.0.3.0
mlnx_ofed_drv=MLNX_OFED_LINUX-${mlnx_ofed_version}-rhel7.9-x86_64.tgz
kern_ver=3.10.0-1160.90.1.el7.x86_64

if [ ! -d /lib/modules/${kern_ver}/build ]; then
    echo "There is no kernel build directory. Please check if kernel-devel is installed ..."
    exit 1
fi
if ! which gcc >& /dev/null; then
    yum install -y gcc
fi
if ! which make >& /dev/null; then
    yum install -y make
fi

# Install Build Requirement
yum install -y elfutils-libelf-devel createrepo python-devel redhat-rpm-config rpm-build libtool
# Install runtime requirement for all OFED components installation
yum install -y tcl gcc-gfortran fuse-libs tk libnl3-devel

# Install updated mlnx_ofed packages including kernel modules and userspace packages
mkdir update_drivers
tar xf ${mlnx_ofed_drv} --strip-components 2 -C update_drivers/
cd update_drivers
./mlnxofedinstall --without-fw-update  --add-kernel-support -k ${kern_ver} --skip-distro-check \
    --package-install-options "--force" --distro rhel7.9 -q
if [ $? -ne 0 ]; then
    echo "MLNX OFED driver install ... Failed."
    exit 1
fi
cd ..

# 82-net-setup-link.rules cause the name of NIC changed. Then disable this rule.
if [ -f /usr/lib/udev/rules.d/82-net-setup-link.rules ]; then
    mv /usr/lib/udev/rules.d/82-net-setup-link.rules /usr/lib/udev/rules.d/82-net-setup-link.rules.orig
fi

if [ -f /usr/lib/udev/rules.d/83-mlnx-sf-name.rules ]; then
    mv /usr/lib/udev/rules.d/83-mlnx-sf-name.rules /usr/lib/udev/rules.d/83-mlnx-sf-name.rules.orig
fi

# Disable rshim(tmfifo_net0)
systemctl disable rshim.service

rm -rf ${mlnx_ofed_drv} update_drivers
rm -rf /tmp/MLNX* /tmp/*.conf

# update initramfs
dracut -f /boot/initramfs-${kern_ver}.img ${kern_ver}
            

如果第二步卸载了rdma-userspace-config，重新安装回来

                Shell
                
                wget -q http://mirrors.baidubce.com/baidu/rdma_specs/rdma-userspace-config-bbc-v1.0.3-1.el7.centos.x86_64.rpm
rpm -ivh rdma-userspace-config-bbc-v1.0.3-1.el7.centos.x86_64.rpm
service rdma start

重启实例，进入新内核；
检查安装。

                Shell
                
            

                #检查已安装5.8-2.0.3版本并在当前内核下编译出的ofed
[root@localhost ~]# rpm -qa | grep mlnx | grep 3.10.0_1160
mlnx-ofa_kernel-modules-5.8-OFED.5.8.2.0.3.1.kver.3.10.0_1160.90.1.el7.x86_64.x86_64
mlnx-ofa_kernel-devel-5.8-OFED.5.8.2.0.3.1.kver.3.10.0_1160.90.1.el7.x86_64.x86_64
knem-modules-1.1.4.90mlnx1-OFED.5.8.0.4.7.1.kver.3.10.0_1160.90.1.el7.x86_64.x86_64
[root@localhost ~]# modinfo mlx5_core
filename:       /lib/modules/3.10.0-1160.90.1.el7.x86_64/extra/mlnx-ofa_kernel/drivers/net/ethernet/mellanox/mlx5/core/mlx5_core.ko
alias:          auxiliary:mlx5_core.eth-rep
alias:          auxiliary:mlx5_core.eth
basedon:        Korg 5.17-rc4
version:        5.8-2.0.3
license:        Dual BSD/GPL
description:    Mellanox 5th generation network adapters (ConnectX series) core driver
author:         Eli Cohen <eli@mellanox.com>
retpoline:      Y
rhelversion:    7.9
srcversion:     6A14E2ECBAE645B024A60B6
...
#检查网卡
[root@localhost ~]# ifconfig
#检查网卡驱动
[root@localhost ~]# ethtool -i ethX

#检查软件包依赖，如果缺少依赖包，或者软件包重复，或者其他问题，需要手动解决，安装缺失的依赖包，删除重复的软件包等；  
[root@localhost ~]# yum check dependencies
            

CentOS 8

以升级内核到kernel-4.18.0-348.7.1.el8_5.x86_64为例。

1. 安装内核、内核开发包。在实例中安装kernel-4.18.0-348.7.1.el8_5.x86_64版本内核及相关内核开发包：

                Shell
                
                yum install -y kernel-4.18.0-348.7.1.el8_5.x86_64 \
                kernel-devel-4.18.0-348.7.1.el8_5.x86_64 \
                kernel-headers-4.18.0-348.7.1.el8_5.x86_64 \
                kernel-tools-4.18.0-348.7.1.el8_5.x86_64

2. 检查rdma无损配置包。有些实例里安装有rdma无损配置包rdma-userspace-config。需要删除该包，等安装好ofed后重新安装：

                Shell
                
                # 检查是否安装了rdma-userspace-config
rpm -qa |grep -i rdma-userspace-config

如果检查该无损配置包已经安装，则执行命令进行删除：

Plain Text

1如果存在就卸载该包
2# rpm -e rdma-userspace-config

3. 下载ofed安装包。可以在百度软件源上下载，或者在ofed官网下载后传到实例内：

百度软件源下载，以下载5.8-2.0.3版本ofed为例，在实例内执行下面命令下载：

Shell

1wget http://mirrors.baidubce.com/mlnx-ofed/5.8-2.0.3.0/MLNX_OFED_LINUX-5.8-2.0.3.0-rhel8.4-x86_64.tgz

官网下载，在ofed官网下载对应版本的ofed安装包

4. 编译安装ofed

执行以下脚本，编译、安装ofed驱动。整个编译、安装过程要半个小时左右。

注意，将脚本和ofed安装包放到同一目录下，脚本中ofed版本和内核版本改为实际使用版本。

                Shell
                
            

                #!/usr/bin/env bash
# Update mlnx ofed drivers
# -- Prepare mlnx ofed drivers
# -- Extract and install

mlnx_ofed_version=5.8-2.0.3.0
mlnx_ofed_drv=MLNX_OFED_LINUX-${mlnx_ofed_version}-rhel8.4-x86_64.tgz
kern_ver=4.18.0-348.7.1.el8_5.x86_64

if [ ! -d /lib/modules/${kern_ver}/build ]; then
    echo "There is no kernel build directory. Please check if kernel-devel is installed ..."
    exit 1
fi
if ! which gcc >& /dev/null; then
    yum install -y gcc
fi
if ! which make >& /dev/null; then
    yum install -y make
fi

# Install Build Requirement
yum install -y createrepo python36-devel libtool python36 kernel-rpm-macros gdb-headless rpm-build elfutils-libelf-devel
# Install runtime requirement for all OFED components installation
yum install -y tk gcc-gfortran tcsh tcl libnl3-devel perl-Math-Complex cmake-filesystem

# Install updated mlnx_ofed packages including kernel modules and userspace packages
mkdir update_drivers
tar xf ${mlnx_ofed_drv} --strip-components 2 -C update_drivers/
cd update_drivers
./mlnxofedinstall --without-fw-update  --add-kernel-support -k ${kern_ver} --skip-distro-check \
    --package-install-options "--force" --distro rhel8.4 -q
if [ $? -ne 0 ]; then
    echo "MLNX OFED driver install ... Failed."
    exit 1
fi
cd ..

# 82-net-setup-link.rules cause the name of NIC changed. Then disable this rule.
if [ -f /usr/lib/udev/rules.d/82-net-setup-link.rules ]; then
    mv /usr/lib/udev/rules.d/82-net-setup-link.rules /usr/lib/udev/rules.d/82-net-setup-link.rules.orig
fi

if [ -f /usr/lib/udev/rules.d/83-mlnx-sf-name.rules ]; then
    mv /usr/lib/udev/rules.d/83-mlnx-sf-name.rules /usr/lib/udev/rules.d/83-mlnx-sf-name.rules.orig
fi

# Disable rshim(tmfifo_net0)
systemctl disable rshim.service

rm -rf ${mlnx_ofed_drv} update_drivers
rm -rf /tmp/MLNX* /tmp/*.conf

# update initramfs
dracut -f /boot/initramfs-${kern_ver}.img ${kern_ver}
            

如果第二步卸载了rdma-userspace-config，重新安装回来

                Shell
                
                wget -q http://mirrors.baidubce.com/baidu/rdma_specs/rdma-userspace-config-bbc-v1.0.3-1.el7.centos.x86_64.rpm
rpm -ivh --nodeps --force rdma-userspace-config-bbc-v1.0.3-1.el7.centos.x86_64.rpm
service rdma start

重启实例，进入新内核；
检查安装。

                Shell
                
            

                #检查已安装5.8-2.0.3版本并在当前内核下编译出的ofed
[root@localhost ~]# rpm -qa | grep mlnx | grep 4.18.0_348
mlnx-ofa_kernel-devel-5.8-OFED.5.8.2.0.3.1.kver.4.18.0_348.7.1.el8_5.x86_64.x86_64
knem-modules-1.1.4.90mlnx1-OFED.5.8.0.4.7.1.kver.4.18.0_348.7.1.el8_5.x86_64.x86_64
mlnx-ofa_kernel-modules-5.8-OFED.5.8.2.0.3.1.kver.4.18.0_348.7.1.el8_5.x86_64.x86_64
[root@localhost ~]# modinfo mlx5_core
filename:       /lib/modules/4.18.0-348.7.1.el8_5.x86_64/extra/mlnx-ofa_kernel/drivers/net/ethernet/mellanox/mlx5/core/mlx5_core.ko
alias:          auxiliary:mlx5_core.eth-rep
alias:          auxiliary:mlx5_core.eth
basedon:        Korg 5.17-rc4
version:        5.8-2.0.3
license:        Dual BSD/GPL
description:    Mellanox 5th generation network adapters (ConnectX series) core driver
author:         Eli Cohen <eli@mellanox.com>
rhelversion:    8.5
srcversion:     AED21A09CA345D254692F69
...
#检查网卡
[root@localhost ~]# ifconfig
#检查网卡驱动
[root@localhost ~]# ethtool -i ethX
#检查软件包依赖，如果缺少依赖包，或者软件包重复，或者其他问题，需要手动解决，安装缺失的依赖包，删除重复的软件包等； 
[root@localhost ~]# yum check
            

Rocky Linux 8

以升级内核到kernel-4.18.0-477.13.1.el8_8.x86_64为例。

1. 安装内核、内核开发包。在实例中安装kernel-4.18.0-477.13.1.el8_8.x86_64版本内核及相关内核开发包：

                Shell
                
                yum install -y kernel-4.18.0-477.13.1.el8_8.x86_64 \
                kernel-devel-4.18.0-477.13.1.el8_8.x86_64 \
                kernel-headers-4.18.0-477.13.1.el8_8.x86_64 \
                kernel-tools-4.18.0-477.13.1.el8_8.x86_64

2. 检查rdma无损配置包。有些实例里安装有rdma无损配置包rdma-userspace-config。需要删除该包，等安装好ofed后重新安装：

                Shell
                
                # 检查是否安装了rdma-userspace-config
rpm -qa |grep -i rdma-userspace-config

如果检查该无损配置包已经安装，则执行命令进行删除：

Plain Text

1如果存在就卸载该包
2# rpm -e rdma-userspace-config

3. 下载ofed安装包。可以在百度软件源上下载，或者在ofed官网下载后传到实例内：

百度软件源下载，以下载5.8-2.0.3版本ofed为例，在实例内执行下面命令下载

Shell

1wget http://mirrors.baidubce.com/mlnx-ofed/5.8-2.0.3.0/MLNX_OFED_LINUX-5.8-2.0.3.0-rhel8.7-x86_64.tgz

官网下载，在ofed官网下载对应版本的ofed安装包

4. 编译安装ofed

执行以下脚本，编译、安装ofed驱动。

注意，将脚本和ofed安装包放到同一目录下，脚本中ofed版本和内核版本改为实际使用版本。

整个编译、安装过程要半个小时左右。

                Shell
                
            

                #!/usr/bin/env bash
# Update mlnx ofed drivers
# -- Prepare mlnx ofed drivers
# -- Extract and install

mlnx_ofed_version=5.8-2.0.3.0
mlnx_ofed_drv=MLNX_OFED_LINUX-${mlnx_ofed_version}-rhel8.7-x86_64.tgz
kern_ver=4.18.0-477.13.1.el8_8.x86_64

if [ ! -d /lib/modules/${kern_ver}/build ]; then
    echo "There is no kernel build directory. Please check if kernel-devel is installed ..."
    exit 1
fi
if ! which gcc >& /dev/null; then
    yum install -y gcc
fi
if ! which make >& /dev/null; then
    yum install -y make
fi

# Install Build Requirement
yum install -y createrepo python36-devel libtool python36 kernel-rpm-macros gdb-headless rpm-build elfutils-libelf-devel 
# Install runtime requirement for all OFED components installation
yum install -y tk gcc-gfortran tcsh tcl libnl3-devel perl-Math-Complex cmake-filesystem

# Install updated mlnx_ofed packages including kernel modules and userspace packages
mkdir update_drivers
tar xf ${mlnx_ofed_drv} --strip-components 2 -C update_drivers/
cd update_drivers
./mlnxofedinstall --without-fw-update  --add-kernel-support -k ${kern_ver} --skip-distro-check \
    --package-install-options "--force" --distro rhel8.7 -q
if [ $? -ne 0 ]; then
    echo "MLNX OFED driver install ... Failed."
    exit 1
fi
cd ..

# 82-net-setup-link.rules cause the name of NIC changed. Then disable this rule.
if [ -f /usr/lib/udev/rules.d/82-net-setup-link.rules ]; then
    mv /usr/lib/udev/rules.d/82-net-setup-link.rules /usr/lib/udev/rules.d/82-net-setup-link.rules.orig
fi

if [ -f /usr/lib/udev/rules.d/83-mlnx-sf-name.rules ]; then
    mv /usr/lib/udev/rules.d/83-mlnx-sf-name.rules /usr/lib/udev/rules.d/83-mlnx-sf-name.rules.orig
fi

# Disable rshim(tmfifo_net0)
systemctl disable rshim.service

rm -rf ${mlnx_ofed_drv} update_drivers
rm -rf /tmp/MLNX* /tmp/*.conf

# update initramfs
dracut -f /boot/initramfs-${kern_ver}.img ${kern_ver}
            

如果第二步卸载了rdma-userspace-config，重新安装回来

                Shell
                
                wget -q http://mirrors.baidubce.com/baidu/rdma_specs/rdma-userspace-config-bbc-v1.0.3-1.el7.centos.x86_64.rpm
rpm -ivh --nodeps --force rdma-userspace-config-bbc-v1.0.3-1.el7.centos.x86_64.rpm
service rdma start

重启实例，进入新内核；
检查安装。

                Shell
                
            

                #检查已安装5.8-2.0.3版本并在当前内核下编译出的ofed
[root@localhost ~]# rpm -qa | grep mlnx | grep 4.18.0_477
mlnx-ofa_kernel-modules-5.8-OFED.5.8.2.0.3.1.kver.4.18.0_477.13.1.el8_8.x86_64.x86_64
mlnx-ofa_kernel-devel-5.8-OFED.5.8.2.0.3.1.kver.4.18.0_477.13.1.el8_8.x86_64.x86_64
knem-modules-1.1.4.90mlnx1-OFED.5.8.0.4.7.1.kver.4.18.0_477.13.1.el8_8.x86_64.x86_64
[root@localhost ~]# modinfo mlx5_core
filename:       /lib/modules/4.18.0-477.13.1.el8_8.x86_64/extra/mlnx-ofa_kernel/drivers/net/ethernet/mellanox/mlx5/core/mlx5_core.ko
alias:          auxiliary:mlx5_core.eth-rep
alias:          auxiliary:mlx5_core.eth
basedon:        Korg 5.17-rc4
version:        5.8-2.0.3
license:        Dual BSD/GPL
description:    Mellanox 5th generation network adapters (ConnectX series) core driver
author:         Eli Cohen <eli@mellanox.com>
rhelversion:    8.8
srcversion:     AED21A09CA345D254692F69
...
#检查网卡
[root@localhost ~]# ifconfig
#检查网卡驱动
[root@localhost ~]# ethtool -i ethX
#检查软件包依赖，如果缺少依赖包，或者软件包重复，或者其他问题，需要手动解决，安装缺失的依赖包，删除重复的软件包等；
[root@localhost ~]# yum check
            

Rocky Linux 9

以升级内核到kernel-5.14.0-284.11.1.el9_2.x86_64为例。

1. 安装内核、内核开发包。在实例中安装kernel-5.14.0-284.11.1.el9_2.x86_64版本内核及相关内核开发包：

                Shell
                
                yum install -y kernel-5.14.0-284.11.1.el9_2.x86_64 \
                kernel-devel-5.14.0-284.11.1.el9_2.x86_64 \
                kernel-headers-5.14.0-284.11.1.el9_2.x86_64 \
                kernel-tools-5.14.0-284.11.1.el9_2.x86_64

2. 检查rdma无损配置包。有些实例里安装有rdma无损配置包rdma-userspace-config。需要删除该包，等安装好ofed后重新安装：

                Shell
                
                # 检查是否安装了rdma-userspace-config
rpm -qa |grep -i rdma-userspace-config

如果检查该无损配置包已经安装，则执行命令进行删除：

Plain Text

1如果存在就卸载该包
2# rpm -e rdma-userspace-config

3. 下载ofed安装包。可以在百度软件源上下载，或者在ofed官网下载后传到实例内：

百度软件源下载，以下载5.8-2.0.3版本ofed为例，在实例内执行下面命令下载

Shell

1wget http://mirrors.baidubce.com/mlnx-ofed/5.8-2.0.3.0/MLNX_OFED_LINUX-5.8-2.0.3.0-rhel9.1-x86_64.tgz

官网下载，在ofed官网下载对应版本的ofed安装包

4. 编译安装ofed

执行以下脚本，编译、安装ofed驱动。

注意，将脚本和ofed安装包放到同一目录下，脚本中ofed版本和内核版本改为实际使用版本。

整个编译、安装过程要半个小时左右。

                Shell
                
            

                #!/usr/bin/env bash
# Update mlnx ofed drivers
# -- Prepare mlnx ofed drivers
# -- Extract and install

mlnx_ofed_version=5.8-2.0.3.0
mlnx_ofed_drv=MLNX_OFED_LINUX-${mlnx_ofed_version}-rhel9.1-x86_64.tgz
kern_ver=5.14.0-284.11.1.el9_2.x86_64

if [ ! -d /lib/modules/${kern_ver}/build ]; then
    echo "There is no kernel build directory. Please check if kernel-devel is installed ..."
    exit 1
fi
if ! which gcc >& /dev/null; then
    yum install -y gcc
fi
if ! which make >& /dev/null; then
    yum install -y make
fi

# Install Build Requirement
yum install -y perl createrepo python3-devel libtool kernel-rpm-macros gdb-headless rpm-build elfutils-libelf-devel 
# Install runtime requirement for all OFED components installation
yum install -y tk gcc-gfortran tcsh tcl libnl3-devel cmake-filesystem 

# Install updated mlnx_ofed packages including kernel modules and userspace packages
mkdir update_drivers
tar xf ${mlnx_ofed_drv} --strip-components 2 -C update_drivers/
cd update_drivers
./mlnxofedinstall --without-fw-update  --add-kernel-support -k ${kern_ver} --skip-distro-check \
    --package-install-options "--force" --distro rhel9.1 -q
if [ $? -ne 0 ]; then
    echo "MLNX OFED driver install ... Failed."
    exit 1
fi
cd ..

# 82-net-setup-link.rules cause the name of NIC changed. Then disable this rule.
if [ -f /usr/lib/udev/rules.d/82-net-setup-link.rules ]; then
    mv /usr/lib/udev/rules.d/82-net-setup-link.rules /usr/lib/udev/rules.d/82-net-setup-link.rules.orig
fi

if [ -f /usr/lib/udev/rules.d/83-mlnx-sf-name.rules ]; then
    mv /usr/lib/udev/rules.d/83-mlnx-sf-name.rules /usr/lib/udev/rules.d/83-mlnx-sf-name.rules.orig
fi

# Disable rshim(tmfifo_net0)
systemctl disable rshim.service

rm -rf ${mlnx_ofed_drv} update_drivers
rm -rf /tmp/MLNX* /tmp/*.conf

# update initramfs
dracut -f /boot/initramfs-${kern_ver}.img ${kern_ver}
            

如果第二步卸载了rdma-userspace-config，重新安装回来

                Shell
                
                wget -q http://mirrors.baidubce.com/baidu/rdma_specs/rdma-userspace-config-bbc-v1.0.3-1.el7.centos.x86_64.rpm
rpm -ivh --nodeps --force rdma-userspace-config-bbc-v1.0.3-1.el7.centos.x86_64.rpm
service rdma start

重启实例，进入新内核；
检查安装。

                Shell
                
            

                #检查已安装5.8-2.0.3版本并在当前内核下编译出的ofed
[root@localhost ~]# rpm -qa | grep mlnx | grep 5.14.0_284
mlnx-ofa_kernel-modules-5.8-OFED.5.8.2.0.3.1.kver.5.14.0_284.11.1.el9_2.x86_64.x86_64
mlnx-ofa_kernel-devel-5.8-OFED.5.8.2.0.3.1.kver.5.14.0_284.11.1.el9_2.x86_64.x86_64
knem-modules-1.1.4.90mlnx1-OFED.5.8.0.4.7.1.kver.5.14.0_284.11.1.el9_2.x86_64.x86_64 
[root@localhost ~]# modinfo mlx5_core
filename:       /lib/modules/5.14.0-284.11.1.el9_2.x86_64/extra/mlnx-ofa_kernel/drivers/net/ethernet/mellanox/mlx5/core/mlx5_core.ko
alias:          auxiliary:mlx5_core.eth-rep
alias:          auxiliary:mlx5_core.eth
basedon:        Korg 5.17-rc4
version:        5.8-2.0.3
license:        Dual BSD/GPL
description:    Mellanox 5th generation network adapters (ConnectX series) core driver
author:         Eli Cohen <eli@mellanox.com>
rhelversion:    9.2
srcversion:     E4CF39F4680CAB323741675 
...
#检查网卡
[root@localhost ~]# ifconfig
#检查网卡驱动
[root@localhost ~]# ethtool -i ethX
#检查软件包依赖，如果缺少依赖包，或者软件包重复，或者其他问题，需要手动解决，安装缺失的依赖包，删除重复的软件包等；
[root@localhost ~]# yum check
            

Ubuntu 20.04

以升级内核到5.4.0-152-generic为例。

1. 安装内核、内核开发包。在实例中安装5.4.0-152-generic版本内核及其它相关组件：

                Shell
                
            

                apt-get install -y linux-image-5.4.0-152-generic \
                   linux-headers-5.4.0-152 \
                   linux-headers-5.4.0-152-generic \
                   linux-modules-5.4.0-152-generic \
                   linux-modules-extra-5.4.0-152-generic
            

2. 检查rdma无损配置包。有些实例里安装有rdma无损配置包rdma-userspace-config。需要删除该包，等安装好ofed后重新安装：

                Shell
                
                # 检查是否安装了rdma-userspace-config
rpm -qa |grep -i rdma-userspace-config

如果检查该无损配置包已经安装，则执行命令进行删除：

Plain Text

1如果存在就卸载该包
2# rpm -e rdma-userspace-config

3. 下载ofed安装包。可以在百度软件源上下载，或者在ofed官网下载后传到实例内：

百度软件源下载，以下载5.8-2.0.3版本ofed为例，在实例内执行下面命令下载

Shell

1wget http://mirrors.baidubce.com/mlnx-ofed/5.8-2.0.3.0/MLNX_OFED_LINUX-5.8-2.0.3.0-ubuntu20.04-x86_64.tgz

官网下载，在ofed官网下载对应版本的ofed安装包

4. 编译安装ofed

执行以下脚本，编译、安装ofed驱动。整个编译、安装过程要半个小时左右。

注意，将脚本和ofed安装包放到同一目录下，脚本中ofed版本和内核版本改为实际使用版本。

                Shell
                
            

                #!/usr/bin/env bash
# Update mlnx ofed drivers
# -- Prepare mlnx ofed drivers
# -- Extract and install

mlnx_ofed_version=5.8-2.0.3.0
mlnx_ofed_drv=MLNX_OFED_LINUX-${mlnx_ofed_version}-ubuntu20.04-x86_64.tgz
kern_ver=5.4.0-152-generic

if [ ! -d /lib/modules/${kern_ver}/build ]; then
    echo "There is no kernel build directory. Please check if kernel-devel is installed ..."
    exit 1
fi

apt-get update
if ! which gcc >& /dev/null; then
    apt-get -y install gcc
fi
if ! which make >& /dev/null; then
    apt-get -y install make
fi

# Install updated mlnx_ofed packages including kernel modules and userspace packages
mkdir update_drivers
tar xf ${mlnx_ofed_drv} --strip-components 2 -C update_drivers/
pushd update_drivers
./mlnxofedinstall --without-fw-update  --add-kernel-support -k ${kern_ver} --skip-distro-check -q
if [ $? -ne 0 ]; then
    ECHO_ERROR "MLNX OFED driver install ... Failed."
    exit 1
fi
popd

# 82-net-setup-link.rules cause the name of NIC changed. Then disable this rule.
if [ -f /lib/udev/rules.d/82-net-setup-link.rules ]; then
    mv /lib/udev/rules.d/82-net-setup-link.rules /lib/udev/rules.d/82-net-setup-link.rules.orig
fi

if [ -f /usr/lib/udev/rules.d/83-mlnx-sf-name.rules ]; then
    mv /usr/lib/udev/rules.d/83-mlnx-sf-name.rules /usr/lib/udev/rules.d/83-mlnx-sf-name.rules.orig
fi

# Disable rshim(tmfifo_net0)
systemctl disable rshim.service

rm -rf ${mlnx_ofed_drv} update_drivers
rm -rf /tmp/MLNX* /tmp/*.conf

# update initramfs
dracut  -f /boot/initrd.img-${kern_ver} ${kern_ver}
            

如果第二步卸载了rdma-userspace-config，重新安装回来

Shell

1wget -q http://mirrors.baidubce.com/baidu/rdma_specs/rdma-userspace-config-bbc_1.0.4_x86.deb
2dpkg -i rdma-userspace-config-bbc_1.0.4_x86.deb
3service rdma start

重启实例，进入新内核；
检查安装。

                Shell
                
            

                #检查已安装5.8-2.0.3版本并在当前内核下编译出的ofed
[root@localhost ~]# dpkg -l | grep mlnx | grep 5.4.0-152
ii  knem-modules                          1.1.4.90mlnx1-OFED.5.8.0.4.7.1.kver.5.4.0-152-generic amd64        kernel module for high-performance intra-node MPI communication for large messages
ii  mlnx-ofed-kernel-modules              5.8-OFED.5.8.2.0.3.1.kver.5.4.0-152-generic           amd64        mlnx-ofed kernel modules
ii  mlnx-ofed-kernel-utils                5.8-OFED.5.8.2.0.3.1.kver.5.4.0-152-generic           amd64        Userspace tools to restart and tune mlnx-ofed kernel modules  
[root@localhost ~]# modinfo mlx5_core
filename:       /lib/modules/5.4.0-152-generic/updates/dkms/mlx5_core.ko
alias:          auxiliary:mlx5_core.eth-rep
alias:          auxiliary:mlx5_core.eth
basedon:        Korg 5.17-rc4
version:        5.8-2.0.3
license:        Dual BSD/GPL
description:    Mellanox 5th generation network adapters (ConnectX series) core driver
author:         Eli Cohen <eli@mellanox.com>
srcversion:     E9B015CBD3F471BDD31CB24
...
#检查网卡
[root@localhost ~]# ifconfig
#检查网卡驱动
[root@localhost ~]# ethtool -i ethX
#检查软件包依赖，如果缺少依赖包，或者软件包重复，或者其他问题，需要手动解决，安装缺失的依赖包，删除重复的软件包等； 
[root@localhost ~]# apt-get check
            

Ubuntu 22.04

以升级内核到5.15.0-75-generic为例。

1. 安装内核、内核开发包。在实例中安装5.15.0-75-generic版本内核及其它相关组件：

                Shell
                
            

                apt-get install -y linux-image-5.15.0-75-generic \
                   linux-headers-5.15.0-75 \
                   linux-headers-5.15.0-75-generic \
                   linux-modules-5.15.0-75-generic \
                   linux-modules-extra-5.15.0-75-generic
            

有些实例里安装有rdma无损配置包rdma-userspace-config。需要删除该包，等安装好ofed后重新安装：

                Shell
                
                #检查是否安装了rdma-userspace-config
dpkg -l |grep -i rdma-userspace-config
如果存在就卸载该包
dpkg -r rdma-userspace-config

3. 下载ofed安装包。可以在百度软件源上下载，或者在ofed官网下载后传到实例内：

百度软件源下载，以下载5.8-2.0.3版本ofed为例，在实例内执行下面命令下载

Shell

1wget http://mirrors.baidubce.com/mlnx-ofed/5.8-2.0.3.0/MLNX_OFED_LINUX-5.8-2.0.3.0-ubuntu22.04-x86_64.tgz

官网下载，在ofed官网下载对应版本的ofed安装包

4. 编译安装ofed

执行以下脚本，编译、安装ofed驱动。整个编译、安装过程要半个小时左右。

注意，将脚本和ofed安装包放到同一目录下，脚本中ofed版本和内核版本改为实际使用版本。

                Shell
                
            

                #!/usr/bin/env bash
# Update mlnx ofed drivers
# -- Prepare mlnx ofed drivers
# -- Extract and install

mlnx_ofed_version=5.8-2.0.3.0
mlnx_ofed_drv=MLNX_OFED_LINUX-${mlnx_ofed_version}-ubuntu22.04-x86_64.tgz
kern_ver=5.15.0-75-generic

if [ ! -d /lib/modules/${kern_ver}/build ]; then
    echo "There is no kernel build directory. Please check if kernel-devel is installed ..."
    exit 1
fi

apt-get update
if ! which gcc >& /dev/null; then
    apt-get -y install gcc
fi
if ! which make >& /dev/null; then
    apt-get -y install make
fi

# Install required packages for installing MLNX_OFED_LINUX
apt-get install -y libnl-route-3-200 libnl-route-3-dev libnl-3-dev bison libfuse2 flex gfortran tk libnuma-dev libgfortran5

# Install updated mlnx_ofed packages including kernel modules and userspace packages
mkdir update_drivers
tar xf ${mlnx_ofed_drv} --strip-components 2 -C update_drivers/
pushd update_drivers
./mlnxofedinstall --without-fw-update  --add-kernel-support -k ${kern_ver} --skip-distro-check -q
if [ $? -ne 0 ]; then
    ECHO_ERROR "MLNX OFED driver install ... Failed."
    exit 1
fi
popd

# 82-net-setup-link.rules cause the name of NIC changed. Then disable this rule.
if [ -f /lib/udev/rules.d/82-net-setup-link.rules ]; then
    mv /lib/udev/rules.d/82-net-setup-link.rules /lib/udev/rules.d/82-net-setup-link.rules.orig
fi

if [ -f /usr/lib/udev/rules.d/83-mlnx-sf-name.rules ]; then
    mv /usr/lib/udev/rules.d/83-mlnx-sf-name.rules /usr/lib/udev/rules.d/83-mlnx-sf-name.rules.orig
fi

# Disable rshim(tmfifo_net0)
systemctl disable rshim.service

rm -rf ${mlnx_ofed_drv} update_drivers
rm -rf /tmp/MLNX* /tmp/*.conf

# update initramfs
dracut  -f /boot/initrd.img-${kern_ver} ${kern_ver}
            

如果第二步卸载了rdma-userspace-config，重新安装回来

Shell

1wget -q http://mirrors.baidubce.com/baidu/rdma_specs/rdma-userspace-config-bbc_1.0.4_x86.deb
2dpkg -i rdma-userspace-config-bbc_1.0.4_x86.deb
3service rdma start

重启实例，进入新内核；
检查安装。

                Shell
                
            

                #检查已安装5.8-2.0.3版本并在当前内核下编译出的ofed
[root@localhost ~]# dpkg -l | grep mlnx | grep 5.15.0-75
ii  knem-modules                          1.1.4.90mlnx1-OFED.5.8.0.4.7.1.kver.5.15.0-75-generic amd64        kernel module for high-performance intra-node MPI communication for large messages
ii  mlnx-ofed-kernel-modules              5.8-OFED.5.8.2.0.3.1.kver.5.15.0-75-generic           amd64        mlnx-ofed kernel modules
ii  mlnx-ofed-kernel-utils                5.8-OFED.5.8.2.0.3.1.kver.5.15.0-75-generic           amd64        Userspace tools to restart and tune mlnx-ofed kernel modules
[root@localhost ~]# modinfo mlx5_core
filename:       /lib/modules/5.15.0-75-generic/updates/dkms/mlx5_core.ko
alias:          auxiliary:mlx5_core.eth-rep
alias:          auxiliary:mlx5_core.eth
basedon:        Korg 5.17-rc4
version:        5.8-2.0.3
license:        Dual BSD/GPL
description:    Mellanox 5th generation network adapters (ConnectX series) core driver
author:         Eli Cohen <eli@mellanox.com>
srcversion:     E4CF39F4680CAB323741675
...
#检查网卡
[root@localhost ~]# ifconfig
#检查网卡驱动
[root@localhost ~]# ethtool -i ethX
#检查软件包依赖，如果缺少依赖包，或者软件包重复，或者其他问题，需要手动解决，安装缺失的依赖包，删除重复的软件包等； 
[root@localhost ~]# apt-get check
            

Debian 9软件源配置

linux pip配置百度源

百度智能云

云服务器 BCC

云服务器 BCC

线上带ofed驱动的实例更换内核方案

概述

操作步骤

CentOS 7

CentOS 8

Rocky Linux 8

Rocky Linux 9

Ubuntu 20.04

Ubuntu 22.04