This section describes how to remove a host from a cluster prepared for network virtualization. You might want to do this if, for example, you decide that the host is not going to participate in NSX.

About this task


In the host has NSX 6.3.0 or later and ESXi 6.0 or later, you do not need to reboot a host to uninstall VIBs. In earlier versions of NSX and ESXi, a reboot is required to complete the VIB uninstall.


  1. Place the host into maintenance mode and wait for DRS to evacuate the host, or manually vMotion running VMs from the host.
  2. Remove host from the prepared cluster by either moving it to an unprepared cluster or making it a standalone host outside of any cluster.

    NSX uninstalls the network virtualization components and service virtual machines from the host.

  3. If the host has NSX 6.2.x or earlier installed, or has ESXi 5.5 installed, reboot the host.
  4. Verify the VIB uninstall has completed.
    1. Check the Recent Tasks pane in the vSphere Web Client.
    2. In the Host Preparation tab, check that the Installation Status for the cluster from which the host was removed has a green checkmark.

      If the Installation Status is Installing, the uninstall is still in progress.

  5. Once the uninstall is complete, remove the host from maintenance mode.


The NSX VIBs are removed from the host. To verify, SSH to the host and run the esxcli software vib list | grep esx command. Make sure the following VIBs are not present on the host:

  • esx-vsip

  • esx-vxlan

If the VIBs remain on the host, you can view the logs to determine why automated VIB removal did not work.

You can remove the VIBs manually by running the following commands:

  • esxcli software vib remove --vibname=esx-vxlan

  • esxcli software vib remove --vibname=esx-vsip