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:

• Host is not compatible with the image
• Downgrades of host VIBs icen(1.5.5.0-1OEM.670.0.0.8169922) in the image are not supported.

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. 

Resolution

Follow one of the following options as it best fits the environment.

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.