Home
Test Execution Specialist Guide
This guide describes tasks that you must complete before you can configure and run tests in HCL OneTest™ Server. You can find information about configuring runs for the different test types that are supported. You can also find information about other tasks that you can perform on the Resource Monitoring Service, Virtualization, and Integrations with third-party applications. This guide is intended for testers or test execution specialists.
Agents overview
You can find information about the agents that you must install on remote computers and configure the agents with the offline user token so that the agents register with HCL OneTest™ Server. After the agents are registered, you can add them to your projects and then select them as locations to run tests.
Viewing agents that are registered with HCL OneTest™ Server
After you install the remote agents and configure them with your offline user token, the agents register with HCL OneTest™ Server and you can view the registered agents on the Agents and Intercepts page.

Test Execution Specialist Guide
This guide describes tasks that you must complete before you can configure and run tests in HCL OneTest™ Server. You can find information about configuring runs for the different test types that are supported. You can also find information about other tasks that you can perform on the Resource Monitoring Service, Virtualization, and Integrations with third-party applications. This guide is intended for testers or test execution specialists.
- System modeling
  In this topic, you can find information about using the system model feature. You can also find the tasks that you can perform to create a system model. You must configure a repository to save the system model that you created for the application under test.
- Prerequisites to running tests
  Before you can configure and run a test in a project on HCL OneTest™ Server, you must read the information about the different tests. You might want to add a remote static agent or a remote Docker host to the project as an alternate location to run the tests.
- Agents overview
  You can find information about the agents that you must install on remote computers and configure the agents with the offline user token so that the agents register with HCL OneTest™ Server. After the agents are registered, you can add them to your projects and then select them as locations to run tests.
  - Test run considerations for running tests on remote agents
    Before you configure a test to run on a remote agent from HCL OneTest™ Server, you must read the considerations that you must take into account.
  - Viewing agents that are registered with HCL OneTest™ Server
    After you install the remote agents and configure them with your offline user token, the agents register with HCL OneTest™ Server and you can view the registered agents on the Agents and Intercepts page.
  - 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.
  - Working with agent capabilities
    When you have installed static agents V10.1.2 or later, and added them to your project, you can view capabilities of the agents from the Infrastructure page. When you have installed static agents V10.1.3 or later, you can add, view, edit, or delete capabilities of agents from the User Defined panel of that agent.
- Managing Docker hosts
  You can find information about the tasks that you can perform on remote Docker hosts. After you set up a remote Docker host, you can register the Docker host with HCL OneTest™ Server. You must add the registered remote Docker host to your project before you can run tests on the remote Docker host location.
- Test run configurations
  You can configure and run tests in HCL OneTest™ Server after you add the test resources to your project.
- Management of running tests
  Find information about the tasks that you can perform on a test that you configured for a run either while it runs or after it completes the run.
- Management of virtualized services
  You can find information about the tasks that you can perform on and manage the virtualized services that run on HCL OneTest™ Server. You can start or stop the virtual services that are connected to HCL OneTest Server. You can view the routing rules and usage statistics of virtualized services, agents, or intercepts that are connected to HCL OneTest Server.
- Test results
  After the tests or schedules are run and completed, you can view the results and reports in HCL OneTest™ Server to analyze the verdict, the performance, and statistics. You can also re-execute tests and schedules from the Result page with the same commit id.
- Resource Monitoring service
  When you apply load to a system under test, the amount of resources consumed by your system is increasing. If the capacity of the resources does not match the load, you can see performance issues in the results. The Resource Monitoring service in HCL OneTest™ Server helps you monitoring the resources of a system and establish the performance metrics of the system. Thus, you can observe the health of these resources while a schedule is running.
- Configuration of a change management system
  When you use any application to create and track defects (bugs), issues, or other work items, you can configure the application as a change management system on HCL OneTest™ Server. You can then create defects (bugs), issues, or other work items without the need to open your application.
- Integrating with other applications
  You can integrate certain applications with HCL OneTest™ Server to run tests, view the test results, and create defects.
- Managing access to the server
  Desktop clients and third-party integrations use offline user tokens to connect to HCL OneTest™ Server.

Viewing agents that are registered with HCL OneTest™ Server

After you install the remote agents and configure them with your offline user token, the agents register with HCL OneTest™ Server and you can view the registered agents on the Agents and Intercepts page.

Before you begin

You must have completed the following tasks:

Installed the agent of the same version as the version of HCL OneTest™ Server.
Configured the agent with your offline user token so that the agent can register with HCL OneTest™ Server.
Note: When you configure the agent to connect to the server, you must specify the offline user token that you generated on HCL OneTest™ Server. This token defines your ownership over the agent.

Procedure

Log in to HCL OneTest™ Server.
Click Infrastructure > Agents and Intercepts in the navigation pane.

The Agents and Intercepts page is displayed.

You can view the agents, intercepts or Dockers that are registered with HCL OneTest™ Server.
You can view the agents that you own in any of the following ways:
- Search for the agent by entering the name of the agent in the Search field.
  Note: You can enter either the full name or any text that is in the name. The search is enabled for case sensitive text that you can enter.
- Sort the Type column to sort the items and display the agents in the rows at the top of the table.
- Sort the Agents column and identify the agents by their names or by their owner.
You can view the following details about the agents that are registered with HCL OneTest™ Server:
- The projects to which the agent is added, are displayed in the Projects column.
- The status of the agent is displayed in the Status column.
  Note: You can add agents that are in the Ready state to your project, and then use them as locations to run tests.

Results

You have viewed the registered agents from the Agents and Intercepts page.

What to do next

You can add the agents that you own to your project. See Adding an agent to a project.