Upgrade the hosts in your environment using the upgrade coordinator.


  • Verify that you have configured the overall hosts upgrade plan. See Configure Hosts.
  • Verify that ESXi hosts that are part of a disabled DRS cluster or standalone ESXi hosts are placed in maintenance mode.

    For ESXi hosts that are part of a fully enabled DRS cluster, if the host is not in maintenance mode, the upgrade coordinator requests the host to be put in maintenance mode. vSphere DRS migrates the VMs to another host in the same cluster during the upgrade and places the host in maintenance mode.

  • For ESXi host, for an in-place upgrade you do not need to power off the tenant VMs.
  • For a KVM host, for an in-place upgrade you do not need to power off the VMs. For a maintenance mode upgrade, power off the VMs.
  • For a stateless ESXi host, log in vCenter Server and update the ESXi image with the NSX-T Data Center kernel modules.


  1. Click Start to upgrade the hosts.
    For vSphere Lifecycle Manager-enabled clusters, see Upgrade a vSphere Lifecycle Manager-enabled Cluster.
  2. Click Refresh and monitor the upgrade process.
    You can view the overall upgrade status and specific progress of each host upgrade unit group. The upgrade duration depends on the number of host upgrade unit groups you have in your environment.

    Wait until the in progress upgrade units are successfully upgraded. You can then pause the upgrade to configure the host upgrade unit group that is not upgraded and resume the upgrade.

  3. Click Run Post Checks to make sure that the upgraded hosts and NSX-T Data Center do not have any problems.
    Note: If a host upgrade unit failed to upgrade and you removed the host from NSX-T Data Center, refresh the upgrade coordinator to view all the successfully upgraded host upgrade units.

    If a host fails during the upgrade, reboot the host and try the upgrade again.

  4. After the upgrade is successful, verify that the latest version of NSX-T Data Center packages is installed on the vSphere, KVM hosts, and bare metal server.
    • For vSphere hosts, enter esxcli software vib list | grep nsx
    • For Ubuntu hosts, enter dpkg -l | grep nsx
    • For SUSE Linux Enterprise Server, Red Hat, or CentOS hosts, enter rpm -qa | egrep 'nsx|openvswitch|nicira'
  5. Power on the tenant VMs of standalone ESXi hosts that were powered off before the upgrade.
  6. Migrate the tenant VMs on hosts managed by vCenter Server that are part of the enabled DRS cluster to the appropriate host.
  7. Power on or return the tenant VMs of ESXi hosts that are part of a disabled DRS cluster that were powered off before the upgrade.

What to do next

You can proceed with the upgrade only after the upgrade process finishes successfully. If some of the hosts are disabled, you must enable and upgrade them before you proceed. See Upgrade Management Plane.

If there are upgrade errors, you must resolve the errors. See Troubleshooting Upgrade Failures.