NSX Host Preparation Fails with "Failed to install software on Host. Operation timed out"

Products

• VMware NSX

Issue/Introduction

When attempting to prepare an ESXi host for VMware NSX within a host cluster, the installation does not complete successfully.

• The Host Node status in the NSX Manager UI displays as Install Failed.
• The detailed error message associated with the failure reads: Failed to install software on host, Operation Timed out.



Environment

VMware NSX 

Cause

This issue typically occurs when the NSX Manager or vCenter Server is unable to successfully push and install the required VIBs (vSphere Installation Bundles) to the ESXi host within the allotted timeframe. This timeout can be triggered by:

• Stale, corrupted, or partially installed NSX VIBs from a previous failed installation attempt.
• The ESXi host's esxupdate service becoming unresponsive or hanging during the deployment process.
• Transient network connectivity interruptions between the NSX Manager and the ESXi host during the installation sequence.

Resolution

To resolve this issue, you must clear out the corrupted or hung installation state by removing the host from the cluster, forcing a complete removal of the NSX software, and then returning the host to the cluster to trigger a clean installation.

• Remove Host from the Cluster:  In the vSphere Client, place the affected ESXi host into Maintenance Mode.
• Drag and drop the affected host out of the NSX-prepared cluster. This action will automatically initiate a standard uninstall of NSX from the host.
• Locate the Host in the Standalone Tab: Log into the NSX Manager UI and navigate to System > Fabric > Nodes > Host Transport Nodes.
• You should see the affected host listed here. The status should be displayed as Not Configured
  
  • Note: If the Host still shows as configured, Force Remove NSX: Select the standalone host and click Remove NSX.
• Choose the Force Delete or Force Remove option. This ensures that any residual, corrupted, or stuck VIBs and configurations are completely stripped from the ESXi host. Wait for the uninstallation to complete successfully.
• Drag and drop the host back into the original NSX-prepared cluster.
  
  • Note: Because the cluster is configured for NSX, adding the host back will automatically trigger the NSX installation process.
• Verify Installation: Return to the NSX Manager UI (System > Fabric > Nodes > Host Transport Nodes).
• Monitor the installation process for the newly added host. The host status should now successfully transition to Up and the NSX Configuration should show as Success.
• Exit Maintenance Mode on the ESXi host in vSphere.