The upgrade coordinator runs in the NSX Manager. It is a self-contained web application that orchestrates the upgrade process of hosts, NSX Edge cluster, NSX Controller cluster, and Management plane.

The upgrade coordinator guides you through the proper upgrade sequence. You can track the upgrade process and if necessary you can pause and resume the upgrade process from the user interface.

The upgrade coordinator allows you to upgrade groups in a serial or parallel order. It also provides the option of upgrading the upgrade units within that group in a serial or parallel order.

Prerequisites

Verify that the upgrade bundle is available. See Download the NSX-T Data Center Upgrade Bundle.

Procedure

  1. In the NSX Manager CLI, verify that the NSX-T Data Center services are running.
    get service install-upgrade
    If the services are not running, troubleshoot the problem. See the NSX-T Data Center Troubleshooting Guide.
    • get service install-upgrade lists the IP address of the orchestrator node. See Enabled on.

      You can also make the following API call to retrieve the IP address.
      GET /api/v1/node/services/install-upgrade
      Use this IP address throughout the upgrade process.
      Note: Ensure that you do not use any type of Virtual IP address or the FQDN to upgrade NSX-T Data Center.
    • To change the orchestrator node, log in to the node that you want to set as an orchestrator node and run set repository-ip.
      Note: If in an NSX Federation environment, you are upgrading a Local Manager from the Global Manager and you have changed the orchestrator node of the Local Manager, this change takes some time to appear on the Global Manager UI.
    • When the Management Plane upgrade is in progress, avoid any configuration changes from any of the nodes.
  2. From your browser, log in as a local admin user to an NSX Manager at https://nsx-manager-ip-address/login.jsp?local=true.
  3. Select System > Upgrade from the navigation panel.
  4. Click Proceed to Upgrade.
  5. Navigate to the upgrade bundle .mub file by navigating to the downloaded upgrade bundle or pasting the download URL link.
    • Click Browse to navigate to the location you downloaded the upgrade bundle .mub file.
    • Paste the VMware download portal URL where the upgrade bundle .mub file is located.
  6. Click Upload.
    Upgrading the upgrade coordinator might take 10–20 minutes, depending on your network speed. If the network times out, reload the upgrade bundle.
    When the upload process finishes, the Begin Upgrade button appears.
  7. Click Begin Upgrade to upgrade the upgrade coordinator.
    Note: Do not initiate multiple simultaneous upgrade processes for the upgrade coordinator.

    The EULA appears.

  8. Read and accept the EULA terms.
  9. Accept the notification to upgrade the upgrade coordinator.
  10. (Optional) If a patch release becomes available after the upgrade coordinator is updated, upload or add the URL of the latest upgrade bundle and upgrade the upgrade coordinator.
  11. Click Run Pre-Checks to verify that all the NSX-T Data Center components are ready for upgrade.
    This action checks for component connectivity, version compatibility, and component status among other environment readiness checks, for your current upgrade plan.
    Note: You must run the pre-checks when you change or reset your upgrade plan, or upload a new upgrade bundle.
  12. (Optional) View the list of pre-checks that are performed with the API call GET https://<nsx-manager>/api/v1/upgrade/upgrade-checks-info.
  13. Resolve any warning notifications to avoid problems during the upgrade.
    1. Click the Hosts notification next to Pre-Checks to see the warning details.
      You might have to place some of the hosts in maintenance mode.
    2. Click the Edges notification next to Pre-Checks to see the warning details.
      You might have to resolve connectivity problems.
    3. Click the Management Nodes notification next to Pre-Checks to see the warning details.
    You can click Download Pre-Check Results to download a CSV file with details about pre-check errors for each component and their status.
  14. (Optional) Click Show Upgrade History and view information about previous NSX Manager upgrades.