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 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 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 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 you want to add to the project from the agents displayed.


You have added remote agents to your project.

What to do next

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