Install Test Agent Application

SUMMARY The installation topic describes procedures to register the Test Agent using the official container image, build a test agent image, and deploy a native Test Agent application on an x86 machine.

The Test Agent application is a container that you deploy natively in an x86 platform or as a docker container, or as a container in a router running Junos Evolved OS. In this installation procedure, we will explore the steps to deploy Test Agents as a container.

Before You Begin

Before you begin the Test Agent installation, you must:

Ensure to install Docker Engine in your system that runs the latest Ubuntu version.
Ensure that no firewalls are blocking the connection to Paragon Automation on TCP port 6800.

Warning:

We do not recommend installing Test Agents using Junos CLI.

Deploy a Test Agent Using Container Image

To deploy a Test Agent using the container image:

Download the latest image of the Test Agent. You can download the Test Agent software (Test Agent Application (amd64)) from the Software Download page or from the Docker Hub (netrounds/test-agent-application).
Register the Test Agent using the register command. This connects the Test Agent with Paragon Automation. When you run the register command, specify one of the following:
- Specify the email address and password that is used at the time of Paragon Automation installation.
- Specify the organization's UUID. To find your organization's UUID, go to Administration > Settings in Paragon Automation and then copy the organization's UUID.
- Specify the hostname for Active Assurance Test Agent gateway IP address.

Start a Test Agent using the run command:

Build a Test Agent Container Image

Use this procedure to build your own container image. To build a custom Test Agent container image:

Download the latest image of the Test Agent. You can download the Test Agent software (Test Agent Application (amd64)) from the Software Download page.

Unpack the tar file of the Test Agent software by using the following command:

Create a docker file in the directory where you unpacked the Test Agent software. The following docker file copies the Test Agent software to the opt/paa-test-agent-application location and configures the entry point to run the Test Agent software.
Build the docker image by using the docker build command. Replace mycustom in the following command with any name. The name you specify here is the name of the docker that must used going forward.
user@host:~$ docker build -t mycustom/paa-test-agent-application

Start the Test Agent.
Tip:
The --privileged -v and /var/run/netns:/var/run/netns arguments enable Test Agents to use the network namespaces to route the traffic independently.

The A option enables Test Agent to detect all available namespaces and their interfaces.

The log-opt option is used to limit the size and the number of log files generated by Test Agent.

The docker logs <container ID> command enables you to inspect the container log files.

Install a Test Agent as a Native Application in Linux

You can install a Test Agent application natively on an x86 machine.

Download the latest image of Test Agent. You can download the Test Agent software (Test Agent Application (amd64)) from the Software Download page.

Unpack the tar file and install the application by using the following commands.

Start the Test Agent application.
Tip:
The A option enables Test Agent to detect all available namespaces and their interfaces.