Installing resource monitoring agents on remote hosts

You must install the resource monitoring agents on the target host for which you want to monitor the performance statistics. You need to run the agents to establish a connection with the resource monitoring service.

Before you begin

  • The resource monitoring service does not require access to the agent host but the agent must have reached the service host over HTTPS.
  • The Java agent must have been launched from a jar file and requires a Java 8 virtual machine.
  • The Docker agent must have been launched in a Docker container and requires Docker 19.03.

About this task

This task applies to Java and Docker agents. However, the commands used to install agents are different from Java and Docker agents. You can find the commands and instructions in IBM® Rational® Test Automation Server in the resource monitoring agents page.

Before you start the Docker agents, you must build a Docker image.

Procedure

  1. Click Set up Agents to extend Resource Monitoring service link in IBM® Rational® Test Automation Server to access the agents page where you can find the instructions and commands that are to be used to install and run the agents. Link to instructions about how to extend RM service with agentsinstructions about how to configure a docker agent
  2. Expand Configure the Java agent and click Download jar file to download the Java agent, or expand Configure the Docker agent and click Download Docker file to download a Docker agent.
    You can also use the curl and wget commands to download the agent without accessing the resource monitoring web UI. For more facility, use the code snippets to copy and fill in the commands with the valid offline token and the jar or docker file name. 
    curl -O -J https://hostName/rm/Agent-jar
wget --content-disposition https://hostName/rm/Agent-jar
  3. Copy the build command that is under Build the Docker image, paste it in your console and run it to build a resource monitoring Docker image. 
    docker build --network=host --rm -t rmagent
    Note: This step applies to Docker agents only.
  4. Configure the command as follows to run your agent:
    1. Copy the appropriate command for Windows or Linux with the code snippets.
    2. Enter the path to the directory that contains the agent .jar file, and paste the command.
    On Windows:
    set RTCP_OFFLINE_TOKEN=(Enter your offline token here)
java -jar (Enter the name of the downloaded jar file here) --ServiceUrl=https://hostName/rm --projectId=<project_id>
    On Linux:
    sudo RTCP_OFFLINE_TOKEN=(Enter your offline token here) java -jar (Enter the name of the downloaded jar file here) --ServiceUrl=portNumber/rm --projectId=<project_id>

Results

When the agent is started, the agent is connected to IBM® Rational® Test Automation Server. The agent is displayed in the list of connected resource monitoring agents with the host name and status of the agent. The agent is also added to the main page of the resource monitoring service in IBM® Rational® Test Automation Server.view of total and type of sources, agents added to a project

What to do next

You can add a new resource monitoring source. It can be collected from a service or from the named agents, depending on the capabilities supported by the environment.