If you want to uninstall NSX-T completely or just remove a hypervisor host from NSX-T so that the host can no longer take part in the NSX-T overlay, follow these steps.

About this task

The following procedure describes how to perform a clean uninstall of NSX-T.


  1. In your VM management tool, detach all VMs on the host from any NSX-T logical switches.
  2. In the NSX Manager, delete the host transport node with the Fabric > Nodes > Transport Nodes UI or with the DELETE /api/v1/transport-node/<node-id> API.

    Deleting the transport node causes the NSX-T hostswitch to be removed from the host. You can confirm this by running the following command.

    [root@host:~] esxcli network vswitch dvs vmware list

    On KVM, the command is:

    ovs-vsctl show
  3. In the NSX Manager CLI, enable and start the NSX-T install-upgrade service.
    nsx-manager-1> set service install-upgrade enable
    nsx-manager-1> start service install-upgrade
  4. Unregister the host from the management plane and remove the NSX-T modules.

    It might take up to 10 minutes for all NSX-T modues to be removed.

    There are several methods you can use to remove the NSX-T modules:

    • In the NSX Manager, use the Fabric > Nodes > Hosts > Delete UI.

      In the UI, make sure Uninstall NSX Components is checked. This causes the NSX-T modules to be uninstalled on the host. Note that using Fabric > Nodes > Hosts > Delete with the Uninstall NSX Components option unchecked is not meant to be used on a host that is in a good state. It is only meant as a workaround for hosts that are in a bad state.

    • Use the DELETE /api/v1/fabric/nodes/<node-id> API.

    • Use the CLI.

      1. Get the manager thumbprint.

        manager> get certificate api thumbprint
      2. On the host's NSX-T CLI, run the following command to detach the host from the management plane.

        host> detach management-plane <MANAGER> username <MANAGER-USERNAME> password <MANAGER-PASSWORD> thumbprint <MANAGER-THUMBPRINT>
      3. On the host, run the following command to remove filters.

        [root@host:~] vsipioctl clearallfilters
      4. On the host, run the following command to stop netcpa.

        [root@host:~] /etc/init.d/netcpad stop
      5. Power off the VMs on the host.

      6. Manually uninstall the NSX-T modules from the host.

        Note that removing individual modules is not supported. You must remove all modules in one command.

        esxcli software vib remove -n nsx-aggservice -n nsx-da -n nsx-esx-datapath -n nsx-exporter -n nsx-host -n nsx-lldp -n nsx-mpa -n nsx-netcpa -n nsx-python-protobuf -n nsx-sfhc -n nsx-support-bundle-client -n nsxa -n nsxcli

        On RHEL, use the sudo yum remove <package-name> command. On Ubuntu, use the apt-get remove <package-name> command.

        In both cases, use wildcards to select the NSX-T modules.

        Also remove the following modules:

        • On Ubuntu: tcpdump-ovs, nicira-ovs-hypervisor-node, python-openvswitch, openvswitch-*, libgoogle-glog0, libjson-spirit

        • On RHEL: tcpdump-ovs, openvswitch, kmod-openvswitch, glog, json_spirit

What to do next

After making this change, the host is removed from the management plane and can no longer take part in the NSX-T overlay.

If you are removing NSX-T completely, in your VM management tool, shut down NSX Manager, NSX Controllers, and NSX Edges and delete them from the disk.