Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Appendix: Paragon UI Implementation for Automation JVD

This appendix outlines the steps and procedures for using the Paragon UI to onboard devices, collect statistics on network nodes, and present configuration and operational states. Each step and expected outcome are documented based on the validation workflow conducted for this JVD.

To onboard devices in Paragon Automation GUI, you need to follow a series of steps that involve creating sites, configuration templates, device profiles, network implementation plans, and configuring onboarding commands and service configurations. Let’s see them one by one:

Create Organization

In Paragon Automation, an organization represents a customer. An organization can have multiple sites representing the locations where routers, switches, and firewalls are installed. While a site can have more than one device, a device can be associated with only one site. To apply Life-Cycle Management (LCM) functions on a device, it must be assigned to a specific site. Sites can be grouped based on regions, functions, or other parameters for efficient management of the devices.

An organization can be added from the New Account page when logging in as a superuser or from the organization list (next to the Help icon) on the top right-corner of the Paragon Automation GUI.

Figure 1: Relationship Between an Organization, Sites, and Site Groups in Paragon Automation A diagram of a group of buildings AI-generated content may be incorrect.
Figure 2: New Account Page for Creating Organization as Superuser A screenshot of a phone Description automatically generated
Figure 3: Creating Organization A screenshot of a computer Description automatically generated
Figure 4: Organization Successfully Created A screenshot of a chat Description automatically generated

Create Sites

Create sites that mention the geographical location of the devices to be onboarded. The following figures show all the sites configured in the lab topology and the configuration of a site in detail (for example, Seattle):

Figure 5: Site Creation A screenshot of a map Description automatically generated
Figure 6: All Sites from JVD Organization Created A screenshot of a computer Description automatically generated

Create Configuration Templates

Create a configuration template to configure service configuration of access nodes from Paragon Automation application. The following figures display how to create a configuration template.

Figure 7: Configuration Template Creation A white screen with black text Description automatically generated
Figure 8: CLI Configuration to Load Service Configuration to Access Nodes A close-up of a computer screen Description automatically generated
Figure 9: Save Configuration Template A white background with black text Description automatically generated
Figure 10: Configuration Template Creation Completed A white rectangular object with black text Description automatically generated

Create Device Profiles and Map Configuration Template

Create device profile and map the configuration template to the access node’s device profile. The following figures explain how to associate a configuration template with a device profile.

Figure 11: Device Profile Creation and Configuration Template Mapping A screenshot of a computer Description automatically generated

Create Network Implementation Plan

Network Implementation Plan (NIP) defines which device profile and interface profile should be applied to a device or a group of devices during onboarding. The profiles define which interfaces to configure, which protocols to enable, which IP addresses to assign, and so on.

Paragon Automation maps the serial number of a device during onboarding with the serial number that is included in a particular network implementation plan, corresponding device and interface profiles are then applied to the device.

A plan is created by adding devices, assigning device and interface profiles to the devices, and defining links from the devices to neighboring devices.

Paragon Automation provides an Add Network Implementation page (in a wizard format) that guides you to create the plan. The following figures show how to create a NIP from onboarding dashboard and add all the devices, which are part of the topology.

Figure 12: Navigate to Network Implementation Plan A screenshot of a chat Description automatically generated
Figure 13: Create Network Implementation Plan A screenshot of a computer Description automatically generated
Figure 14: Add Plan Name and Description A screenshot of a computer Description automatically generated

Create a Device under NIP

To create a device under NIP, add device's details like host name, site name (previously created), serial number of the device, and device profile (previously created).

Figure 15: Add Device Specific Details A screenshot of a computer Description automatically generated

Click + to add the device's ports details.

Figure 16: Add Physical Ports Details A screenshot of a computer Description automatically generated
Figure 17: Add Device’s Ports and Descriptions A screenshot of a computer Description automatically generated
Figure 18: Port Details Added Successfully A screenshot of a computer Description automatically generated
Figure 19: Details Added for All the Ports A screenshot of a computer Description automatically generated
Figure 20: Add Chassis Details (PSMs, Fans, Line cards, Pluggable) A screenshot of a computer Description automatically generated
Figure 21: Device Details Added Successfully A screenshot of a computer Description automatically generated
Figure 22: Single Device Details Added A screenshot of a computer Description automatically generated
Figure 23: All Device's Details Added A screenshot of a computer Description automatically generated

After adding all device details, add link details that describe the connection between two devices.

