Menu

Execute Universal Agent

Execute Universal Agent Manually

There are 2 (two) reasons to execute Universal Agent manually:

  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 are configured correctly
    • you want to make sure your Execute Command runs properly
    • you want to test your newly created custom test result parser

To run Universal Agent manually:

  1. Access the Automation Host UI and locate the Universal Agent in the Agents list.
  2. Select the Run now button.run-universal-agent-btn.png
  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.
      Note: the changes you make will not be saved to the Universal Agent. In other words, the changes only affects to this execution session.
    • Review or edit Execute Command
      Note: the changes you make will not be saved to the Universal Agent. In other words, the changes only affects to this execution session.
    • View latest values of the magic variables.
      Note: 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.
      run-universal-agent-dlg.png

  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 it's execution progress.universal-agent-console-log.png

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.
    schedule-test.png
  4. The SCHEDULE AUTOMATION TEST EXECUTIONS dialog will open and make sure you select the host with the Universal Agent you want to execute.
  5. Input relevant information for the schedule and select OK.schedule-automation-test-execution.png

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

Subscribe To Our Blog
Powered by Zendesk