Adding an agent to a project

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

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 click Manage > Infrastructure to go to the Infrastructure page.
  2. Click Add > Add agent.

    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.
      User Defined capabilities User defined The capabilities that you add for an agent. You can also tag an agent so that you can identify the agent to select as a location.
    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.


You have added remote agents to your project and viewed the agent capabilities displayed for each agent that you own.

What to do next

You can perform any of the following tasks:
  • Run the tests on the agent that is added to the project from the Execution page. See Test run configurations.
  • Define the capabilities that you want to add, and then view, edit, or delete the capabilities that you defined for the agents in your project. See Working with agent capabilities.