Direct upgrade to NSX-V 6.4.10 and higher fails from NSX-V 6.4.2, 6.4.3, 6.4.4, and 6.4.5 versions

Products

• VMware NSX

Issue/Introduction

Symptoms:
Upon uploading a NSX-V 6.4.10 or higher bundle in a setup running NSX-V 6.4.2, 6.4.3, 6.4.4, and 6.4.5 and attempting a upgrade to NSX-V 6.4.10 or higher the upgrade operation will display a similar message as shown below:

 

Resolution

Currently, there is no resolution.

Workaround:

Customers planning to upgrade from any of the impacted releases can follow one of the two options below:

Option-1: Beanshell Script (Recommended)

1. Download the attached signed_bsh_UpgradeUtilsFix_withVersionCheck.encoded file.
2. Run the following REST API POST call using either method a. or method b. as described below.  Choose one method or the other before moving on to step 3.                                                              You can choose to use a REST API Client like POSTMAN on NSX Manager. Alternatively, you can use a curl command as mentioned below in case you are executing this from a Linux machine.

a. First Method Option: POSTMAN

URL: https://NSXMGR_IP/api/1.0/services/debug/script

(Replace the NSXMGR_IP in the above URL with the actual IP address of NSXMGR)

Authentication: Basic authentication (Username: admin)

Headers: content-type - application/xml

Body: copy contents of the attached file signed_bsh_UpgradeUtilsFix_withVersionCheck.encoded.

Sample screenshot:

OR

b. Second Method Option: Using curl command for Linux:

curl --verbose --noproxy '*' -u admin:'default' -H "Accept: application/xml" -H "Content-Type: application/xml" -k -X POST --data @/tmp/signed_bsh_UpgradeUtilsFix.encoded 

https://NSXMGR_IP/api/1.0/services/debug/script

Expected Response: 200

3. When the BeanShell patch is applied, restart the appliance management service with the below api. Refer to the screenshot:

POST https://NSXMGR_IP/api/1.0/appliance-management/components/component/APPMGMT/restart 

4. Log in to the NSX Manager via a web browser.
5. Upload the NSX-V 6.4.10, 6.4.11 or 6.4.12 upgrade bundle and continue the upgrade.
Upgrade operation will display a similar message as shown below:

Option-2: Two-step Upgrade

1. If you are using NSX-V 6.4.2, 6.4.3, 6.4.4, or 6.4.5, then upgrade only the NSX Manager to NSX-V 6.4.6 or NSX-V 6.4.8. Do not upgrade any other NSX components such as (Controllers/host/DLR/edge/USVMs) at this time.
    
2. When the upgrade is completed successfully to 6.4.6 or 6.4.8, you can upload NSX-V 6.4.10 or higher bundle and follow the standard upgrade procedure (that includes an upgrade for all components as per the upgrade guide).

Additional Information

Impact/Risks:
Customers upgrading from the impacted versions (NSX-V 6.4.2, 6.4.3, 6.4.4, and 6.4.5) to NSX-V 6.4.10 and higher will not be able to upgrade using a single-step upgrade.