BF-Bundle 安装和升级

用户有三个选项可在 BlueField DPU 或 SuperNIC 上安装或升级 DOCA

在 BlueField 上安装 BF-bundle 之前，请务必更新 主机端 上的 DOCA。

用户可以通过升级 BlueField 上的完整 DOCA 镜像，在 BlueField DPU 或 SuperNIC 上安装 DOCA。

选项 1 – 无预定义密码

要安装 BFB，请使用以下命令

            

            
host# sudo bfb-install --rshim rshim<N> --bfb <image_path.bfb>
        

其中

• <N> – 适当的 RShim 设备标识符。如果您只有一个 BlueField 设备，请使用 rshim0。

• <image_path.bfb> – 将其替换为 BFB 镜像文件的路径。

要列出系统上存在的 RShim 设备，请运行以下命令

            

            
host# ls -la /dev/ | grep rshim
        

选项 2 – 设置预定义密码

Ubuntu 用户可以在 bf.cfg 配置文件中为 ubuntu 用户设置唯一密码，该密码将在 BlueField BFB 捆绑包安装结束时自动应用。

为此，请按照以下步骤操作

1. 生成哈希密码

   复制

   已复制！

               
   
               
   host# openssl passwd -1
   Password:
   Verifying - Password:
   $1$3B0RIrfX$TlHry93NFUJzg3Nya00rE1
           

2. 将密码哈希添加到 bf.cfg 配置文件

   复制

   已复制！

               
   
               
   host# echo ubuntu_PASSWORD='$1$3B0RIrfX$TlHry93NFUJzg3Nya00rE1' > bf.cfg
           

3. 运行安装命令时，使用 --config 标志指定配置文件

   复制

   已复制！

               
   
               
   host# sudo bfb-install --rshim rshim<N> --bfb <image_path.bfb> --config bf.cfg
           

   注意

   如果未使用 --config，则首次登录 BlueField 设备后，将提示用户更新默认 ubuntu 密码。

   注意

   （可选）要使用 BFB 捆绑包升级 BlueField 集成 BMC 固件，请在 bf.cfg 文件中提供当前的 BMC root 凭据，如下所示

   复制

   已复制！

               
   
               
   BMC_PASSWORD="<root password>"
   BMC_USER="root"
   BMC_REBOOT="yes"
           

   除非之前已更改，否则默认 BMC root 密码为 0penBmc。

   以下是 Ubuntu-22.04 BFB 捆绑包安装的示例输出（版本在将来可能会有所不同）

   折叠源

   复制

   已复制！

               
   
               
   host# sudo bfb-install --rshim rshim0 --bfb bf-bundle-2.7.0_24.04_ubuntu-22.04_prod.bfb --config bf.cfg
   Pushing bfb 1.41GiB 0:02:02 [11.7MiB/s] [           <=>                                                                                                                                ]
   Collecting BlueField booting status. Press Ctrl+C to stop
    INFO[PSC]: PSC BL1 START
    INFO[BL2]: start
    INFO[BL2]: boot mode (rshim)
    INFO[BL2]: VDDQ: 1120 mV
    INFO[BL2]: DDR POST passed
    INFO[BL2]: UEFI loaded
    INFO[BL31]: start
    INFO[BL31]: lifecycle GA Secured
    INFO[BL31]: VDD: 850 mV
    INFO[BL31]: runtime
    INFO[BL31]: MB ping success
    INFO[UEFI]: eMMC init
    INFO[UEFI]: eMMC probed
    INFO[UEFI]: UPVS valid
    INFO[UEFI]: PMI: updates started
    INFO[UEFI]: PMI: total updates: 1
    INFO[UEFI]: PMI: updates completed, status 0
    INFO[UEFI]: PCIe enum start
    INFO[UEFI]: PCIe enum end
    INFO[UEFI]: UEFI Secure Boot 
    INFO[UEFI]: PK configured
    INFO[UEFI]: Redfish enabled
    INFO[UEFI]: exit Boot Service
    INFO[MISC]: Found bf.cfg
    INFO[MISC]: Ubuntu installation started
    INFO[MISC]: Installing OS image
    INFO[MISC]: Changing the default password for user ubuntu
    INFO[MISC]: Ubuntu installation completed
    INFO[MISC]: Updating NIC firmware...
    INFO[MISC]: NIC firmware update done
    INFO[MISC]: Installation finished 
           

