Managed Devices

Devices with installed AOS device agents appear in the managed devices list. From the AOS web interface, navigate to Devices / Managed Devices.

_images/managed_devices_330.png

From Managed Devices, you can perform tasks, such as acknowledging devices (to bring them under AOS management), setting admin states, updating user configuration, changing associated device profiles or admin states, and deleting devices. See the device guides for detailed information about device management in AOS.

Acknowledge Device(s)

Acknowledging devices puts them in the Ready state and signals the intent to have AOS manage them.

  1. From the AOS web interface, navigate to Devices / Managed Devices and select the device(s) to be managed by AOS.
  2. Above where you just clicked, click the checkmark to Acknowledge the selected device(s).
  3. Click Confirm to acknowledge the device(s) and return to the list view. The Acknowledged? field for the device changes to a green checkmark and the device state changes to OOS-READY.

Setting Admin State on Devices

  1. From the AOS web interface, navigate to Devices / Managed Devices and select the device(s) to update.
  2. Click the button for the state to change the selection(s) to (MAINT, NORMAL, DECOMM).
  3. Click Confirm to set the admin state and return to the list view.

Important

If you are decommissioning a device, after setting the admin state to DECOMM, you must uninstall the device agent. See the device guide for removing a device. If you would subsequently like AOS to manage the device you can add the device back to AOS.

Updating User Config

  1. From the AOS web interface, navigate to Devices / Managed Devices and select the device(s) to update.
  2. Click the Update user config button, then to override device profile, admin state, and/or location, check the appropriate boxes.
  3. Click Confirm to update the user config and return to the list view.

Editing System

There may be cases where you’ll need to change managed device details. For two examples, see the Modular Devices and Device Profiles and Hyperloop Interface sections below.

To edit a managed device:

  1. From the AOS web interface, navigate to Devices / Managed Devices and select the device key for the device to update.

    _images/managed_device_key_330.png
  2. Click the Edit button (top-right) and select a different device profile, admin state, and/or location, as applicable.

    _images/managed_devices_edit_system_330.png
  3. Click Update to update the device and return to the list view.

Modular Devices and Device Profiles

Multiple device profiles may exist for one modular device model to represent different line card configurations.

_images/managed_devices_modular_330.png

AOS selects the first device profile, based on the selector model field, that it encounters that matches the model of the device chassis (e.g. DCS-7504N).

_images/managed_devices_modular_system_330.png

AOS currently does not match device profiles based on line card configuration.

When using a modular device in your network, check that the correct device profile is associated with it. If necessary change it by following the steps above for editing a system. This must be done prior to acknowledging the managed device and assigning it to an AOS blueprint.

_images/managed_devices_modular_edit_system_330.png

Hyperloop Interface

If you want to set up a hyperloop interface to enable VXLAN Routing on a Cumulus device equipped with Tomahawk so it supports Routing In and Out of Tunnels (RIOT) you must change the device profile used in the managed device.

Editing Pristine Config

Warning

The Pristine Config should never be modified directly unless there is no alternative. Changes are not validated. Contact Apstra Global Support for assistance as needed.

Modifying Pristine Config is a local operation, and does not lead to a change to the running device configuration. Changes are applied on the next full config push. Persistent changes to a configuration are best applied with configlets.

  1. From the AOS web interface, navigate to Devices / Managed Devices and select the Device Key of the device.
  2. Click the Pristine Config tab (top-left), then click the Edit pristine config button (under running-config on the left).
  3. Make your changes.
  4. Click Update to apply the changes.
_images/pristine_update_1.png

Updating Pristine Config from Device

It is also possible to update (customize) the pristine config by copying the running device configuration. To use this function, the device should be out of service (OOS-READY or OOS-MAINT). Once you have your device in OOS state, please make sure that all the necessary changes are done manually via CLI on the device before updating pristine config from the device.

  1. Unassign the device from the blueprint.
  2. Make any necessary changes to the running device configuration via CLI.
  3. From the AOS web interface, navigate to Devices / Managed Devices and select the Device Key of the device.
  4. Click the Pristine Config tab (top-left), then click the Update From Device button (top-right).
  5. Click Update to update Pristine Config from the device.
_images/pristine_update_4.png

Note

After the “Update From Device” operation, please verify the Pristine Config again. As you have copied the running config of the device in OOS state which should be the device “Discovery-1” config, it may include additional configuration such as interface “speed” commands. You can edit Pristine Config again and delete those additional configuration manually. Contact Apstra Global Support for assistance as needed.

Deleting System(s)

Important

Devices that have been acknowledged cannot simply be deleted - as there is still an active agent on the device talking to the AOS server, they would re-appear within seconds. For details on removing a device from AOS, see the device guides.

After decommissioning a device and uninstalling its agent, remove it from the managed devices list.

  1. From the AOS web interface, navigate to Devices / Managed Devices and select the device(s) to remove.
  2. Click the Delete system(s) button, then click Confirm to remove the device(s) and return to the list view.

Managed Device Telemetry

  1. From the AOS web interface, navigate to Devices / Managed Devices and select the Device Key of the device.
  2. Click the Telemetry tab (top-left), then click a tab to see the relevant telemetry.

From the Config tab, you can Apply Full Config or Accept Changes, as applicable. You can also apply full config from the blueprint that it’s used in. See Configuration Deviation for more information about when to apply a full config.