Ranorex Help Center

How can we help you?

Ranorex Agent

A Ranorex Agent is a standalone tool that enables remote test execution.

Quick facts:

  • A Ranorex Agent queues multiple requests and executes one test at a time.
  • Agents can be installed on physical and virtual machines.
  • One Ranorex Agent can be installed per machine.
  • An active user session is required for a Ranorex Agent to run.
  • Remotely executed tests are fully functional, including mouse and keyboard actions.
  • A Ranorex Runtime License is required for remote test execution. When starting the agent, it is automatically requested from the License Manager installed in the network. The license is released once the agent is shut down.

When a Ranorex Agent is started, an icon will be shown in the Windows system tray. To open the Ranorex Agent window, just click on this icon:

Ranorex Agent icon in the system tray

Using the context menu of this icon, you can open and close the agent’s window.
Select 'Exit' to shut down the agent. Shutting down the agent will release the license, close the whole application. Running tests remotely will not be possible after this action.

Context menu of the Ranorex Agent

The window of the Ranorex Agent displays the agent’s job queue as well as the agent's log, including technical details, and the agent's display name. The host name of the machine is shown in the title bar.

Ranorex Agent window

You can also configure the settings of an agent. For more information on this topic visit this section: Configure Ranorex Agent

The Job Queue provides an overview of the currently executed and planned tests. The jobs are listed with their individual Test Suite name and the issuer is presented with the machine's name the issuing Ranorex Studio is running on.

Ranorex Agent job queue