NSX Upgrade Pre-check fails with the error message "Failed to execute Check for NSX Application Platform version for upgrade."

Products

• VMware NSX

Issue/Introduction

• Following error seen when upgrading NSX from a 3.2 or higher version to any version: "Failed to execute Check for NSX Application Platform version for upgrade."

• Legacy NSX Intelligence Appliance (VM-based) were deployed in the environment at some point.

• During the upgrade of NSX Manager, an error message is displayed stating that NAPP needs to be upgraded first, even though NAPP is not installed in the environment. This issue prevents the upgrade process from proceeding.

• Error message observed under "Edges" Pre-check:

Failed to execute Check for NSX Application Platform version for upgrade. [UC] Error in rest call. url=/napp/api/v1/platform/monitor/platform/status , method= GET ,response= Unknown Error occurred , error= I/O error on GET request for "https://<nsx-manager-virtual-ip>:443/napp/api/v1/platform/monitor/platform/status"

Environment

• VMware NSX-T Data Center 3.x
• VMware NSX 4.x

 

Cause

• The root cause of the issue is that the NSX Manager is still trying to check the status of the Intelligence Feature, which may no longer be in use, and is causing the upgrade process to fail.
• The deployment of the legacy NSX Intelligence Appliance (VM-based) can trigger this behavior.

Resolution

This is a condition that may occur in a VMware NSX environment where NAPP was deployed and subsequently removed.

 

Follow these steps to clear the stale registration and allow the upgrade to proceed:

Step 1: Manual Deletion via GUI

1. Log in to the NSX Manager UI.

2. Navigate to System > Appliance (or System > Configuration > Appliances).

3. Locate any entry for NSX Intelligence. If it is no longer in use, delete the appliance entry directly from this tab.

4. Re-run the Upgrade Pre-checks.

Step 2: API Cleanup (If GUI Deletion Fails)

If the pre-check still fails after GUI deletion, the registration must be removed via the NSX API.

1. Retrieve the Registration Details: Run the following GET request (using Postman or curl): GET https://<nsx-mgr-ip>/policy/api/v1/infra/sites/napp/registration

2. Identify the Cluster ID: In the JSON response, locate the "id" field (e.g., 467c5144-####-####-####-############).

3. Delete the Registration: Execute a DELETE request using the ID found in the previous step: DELETE https://<nsx-mgr-ip>/policy/api/v1/infra/sites/napp/registration/<cluster_id>

Additional Information

If the environment has a working NSX Intelligence VM-based appliance, it is recommended to have it migrated to the NSX Application Platform based vertical. More information about this can be found in the below document:

Activating and Upgrading VMware NSX Intelligence