To help ensure a successful NSX upgrade, be sure to check the release notes for upgrade issues, make sure that you are using the correct upgrade sequence, and make sure that the infrastructure is properly prepared for the upgrade.


Downgrades are not supported:

  • Always capture a backup of NSX Manager before proceeding with an upgrade.

  • Once NSX Manager has been upgraded successfully, NSX cannot be downgraded.

VMware recommends doing upgrade work in a maintenance window as defined by your company.

The following guidelines can be used as a pre-upgrade checklist.

  1. Verify that vCenter meets the system requirements for NSX. See System Requirements for NSX.

  2. If any Guest Introspection or Network Extensibility partner services are deployed, verify compatibility before upgrading:

    • In most circumstances, NSX can be upgraded without impacting partner solutions. However, if your partner solution is not compatible with the version of NSX to which you are upgrading, you will need to upgrade the partner solution to a compatible version before upgrading NSX.

    • Consult the VMware Compatibility Guide for Networking and Security. See

    • Consult the partner documentation for compatibility and upgrade details.

  3. If you have Data Security in your environment, uninstall it before upgrading NSX Manager. See Uninstall NSX Data Security.

  4. Plan to upgrade all NSX Managers that are connected to vCenter Server systems that use the same SSO server (including vCenter Server systems in Enhanced Linked Mode). If you cannot, see for a workaround.

  5. Verify that you have a current backup of the NSX Manager, vCenter and other NSX components. See NSX Backup and Restore.

  6. Create a Tech Support Bundle.

  7. Ensure that forward and reverse domain name resolution is working, using the nslookup command.

  8. If VUM is in use in the environment, ensure that the bypassVumEnabled flag is set to true in vCenter. This setting configures the EAM to install the VIBs directly to the ESXi hosts even when the VUM is installed and/or not available. See

  9. Download and stage the upgrade bundle, validate with md5sum. See Download the NSX Upgrade Bundle and Check the MD5.

  10. As a best practice, quiesce all operations in the environment until all sections of the upgrade are complete.

  11. Do not power down or delete any NSX components or appliances before instructed to do so.