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.

Decommission Switches

You can decommission a switch or host at any time. You might need to do this when you:

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

Decommissioning the switch or host removes information about the switch or host from the NetQ database. When the NetQ Agent restarts at a later date, it sends a connection request back to the database, so NetQ can monitor the switch or host again.

Decommission from the CLI

To decommission a switch or host:

  1. On the given switch or host, stop and disable the NetQ Agent service.

    cumulus@switch:~$ sudo systemctl stop netq-agent
    cumulus@switch:~$ sudo systemctl disable netq-agent
    
  2. On the NetQ On-premises or Cloud Appliance or VM, decommission the switch or host.

    cumulus@netq-appliance:~$ netq decommission <hostname-to-decommission>
    

Decommission from the NetQ UI

You can decommission a switch or host from the NetQ UI using the Inventory | Devices card. This stops and disables the NetQ Agent service on the device, and decommissions it from the NetQ database.

  1. Expand the Inventory | Devices card to list the devices in the current inventory:
  1. Select the devices to decommission:
  1. Confirm the devices to decommission:
  1. Wait for the decommission process to complete: