"NSX Version found is not compatible with this global manager" error during Local Manager Federation Onboarding
search cancel

"NSX Version found is not compatible with this global manager" error during Local Manager Federation Onboarding

book

Article ID: 438062

calendar_today

Updated On:

Products

VMware NSX

Issue/Introduction

  • When attempting to add an NSX Local Manager to an NSX Global Manager, the "Check version compatibility" operation fails with the following error message:
    • "NSX version found is not compatible with this global manager"
  • This occurs despite both managers running identical builds.

Environment

  • VMware Cloud Foundation 9.0.x
  • VMware NSX 9.0.x

Cause

  • The incorrect certificate thumbprint (e.g., an individual node API thumbprint instead of the cluster VIP thumbprint) may have been provided during the Add New Location process.
  • The resulting trust validation failure is incorrectly parsed by the system, resulting in a misleading version compatibility error.
    • This (the misleading error) is a known issue that will be resolved in a future release.

Resolution

  1. Open an SSH session to the NSX Local Manager appliance and authenticate as the admin user.
  2. Execute the following command to retrieve the correct thumbprint:
    1. get certificate cluster thumbprint
  3. Copy the returned SHA-256 thumbprint.
  4. Return to the Global Manager UI or API and re-attempt adding the Local Manager using the copied cluster VIP thumbprint.