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

Note:

After you initiate the upgrade, the NSX Manager user interface is briefly accessible. Then the NSX Manager user interface, API, and CLI are not accessible until the upgrade finishes and the Management plane is restarted.

Prerequisites

Verify that the NSX Edge cluster is upgraded successfully. See Upgrade NSX Edge Cluster.

Procedure

  1. Backup the NSX Manager.

    See the NSX-T Data Center Administration Guide.

  2. When upgrading to NSX-T Data Center 2.4, in the vSphere Client, verify that your NSX-T Data Center 2.3 NSX Manager meets the vCPU and RAM limits and make necessary changes.

    NSX-T Data Center 2.3 Appliance

    Memory

    vCPU

    NSX-T Data Center 2.4 Appliance

    Memory

    vCPU

    N/A

    N/A

    N/A

    NSX Manager Extra Small VM

    8 GB

    2

    NSX Manager Small VM

    8 GB

    2

    NSX Manager Small VM

    16 GB

    4

    NSX Manager Medium VM

    16 GB

    4

    NSX Manager Medium VM

    24 GB

    6

    NSX Manager Large VM

    35 GB

    8

    NSX Manager Large VM

    48 GB

    12

  3. Select a Management plane upgrade plan.
    • You can allow a transport node connection to a single NSX Controller node after upgrade.

    • You can block the transport node connection to the NSX Controller until a three-node NSX Manager cluster is created.

      The transport node status is degraded because the connection between the transport node and the NSX Controller is blocked.

  4. Click Start to upgrade the Management plane.
  5. Accept the upgrade notification.

    You can safely ignore any upgrade related errors such as, HTTP service disruption that appears at this time. These errors appear because the Management plane is rebooting during the upgrading.

    Wait until the reboot finishes and the services are reestablished.

  6. In the CLI, log in to the NSX Manager to verify that the services have started.

    get service

    When the services start, the Service state appears as running. Some of the services include, SSH, install-upgrade, and manager.

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

  7. In the web browser, click Reload to refresh the browser.
  8. From your browser, log in with admin privileges to an NSX Manager at https://nsx-manager-ip-address.
  9. (Optional) Depending on the upgrade plan, allow the host connection to the single NSX Controller node.
  10. (Optional) Click the Help icon in the top right corner.
  11. (Optional) Select About to verify that the product version is updated.
  12. For NSX-T Data Center 2.3.x > NSX-T Data Center 2.4.x upgrade, complete the following tasks.
    1. Select System > Overview and deploy two NSX Manager nodes to form a cluster.

      The newly deployed nodes continue to use pre-upgrade passwords. It is recommended that you change your passwords to match the password complexity recommendations for NSX-T Data Center 2.4.

      See instructions on how to deploy NSX Manager and create a cluster in the NSX-T Data Center Installation Guide.

    2. Select System > Overview and verify that the repository synchronization for the cluster is complete.
    3. Log in with admin privileges to the newly deployed NSX Manager node.
    4. Verify that the cluster status is UP and Stable.

      get cluster status

    5. For a VMware Integrated OpenStack deployment, add the node IP addresses to the nsx.ini file.
      /etc/neutron/plugins/vmware/nsx.ini

      Restart the Neutron service.

      sudo systemctl restart devstack@q-svc.service

  13. For NSX-T Data Center 2.2.x > NSX-T Data Center 2.3.x > NSX-T Data Center 2.4.x upgrade, complete the following tasks.
    1. Select System > Overview and deploy three NSX Manager nodes to form a cluster.

      The newly deployed nodes continue to use pre-upgrade passwords. It is recommended that you change your passwords to match the password complexity recommendations for NSX-T Data Center 2.4.

      See instructions on how to deploy NSX Manager and create a cluster in the NSX-T Data Center Installation Guide.

    2. Select System > Overview and verify that the repository synchronization for the cluster is complete.
    3. Log in with admin privileges to the newly deployed NSX Manager node.
    4. Verify that the cluster status is UP and Stable.

      get cluster status

    5. Detach the upgraded NSX Manager node from the cluster using the command, detach node <upgraded-node-uuid>.
    6. Set the newly deployed NSX Manager node as the upgrade-coordinator orchestrator using the command, set repository-ip.
      Important:

      You must implement this step so that the newly deployed node functions properly.

    7. Power off and delete the detached NSX Manager node.
      Note:

      The detached node is no longer part of NSX-T Data Center.

What to do next

Perform post-upgrade tasks or troubleshoot errors depending on the upgrade status. See Post-Upgrade Tasks or Troubleshooting Upgrade Failures.