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.
- In your VM management tool, detach all VMs on the host from any NSX-T logical switches.
- 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:
- 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
- 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.
Get the manager thumbprint.
manager> get certificate api thumbprint
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>
On the host, run the following command to remove filters.
[root@host:~] vsipioctl clearallfilters
On the host, run the following command to stop netcpa.
[root@host:~] /etc/init.d/netcpad stop
Power off the VMs on the host.
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.