You can upgrade the NSX Application Platform to a later build version using the NSX Manager UI.

The upgrade process retains the form factor being used for the current platform deployment. If you deployed the platform using an Evaluation form factor and want to continue using an Evaluation form factor, but use a later platform version, you must delete your current NSX Application Platform deployment first. You then redeploy the platform using a later platform version.

Upgrading to a newer version of the NSX Application Platform involves multiple steps. You must first configure and deploy the Upgrade Coordinator before you can proceed with upgrading the platform and each of the currently activated NSX features. The Upgrade Coordinator orchestrates all of the upgrade steps, and the system provides status on the UI as it upgrades each component.


  • Review the NSX Release Notes for any known upgrade issue and workaround documented for the NSX Application Platform.

  • Ensure that there are no open alarms detected on the NSX Application Platform.

  • Verify that all of the prerequisites and system requirements listed in NSX Application Platform Deployment Prerequisites are met.

  • You must have Enterprise Admin privileges.


  1. From your browser, log in with Enterprise Admin privileges to an NSX Manager at https://<nsx-manager-ip-address>.
  2. Navigate to System > Upgrade.
  3. Deploy the Upgrade Coordinator.
    1. In the NSX Application Platform card, click Upgrade.

      This step can take some time as the system updates the Helm chart and Docker registry information from the Helm repository.

    2. In the Platform Target Version text box, select the build version that you want to use for the upgrade.
    3. Click Deploy Upgrade Coordinator.

      This step can also take some time as the system deploys the Upgrade Coordinator to your TKC pod or upstream Kubernetes pod.

    After the Upgrade Coordinator deployment completes, the NSX Application Platform upgrade card appears again. The Upgrade Summary section shows the Deploy Upgrade Coordinator marked as completed.

  4. In the NSX Application Platform upgrade card, click Continue With Upgrade.

    The Upgrade NSX Application Platform page displays with the Prepare tab and the NSX Application Platform tab by default. Tabs also appear for each NSX feature that is scheduled for the upgrade. For example, the NSX Malware Prevention tab and feature card appear in the following image because it is currently an activated feature on the NSX Application Platform. The system upgrades the activated features after the platform upgrade finishes successfully.

    UI page for Upgrade NSX Application Platform. The Prepare tab contents are displayed and described by the surrounding text.

  5. In the Deploy Upgrade Coordinator section of the Prepare tab, verify that the values shown in Helm Repository, Docker Registry, and Platform Target Version text boxes are correct.

    If you must modify any of the values, click Delete next to the Note located after the Status section and redeploy a new upgrade coordinator.

  6. If all the Upgrade Coordinator values are correct, click Run Prechecks and select All Prechecks from the drop-down menu.

    To optionally precheck specific components only, click Run Prechecks and from the drop-down menu, select the name of the component that you want to precheck.

    The system performs all the prechecks for all the components that are scheduled for the upgrade. The prechecks help detect and resolve potential problems early in the upgrade process, which can make the upgrade process run more smoothly. The system updates the component cards with their prechecks status.

    If the system identifies any issues during the precheck, you can click Download Precheck Results and use the information in the downloaded file to help investigate the reported issues.

  7. Click Next.

    The NSX Application Platform tab displays a grid of all the groups of components that comprise the platform. You can expand each row to see all of the units for each component group that will be upgraded.

  8. Click Upgrade.

    The system upgrades each group that comprise the NSX Application Platform. This step can take some time to finish. You can leave the Upgrade UI screen and return to it by navigating back to System > Upgrade page and clicking Continue With Upgrade.

    There are multiple ways to track the progress of the upgrade.

    1. To view the logs generated as the upgraded progresses, click Recent Logs.

    2. To monitor the upgrade status for each component group, use the Group Status column.

    3. To see the upgrade status for each item in a particular group, expand the grid row for that group and verify the status shown for each group item.

    If an error occurs for a group upgrade, expand the row for the group and click the Failed link to see the reason for the failure. Use that information to resolve the reported problem and to work with your infrastructure administrator or VMware support. When you have resolved the cause of the failure, click Retry to try to complete the upgrade.

  9. When the platform is successfully upgraded, click Next and in the tab for the NSX feature (for example NSX Malware Prevention), click Update.

    After this feature is successfully upgraded, repeat this step for each of the remaining NSX features that must be upgraded.

  10. After you have upgraded all of the NSX features activated on the platform, navigate to System > NSX Application Platform. Verify the Platform Version and Feature Version details for each of the activated features are correct.