Error: "Downgrades of host VIBs <name>(<version>) in the image are not supported" when attempting to update ESXi hosts with vLCM

Products

• VMware vSphere ESXi

Issue/Introduction

When attempting to update ESXi hosts with vLCM using the single image option, the following similar messages appear when reviewing Image Compliance:

• The "Check Compliance" status for the ESXi host returns "Incompatible" on vLCM.
• When attempting to remediate or check compliance of an ESXi host against a vSphere Lifecycle Manager (vLCM) cluster image, the process fails with a "red bang" error:

Downgrades of host VIBs <name>(<version>) in the image are not supported.

Add the components of matching or higher versions to the image.

Cause

• This message appears when the ESXi host is currently installed with a newer VIB version than what the image provides. As such, vLCM is unable to downgrade the current newer version on the ESXi host.
• The error is triggered because vSphere Lifecycle Manager (vLCM) is designed to move hosts toward a "Desired State." vLCM does not support automatic downgrades of "manually added" components (third-party drivers/VIBs) during a standard remediation if the version defined in the cluster image is older than what is currently running on the hardware.

Resolution

Select and implement one of the following options, as appropriate for your specific environment configuration.

Option 1

Use this option if the VIB is no longer in use.

1. SSH to the ESXi host.
2. List/search for the VIB.
   
   esxcli software vib list |grep -i <vib name>
   
   Example
   
   esxcli software vib list |grep -i icen
   
   
3. Check if the driver is in use.
   
   Network
   esxcli network nic list
   
   Storage
   esxcli storage core adapter list
   
   Reference: Determining Network/Storage firmware and driver version in ESXi.
   
   
4. If the VIB is not in use, remove the VIB.
   
   esxcli software vib remove -n <vib name>
   
   Example
   
   esxcli software vib remove -n icen
   
   Reference: Instructions for uninstalling third-party VIBs from an ESXi host.
   
   
5. Run the vLCM Image Compliance pre-check.

Option 2

Use this option if the VIB is still in use.

1. If needed, download the corresponding driver VIB whose version is equal to or higher than what is currently installed on the ESXi host.
   
   
2. Add the new VIB to the image, using components.
   1. Click on Cluster > Updates > Under Hosts > Image.
   2. Select Edit to edit the image.
   3. For components section, click Show details.
   4. Click Add Components.
   5. Under Show: Select appropriate component type ("All components", "Independent components", or "Independent components and Vendor Addon Components"), selecting All will show all available driver VIBs.
   6. Use filter option to search for the given driver name or type.
   7. Select the newer version to match the version shown in the downgrade error from the compliance check.
   8. Click "Select" to add the component to the image.
   9. Repeat Step 4 until all drivers/components have been added that are downgrades for the image.
      
      
3. If the driver is not in the list of components, upload the new VIB to the Image Depot and follow step 2.
   
   Reference:
   Newer versions of a vendor addon might be missing when configuring a Lifecycle Manager cluster image in vCenter Server 7.0/8.0.
   
   Working with Images.
   
   
4. Validate and Save the image for the cluster.
   
   
5. vLCM should automatically trigger a compliance check on the hosts in the cluster.