Adding agents to projects to run tests on remote workstations

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:

  • Configured the agent with your offline user token to connect to HCL OneTest Server. The agent can be connected to both the server and desktop clients.
  • Associated the agents with the performance schedule in HCL OneTest Performance.
  • Specified the host name of the remote workstation in the AFT XML file.
  • To run suites or tests that contain Web UI tests on the agent, you must have started the command prompt by using the Run as Administrator option, and then started the agent by running the command, majordomo.bat.
  • Assigned yourself 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.


To add agents to the project:

  1. Log in to HCL OneTest Server and go to the Agents 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.

What to do next

You can run the tests from the Execution page.