Adding an agent to the project for running tests

If you have performance tests that distribute workload across different workstations or Accelerated Functional Testing (AFT) Suites that need to run on different platforms and browsers, you can add HCL OneTest Performance Agents to your projects to run tests on remote workstations.

Before you begin

You must have completed the following tasks:

  • Read about the considerations that you must take into account before you configure a test run to run on a remote agent. See Test run considerations for running tests on remote agents.
  • Been assigned the Owner or Tester role in the project to which you want to add the agent.
  • Owned at least one agent that is not added to the project.

About this task

When you configure the agent to connect to the server, you must specify an offline user token. This token defines your ownership over the agent. Only you can add or remove this agent from the project. However, any member of your project with the permission to run the tests can initiate the run of the performance schedule and AFT Suites that are associated with the agent.


  1. Log in to HCL OneTest Server, open your project, and go to the Infrastructure page.
  2. Click Add Agents.

    The agents that you configured with your user token are displayed.

  3. Select the agents that you want to use and click Add.

    The agents that you added are displayed.

  4. Perform the following steps to view details and capabilities of the agents:
    1. Expand the agent to view the details panel.
      You can find the following details of the agent displayed:
      Parameter Description
      Version The version of the installed agent.
      Address The IP address of the computer on which the agent is installed.
      License type The license type that is enabled for you to use the agent.
      Load generation service The status of the agent whether it can be used for load generation service.
      Last contact The time of the last contact with the agent by HCL OneTest Server.
    2. Expand the capabilities panel to view the system and application capabilities.
      You can find the following capabilities of the agent displayed:
      Capability Description
      System capabilities Architecture The architecture of the CPU processor of the computer on which the agent is installed.
      Operating system The operating system of the computer on which the agent is installed.
      RAM The memory that is allotted to RAM in the computer on which the agent is installed.
      Application capabilities Browser The browsers along with their version that are installed on the computer on which the agent is installed.
    3. Check for the status of the agent from the Status column.
      Note: You can add agents that are in any state to the project. However, the agent must be in the Ready state for you to select the agent as the location for running the test.


You have added remote agents to your project.

What to do next

You can run the tests on the agent that is added to the project from the Execution page. See Test run configurations.