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.


netq decommission

Decommissions a switch or host currently running the NetQ Agent. This removes information about the switch or host from the NetQ database. Before decommissioning a switch, you should stop and disable the NetQ Agent.

You might need to decommission a switch when you:

  • Change the hostname of the switch or host
  • Move the switch or host from one data center to another
  • Return the switch or host


netq decommission <hostname-to-decommission>

Required Arguments

NA<hostname-to-decommission>Decommission the switch with this hostname



Sample Usage

cumulus@switch:~$ sudo systemctl stop netq-agent
cumulus@switch:~$ sudo systemctl disable netq-agent

cumulus@switch:~$ netq decommission leaf28
Successfully decommissioned node leaf28