close

keyboard_arrow_left

Table of Contents Expand all

list Table of Contents

English

request services paa install

date_range 15-Dec-23

arrow_backward

arrow_forward

Syntax

content_copy zoom_out_map
request services paa install 
cc-account account 
cc-host host 
cc-user user@domain 
cc-password password 
ta-version version 
ta-name name 
cc-port port 
<cc-insecure> 
<ta-debug>

Description

Install the Paragon Active Assurance (PAA) test agent. Junos OS Evolved Release 22.3R1 supports installing test agents for PAA 4.0 and later. This command fetches the PAA test agent software image from the PAA Control Center for you and installs the software into a Docker container.

Before issuing this command, make sure you have an HTTPS connection to the PAA Control Center (port 443 is open) and either port 6800 or a port of your choosing is open to connect the test agent with the PAA Control Center. In the PAA Control Center, make sure your SSL certificate is correct on both ports, and both are either secure or self-signed. Also, configure 127.0.0.1 as the loopback address (lo0.0) on the router. For more information about loopback addresses and how to configure them, see Loopback Interfaces (Junos OS Evolved).

Options

cc-account `account`	(Required) Your PAA Control Center user account.
cc-host `host`	(Required) IP address or DNS host name of the PAA Control Center.
cc-user `user@domain`	(Required) The email address registered with the PAA Control Center.
cc-password `password`	(Required) Your PAA Control Center password. The password is passed as-is from the router to the PAA Control Center. Special characters must be escaped using the standard escaping scheme for the Linux shell.
ta-version `version`	(Optional) The PAA test agent software version you would like to install. Check the PAA Control Center for the versions available. If not specified, the operating system installs the latest PAA test agent software version.
ta-name `name`	(Optional) The name you want to use to refer to this PAA test agent. When upgrading the test agent, make sure to use the existing `ta-name`. The default is the router's hostname. The `ta-name` is used to identify the test agent in the PAA Control Center, and PAA won’t allow two test agents with the same name to run at the same time.
cc-port `port`	(Optional) Port over which the router can communicate with the PAA Control Center. The default is port 6800. Make sure the port you specify here (or port 6800 if taking the default) is open.
cc-insecure	(Optional) Allow an insecure connection between the test agent and the PAA Control Center. In other words, disable SSL certificate checking and use self-signed SSL certificates.
ta-debug	(Optional) Enable debug log files for test agent operation. Specify this option if you want to see some debug-level log messages if something goes wrong with the installation. This option also allows you to collect debug-level messages about test agent operation after a successful install. To see these logs, use the `docker logs` command at the shell prompt: user@host> `start shell` user@host:~$ `export DOCKER_HOST=unix:///run/docker-vrf0.sock` user@host:~$ `docker logs paa_agent`

Additional Information

You can also use NETCONF to install the PAA test agent:

content_copy zoom_out_map
 
 <rpc>​
    <install-paa-ta>​
      <cc-host>host</cc-host>​
      <cc-account>account</cc-account>​
      <cc-user>user@domain</cc-user>​
      <cc-password>password</cc-password>​
      <ta-version>version</ta-version>​
      <cc-port>port</cc-port>​
      <ta-name>name</ta-name>​
      <cc-insecure></cc-insecure>​
      <ta-debug></ta-debug>​
    </install-paa-ta>​
  </rpc>​
  ]]>]]>​

Required Privilege Level

maintenance

Sample Output

request services paa install (first-time installation)
request services paa install (subsequent upgrade)