NSX Upgrade Finalization Fails with Incompatible WCP Cluster Version Error
search cancel

NSX Upgrade Finalization Fails with Incompatible WCP Cluster Version Error

book

Article ID: 443754

calendar_today

Updated On:

Products

VMware NSX VMware SDDC Manager / VCF Installer

Issue/Introduction

After upgrading components through SDDC to version 9.0.2, the NSX upgrade fails to finalize through the User Interface (UI). The process is blocked during the pre-upgrade check phase.

Symptoms:


The NSX Manager UI displays a failure during the `FINALIZE_UPGRADE` stage.


Pre-check logs indicate a version mismatch between NSX and the Workload Control Plane (WCP) clusters.

Error Message seen when running the Finalize Upgrade through NSX UI:


`Pre-upgrade checks failed for FINALIZE_UPGRADE: Incompatible WCP clusters with NSX version exist. Please upgrade the WCP clusters before upgrading NSX. Precheck failed because NSX version 9.0 requires minimum WCP Version to be 9.0.0.0 whereas the current WCP Version is 0.1.12. Following WCP versions are available 9.0.2.0, 9.0.2.0 for cluster'

Environment

VMware NSX 4.2.1.0

VMware SDDC/VCF 9.0.2

Cause

NSX version 9.0 (as part of the VCF 9.0.2 stack) enforces a minimum Supervisor/WCP version of 9.0.0.0. If the Supervisor clusters in vCenter are still running an older version, the NSX finalization logic will block the upgrade to ensure compatibility and stability of the Workload Management components.

Resolution

To resolve this issue, the Supervisor clusters must be updated to a compatible version before finalizing the NSX upgrade.

Prerequisites:

  • Ensure all other SDDC components have successfully reached the 9.0.2 target state.
  • Take a backup or snapshot of the vCenter Server and NSX Managers.

Steps:

  1. Log in to the vSphere Client.
  2. Navigate to 3 Line Menu > Workload Management(Supervisor Management if Workload Management isn't present.)
  3. Select the affected Supervisor Cluster(s) (e.g., domain-c1234).
  4. Perform the upgrade of the Supervisor to the latest available version (e.g., v1.31.6 or WCP 9.0.2.0).
  5. Verify that the Supervisor status shows as Running with the updated version in vCenter.
  6. Return to the NSX Manager UI.
  7. Re-run the upgrade finalization. The pre-check should now pass, allowing the upgrade to complete successfully.

Additional Information

Note:

Ensure the Supervisor upgrade completes fully across all control plane nodes before attempting to finalize the NSX side.

Upgrade a Supervisor

vSphere Interoperability Matrix

Powered by Wolken Software