If you are using the current version of Cumulus NetQ, the content on this page may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

Uninstall NetQ

This page outlines how to remove the NetQ software from your system server and switches.

Remove the NetQ Agent and CLI

Use the apt-get purge command to remove the NetQ Agent or CLI package from a Cumulus Linux switch or an Ubuntu host:

cumulus@switch:~$ sudo apt-get update
cumulus@switch:~$ sudo apt-get purge netq-agent netq-apps
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following packages will be REMOVED:
  netq-agent* netq-apps*
0 upgraded, 0 newly installed, 2 to remove and 0 not upgraded.
After this operation, 310 MB disk space will be freed.
Do you want to continue? [Y/n] Y
...

If you only want to remove the agent or the CLI, but not both, specify just the relevant package in the apt-get purge command.

To verify the removal of the packages from the switch, run:

cumulus@switch:~$ dpkg-query -l netq-agent
dpkg-query: no packages found matching netq-agent
cumulus@switch:~$ dpkg-query -l netq-apps
dpkg-query: no packages found matching netq-apps

Use the yum remove command to remove the NetQ agent or CLI package from a RHEL7 or CentOS host:

root@rhel7:~# sudo yum remove netq-agent netq-apps
Loaded plugins: fastestmirror
Resolving Dependencies
--> Running transaction check
---> Package netq-agent.x86_64 0:3.1.0-rh7u28~1594097110.8f00ba1 will be erased
--> Processing Dependency: netq-agent >= 3.2.0 for package: cumulus-netq-3.1.0-rh7u28~1594097110.8f00ba1.x86_64
--> Running transaction check
---> Package cumulus-netq.x86_64 0:3.1.0-rh7u28~1594097110.8f00ba1 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

...

Removed:
  netq-agent.x86_64 0:3.1.0-rh7u28~1594097110.8f00ba1

Dependency Removed:
  cumulus-netq.x86_64 0:3.1.0-rh7u28~1594097110.8f00ba1

Complete!

If you only want to remove the agent or the CLI, but not both, specify just the relevant package in the yum remove command.

To verify the removal of the packages from the switch, run:

root@rhel7:~# rpm -q netq-agent
package netq-agent is not installed
root@rhel7:~# rpm -q netq-apps
package netq-apps is not installed

Uninstall NetQ from the System Server

First remove the data collected to free up used disk space. Then remove the software.

  1. Log in to the NetQ system server.

  2. Remove the data using the following command. For cluster deployments, run this command on each node in the cluster:

netq bootstrap reset purge-db
  1. Remove the software with apt-get purge:
cumulus@switch:~$ sudo apt-get update
cumulus@switch:~$ sudo apt-get purge netq-agent netq-apps
  1. Verify the removal of the packages from the switch:
cumulus@switch:~$ dpkg-query -l netq-agent
dpkg-query: no packages found matching netq-agent
cumulus@switch:~$ dpkg-query -l netq-apps
dpkg-query: no packages found matching netq-apps
  1. Delete the virtual machine according to the usual VMware or KVM practice.

Delete a virtual machine from the host computer using one of the following methods:

  • Right-click the name of the virtual machine in the Favorites list, then select Delete from Disk.
  • Select the virtual machine and choose VM > Delete from disk.

Delete a virtual machine from the host computer using one of the following methods:

  • Run virsch undefine <vm-domain> --remove-all-storage
  • Run virsh undefine <vm-domain> --wipe-storage