Figure 24: Adding Connection Details Between Device A and Device B A screenshot of a computer Description automatically generated
Figure 25: Complete Network Topology with All Device Connections Added A screenshot of a computer Description automatically generated
Figure 26: Review the Connection Details in the Topology View A screenshot of a computer Description automatically generated
Figure 27: Save the Network Implementation Plan A screenshot of a computer Description automatically generated
Figure 28: Network Implementation Plan Creation Successful A screenshot of a computer Description automatically generated

Onboard Devices

Once NIP is created, onboard all the aggregate, core, and SAG devices manually (remember in this solution, ZTP is limited to access nodes only) by configuring the onboarding commands, selecting the "Add devices" option present on the inventory section for the appropriate sites and pushing their service configurations using Python script from the server. The following figures explain step-by-step procedure to onboard these devices.

Figure 29: Select Onboarding Commands for Each Aggregate, Core and SAG Sites A screenshot of a computer Description automatically generated
Figure 30: Configure the Onboarding Commands Manually on Each Device CLI A screenshot of a computer screen Description automatically generated
Figure 31: Device Details Appear in the Inventory Section A screenshot of a computer Description automatically generated
Figure 32: Device Connected to the Paragon Automation A screenshot of a computer Description automatically generated
Figure 33: All the Devices are Connected to the Paragon Automation A screenshot of a computer Description automatically generated

Configurate Underlay and Overlay for Aggregate, Core and SAG Devices using Python Script

Once aggregate, core, and SAG devices are onboarded, a python script (for example, load_configs.py) is used to push the service configurations saved in the junos-pyez/device_configs/ server directory to all those devices:

Figure 34: Python Script to Push Service Configuration to all the Aggregate, Core and SAG Devices A computer screen shot of a black screen AI-generated content may be incorrect.
Figure 35: YAML File with Device Details and Configuration Details A screenshot of a computer program AI-generated content may be incorrect.
Figure 36: Push Service Configuration from DHCP Server to Aggregate Core and SAG Devices A screen shot of a computer Description automatically generated

Onboard Access Node Devices

Once aggregate, core, and SAG devices are configured, initiate ZTP process from access nodes to onboard.

Initiate ZTP from access nodes (Acquire IP address and copy a python script from VM to access nodes)

For access nodes, initiate ZTP (Zero Touch Provisioning) to acquire an IP address for reachability and transferring the Python script base configuration, and service configuration from the DHCP server to the access node. Transferring Python script from the DHCP server to the access nodes and executing it as part of the ZTP process configures onboarding commands on all the access nodes. During the access node onboarding process, service configuration of the device is configured by executing the configuration template associated with the access node profile.

Figure 37: ZTP Initiated from Access Node A computer screen with white text Description automatically generated

During the ZTP process, an IP address is assigned to each access node so they can be reached. The DHCP options trigger the transfer of a Python script from /tftpboot/ on the DHCP server to the access nodes and execute it on-device. The script initiates FTP transfers of stored base configuration and service configuration files from the server to /var/tmp/ on the access nodes, configures the base configuration, and initiates the onboarding process. The onboard configuration is part of the base configuration stored on the server.

Figure 38: ZTP Completed A screen shot of a computer screen Description automatically generated

After completing ZTP, the access node acquired IP address for reachability and executed python script to transfer the configuration files and configure the onboarding commands on the access nodes.

Figure 39: Access Node Onboarded Successfully A screenshot of a computer Description automatically generated
Figure 40: All Devices Onboarded Successfully A screenshot of a computer Description automatically generated
Figure 41: Detailed Onboarding State from More Option in the Network Implementation Plan Page A screenshot of a computer Description automatically generated

Telemetry Traffic Classification

Observability

Paragon Automation enables comprehensive network observability by collecting telemetry data from devices and systems. This real-time monitoring provides actionable insights into device health, allowing early issue detection.

You can monitor device health and behavior in real-time, gain detailed insights into the individual device components such as hardware and software, and receive alerts and notifications for potential issues before they become major incidents.

Paragon Automation provides a comprehensive overview of various aspects of a device, including its identity and location, remote management details, hardware and interface health, software configuration, and routing information.

This comprehensive overview allows users to quickly assess device details, device location, hardware utilization, interface statistics and errors, software upgrade needs, configuration backups, routing information, and connectivity status, among other key metrics – providing a complete picture of the device's state.

Click the device’s name on the Troubleshoot Devices page to view different accordions as shown in the following figure.

Figure 42: Troubleshoot Devices Page A screenshot of a computer AI-generated content may be incorrect.

Device Identity and Location Details

