Error: "Failed to run health checks for NSX-T" and "install skipped" during vLCM Remediation and NSX Host Preparation

Products

• VMware NSX

Issue/Introduction

VMware vSphere Lifecycle Manager (vLCM) and VMware NSX. 

• When attempting to prepare hosts for NSX, the NSX UI displays an "install skipped" status. The detailed error message reports: "vLCM remediation was skipped or failed for some hosts." Concurrently, vLCM cluster remediation in the vSphere UI fails with the following errors: "Remediation of cluster failed" "Health Check for '<Cluster>' failed" "Failed to run health checks for NSX-T on '<Cluster>'."

• The VLCM user interface may indicate that hosts within the cluster are out of compliance and require remediation.

• NSX host preparation stalls at 15%, or the user interface displays "Install Skipped." Selecting the "Install Skipped" hyperlink reveals the following information:

Environment

VMware NSX-T Data Center VMware vSphere Lifecycle Manager (vLCM)

Cause

This issue is caused by a circular dependency between vLCM and NSX during cluster preparation. vLCM remediation is blocked by the NSX pre-check because NSX components are not yet installed on the host. Conversely, NSX host preparation fails because vLCM reports the cluster is out of compliance, halting the preparation workflow.

Resolution

• Log in to the vCenter Server Appliance (VCSA) via SSH as the root user.

• Stop the update manager service. Example: service-control --stop updatemgr

• Create a backup of the vLCM configuration file. Example: cp /usr/lib/vmware-updatemgr/bin/vci-integrity.xml /usr/lib/vmware-updatemgr/bin/vci-integrity.xml.bak

• Open /usr/lib/vmware-updatemgr/bin/vci-integrity.xml in a text editor. Example: vi /usr/lib/vmware-updatemgr/bin/vci-integrity.xml

• Locate the <nsxt_rest> section and change the <enabled> tag from true to false to bypass the pre-check.

• Example:

   <nsxt_rest>

       <enabled>false</enabled>   <<<<<<<<<<

   </nsxt_rest>

• Save the file and start the Update Manager service. Example: service-control --start updatemgr

• In the vSphere Client, initiate the vLCM cluster remediation process. Verify the hosts reach a compliant status.

• Once remediation completes successfully, revert the change in /usr/lib/vmware-updatemgr/bin/vci-integrity.xml (change <enabled> back to true) by following steps 1 through 5 again.

• Start the Update Manager service again: service-control --start updatemgr. Example: service-control --start updatemgr

• In the NSX UI, prepare the compliant hosts for NSX via the Transport Node Profile.

 

Additional Information

For related information, see KB 427686 (Host remediation failed due to NSX-T health checks).