在Hyperflex集群上应用非自定义ESXI映像补丁

简介

本文档介绍通过命令行界面(CLI)或通过HX连接，使用非自定义HX映像为Hyperflex ESXI节点打补丁的过程。

先决条件

要求

Cisco 建议您了解以下主题：

• Hyperflex
• ESXI

使用的组件

本文档中的信息基于以下软件和硬件版本：

• HyperFlex Connect 5.0.2d
• Hyperflex标准集群
• vCenter 8.0
• VMware ESXI，7.0.3内部版 — 23794027
• VMware ESXI 7.0.3内部版本 — 24585291（目标补丁）

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

背景信息

思科并不总是为每个新的VMware ESXI补丁版本提供单独的HyperFlex捆绑包。对于关键ESXI更新，可以通过本文介绍的任何方法手动应用这些更新。但是，HyperFlex不建议使用VMware Update Manager(VUM)或VMware Lifecycle Manager(vLCM)升级ESXI，因为它可能会导致某些HyperFlex vSphere安装捆绑包(VIB)出现问题。

非自定义修补程序只能应用于相同的ESXI版本。如果您使用的是ESXI 7.0 u3，则只能应用7.0u3+补丁，并且不能从7.0u3升级到8.0u2或8.0u3，也不能使用非自定义映像从8.0u2x升级到8.0u3x。

在应用任何修补程序之前，请确保当前的HyperFlex数据平台(HXDP)版本与计划安装的ESXi版本兼容。兼容性图表如下：

如果您的HXDP版本较旧，请先升级HXDP，然后升级ESXI。

配置

从Broadcom网站下载ESXI zip文件

在开始练习之前，请确保群集处于联机状态且运行正常。

验证集群的ESXi节点上Hyperflex、nenic和nfnic vib的初始版本。

esxcli软件vib列表 | egrep -i 'scvmclient|STFSNasPlugin|stHypervisorSvc|nenic|nfnic'

通过CLI升级

步骤1.从HX Connect导航到System Information > Nodes，选择一个主机，然后单击Enter HX Maintenance Mode。

在主机进入维护模式后，继续下一步。

步骤2.将zip文件传输到主机。

您可以通过vCenter将其上传到已装载的数据存储。
导航到所需的Datastore并选择Files，然后选择UPLOAD FILES并上传zip文件。在下面的映像上，使用名为Upgrade的Datastore。

您还可以将ESXI升级捆绑包远程安全复制到一个适当的文件夹，该文件夹具有足够的SCP空间。

scp local_filename user@ESXIserver:/path/where/file/should/go

步骤3.以维护模式通过SSH连接到ESXI主机，并导航到复制ESXI升级捆绑包的datastore文件夹。在此场景中，该文件在Upgrade datastore上可用。

[root@Monterrey-server-1:~]cd /vmfs/volumes/Upgrade

您可以使用命令vmware -v验证当前版本

[root@Monterrey-server-1:~] vmware -v
VMware ESXi 7.0.3 build-23794027

运行以下命令以查看软件包配置文件的详细信息：esxcli软件源配置文件列表 — d /complete/path/VMware-ESXi...zip

[root@Monterrey-server-1:/vmfs/volumes/2f27e295-70f773c4] esxcli software sources profile list -d /vmfs/volumes/Upgrade/VMware-ESXi-7.0U3s-24585291-depot.zip
Name                           Vendor        Acceptance Level  Creation Time        Modification Time
-----------------------------  ------------  ----------------  -------------------  -----------------
ESXi-7.0U3s-24585291-standard  VMware, Inc.  PartnerSupported  2025-03-04T00:00:00  2025-03-04T00:00:00
ESXi-7.0U3s-24585291-no-tools  VMware, Inc.  PartnerSupported  2025-03-04T00:00:00  2025-02-21T03:24:14

步骤4.运行此命令以安装修补程序：esxcli软件配置文件更新 — d /complete/path/VMware-ESXi...zip -p PackageProfileName，并等待它显示成功的结果。

