NSX upgrade pre-checks are stuck for Edges

Products

• VMware NSX

Issue/Introduction

During an NSX upgrade, the pre-upgrade checks for Edge nodes may hang in a continuous loading state. This causes the Upgrade Coordinator to stall and preventing the upgrade of remaining ESXi hosts.

• Upgrade coordinator shows pre-checks for Edges as "Running" or "Loading" indefinitely.
• Restarting the install-upgrade service does not resolve the frozen state.
• Rolling reboot of NSX Managers does not break the upgrade pre-checks task. 

Environment

• VMware NSX
• Upgrade from VMware NSX 3.2.x to 4.x

Cause

The NSX Upgrade Coordinator enters a stalled state because the pre-upgrade checks for NSX Edges are stuck in a continuous loop. 

Resolution

To break the loop and allow the upgrade to proceed, abort the stuck pre-upgrade checks using the REST API.

1. Open a REST API client (such as Postman).
2. Execute the following call against the NSX Manager IP: Abort pre-upgrade checks
   • Method: POST
   • URL: https://<nsx-manager-ip>/api/v1/upgrade?action=abort_pre_upgrade_checks
   • Authentication: Use NSX admin credentials.
3. Verify the pre-checks have stopped in the UI.
4. Once the pre-checks are aborted, retry the upgrade for the remaining components.