4. 要验证 BlueField 设备是否已完成启动，请在安装过程完成后等待 90 秒，然后运行以下命令

   复制

   已复制！

               
   
               
   host# sudo cat /dev/rshim<N>/misc
   ...
    INFO[MISC]: Linux up
    INFO[MISC]: DPU is ready  
           

5. 检索已安装的软件包及其版本作为 BF-Bundle 安装的一部分

   1. 登录到 BlueField。

   2. 运行以下命令

      复制

      已复制！

                  
      
                  
      bf# sudo bf-info
              

      示例输出

      复制

      已复制！

                  
      
                  
      Versions:
      - ATF: v2.2(release):4.9.0-16-g221717c68
      - UEFI: 4.9.0-37-gcbeaab0650
      - BSP: 4.9.0.13322
      - NIC Firmware: 32.43.0356
      - DOCA Base (OFED): 24.10-0.5.1.0
      ...
      Storage:
      - mlnx-libsnap 1.6.0-1
      - spdk 23.01.5-24
      - virtio-net-controller 24.10.15-1
      DOCA:
      - doca-apsh-config 2.9.0064-1
      - libdoca-sdk-urom-dev 2.9.0064-1
      ...
      FlexIO:
      - flexio-samples 24.10.2447
      - flexio-sdk 24.10.2447
      ...
      SoC Platform:
      - mlxbf-gige-modules 1.0-0.kver.6.1.0-11-arm64
      - sdhci-of-dwcmshc-modules 1.0-0.kver.6.1.0-11-arm64
      ...
      OFED:
      rdma-core 2410mlnx54-1.2410051
      ucx 1.18.0-1.2410051
      ...
              

6. 要通过 IPv4 配置 tmfifo_net0 接口以 SSH 访问 BlueField Arm OS

   复制

   已复制！

               
   
               
   host# ifconfig tmfifo_net0 192.168.100.1/24
           

   信息

   使用 192.168.100.2（预配置的默认值）SSH 进入 BlueField Arm OS

   复制

   已复制！

               
   
               
   host# ssh ubuntu@192.168.100.2
           

此过程允许使用标准 Linux 工具（例如，apt update 和 yum update）在 BlueField 网络平台（DPU 或 SuperNIC）上升级 DOCA 组件。它利用本机软件包管理器存储库来更新组件，而无需完全重新安装。

此过程具有以下优点

• 仅更新包含修改的组件

• 包括以下升级

  • DOCA 驱动程序和库

  • DOCA 参考应用程序

  • BSP (UEFI/ATF) 升级，同时保持配置

  • NIC 固件升级，同时保持配置

  • BMC 组件升级

• 不执行以下操作

  • 影响用户二进制文件

  • 升级非 Ubuntu OS 内核

• BlueField 升级完成后

  • 如果 NIC 固件未更新，请执行 BlueField Arm 重置（软件重置/重启 BlueField）

  • 如果 NIC 固件已更新，请执行固件重置 (mlxfwreset) 或执行正常关机和电源循环

            

            
