Execute Universal Agent

Manually execute Universal Agent

There are two reasons to execute Universal Agent manually, instead of scheduling it:

  1. When you first create the Universal Agent, there will be no automated test runs in qTest Manager for you to schedule the tests.

  2. You want to `DEBUG` your Universal Agent. For example:

    • You want to make sure your Pre-Execute Script is configured correctly.

    • You want to make sure your Execute Command runs properly.

    • You want to test your newly created custom test result parser.

Execute Universal Agent from Launch

To execute an agent from Launch, follow these steps:

  1. In qTest Launch, select the host you want to execute an agent for and select View from the Action dropdown.

  2. Find the agent you want to execute on this host and select Execute from the Action dropdown.

The agent then executes on the Automation Host during the next polling cycle.

Execute Universal Agent from Automation Host

The Automation Host UI is disabled. You can manually activate the Automation Host UI during installation to use it either on the local host or on the local network. However, all Automation Host functions are now available in Launch. We recommend that you access all the tools you need from Launch as the most secure option.

To run Universal Agent from the Automation Host:

  1. Access the Automation Host UI and locate the Universal Agent in the Agents section.

    For information on accessing qTest Automation Host, refer to Access qTest Automation Host for Windows, Access qTest Automation Host for Mac, or Access qTest Automation Host for Linux.

  2. Click the Action icon for an Agent. Then select Run now.

  3. A dialog will display that shows your existing Universal Agent configuration. From here you can:

    • Review the general configuration of your Universal Agent.

    • Review or edit your Pre-Execute Scripts.

      The changes you make will not be saved to the Universal Agent. In other words, the changes only affect this execution session.

    • Review or edit Execute Command.

      The changes you make will not be saved to the Universal Agent. In other words, the changes only affect this execution session.

    • View latest values of the magic variables.

      Values of these variables will be set when the Universal Agent kicks off Test Execution for the test runs being scheduled in qTest Manager. So if this is the first time you run Universal Agent and you do not have any test runs from qTest Manager being scheduled to be executed by this Universal Agent, these variables will have empty values.

  4. Select the Execute button to kick off your Universal Agent execution. During execution, the Universal Agent shows its execution logs in the Console Log section for you to observe its execution progress.

Schedule Test Execution with Universal Agent

The practical usage of Universal Agent is to schedule it to execute your tests from qTest Manager.

  1. From qTest Manager, select the Test Execution tab.

  2. Locate and select the automated test runs that you want to schedule for execution.

  3. Select the More button, and then Schedule.

  4. The Schedule Automation Test Executions dialog appears. Make sure you select the host with the Universal Agent you want to execute.

  5. Input relevant information for the schedule and select OK.

Now, the next time the Automation Host polls to qTest Manager, your jobs schedule will be executed by the Universal Agent.