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

    If the services are not running, troubleshoot the problem. See the NSX-T Data Center Troubleshooting Guide.

    For NSX-T Data Center 2.4 > NSX-T Data Center 2.4.x upgrade:

    • get service lists the IP address of the orchestrator node. See Enabled on. Use this IP address throughout the upgrade process.

      Note:

      Ensure that you do not use any type of Virtual IP address 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

    • When the Management Plane upgrade is in progress, avoid any configuration changes from any of the nodes.

  2. From your browser, log in with admin privileges to an NSX Manager at https://nsx-manager-ip-address.
  3. Select System > Utilities > Upgrade from the navigation panel.

    The existing NSX-T Data Center release version and components are listed.

    1. Identify a component such as, Host or Edge.
    2. Click the number listed under the Count column.

      A list of all the configured hosts or NSX Edge nodes appear in the dialog box.

  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. Scroll to the bottom of the EULA 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 pre-check details for every component with the API call GET https://<nsx-manager>/api/v1/upgrade/upgrade-checks-info.
  13. Resolve the red warning notification to avoid problems during the upgrade.
    1. Click the Hosts notification to see the warning details.

      You might have to place some of the hosts in maintenance mode.

    2. Click the Edges notification to see the warning details.

      You might have to resolve connectivity problems.

    3. Click the Management Nodes notification to see the warning details.

      You might have to increase the NSX Manager CPU and RAM limits in the vSphere Client.

    You can click Export Pre Checks CSV and download details about any pre-check errors for all the components and their status in a CSV file.

  14. (Optional) Click Show Upgrade History and view information about previous NSX Manager upgrades.

Results

The hosts are ready to be upgraded and the planned upgrade sequence appears. See Configure Hosts.