root@Monterrey-server-1:/vmfs/volumes/2f27e295-70f773c4] esxcli software profile update -d /vmfs/volumes/Upgrade/VMware-ESXi-7.0U3s-24585291-depot.zip -p ESXi-7.0U3s-24585291-standard
Update Result
   Message: The update completed successfully, but the system needs to be rebooted for the changes to be effective.
   Reboot Required: true
   VIBs Installed: VMware_bootbank_bmcal_7.0.3-0.135.24585291, VMware_bootbank_cpu-microcode_7.0.3-0.135.24585291, VMware_bootbank_crx_7.0.3-0.135.24585291, VMware_bootbank_esx-base_7.0.3-0.135.24585291, VMware_bootbank_esx-dvfilter-generic-fastpath_7.0.3-0.135.24585291, VMware_bootbank_esx-update_7.0.3-0.135.24585291, VMware_bootbank_esx-xserver_7.0.3-0.135.24585291, VMware_bootbank_esxio-combiner_7.0.3-0.135.24585291, VMware_bootbank_gc_7.0.3-0.135.24585291, VMware_bootbank_loadesx_7.0.3-0.135.24585291, VMware_bootbank_native-misc-drivers_7.0.3-0.135.24585291, VMware_bootbank_trx_7.0.3-0.135.24585291, VMware_bootbank_vdfs_7.0.3-0.135.24585291, VMware_bootbank_vsan_7.0.3-0.135.24585291, VMware_bootbank_vsanhealth_7.0.3-0.135.24585291
   VIBs Removed: VMware_bootbank_bmcal_7.0.3-0.125.23794027, VMware_bootbank_cpu-microcode_7.0.3-0.125.23794027, VMware_bootbank_crx_7.0.3-0.125.23794027, VMware_bootbank_esx-base_7.0.3-0.125.23794027, VMware_bootbank_esx-dvfilter-generic-fastpath_7.0.3-0.125.23794027, VMware_bootbank_esx-update_7.0.3-0.125.23794027, VMware_bootbank_esx-xserver_7.0.3-0.125.23794027, VMware_bootbank_esxio-combiner_7.0.3-0.125.23794027, VMware_bootbank_gc_7.0.3-0.125.23794027, VMware_bootbank_loadesx_7.0.3-0.125.23794027, VMware_bootbank_native-misc-drivers_7.0.3-0.125.23794027, VMware_bootbank_trx_7.0.3-0.125.23794027, VMware_bootbank_vdfs_7.0.3-0.125.23794027, VMware_bootbank_vsan_7.0.3-0.125.23794027, VMware_bootbank_vsanhealth_7.0.3-0.125.23794027
   VIBs Skipped: VMW_bootbank_atlantic_1.0.3.0-8vmw.703.0.20.19193900, VMW_bootbank_bnxtnet_216.0.50.0-44vmw.703.0.50.20036589, VMW_bootbank_bnxtroce_216.0.58.0-23vmw.703.0.50.20036589, VMW_bootbank_brcmfcoe_12.0.1500.2-3vmw.703.0.20.19193900, VMW_bootbank_elxiscsi_12.0.1200.0-9vmw.703.0.20.19193900, VMW_bootbank_elxnet_12.0.1250.0-5vmw.703.0.20.19193900, VMW_bootbank_i40en_1.11.1.32-1vmw.703.0.125.23794027, VMW_bootbank_iavmd_2.7.0.1157-3vmw.703.0.105.22348816, VMW_bootbank_icen_1.4.1.20-1vmw.703.0.50.20036589, VMW_bootbank_igbn_1.4.11.2-1vmw.703.0.20.19193900, VMW_bootbank_ionic-en_16.0.0-16vmw.703.0.20.19193900, VMW_bootbank_irdman_1.3.1.22-1vmw.703.0.50.20036589, VMW_bootbank_iser_1.1.0.1-1vmw.703.0.50.20036589, VMW_bootbank_ixgben_1.7.1.35-1vmw.703.0.20.19193900, VMW_bootbank_lpfc_14.0.169.26-5vmw.703.0.50.20036589, VMW_bootbank_lpnic_11.4.62.0-1vmw.703.0.20.19193900, VMW_bootbank_lsi-mr3_7.718.02.00-1vmw.703.0.20.19193900, VMW_bootbank_lsi-msgpt2_20.00.06.00-4vmw.703.0.20.19193900, VMW_bootbank_lsi-msgpt35_19.00.02.00-1vmw.703.0.20.19193900, VMW_bootbank_lsi-msgpt3_17.00.12.00-2vmw.703.0.105.22348816, VMW_bootbank_mtip32xx-native_3.9.8-1vmw.703.0.20.19193900, VMW_bootbank_ne1000_0.9.0-1vmw.703.0.50.20036589, VMW_bootbank_nenic_1.0.33.0-1vmw.703.0.20.19193900, VMW_bootbank_nfnic_4.0.0.70-1vmw.703.0.20.19193900, VMW_bootbank_nhpsa_70.0051.0.100-4vmw.703.0.20.19193900, VMW_bootbank_nmlx4-core_3.19.16.8-2vmw.703.0.20.19193900, VMW_bootbank_nmlx4-en_3.19.16.8-2vmw.703.0.20.19193900, VMW_bootbank_nmlx4-rdma_3.19.16.8-2vmw.703.0.20.19193900, VMW_bootbank_nmlx5-core_4.19.16.11-1vmw.703.0.20.19193900, VMW_bootbank_nmlx5-rdma_4.19.16.11-1vmw.703.0.20.19193900, VMW_bootbank_ntg3_4.1.9.0-5vmw.703.0.90.21686933, VMW_bootbank_nvme-pcie_1.2.3.16-3vmw.703.0.105.22348816, VMW_bootbank_nvmerdma_1.0.3.5-1vmw.703.0.20.19193900, VMW_bootbank_nvmetcp_1.0.0.3-1vmw.703.0.125.23794027, VMW_bootbank_nvmxnet3-ens_2.0.0.22-1vmw.703.0.20.19193900, VMW_bootbank_nvmxnet3_2.0.0.30-1vmw.703.0.20.19193900, VMW_bootbank_pvscsi_0.1-4vmw.703.0.20.19193900, VMW_bootbank_qcnic_1.0.15.0-14vmw.703.0.20.19193900, VMW_bootbank_qedentv_3.40.5.53-22vmw.703.0.20.19193900, VMW_bootbank_qedrntv_3.40.5.53-18vmw.703.0.20.19193900, VMW_bootbank_qfle3_1.0.67.0-22vmw.703.0.20.19193900, VMW_bootbank_qfle3f_1.0.51.0-22vmw.703.0.20.19193900, VMW_bootbank_qfle3i_1.0.15.0-15vmw.703.0.20.19193900, VMW_bootbank_qflge_1.1.0.11-1vmw.703.0.20.19193900, VMW_bootbank_rste_2.0.2.0088-7vmw.703.0.20.19193900, VMW_bootbank_sfvmk_2.4.0.2010-6vmw.703.0.20.19193900, VMW_bootbank_smartpqi_70.4149.0.5000-1vmw.703.0.20.19193900, VMW_bootbank_vmkata_0.1-1vmw.703.0.20.19193900, VMW_bootbank_vmkfcoe_1.0.0.2-1vmw.703.0.20.19193900, VMW_bootbank_vmkusb_0.1-8vmw.703.0.85.21424296, VMW_bootbank_vmw-ahci_2.0.11-3vmw.703.0.125.23794027, VMware_bootbank_elx-esx-libelxima.so_12.0.1200.0-4vmw.703.0.20.19193900, VMware_bootbank_esx-ui_2.13.2-22721163, VMware_bootbank_lsuv2-hpv2-hpsa-plugin_1.0.0-3vmw.703.0.20.19193900, VMware_bootbank_lsuv2-intelv2-nvme-vmd-plugin_2.7.2173-1vmw.703.0.20.19193900, VMware_bootbank_lsuv2-lsiv2-drivers-plugin_1.0.0-12vmw.703.0.50.20036589, VMware_bootbank_lsuv2-nvme-pcie-plugin_1.0.0-1vmw.703.0.20.19193900, VMware_bootbank_lsuv2-oem-dell-plugin_1.0.0-1vmw.703.0.20.19193900, VMware_bootbank_lsuv2-oem-hp-plugin_1.0.0-1vmw.703.0.20.19193900, VMware_bootbank_lsuv2-oem-lenovo-plugin_1.0.0-1vmw.703.0.20.19193900, VMware_bootbank_lsuv2-smartpqiv2-plugin_1.0.0-9vmw.703.0.105.22348816, VMware_bootbank_qlnativefc_4.1.14.0-26vmw.703.0.20.19193900, VMware_bootbank_vmware-esx-esxcli-nvme-plugin_1.2.0.44-1vmw.703.0.20.19193900, VMware_locker_tools-light_12.3.5.22544099-23794019

