request services paa install
Syntax
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 The |
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 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:
<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)
request services paa install (first-time installation)
user@host> request services paa install cc-account my_account cc-host host cc-user user@domain cc-password $1234abc ta-version 4.0.0.29 ta-name my_test_agent cc-port 6800
PAA installation files copied from 10.83.153.119. Starting docker daemon. Created symlink /etc/systemd/system/extensions.target.wants/docker@vrf0.service -> /lib/systemd/system/docker@.service. Starting PAA test agent process. Loaded image: paa/test-agent-application:4.0.0.29 Setting environment. 459d83560855faa6bae16873d3753344f252cb5cd860f790228cf53d5e0ff046 Done. Starting the test agent with environment file /var/opt/paa.env
request services paa install (subsequent upgrade)
user@host> request services paa install cc-account my_account cc-host host cc-user user@domain cc-password $1234abc ta-version 4.0.0.36 ta-name my_test_agent cc-port 6800
PAA installation files copied from 10.83.153.119. Starting docker daemon. Starting PAA test agent process. Loaded image: paa/test-agent-application:4.0.0.36 Setting environment. A0c12feaddb312fd2fe3625a659304a448e9eeac4767d2eccd7749bc6f24e8ca Done. Starting the test agent with environment file /var/opt/paa.env
Release Information
Command introduced in Junos OS Evolved Release 22.3R1.
Command deprecated in Junos OS Evolved Release 23.4R1. Replaced by the
test-agent
configuration statement at the [edit services paa] hierarchy
level.