Uninstall and Delete Agent

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 as shown below.

  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).
  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.
    Device management interface showing breadcrumb navigation Devices greater than Managed Devices, search bar with Query All, device and agent action icons, filter options, buttons for creating Onbox and Offbox agents, and columns selector.

    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.