Use this accordion to view details such as vendor, hostname, and serial number of a device and the name and location of the site where the device is installed. You can add tags to the device and also view the most recent trust score recorded for the device, and alerts and alarms related to the trust score.

Figure 43: Identity and Location Accordion A screenshot of a computer Description automatically generated

Remote Connectivity

Use this accordion to view details of the last outbound SSH and gNMI sessions established or terminated between the device and Paragon Automation as a Service. You can view details about the latest system log and latest alarm that the device generated, and the status of the synchronization between the device’s clock and the NTP server.

Figure 44: Remote Management with Outbound SSH Connectivity for Access Node Established A screenshot of a computer Description automatically generated
Figure 45: gNMI Connectivity for the Access Node Established A screenshot of a computer Description automatically generated

gNMI and Outbound SSH connectivity output for each of the access nodes CLI.

Figure 46: gNMI and Outbound SSH Connectivity Output from AN1 CLI A black screen with white text Description automatically generated
Figure 47: gNMI and Outbound SSH Connectivity Output from AN3 CLI gNMI and Outbound SSH Connectivity Output from AN3 CLI
Figure 48: gNMI and Outbound SSH Connectivity Output from AN4 CLI gNMI and Outbound SSH Connectivity Output from AN4 CLI

Hardware Health

Use this accordion to view data about the number of available and unhealthy chassis components, the KPIs for the components, and the details of temperature sensors. The top-right of the accordion displays the overall health of the device’s hardware components and temperature. Latest events related to hardware performance appear under the Relevant Events section in the order of severity.

Figure 49: Hardware Accordion A screenshot of a computer Description automatically generated
Figure 50: Fan Status within Hardware Accordion in Paragon Automation UI A screenshot of a computer Description automatically generated
Figure 51: Fan Status from Device’s CLI A screenshot of a computer screen Description automatically generated
Figure 52: CPU Status within Hardware Accordion in Paragon Automation UI A screenshot of a computer Description automatically generated
Figure 53: CPU Status from Device’s CLI A computer screen shot of a black screen Description automatically generated
Figure 54: Memory Status within Hardware Accordion in Paragon Automation UI A screenshot of a computer Description automatically generated
Figure 55: Memory Status from Device CLI Memory Status from Device CLI
Figure 56: Temperature Status within Hardware Accordion in Paragon Automation UI A screenshot of a computer Description automatically generated
Figure 57: Temperature Status from Device CLI Temperature Status from Device CLI

Interfaces Health

View the health of the device interfaces monitored by Paragon Automation.

Figure 58: Interfaces Accordion A screenshot of a chat Description automatically generated

Software Life Cycle Management (Upgrades, EOL, Vulnerabilities)

Paragon Automation manages software upgrades/downgrades. It displays the details of the OS installed on the device, a link to the OS documentation, and an option to upgrade the OS. The OS details include the OS version installed on the device, end-of-life information, active licenses, and the number of OS-related SIRT advisories. Software Images can be uploaded from local system via the Paragon application. To upload files larger than 2.5 GB, use the Upload Image REST API, instead of the GUI. In the Paragon Automation User Guide , there is a sample script (see "Sample Script" on page 315) that you can use to upload a software image using the Upload Image REST API.

Figure 59: Software Accordion A screenshot of a computer Description automatically generated

The following figures show a step-by-step guide for a software upgrade. Figure 60 shows a release installed in one of the Access nodes.

Figure 60: Software Image Before Upgrade A screen shot of a computer AI-generated content may be incorrect.

The following figures show how the image is uploaded to Paragon.

Figure 61: Upload Image A screenshot of a computer AI-generated content may be incorrect.
Figure 62: Image Upload In Progress A screenshot of a computer AI-generated content may be incorrect.

Figure 63 shows how the image is successfully uploaded to Paragon.

Figure 63: Image Upload Successful A screenshot of a computer AI-generated content may be incorrect.

The following couple of figures show a selection of a device to perform an upgrade.

Figure 64: Selecting a Device and Navigating to Upgrade Window A screenshot of a computer AI-generated content may be incorrect.
Figure 65: Select Image to Upgrade A screenshot of a computer AI-generated content may be incorrect.
Figure 66: Upgrade Device with Selected Image A screenshot of a computer AI-generated content may be incorrect.
Figure 67: Upgrade Request Successful A screenshot of a computer AI-generated content may be incorrect.
Figure 68: Image Upgrade Started A screen shot of a computer AI-generated content may be incorrect.
Figure 69: Image Upgrade Process Audit Log from Paragon Automation GUI A screenshot of a computer AI-generated content may be incorrect.
Figure 70: Software Image After Device Upgraded Successfully A screenshot of a computer program AI-generated content may be incorrect.

