How to Reset NSX Upgrade Prechecks

Products

• VMware NSX

Issue/Introduction

• Precheck errors were displayed initially
• Precheck errors have since been resolved
• A re-run of the prechecks does not resolve the issue

Environment

NSX 3.x

NSX 4.x 

Cause

The Upgrade plan updates a file that persists after a reboot. The plan needs to be reset via API.

Resolution

Reset the upgrade plan via API.

You can run this API call from a client such as Postman or from the root shell of any NSX manager using curl.

POST https://mgr_IP/api/v1/upgrade/plan?action=reset&component_type=<component>

Component parameters are: 'HOST', 'EDGE' or 'MP'

POST https://mgr_IP/api/v1/upgrade/plan?action=reset&component_type=MP

POST https://mgr_IP/api/v1/upgrade/plan?action=reset&component_type=EDGE

POST https://mgr_IP/api/v1/upgrade/plan?action=reset&component_type=HOST

NOTE:

Check to make sure the Upgrade-Coordinator service is running before and after running the above API calls. 

 

Additional Information

If you are running NSX 4.1.0.2 There may be a failure to reset the upgrade plan via API. 

Please see Failed to execute method GetRemoteRepoSyncResult error when upgrading NSX