Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Managed Devices

Apstra software uses device system agents to manage devices. These agents manage configuration, device-to-device communication and telemetry collection. You can use Apstra Zero Touch Provisioning (ZTP) to install agents and bring devices under Apstra management or you can use the device installer.

CAUTION:

A good understanding of the Apstra device configuration lifecycle is essential. Before working with devices in the Apstra environment, we strongly recommend that you fully understand how devices are configured from the moment they are on-boarded to the moment they are decommissioned.

From the left navigation menu in the Apstra GUI, navigate to Devices > Managed Devices to go to the table of those devices with installed agents.

Juniper Apstra Managed Devices UI showing device management options and details like IP, hostname, state, and OS version.

The Managed Devices page is the hub for many device-related tasks, described in later sections. Managed Devices interface showing action buttons for device management, a device info table with details like IP and OS version, and navigation options.

Click a management IP to go to details for its device, agent, pristine config and telemetry as shown below.

Device

The device detail view shows the user config, the device status and other facts about the device. From the device detail page you can edit and delete the device. You can also edit or delete a device from the table view or any of the other detail views (Agent, Pristine Config, Telemetry).

Here's an example of a managed NVIDIA GPU Server. Device management interface screenshot showing detailed information about a managed device. Sections include User Config with Active Device Profile Nvidia_DGXH100_BRU_B4-000 and Admin State Normal; Status with State IS-READY and online status Yes; and Facts with Serial Number 525400A4A271, Management IP 10.29.51.18, Vendor NVIDIA, Hardware Model DGXH100, OS Family Ubuntu GNU/Linux, and OS Variant 18.04 LTS.

Agent

Apstra device system agents handle configuration management, device-to-server communication, and telemetry collection. If you're not using Apstra ZTP to bootstrap your devices (or if you have a one-off installation) you can use this device installer to automatically install and verify devices. Depending on the device NOS, you can install device agents onbox (agent is installed on the device) or offbox (agent is installed on the Apstra server and communicates with devices via API). For support information, see the Device Management section of the Apstra 5.1.0 Feature Matrix.

The device agent view shows the agent config, agent status, last job status, jobs history and telemetry status. From the agent detail page you can perform various tasks similar to tasks in the table view. For example, you can restore a device's pristine configuration by clicking the Revert to Pristine Config button (as of Apstra version 4.0.1) as long as the device is not assigned to a blueprint.

Network management interface showing device IP 10.29.61.11, agent type OFFBOX, connected state, last job INSTALL success, and Junos platform running version re0: 21.4R3.15.

The device agent view shows the agent config, agent status, last job status, jobs history and telemetry status. From the agent detail page you can perform various tasks similar to tasks in the table view. For example, you can restore a device's pristine configuration by clicking the Revert to Pristine Config button (as of Apstra version 4.0.1) as long as the device is not assigned to a blueprint.

Web interface screenshot showing device configuration with tabs for Device, Agent, and Telemetry. Displays device address 10.29.51.18, profile Nvidia GPU Server_Profile, operation mode Telemetry Only, and status info like System ID 525400AA0271, Aptron Version 4.00.152, state SUCCESS, and platform ubuntu 18.04. Includes job history with Job ID 1 and state SUCCESS.

Pristine Config

The pristine config view shows the pre-Apstra configuration on the device. You can edit the pristine config manually or update it directly from the device. You can edit and delete the device. You can also edit or delete the device from the table view or any of the other detail views (Device, Agent, Telemetry).

Configuration interface for a network device showing tabs like Device, Agent, Pristine Config, and Telemetry. Pristine Config tab selected with a configuration file for version 21.4R3.15. Buttons labeled Revert to Pristine and Update From Device suggest managing the configuration. Tooltip visible for editing pristine config.

Telemetry

The telemetry view shows telemetry for the device. For more information, see Telemetry Services. Network management interface showing telemetry data for device IP 10.28.52.15; all tabs have green checkmarks; no issues detected.

This telemetery view show telemetry for the GPU server, Telemetry interface for device IP 10.29.51.18. Anomalies tab shows no anomalies detected. Tabs: Interface, LLDP, Hostname, Counters, Utilization, Collection Statistics.