NSX Upgrade Fails due to Stale Transport Node Entry

Products

• VMware NSX

Issue/Introduction

• The upgrade interface shows the host in a failed state with the message: "Pre-upgrade checks failed for host."
• Attempts to delete the associated upgrade group failed with the error: "Group contains upgrade units and cannot be deleted."
  
  

Environment

VMware NSX

Cause

A stale transport node entry of a decommissioned host remains in the NSX Manager database.
Even though the host was removed from the vCenter inventory and had no NSX VIBs installed, its record is still being referenced in the upgrade group, preventing upgrade completion.

Resolution

Before implementing below workaround, please make sure that the problem ESXi is indeed a stale entry by validating it's presence in vSphere inventory

Workaround:

The stale transport node can be forcibly removed using the below API call:

DELETE https://<NSX-Manager-IP>/api/v1/transport-nodes/<Transport-Node-UUID>?force=true&unprepare_host=false

Note: Please open a case with Broadcom Support Team if the issue persists even after following the above workaround.

Additional Information

Additional reference : Installing or Upgrading NSX on an ESXi host fails reporting the node already exists