步骤5.升级完成后，重新启动ESXi主机。 

步骤6.使用SSH连接到主机并使用命令验证版本：vmware -v

[root@Monterrey-server-1:~] vmware -v
VMware ESXi 7.0.3 build-24585291

步骤7.从维护模式中退出节点，然后等待群集恢复正常。

打开HX-Connect，选择System Information> Nodes，选择处于维护模式的节点，然后单击Exit HX Maintenance Mode

为Hyperflex集群完成修复留出几分钟的时间。HX Connect Dashboard显示Operational Status，它必须是Online，且Resiliency Health必须显示Healthy。
此外，还要从VCenter中，确保服务器可以看到所有datastore。 

在属于集群的所有节点上重复这些步骤，一次一个步骤。

通过HX Connect UI升级

导航到Upgrade选项卡，选择ESXI升级类型并上传ESXI升级文件。

注意：如果您的集群在HX版本5.5或6.0上，则需要通过选择HX Data Platform并上传当前版本的HX捆绑包来执行组合升级

上传文件后，输入vCenter Credentials，然后单击Upgrade。

第一步是验证升级如果启用分布式资源调度程序(DRS)，虚拟机将自动移动至其他主机。 

单击Skip Validations并自动启动升级。

监控升级过程。

注意：如果禁用DRS，请手动移动VM以继续升级过程。

