About the Test Agent-Name Page

Tasks You Can Perform

You can perform the following tasks from this page:

• View the connection (Online and Device Online) status of the configured Test Agent.

• View the total number of Test Agents that are in-use.

• View the total number of events generated by the Test Agent.

• View the installation status of the Test Agent on the device.

• View the Test Agent Gateway Hostname (IPv4 and IPv6) addresses.

• Commit configuration changes—You can apply all the configuration changes you have made for the global (management and NTP interfaces) and network interfaces by using the Commit Changes button. To apply the configuration changes made in the Configuration accordion and Interfaces tab:

  1. Click the Commit Changes button.

     A Create New Commit page appears.

     You can also enable the toggle button to automatically rollback if the commit fails.

  2. Click Commit to apply configuration.

     You are taken to the Commit page where you can view the commit status, settings, details, and full interface configuration details. An alert appears displaying the progress of your commit on the top of the Test-Agent-Name page.

• Discard configuration changes—You can discard all the configuration changes you have made for the global (management and NTP interfaces) and network interfaces by using the Discard Changes button. To discard the configuration changes:

  • Click the Discard Changes button.

    A Discard all pending configuration changes page appears asking you to confirm the discard operation on all pending configuration changes.

  • Click Discard Changes.

    A message is displayed confirming that you have successfully discarded the changes.

• View configuration history—You can view the history of configuration changes that were applied to Test Agent Appliance. Click the Commit history button and a Test Agent Config Commit History page appears with a list of configuration changes displaying the status. status message, the user address of the person, timestamp, and so on. From this page, you can also apply or discard configuration changes.

• Upgrade a Test Agent Appliance—You can upgrade a Test Agent Appliance to its latest software version.

  To upgrade a Test Agent Appliance:

  1. Click More > Upgrade.

     A Test-Agent-Appliance Upgrade page appears asking you for a confirmation on upgrade.

  2. Click Upgrade to confirm the upgrade operation.

     The Test Agent Appliance you selected upgrades to the latest version, and you can track the progress on the Software accordion of the Overview tab (Inventory > Active Assurance > Test Agents > Test Agent Details page > Overview).

  Warning: When you upgrade a Test Agent Appliance, the Test Agent Appliance goes offline and all active measurements related to Test Agent Appliances are disrupted.

• Reboot a Test Agent—You can reboot Test Agent Appliance.

  To reboot a Test Agent Appliance:

  1. Click More > Reboot.

     A Reboot Test Agent Appliance page appears asking you for a confirmation the reboot operation.

  2. Click Yes to confirm the reboot operation.

  Warning: When you reboot a Test Agent Appliance, the Test Agent Appliance goes offline and all active measurements related to Test Agent Appliances are disrupted.

• Delete a Test Agent—To delete a Test Agent:

  1. Click More > Delete.

  2. Click Yes to confirm the delete operation.

     A message is displayed confirming that the Test Agent is deleted successfully.

     Note:

     If you delete a Test Agent, the Tests that are associated with this Test Agent fail and the Monitors that are associated with this Test Agent stop running.

• View the following tabs:

  • Overview Tab—You can view the connection status, the location of the Test Agent, system information to troubleshoot issues, statistics of the interfaces of the Test Agent, Test Agent upgradation details, and you can also configure the global (management and NTP interface) and network interfaces of Test Agent Appliances. For more information, see Overview Tab.

  • Interfaces Tab—You can view the interface details relevant to the Test Agent such as IPv4 and IPv6 addresses, interface names, and their descriptions. In addition, you can configure interfaces details and state. For more information, see Interfaces Tab.

    Note:

    If the Test Agent is offline, Paragon Automation displays the details of interfaces, system information, and location status that were retrieved when the Test Agent was online.

• Download & Run Tab—You can view the Test Agent installation instructions.

  • For Test Agent Application—You can generate and copy the secret key as well as the commands to download, install, and run the Test Agent Application in a Docker environment.

  • For Test Agent Appliance—You can view and copy the cloud-init configuration to set up Test Agent Appliance on various virtualization platform. For more information, see Download & Run Tab.

Overview Tab

You can access the Overview tab on the Test-Agent-Name (Inventory > Active Assurance > Test Agents > Test-Agent-Name) page.

In the Overview tab, you can:

• View the identity and location, the system information of software environment, and the interface statistics of the Test Agent. In addition,you can view the configuration and software upgradation details of Test Agent Appliances.

  By default, all accordions are expanded in the Overview tab. You can also click to expand and minimize each accordion to view the following information:

  • Identity & Location—Click and expand the Identity & Location accordion. In this accordion, you can view the following information:

    • Metadata—View and edit the name, description, and tags of the Test Agent.

    • Location—View the site details of a Test Agent and assign the Test Agents to a site. To assign a Test Agent to a site:

      1. Click the Edit (pencil) icon near the site name.

         The Assign Test Agents to Site page appears displaying the details described in Table 3.

      2. Select a site that you want to assign from the available list.

      3. Click OK.

         A message confirms that Paragon Automation has successfully updated the site.

         Note:

         You can assign a Test Agent to a site only if the Test Agent is not installed on any devices. For the Test Agent installed on a device, the site is pre-populated with the location of that device. To update the site information of a device, see About the Sites Page

         .

    • Test Agent—View the ID, created and updated details, last connect time, and last disconnect time of the Test Agent. You can also copy the ID of the Test Agent.

    • Device—View the ID, name, model, MAC address, and installation state of the device on which you have associated the Test Agent. You can also copy the ID of the device.

  • Configuration—Click and expand the Configuration accordion to view the following information on global interface configuration:

    • Management interface configuration—View the list of network interfaces used for managing Test Agent Appliance. You can select the desired interface from the list of interfaces.

    • NTP interface configuration—Select the network interface to synchronize the time of Test Agent Appliance with NTP server. You can:

      • Enable the Same as Management Interface toggle button if you want to use the management interface for NTP communication.

      • Enable the Enable IPv6 for NTP toggle button to support IPv6 for NTP synchronization.

      • Specify IP address of NTP servers for time synchronization.

    • NTP Stats—View status of time synchronization. The statuses include reachability, poll interval, last received time, and so on.

  • Software—Click and expand the Software accordion to view the following information on software upgradation of Test Agent Appliance:

    • Device—View the type and vendor of the device. By default, the type is Appliance.

    • Versions—View the sofware version details such as current version, upgradation status of Test Agent Appliance. In addition, you can also upgrade Test Agent Appliance to the latest available version.

  • Interfaces—Click and expand the Interfaces accordion to display the following information on the interfaces:

    • Number of interfaces.

    • Number of interfaces that are online.

    • Number of interfaces that are offline.

  • System Information—Click and expand the System Information accordion to view the information related a Test Agent as described in the Table 2.

    Table 1: Fields on the NTP Stats Section

    Field	Description
    Status	Displays the current synchronization status of the NTP server. For example, reachable, unreachable.
    Address	Displays the IP address of the NTP server.
    Stratum	Displays the number of hierarchical hops between server and the reference clock. Lower the stratum number, higher the accuracy. For example, Stratus 2 indicates that the server is 2 hops away from the clock and accuracy is low compared to stratus 1
    Poll interval	Displays the interval between consecutive requests that Test Agent Appliance sends to the NTP server. Low poll interval indicates connection issues and long poll interval indicates that the synchronization is stable.
    Reach	Displays the number of recent successful NTP requests.
    Last RX	Displays the number of polling intervals since the last successful NTP response. Low RX value indicates that Test Agent recently synced with NTP server and high RX value indcates network or server issues.

    Table 2: System Information Fields of a Test Agent

    Field	Description
    Agent Version	Displays the software version of the Test Agent. For example, 4.3.0.18
    Hostname	Displays the hostname of the device on which the Test Agent is installed.
    Kernel Version	Displays the kernel version of the Test Agent software.
    Architecture	Displays the software architecture and its operation mode in the device. For example, x86_64.
    Bios Version	Displays the BIOS version of host device.
    System Manufacturer	Displays the manufacturer of the host device. For example, Juniper.
    System Product Name	Displays the product name of the host device. For example, ACX7024
    System Version	Displays the version number of the OS running on the host device. For example, 23.2R1.15-EVO.
    Processor Manufacturer	Displays the manufacturer of the processor available on the host device.
    Processor Version	Displays the version number of the processor available on the host device.
    Management Interface	Displays the name of the management interfaces that the Test Agent uses to communicate with Paragon Automation. For example, re0:mgmt-0.0.
    Management Address	Displays the IP address of the management interface that the Test Agent uses to communicate with Paragon Automation. For example, 10.48.54.198.

  Table 3: Fields on the Assign Test Agents to Site Page

  Fields	Description
  Name	Displays the name of the site.
  Country	Displays the country where the site is located.
  Timezone	Displays the time zone of the site.
  Address	Displays the address of the site.
  Notes	Displays additional information about the site.

Interfaces Tab

You can access the Interfaces tab on the Test-Agent-Name (Active Assurance > Test Agents > Test-Agent-Name) page.

In the Interfaces tab, you can:

• View details of interfaces—View the general information such as the name and the IP addresses of all the interfaces associated with Test Agent as described in the Table 4.

• Configure an interface—Specify the interfaces details and view interfaces state.

  You can also set the interface as management interface and set the interface as NTP source for Test Agent Appliances.

  Note: You can only configure interfaces for Test Agent Appliances. For Test Agent Applications, you can only view the details related to the state of interfaces.