<bf> $ apt remove --purge mlxbf-bootimages* -y
        

            

            
<bf> $ apt update
<bf> $ apt install gnupg2
        

            

            
<bf> $ export DOCA_REPO="<URL>"
        

            

            
<bf> $ curl $DOCA_REPO/GPG-KEY-Mellanox.pub | gpg --dearmor > /etc/apt/trusted.gpg.d/GPG-KEY-Mellanox.pub
        

            

            
<bf> $ echo "deb [signed-by=/etc/apt/trusted.gpg.d/GPG-KEY-Mellanox.pub] $DOCA_REPO ./" > /etc/apt/sources.list.d/doca.list
        

            

            
<bf> $ apt update
        

            

            
<bf> $ apt install mlxbf-bootimages-signed mlxbf-scripts
        

            

            
<bf> $ bfrec
        

            

            
<bf> $ apt install mlnx-fw-updater-signed
        

            

            
<bf> $ sudo /opt/mellanox/mlnx-fw-updater/mlnx_fw_updater.pl --force-fw-update
        

            

            
<bf> $ cat > /etc/bf-upgrade.conf << EOF
BMC_PASSWORD="<password>"
EOF
        

            

            
<bf> $ cat >> /etc/bf-upgrade.conf << EOF
BMC_REBOOT="yes"
CEC_REBOOT="yes"
EOF
        

            

            
<bf> $ apt -y install bf3-bmc-nic-fw-* bf3-bmc-fw-signed bf3-cec-fw-signed bf3-bmc-gi-signed
<bf> $ apt -y install bf-release*
        

            

            
<bf> $ dpu-bmc-upgrade
        

            

            
<bf> $ apt-get remove doca* mlnx-ofed* kernel-mft* -y
        

            

            
<bf> $ apt-get install doca-runtime doca-devel -y
        

            

            
<bf> $ apt upgrade
        

            

            
<bf> $ yum -y remove mlxbf-bootimages* --noautoremove
<bf> $ yum makecache
        

            

            
<bf> $ export DOCA_REPO="<URL>"
        

            

            
echo "[doca] 
name=DOCA Online Repo 
baseurl=$DOCA_REPO 
enabled=1 
gpgcheck=0 
priority=10 
cost=10" > /etc/yum.repos.d/doca.repo
        

            

            
<bf> $ yum makecache
        

            

            
<bf> $ yum install -y mlxbf-bootimages-signed mlxbf-bfscripts
        

            

            
<bf> $ bfrec
        

            

            
<bf> $ yum install -y mlnx-fw-updater-signed
        

            

            
<bf> $ cat > /etc/bf-upgrade.conf << EOF
BMC_PASSWORD="<password>"
EOF
        

            

            
<bf> $ cat >> /etc/bf-upgrade.conf << EOF
BMC_REBOOT="yes"
CEC_REBOOT="yes"
EOF
        

            

            
<bf> $ yum -y install bf3-bmc-nic-fw-* bf3-bmc-fw-signed bf3-cec-fw-signed bf3-bmc-gi-signed
<bf> $ yum -y install bf-release*
        

            

            
<bf> $ dpu-bmc-upgrade
        

            

            
<bf> $ yum remove doca*  mlnx-ofed* kernel-mft* -y
        

            

            
<bf> $ yum remove strongswan-bf strongswan-swanctl
<bf> $ yum remove strongswan-bf strongswan-swanctl libreswan
        

            

            
<bf> $ yum -y install doca-runtime doca-devel
        

            

            
<bf> dnf install python3-dnf-plugin-versionlock
<bf> dnf versionlock kernel*
        

            

            
<bf> $ yum upgrade --nobest
        

            

            
<bf> $ sed -i 's/GRUB_ENABLE_BLSCFG=true/GRUB_ENABLE_BLSCFG=false/' /etc/default/grub; mv /boot/efi/EFI/anolis/grub.cfg.rpmsave /boot/efi/EFI/anolis/grub.cfg
        

希望构建自己的自定义 BlueField OS 镜像的用户可以使用 BFB 构建环境。有关更多详细信息，请参阅 此 GitHub 网页中的 bfb-build 项目。

要在启用 UEFI 安全启动的 BlueField（默认安全启动设置）上启动自定义 BlueField OS 镜像，必须满足以下条件

• OS 镜像必须使用 UEFI DB 中已存在的密钥（例如，Microsoft 密钥）进行签名

• 如果以上方法不可行，则必须禁用 UEFI 安全启动以允许启动未签名或不同签名的镜像

有关管理 UEFI 安全启动的详细说明，请参阅BlueField 平台 SW 文档中的“安全启动”页面。