You can uninstall NSX-T Data Center from a ESXi host.
Prerequisites
If you are uninstalling
NSX-T Data Center from a standalone
ESXi host, verify the following settings:
- In vCenter Server, put the hosts in maintenance mode and power off VMs running on the hosts if you want to migrate VMkernel adapters during uninstallation.
Procedure
- From a browser, log in with admin privileges to an NSX Manager at https://<nsx-manager-ip-address>.
- Navigate the UI based on the NSX-T Data Center version and select a host:
- (NSX-T Data Center 3.2.2 or later) and select the Cluster tab.
-
(NSX-T Data Center 3.2.1 or earlier)
and from the Managed by dropdown menu, select None: Standalone Hosts or a vCenter Server.
- Select the host and click Delete. In the confirmation dialog box, by default Uninstall NSX Components is selected. Uncheck Force Delete and click Delete.
The NSX-T Data Center software is removed from the host. It might take up to 5 minutes for all NSX-T Data Center software to be removed.
- If the uninstall fails, select the host and click Delete again. In the confirmation dialog box, check Force Delete and click Delete.
The host transport node is deleted from the management plane, but the host might still have
NSX-T Data Center software installed.
- Verify that the NSX-T Data Center software is removed from the host.
- Log into the host's command-line interface as root.
- To check for NSX-T Data Center software packages on the ESXi host, run esxcli software vib list | grep -E 'nsx|vsipfwlib' .
- (Host on an N-VDS switch) If the host goes into a failed state and NSX-T Data Center VIBs cannot be removed, then run the del nsx command to remove NSX-T Data Center from the host.
- Before running the del nsx command, put the ESXi host in maintenance mode. The vCenter Server does not allow the host to be put in maintenance mode unless all running VMs on the host are in powered off state or moved to a different host.
- Log in to the ESXi CLI terminal, run nsxcli -c del nsx.
- Read the warning message. Enter Yes if you want to go ahead with NSX-T Data Center uninstallation.
Carefully read the requirements and limitations of this command:
1.Read NSX-T documentation for 'Remove a Host from NSX-T Data Center or Uninstall NSX-T Data Center Completely'.
2.Deletion of this Transport Node from the NSX-T UI or API failed, and this is the last resort.
3.If this is an ESXi host:
a.The host must be in maintenance mode.
b. All resources attached to NSXPGs must be moved out.
If the above conditions for ESXi hosts are not met, the command WILL fail.
4. For command progress check /scratch/log/nsxcli.log on ESXi host or /var/log/nsxcli.log on non-ESXi host.
Are you sure you want to remove NSX-T on this host? (yes/no)
Important: After running the
del nsx command, do not use the
Resolve functionality in the
NSX Manager UI to reprepare the host that is in
Disconnected state . If you use the
Resolve functionality, the host might go into
Degraded state.
- Verify that the existing VMkernel and physical NICs on the N-VDS switch are migrated to a new vSwitch. If there are more than one N-VDS switches on the host, each N-VDS switch is migrated to a separate vSwitch. For example, if the host has N-VDS1and N-VDS2, the VMkernel adapters and physical NICs are migrated to vSwitch1 and vSwitch 2.
- Select each host and click Remove NSX.
- In the popup window, select Force Delete and begin uninstallation.
- On the ESXi host, verify that system message displayed is Terminated. This message indicates that NSX-T Data Center is completely removed from the host.
After running
del nsx,
NSX-T Data Center removes all existing host switches, migrates VMkernels and physical NICs to the newly created vSwitches, detaches the transport node from
NSX Manager and removes
NSX-T Data Center VIBs from the host.
Results
When the
NSX-T Data Center software is successfully removed, no packages are listed. If any NSX software packages remain on the host, contact
VMware support.