Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Uninstall and Delete Agent

If you want to remove a device from Apstra management, see Remove (Decommission) Device from Managed Devices for the complete worklow. There are additional steps before and after uninstalling and deleting the agent.

  1. From the left navigation menu, navigate to Devices > Managed Devices to go to the managed devices table view.
    Note:

    When you uninstall a device agent, the pristine configuration is restored on the device by default. If you want to retain existing configuration, click Advanced Settings and check the box to Skip Revert to Pristine on Uninstall.

  2. Check the box(es) for the device(s), 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 the agent.

  3. Check the box for the device(s) 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.