Viewing running agents

Depending on the version of HCL Quality Server that you are using, you have different options for viewing agents that are currently running.

About this task

HCL OneTest™ API Agent engines execute stubs that have been published to HCL Quality Server. A HCL OneTest API Agent engine must be installed on each computer where you want to run stubs and there must be at least one HCL OneTest API Agent engine in an environment. Each HCL OneTest API Agent engine must register with a HCL Quality Server instance so that it can accept requests to run stubs.

Note: You can view the agents and the routing or recording rules if the security settings were enabled for you to view them.

Procedure

  1. Log into HCL Quality Server.

    The application window is displayed.

  2. To view all agents that are registered with the current HCL Quality Server instance, complete the following tasks:
    1. Click the Infrastructure icon or navigation link.

      The Infrastructure Dashboard is displayed. Any HCL OneTest API Agents or proxies registered with visible domains and that are currently running are displayed.

      You can by expanding the card, view the details such as identity, domain and environment, current status, recipient, for each of the agents or proxies. You can also find other details such as capabilities, software version number, configuration file location, system, log file location, ports, and attributes under the Details section for each agent.

      Note: The Identity column shows the Identifier for agents and proxies, that was configured in the agent or proxy configuration file. If not configured, the Identity column displays the host name of the machine that is running the agent or proxy.
    2. Expanding the agent or proxy card displays all the attributes defined for the registered agents or proxies under the Details section.
      The operating system upon which the agents run is the only attribute that is available by default. You can define custom attributes in the following ways:
      • Insert attributes in the <agentAttributes> section of the Agent.config file located in <HCL OneTest API Agent installation directory>\config.
      • If you are using the Ant client, then you can specify a comma-separated list of attributes in the "attributes" property of the <startStub> task element. If you are using the sample start-stop-stub.xml file available in the AntClient.zip tool package, you can set the property in either of the following ways:
        • Open the start-stop-stub.xml file for editing and specify the comma-separated list of attributes against the "attributes" property.
        • On the Ant command line, run the following command: ant -f start-stop-stub.xml -Dattributes=<comma-separated list of attributes>. For example, ant -f start-stop-stub.xml -Dattributes="Windows,My Attribute".
        Note: Starting in version 9.1.1, the Ant Client file was renamed to AntClient.zip from RTCPAntClient.zip.
    3. When HCL OneTest Virtualization agents disconnect, they remain in the Disconnected state until they are removed manually from the Infrastructure Dashboard. They can be removed individually by using the Delete icon displayed for a disconnected agent on the Infrastructure Dashboard. In contrast, HTTP, TCP, and other proxy agents remove themselves from the Infrastructure Dashboard automatically after a minute of being in the Disconnected state.
    4. If any HCL OneTest Virtualization agent reconnects without changing its configuration (even after a restart), its status will be changed to Connected. That is, a new row will not be created on the Infrastructure Dashboard and the old row on the Infrastructure Dashboard will be reused. However, if the configuration of any HCL OneTest Virtualization, agent has been changed before restarting, a new row will be created on the Infrastructure Dashboard and the old row will remain visible on the Infrastructure Dashboard with the status of Disconnected.
    5. You have the option to configure an instance name for each HCL OneTest API Agent that is registered with HCL Quality Server. Assigning a name makes it easier to identify a specific agent when there are two or more agents of the same type registered with HCL Quality Server. Configuring an instance name involves uncommenting and editing the identifier name setting in the configuration file of the agent and then restarting the agent.
    To view all HCL OneTest API Agents running for a specific environment or domain, use the Search icon to narrow the list of relevant agents.
    Note: Agent console output is not viewable in the HCL Quality Server, so you must view the console output of an agent on the computer where it is running.

    To view details about any routing rules defined for the agent, see Viewing recording or routing rules.

Feedback