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.

Caution:

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 http://www.vmware.com/resources/compatibility/search.php?deviceCategory=security.

    • Consult the partner documentation for compatibility and upgrade details.

  3. If you have Data Security in your environment, uninstall it before upgrading NSX. Data Security is not supported in NSX 6.3.x. See Uninstall NSX Data Security.

  4. If you have a hardware gateway (hardware VTEP) installed in your environment, upgrade to NSX 6.3.0 and 6.3.1 is blocked. You must contact VMware support to proceed with the upgrade. See https://kb.vmware.com/kb/2148511 for more information. Upgrade to NSX 6.3.2 is allowed.

  5. If you have any NSX 5.5 or earlier NSX Edge appliances, you must upgrade them to NSX 6.x before upgrading to NSX 6.3.x.

  6. If you are upgrading to NSX 6.3.3 the NSX Controller cluster must contain three controller nodes. If it has fewer than three you must add additional nodes before starting the upgrade. See "Deploy NSX Controller Cluster" in the NSX Installation Guide for steps to add controller nodes.

  7. Plan to upgrade all NSX Managers that are connected to vCenter Server systems using the same SSO server (including vCenter Server systems in Enhanced Linked Mode) in the same maintenance window. If you cannot, see https://kb.vmware.com/kb/2127061 for a workaround.

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

  9. Create a Tech Support Bundle.

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

  11. 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 http://kb.vmware.com/kb/2053782.

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

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

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