Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Remove (Decommission) Device from Managed Devices

For successful device removal, it's important to follow these steps in the order specified.

  1. If the device is assigned to a blueprint, unassign it from your datacenter blueprint or freeform blueprint, as applicable.
  2. From the left navigation menu, navigate to Devices > Managed Devices and check the box for the device to remove from Apstra management.
  3. In the Device Actions panel that appears above the table, click the Set admin state to DECOMM for selected systems button, then click Confirm to set the admin state and return to the table. (If the device is assigned to a blueprint, you can't decommission the device.)
  4. Check the box for the device again, then in the Agent Actions panel that appears above the table, click the Uninstall button, click Uninstall selected elements, then click Close.
    Note:

    If the device is unreachable, the job will fail. You can force delete the agent (in the next step), as of Apstra version 4.1.2.

    Prior to Apstra version 4.1.2, if the device is unreachable you could change the agent operation mode to telemetry only, then uninstall its agent.
  5. Check the box for the device again, then in the Agent Actions panel that appears above the table, click the Delete button, click Delete selected elements, then click Close.

    If you weren't able to uninstall the agent in the previous step because the device is unreachable, a dialog opens that gives you the option to force delete the agent. With the Force Delete box checked, click Delete to force delete the agent and return to the table view.

  6. Check the box for the device again, then in the Device Actions panel click the Delete system(s) button, then in the dialog that opens click Confirm to remove the device(s) from Apstra management and return to the table view. (If the device is not in STOCKED or DECOMM stage, you can't delete the device.) Device(s) are disconnected from the Apstra server and removed from the Apstra database.

If you're replacing the device you just removed, follow the steps to add the replacement device to Managed Devices.