Host Becomes Non-Compliant after Upgrade with a Vendor Custom ISO in vSphere Lifecycle Manager (vLCM)
search cancel

Host Becomes Non-Compliant after Upgrade with a Vendor Custom ISO in vSphere Lifecycle Manager (vLCM)

book

Article ID: 402978

calendar_today

Updated On:

Products

VMware vCenter Server

Issue/Introduction

  • After upgrading an ESXi host using a new vendor-specific custom ISO (e.g., from Dell, HPE), administrators may find that the host is flagged as "non-compliant" by the vSphere Lifecycle Manager (vLCM). 
  • The issue can be verified by comparing the software components on the non-compliant Host with those on a known-good, compliant host using the command: 

esxcli software component list

Environment

VMware vCenter server

Cause

  • The root cause of this compliance mismatch is that the vLCM image for the cluster was not updated to include the new and updated OEM driver components that were installed by the latest vendor customized ISO. Hardware vendors regularly release ISOs that bundle specific, certified drivers for their servers.
  • If a component can not be found in the current vLCM depot, it may need to be manually imported from the vendor's zip file before it can be added to the image.

Resolution

The solution is to update the vLCM image to match the new "golden standard" established by the vendor's customized ISO. This is achieved by editing the image and manually adding the specific OEM components that are now installed on the upgraded host:

Steps:

  1. In the vSphere Client, navigate to the Lifecycle Manager.
  2. Go to the Image section for the relevant cluster.
  3. Click EDIT to modify the image.
  4. In the image editor, go to the Components section.
  5. Use the filter to find and select each of the required OEM drivers (e.g., Broadcom-bcm-mpi3, Broadcom NetXtreme-E, qlogic-fc-hba, etc.) with the exact versions that were installed by the new ISO. You may need to deselect older versions if they are present.
  6. Save the updated image.
  7. Run a compliance check again on the host(s); they should now report as compliant with the updated image.

This procedure aligns the vLCM's definition of "compliant" with the actual software installed by the certified vendor ISO. It effectively establishes a new, correct baseline for the cluster, ensuring that all hosts can be consistently managed against this updated standard.

Additional Information

Related KB:

vCenter cluster, and lifecycle manager shows hosts are unknown when checking compliance

Remediation of vLCM Image based cluster failed with error: compliance check reported host as 'non-compliant'. The image on the host does not match the image set for the cluster