Adding a performance agent to a project

Edit online

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 IBM® DevOps Test Performance Agents to your projects on IBM DevOps Test Hub (Test Hub) to run tests on remote workstations.

Before you begin

You must have completed the following tasks:

Read and completed the tasks mentioned in Test run considerations for running tests on remote performance agents, if you want to use a remote agent as the location to run the test.
Ensured that you are assigned a role as a Member or Project Creator in the team space. See Managing members and their roles in a team space.
Ensured that you are assigned a role as a Project Owner or Tester in the project. See Managing access to the server projects.
Installed the agent by using your offline user token, which makes you the owner of the agent, or you are assigned the role of a Team Space Owner.

About this task

Only you can add or remove a performance agent that you own from the project. However, any member of your project with the permission to run the tests can initiate the run of test assets that are associated with the performance agent.

Procedure

Log in to Test Hub.
The Projects page of the initial team space is displayed.
Open your project, and then click Infrastructure > Agents and Intercepts.

The Agents and Intercepts page is displayed.
Click Add > Add performance agent.

The performance agents that you configured with your user token are displayed.
Note: You can add the performance agents that you own and that are in the Ready state. You can add any number of performance agents to your project.
Select the performance agents that you want to use in the project, and then click Add.

The performance agents that you added to the project are displayed.

Perform the following steps to view details and capabilities of the performance agents:

Expand the performance agent to view the details panel.

You can find the following details of the performance agent displayed:


Parameter	Description
Version	The version of the installed performance agent.
Address	The IP address of the computer on which the performance agent is installed.
License type	The license type that is enabled for you to use the performance agent.
Load generation service	The status of the performance agent whether it can be used for load generation service.
Last contact	The time of the last contact with the performance agent by Test Hub.

Expand the capabilities panel to view the system and application capabilities.

You can find the following capabilities of the performance agent displayed:


Capabilities		Description
System capabilities	Architecture	The architecture of the CPU processor of the computer on which the performance agent is installed.
	MAC Address	The MAC address of the computer on which the performance agent is installed.
	Operating system	The operating system of the computer on which the performance agent is installed.
	RAM	The memory that is allotted to RAM in the computer on which the performance 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 a performance agent. You can also tag a performance agent so that you can identify the performance agent to select as a location.

Check for the status of the performance agent from the Status column.

Note: You can add performance agents that are in any state to the project.

Results

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

What to do next

You can perform any of the following tasks:

Run the tests on the performance 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 performance agents in your project. See Working with the capabilities of a performance agent.