等到群集的所有节点上完成升级。

验证

您可以从System Information（系统信息）选项卡上的HX Connect（HX连接）验证ESXI安装版本。

在vCenter中，您可以在服务器的Summary中看到ESXI版本。

由于ESXI映像是非自定义的，您需要确认Hyperflex VIB在服务器上仍显示完好。

在补丁完成之后，在开始下一个节点之前，通过SSH连接到每个ESXI主机，并使用命令验证Hyperflex VIB:esxcli软件vib列表 | egrep -i 'scvmclient|STFSNasPlugin|stHypervisorSvc'

注意：在ESXi 7.0 U3版本中，vmware-esx-STFSNasPlugin更改为CIS-ESX-STFSNasPlugi
          在ESXi 8.0 U1版本中，stHypervisorSvc更改为sthypervisorsvc。

[root@Monterrey-server-1:~] esxcli software vib list | egrep -i 'scvmclient|STFSNasPlugin|stHypervisorSvc'
CIS-ESX-STFSNasPlugin          4.5.1-11                               CIS     VMwareAccepted    2023-10-25
scvmclient                     5.5.1-38                               CIS     VMwareAccepted    2023-11-25
stHypervisorSvc                4.5.1-11                               CIS     VMwareAccepted    2023-10-24

警告：在某些情况下，非自定义映像可以使用不同于自定义映像的版本覆盖nenic和nfnic VIB。您需要在补丁后验证我们是否拥有正确的版本。

在补丁完成之后，在开始下一个节点之前，通过SSH连接到每个ESXI主机，并使用命令验证Hyperflex VIB:esxcli软件vib列表 | egrep -i 'nenic|nfnic'

[root@Monterrey-server-3:~]  esxcli software vib list | egrep -i 'nenic|nfnic'
nfnic                          5.0.0.43-1OEM.700.1.0.15843807         CIS     VMwareCertified   2025-02-23
nenic-ens                      1.0.6.0-1OEM.700.1.0.15843807          Cisco   VMwareCertified   2023-10-25
nenic                          2.0.10.0-1OEM.700.1.0.15843807         Cisco   VMwareCertified   2024-03-17

故障排除

如果nenic或nfnic被其他版本覆盖，您可以通过从software.cisco.com下载相同版本的ESXI自定义压缩映像来安装正确的版本。解压缩映像a，从vib目录查找nenic和nfnic目录。提取vib文件并通过vCenter将其上传到服务器上安装的数据存储。确保群集处于联机状态且运行正常。

步骤1.从HX Connect导航到System Information > Nodes，选择一个主机，然后单击Enter HX Maintenance Mode。

在主机进入维护模式后，继续下一步。

以维护模式通过SSH连接到ESXI主机，然后导航到复制ESXI vib文件的datastore文件夹。在此场景中，该文件在Upgrade datastore上可用

[root@Monterrey-server-3:~] cd /vmfs/volumes/Upgrade

[root@Monterrey-server-3:/vmfs/volumes/2f27e295-70f773c4] ls
CIS_bootbank_nenic_2.0.10.0-1OEM.700.1.0.15843807.vib               

运行以下命令以升级vib:esxcli软件vib更新 — v "/complete/path/vib-file.vib" -f

[root@Monterrey-server-3:/vmfs/volumes/2f27e295-70f773c4] esxcli software vib update -v "/vmfs/volumes/Upgrade/CIS_bootbank_nenic_2.0.10.0-1OEM.700.1.0.15843807.vib" -f
Installation Result
   Message: The update completed successfully, but the system needs to be rebooted for the changes to be effective.
   Reboot Required: true
   VIBs Installed: CIS_bootbank_nenic_2.0.10.0-1OEM.700.1.0.15843807
   VIBs Removed: Cisco_bootbank_nenic_1.0.45.0-1OEM.700.1.0.15843807
   VIBs Skipped: 

vib更新完成后，重新启动ESXi主机。

使用SSH连接到主机，并使用命令esxcli software vib list验证vib是否已成功更新 | egrep -i 'nenic|nfnic'

从维护模式中退出节点，等待集群恢复正常。

打开HX-Connect，选择System Information> Nodes，选择处于维护模式的节点，然后单击Exit HX Maintenance Mode

如果服务器从SD卡启动，则应用补丁时可能会遇到已知问题。“Unable to Remediate Host due to Error while waiting untar process”当单个VIB的untar操作在补救过程中超时超过默认的30秒时，就会导致此问题。对于将SD卡用作OSData分区的环境，VMware工具非焦油过程可能需要稍长的持续时间。您可以参阅本文来解决它。