VCF 5.2 to 9.0.1 upgrade fails with "NSX-T version 9.1.0.0 is not compatible with NCP version 4.1.2. Please choose NSX-T version from compatible list"

Products

• VMware Cloud Foundation

Issue/Introduction

SDDC upgrade from 5.2 to 9.0.1 with multiple Workload Domains sharing the same NSX manager.

Workload domains without supervisor can be successfully upgraded to 9.0.1

During the upgrade of a workload domain with a supervisor and after upgrading the vCenter and NSX manager, the upgrade of the supervisor cluster fails due to incompatible NSX version. The error is similar to the following:

"NSX-T version 9.1.0.0 is not compatible with NCP version 4.1.2. Please choose NSX-T version from compatible list".

At this stage only the NSX manager appliance has been upgraded to 9.1 but, the upgrade finalisation step hasn't occurred yet, the NSX manager product version is still at "4.1.2".

Environment

SDDC 5.2

VCF 9.0.1

Cause

This issue stems from the fact that WCP reads the NSX manager appliance version rather than the product version when performing the compatibility check for a supervisor cluster version. Therefore, the upgrade pre-check may error, reporting the NSX version is not supported by the supervisor cluster.

Resolution

This issue is slated to be resolved in VCF 9.1

Before 9.1, users should manually update the supported NSX version in the relevant section in the WCP compatibility file on the vCenter appliance

1. SSH into the vCenter with root user.
2. Take a backup of the wcp_versions.yaml file
   
   cp -p /etc/vmware/wcp/wcp_versions.yaml /root/wcp_versions.yaml.backup


3. Use vi to edit the wcp_versions.yaml and find the section with NSX. Then hit the letter "i" for insert mode and add "9\.1\..*\..*" in the compatible_with section.
   
   Example:
   
   - compatible_with:
    - 9\.3\..*\..*
    - 9\.2\..*\..*
    - 9\.1\..*\..*
    - 9\.0\..*\..*
    - 4\.2\..*\..*
    - 4\.1\..*\..*
   
   
4. Then hit escape and then type :x to save the file and exit.
5. Restart the WCP service
   
   service-control --restart wcp
   
   
6. Retry the upgrade.