• You can also perform the following tasks on this page:

  • Sort, resize, or re-arrange columns in a table (grid).

  • Show or hide columns in the table or reset page preferences, using the vertical ellipsis menu.

  • Filter the data displayed in the table—Click the filter icon (funnel) and select whether you want to show or hide advanced filters. You can then add or remove filter criteria, save criteria as a filter, apply or clear filters, and so on. The filtered results are displayed on the same page.

Download & Run Tab

• For Test Agent Application:

  You can access the Download & Run tab on the Test Agent Details (Active Assurance > Test Agents > Test-Agent-Application-Name) page.

  On the Download & Run tab, you can:

  • View the following information required to configure the Test Agent Application:

    • Version—You can view the version of the Test Agent Application. By default, the version number is pre-populated with the latest version of the Test Agent Application.

    • Secret—You can view, copy, and regenerate the unique secret key required to authenticate and install the Test Agent Application in the Docker environment.

    • Command to Download, Run & Install—You can view and copy the commands required to download, install, and run the Test Agent Application in the Docker environment. The commands are added to the Command to Download, Install & Run text box based on the check boxes you select. The available check boxes are:

      • Include download instruction—Displays command required to download the Test Agent Application.

      • Include run instruction—Displays command required to run the Test Agent Application.

      • Include debug logs—Displays command required to generate the debug logs while running and installing the Test Agent Application.

      • Ignore SSL certificates—Displays command required to ignore the SSL certificate verification in the Docker environment.

  • Regenerate the secret key—You can regenerate the secret key by clicking the Regenerate button. Every time you regenerate, a new authentication secret is generated.

    By using the Secret key, you can reuse an existing Test Agent registered with Paragon Automation. Reusing the secret key allows the Test Agent to function from a different location while remaining a part of active measurements. To be a part of active measurements, you must use the same container identity.

    If you regenerate a secret key, you must reconfigure all linked measurements and Test templates. Also, you cannot regenerate a secret if the Test Agent associated is online and connected.

    Note:

    A secret key is a unique key used to authenticate the Test Agent Application in a Docker environment. The secret key allows only the authorized Test Agent Applications to communicate with Paragon Automation and prevents unauthorized access. The secret key is displayed only once. You cannot view the same secret key if you return to the Download, Install & Run Tab later.

    As you cannot view the secret key more than once, you need to use the Regenerate button and generate a new secret key.

  • Copy the secret key—You can copy the secret by using the Copy button. You can copy them to clipboard and execute the key in the Docker environment while installation of the Test Agent Application.

  • Copy the commands—You can copy the commands to download, install, and run the Test Agent Application by using the Copy button. You can copy them to clipboard and execute the commands in the Docker environment.

    When you execute the commands from the Docker environment, the Test Agent Application is downloaded and installed into a Docker environment. The secret key authenticates the Test Agent Application and establishes a secure connection with Paragon Automation. Paragon Automation now discovers the Test Agent Application and displays the status as Online.

• For Test Agent Appliance:

  You can access the Download & Run tab on the Test Agent Details (Active Assurance > Test Agents > Test-Agent-Appliance-Name) page.

  On the Download & Run tab, you can:

  • View the following information required to configure the Test Agent Appliance:

    • Secret—You can view, copy, and regenerate the unique secret key required to authenticate and install the Test Agent Appliance on virtualization platforms.

    • Command to Download, Run & Install—You can view and copy the Cloud-init configuration used to setup Test Agent Appliance on various virtualization platforms. The commands are updated on the Cloud-init configuration text box based on the check boxes you select. The available check boxes are:

      • Include examples—Displays references of various possible ways to customize the Test Agent Appliance.

      • Ignore SSL certificates—Displays command required to ignore the SSL certificate verification on virtualization platforms.

  • Regenerate the secret key—You can regenerate the secret key by clicking the Regenerate button. Every time you regenerate, a new authentication secret is generated.

    Note:

    A secret key is a unique key used to authenticate the Test Agent Appliance on virtualization platforms. The secret key allows only the authorized Test Agent Appliances to communicate with Paragon Automation and prevents unauthorized access. The secret key is displayed only once. You cannot view the same secret key if you return to the Download, Install & Run Tab later.

    As you cannot view the secret key more than once, you need to use the Regenerate button and generate a new secret key.

  • Copy the secret key and cloud-init configuration—You can copy the secret by using the Copy button beside the Secret text box. You can copy them to clipboard and execute the key in the virtualization platform while installation of Test Agent Appliance.

    You can copy the cloud-init configuration used to setup Test Agent Appliance by using the Copy button on the bottom-right of the text box. When you use the cloud-init configuration on any virtualization platform, you register the Test Agent Appliance with Paragon Automation. The secret key authenticates the Test Agent Application and establishes a secure connection with Paragon Automation. Paragon Automation now discovers the Test Agent Appliance and displays the status as Online.