Licensing

In general Ranorex provides two different types of licenses to install:

The node locked license type is bound to the machine's host name. After registration each license can be used perpetually on the registered machine. A floating user license can be shared between different machines, but can only be used by one machine (and user) at a time.

Both license types are available for Ranorex Runtime, Professional, and Premium Edition.

If you are going to transfer a license to another machine, have a look at the section Transfer Licenses.

SAP support is not included in the Ranorex standard developer licenses. Please contact our sales team at sales@ranorex.com for further details.

License Registration

In order to register a Ranorex license, start the Ranorex Licensing tool, which is available in the Ranorex start menu folder.

: License installation dialog

The license installation tool is used to install both types of licenses.

Installing a Node Locked License

To install a machine-bound Ranorex license select the 'Use Machine License' option. Though the license needs to be activated on the Ranorex server over the internet, it is not necessarily required to have an internet connection available on the target machine.

Installing with Internet Connection

Simply type or paste in the Ranorex license key which has been delivered to you by email and press 'Install'.

: Installed license after activation

Installing license without Internet Connection

If there is no internet connection available Ranorex allows to register the target machine using a license activation web site on a computer with an internet connection.

: Error Dialog - 'No internet connection available'

The web site address used to authenticate the license key is part of the licensing email delivered after purchasing licenses. Simply open a browser and navigate to the authentication page. Fill in your license key and the machine's host name. After clicking the 'Authenticate' button you'll be able to download the license file. Load the downloaded file within the Ranorex licensing tool in order to finish the license installation process on the target machine.

: License authentication using Ranorex web site

Installing a Floating License

Installing and configuring the Ranorex License Server

In order to use a Ranorex Floating License it is required to install and run the Ranorex license server application on a computer (server) within a network. The download link for the license server setup package is part of the license delivery email. Simply install the package on a system which is reachable from computers which intend to use a Ranorex floating license.

Note: To prevent firewalls from blocking communication between license server and client, it is required to open port 7266 for TCP and UDP access on the server.

Note: By installing a Ranorex license server it's required to use a Ranorex license server installation package which is at least as actual as your Ranorex client installation.

: License server dialog - one premium licenses in use

Open the Ranorex license server configuration tool. Add the floating license keys to the text box and press 'Install'. These licenses are now ready to use.

To get more information about the clients leasing a license you can select the specific license in license server configuration tool and open the 'Clients' tab.

Using the 'Save Server Log' button allows you to export all actions processed by the license server as CSV- or XML-file for further processing.

Note: It is recommended to have an internet connection available in order to install a new license.

: No internet connection available - license needs to be registered on a computer with internet connection

If there is no internet connection available, authenticate the floating license using the license authentication web site. The web site address used to authenticate the license key is part of the licensing email delivered after purchasing licenses. Simply open a browser and navigate to the authentication page. Fill in your license key and the machine's host name. After clicking the 'Authenticate' button you'll be able to download the license file. Load the downloaded file within the Ranorex licensing tool in order to finish the license installation process on the target machine.

Configuring Developer and Runtime Clients

In order to use an installed floating license, open the Ranorex license tool on the client and select the option 'Use License Server'.

: Using license server for Ranorex Premium edition

Press the button 'Detect' to request a list of the currently available license servers within the local network.

The license type specifies which license (Runtime, Professional, Premium) should be used on the client. By selecting 'Auto', the client automatically requests the appropriate license. In case of running Ranorex tests via the standalone test suite runner or from command line, only a Runtime floating license will be used. When starting Ranorex Spy tool a Professional floating license will be leased on the server. After pressing the 'Install' button the client is assigned to the selected license type. To switch the currently installed license type, simply select another one from the list and click 'Install' again.

Every time a Ranorex test, a Ranorex tool, or Ranorex Studio is started the client sends a license request to the server. If the type of the required license is available, it will be assigned to the requesting client. By closing Ranorex Studio or finishing a test run the license will be automatically released and can then be used by other clients.

Transfer Licenses

In order to transfer a license from one machine to another, you have to follow the instructions below.

To transfer a node-locked license, open the Ranorex License Tool and press the "Transfer License" button.

: Transfer a node locked license

If you are going to transfer a floating license, open the Ranorex License Server Tool, right-click the license you are going to transfer and choose "Transfer License(s)" from the context menu.

: Transfer a floating license

Confirm the license transfer for the specific license and the specific machine.

: Confirm the license transfer

A dialog will pop up, informing you about the success of your license transfer.

If the license transfer was successful, the license has been uninstalled from the machine you transferred it from and can be installed on another machine as described in Installing a Node Locked License or Installing a Floating License.

: Succeeded license transfer

If the license transfer has failed, you can manually transfer your license by sending a prepared mail to our support mail box.

: Failed license transfer

Note: When performing a manual license transfer, the license cannot be used until the manual license transfer has been completed.