Configuration Management

Paragon Automation manages the lifecycle of devices through various features like configuration backup and restore, comparison of different configuration versions, and deployment of configuration changes. The following figures explain the step-by-step procedure on how a device’s configuration can be backed up and restored.

Figure 71: Backup Device’s Configuration from Configuration Accordion A screenshot of a computer Description automatically generated
Figure 72: Device’s Configuration Backed Up A close-up of a computer screen Description automatically generated
Figure 73: View Backed Up Configuration A screenshot of a computer Description automatically generated
Figure 74: Difference Between Backup and Current Device Configuration A screenshot of a computer Description automatically generated
Figure 75: Select Device to Restore the Configuration A screenshot of a computer Description automatically generated
Figure 76: Restoring Backup Configuration to the Device A screenshot of a computer Description automatically generated
Figure 77: No Difference in Configuration After Restoring the Backup Configuration A screenshot of a computer Description automatically generated

Routing and MPLS Information

This accordion displays the total RIB and FIB routes of the onboarded device and validates that the expected numbers of entries are available in the routing and forwarding tables. It also validates that the peering states of all BGP, OSPF, IS-IS, RSVP, LSP, and LDP neighbors are healthy and without extensive flaps (however, this is out of scope in the current solution, since none of these protocols were configured by Paragon Automation).

Figure 78: Routing and MPLS Accordion A screenshot of a computer Description automatically generated

Device Inventory (Hardware Components)

Use the Inventory tab to view a list of all the hardware components present on the chassis, and the number of associated physical interfaces, information on licenses applied on the device, and the features available on the licenses. You can also view general details about the hardware components such as model, serial, and part numbers. Everything is the same as from the terminal.

Figure 79: Chassis Hardware Details from Paragon Automation UI A screenshot of a computer Description automatically generated
Figure 80: Chassis Hardware Details A screenshot of a computer screen Description automatically generated
Figure 81: Interface Details from Paragon Automation UI A screenshot of a computer Description automatically generated
Figure 82: Interfaces Details A screenshot of a computer program Description automatically generated

Health Dashboard

Use the Health Dashboard page to monitor network health-related data, and average trust score of the targets in the network in real-time. It helps us to view the health of devices, interfaces, routing components, and details of vulnerabilities in the network from this dashboard.

Figure 83: Navigate to Health Dashboard A white rectangular object with black text Description automatically generated

Figure 84 shows average health (in percentage) of devices, and the total number of unhealthy devices. The data displayed for healthy devices is calculated based on the number of devices that have an alert raised divided by the install base. Install base indicates the total number of devices that are available in the network. You can also view the percentage and health of the KPIs, and the total number of unhealthy devices in relation to that KPI that affects device health.

Figure 84: Device’s Health Details A screenshot of a computer Description automatically generated

Figure 85 shows average health (in percentage) of the interfaces of the devices, and the total number of unhealthy devices. View the percentage and health of the KPIs that affect interface health, and the total number of unhealthy devices in relation to that KPI that affects interface health.

Figure 85: Interface Health Details A screenshot of a computer Description automatically generated

Figure 86 shows average routing health (in percentage) in relation to the number of devices, and the total number of unhealthy devices. View the percentage and health of the KPIs, and total number of unhealthy devices in relation to that KPI that affects routing health.

Figure 86: Routing Health Details A screenshot of a computer Description automatically generated

Device Compliance Status

Paragon Automation monitors the devices and software to ensure that they comply with the security rules that are defined in the benchmarking documents applied to the network. Paragon Automation alerts when a device does not comply with the rules in the benchmarks document.

Figure 87: Compliance A screenshot of a computer Description automatically generated

Device Vulnerabilities

The Vulnerabilities page lists all the SIRT advisories that Juniper Networks has published, the devices on the network affected by these advisories, and the common vulnerabilities and exposures.

Figure 88: Vulnerabilities A screenshot of a computer Description automatically generated

Device Integrity

Paragon Automation periodically checks network devices' integrity, comparing them to the latest Juniper Networks hardware and software releases. It notifies when a device or software nears its End of Life (EOL), allowing proactive maintenance and replacement.

Figure 89: Software EOL A screenshot of a computer Description automatically generated
Figure 90: Hardware EOL A screenshot of a computer Description automatically generated