Uninstall sequence NSX-T VIBs (2.2)

Lately, I have been playing around with NSX-T in my homelab, to be specific with version 2.2. A week or two ago NSX-T 2.3 has been released and initially, I was planning to upgrade all the stuff. After having a chat with a colleague where he suggested to do a clean install instead of upgrading it, I went for a fresh installation for the latest NSX-T version. The uninstallation of all the NSX-T components went pretty smooth. Only with components that have dependencies or relationships with each other in NSX-T you need to think about the uninstall sequence. Otherwise, the system will not let you remove certain objects.

After I installed the NSX-T Manager appliance with the 2.3 version and I tried to prepare my ESXi host with the NSX-T VIBs I ran into an error (obviously because I didn’t remove the NSX-T 2.2 VIBs prior to the installation of the new 2.3 VIBs).

Since NSX-T has its functionally built-in in a divided set of VIBs with a lot of dependencies it is not straightforward to uninstall them. I googled something and found some posts regarding uninstall sequences but they weren’t applicable anymore for the NSX-T 2.2 and 2.3 releases. So I figured out the uninstall sequence myself. NSX-T VIBs can be uninstalled with the ‘esxcli software vib remove -n‘ command in the following sequence: nsxa, nsx-host, nsx-hyperbus, nsx-exporter, nsx-aggservice, nsx-platform-client, nsx-python-logging, nsx-opsagent, nsx-proxy, nsx-nestdb, nsx-da, nsx-sfhc, epsec-mux, nsx-python-protobuf, nsx-python-greenlet, nsx-python-gevent, nsx-profiling-libs, nsxcli, nsx-netcpa, nsx-mpa, nsx-nestdb-libs, nsx-rpc-libs, nsx-metrics-libs, nsx-common-libs, nsx-shared-libs, nsx-cli-libs

The last VIB you need to uninstall is the ‘nsx-esx-datapath’ VIB. That thing gave me a headache at that moment. Since It wouldn’t let me uninstall the VIB even after several reboots, killing off all the services on the ESXi host (inlcuding hostd) and trying to forcefully remove the VIB via the localcli was not succesfull. Thinking about it afterward, it was a pretty easy solution I only needed to add the –no-live–install to the esxcli software vib remove command because the system had tried to live update it when NSX-T 2.3 was installed, which was unsuccessful. So with theesxcli software vib remove -n nsx-esx-datapath –no-live-installcommand I was able to uninstall the VIB and install the fresh NSX-T 2.3 VIBs again.

If you have any questions, remarks or recommendations. Please let me know!

sources: vmware.com, brianragazzi.wordpress.com


  1. for x in ` esxcli software vib list | grep nsx | awk ‘ { print $1 } ‘ ` ; do esxcli software vib remo
    ve -n $x ; done

    Just keep running it until all VIB are gone 🙂


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s