In a vCloud Director environment, you must you must set DRS to Manual before upgrading VIBs on clusters, otherwise NSX will attempt to put the hosts in maintenance mode.

Prerequisites

  • Verify that vShield Manager has been upgraded to NSX Manager.

  • Verify that the VXLAN Column in Host Preparation tab displays Enabled.

  • Verify that the fully qualified domain names (FQDNs) of all of your hosts can be resolved.

  • Before beginning the upgrade, make sure that DRS can work in your environment.

    • Verify that DRS is enabled on the host clusters.

    • Verify that vMotion functions correctly.

    • Verify the host connection state with vCenter.

    • Verify that you have a minimum three ESXi hosts in each host cluster. During an NSX upgrade, a host cluster with only one or two hosts is more likely to have issues with DRS admission control. For a successful NSX upgrade, VMware recommends that each host cluster have at least three hosts. If a cluster contains fewer than three hosts, the recommendation is to manually evacuate the hosts.

  • If DRS is enabled, the running VMs are moved automatically during the host cluster upgrade. Before beginning the upgrade, make sure that DRS can work in your environment.

    • Verify that DRS is enabled on the host clusters.

    • Verify that vMotion functions correctly.

    • Verify the host connection state with vCenter.

    • Verify that you have a minimum three ESXi hosts in each host cluster. During an NSX upgrade, a host cluster with only one or two hosts is more likely to have issues with DRS admission control. For a successful NSX upgrade, VMware recommends that each host cluster have at least three hosts. If a cluster contains fewer than three hosts, the recommendation is to manually evacuate the hosts.

Procedure

  1. In the vSphere Web Client, navigate to Home > Hosts and Clusters.
  2. Set DRS to manual on the host clusters. Repeat these steps for all clusters that have vCloud Networking and Security installed.
    Caution:

    Do not disable DRS. Disabling DRS will delete your resource pools and corrupt your vCloud Director installation.

    1. Select a cluster, and then navigate to Manage > Settings > vSphere DRS.
    2. Take note of the current DRS Automation setting, as you will revert this change later.
    3. Click Edit. In the DRS Automation section, select Manual and click OK.
  3. Navigate to Home > Networking & Security > Installation.
  4. Click the Host Preparation tab.

    All clusters in your infrastructure are displayed.

    If you had Virtual Wires in your 5.5 environment, the Installation Status column displays legacy, Update, and Uninstall.

    Figure 1. Installation Status displays Update when you have Virtual Wires in your 5.5 environment
    update

    If you did not have Virtual Wires in your 5.5 environment, the Installation Status column displays Install.

    Figure 2. Installation Status displays Install when you do not have Virtual Wires in your 5.5 environment
    host

  5. For each cluster, click Update or Install in the Installation Status column.

    Each host in the cluster receives the new logical switch software.

    The host upgrade initiates a host scan. The old VIBs are removed (though they are not completely deleted until after the reboot). New VIBs are installed on the altboot partition. To view the new VIBs on a host that has not yet rebooted, you can run the esxcli software vib list --rebooting-image | grep esx command.

  6. Monitor the installation until the Installation Status column displays Not Ready.

    Do not click Resolve.

  7. Navigate to Home > Hosts and Clusters.
  8. Revert the DRS changes on the host clusters. Repeat these steps for all clusters that have NSX installed.
    1. Select a cluster, and then navigate to Manage > Settings
    2. Select vSphere DRS and click Edit. In the DRS Automation section, select your original DRS setting and click OK.

What to do next

Reboot Hosts Manually after VIB Installation in a vCloud Director Environment.