Executing tests | Ranorex
Help CenterUser GuideRanorex Studio advanced

Executing tests


Note icon


To execute a test, Agents need a Ranorex runtime. You can either include the runtime in your tests by enabling ⇢ Copy runtime to output in Settings (recommended) or you can install the runtime on all machines you want to execute tests on.

First, select the test suite/test sequence and run configuration you want to run from the drop-down menus in at the top.

Then, press the run button next to an agent’s name to start executing the test on this ⇢ Ranorex Agent.

Ranorex Studio will build the test, deploy and deploy it to the Agent on the remote machine, where it will be executed. You don’t have to wait for the test run to finish. Once you’ve deployed your test to a remote machine, you can immediately continue using your local machine.

During remote test execution, you’ll receive information on the progress. By pressing the red stop button, you can abort the remote test run.

Note icon


When you execute a test on an Agent again, Ranorex Studio will only rebuild and redeploy it if you made changes to the test. If everything remained the same, the already existing test on the remote machine will be used.

Once the remote test has been executed successfully, you’ll receive a notification shown at the right most button ‘Open Run History’. You’ll see a number of unread items in the Run History. If the circle is green, it indicates that no error has occurred since you’ve last accessed the Run History.

If there is at least one unread item in the Run History with an error state, the circle is shown in red.

An agent can queue several jobs. The number of items in the queue is shown in the blue circle on the ‘Run’ button.