Licensing | Ranorex
Help CenterUser GuideLicensing

Licensing

Ranorex offers two license types: node-locked and floating.

Node-locked licenses are tied to a machine’s host name and can be used on that machine perpetually. They are not transferable.

Floating licenses can be shared between different machines, but can only be used on one machine (and by one user) at a time.

This chapter explains how to install, uninstall, and transfer node-locked and floating licenses.

In this chapter

 

     

    License registration

    In order to register a Ranorex licensing, start the licensing tool. You can find it in the Start menu folder of your Ranorex installation or by selecting Help > Licensing… in Ranorex Studio.

    Installing a node-locked license

    To install a machine-bound Ranorex license select the ‘Node-Locked’ 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.

    No connection error

    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.

    Installing a Floating License

    Installing and configuring the Ranorex License Manager

    In order to use a Ranorex Floating License it is required to install and run the Ranorex license manager application on a computer within a network. The download link for the license manager 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 icon

    Note

    • Ensure you use the latest License Manager package for installation.
    • The Ranorex License Manager works in IPv4, IPv6, and mixed networks.
    • Ensure port 7266 TCP/UDP is open on the machine running the license manager.

    License Manager – one premium license in use

    Open the Ranorex license manager 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 manager configuration tool and open the ‘Clients’ tab.

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

    No connection error

    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 ‘Floating’.

    Automatically requesting an appropriate license

    Press the button ‘Detect’ to request a list of the currently available license managers within the local network.

    The license type specifies which license (Runtime, 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 Premium floating license will be leased on the manager. 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 manager. If the type of the required license is available, it will be assigned to the requesting client. By being idle, closing Ranorex Studio or finishing a test run the license will be automatically released and can then be used by other clients.

    For this reason a reliable network environment is required when working with floating licenses.

    Note icon

    Note

    If a floating license has not been released correctly (based on a network problem for example), it will be locked for a time-out of 5 minutes.

    Uninstall floating license

    In order to uninstall a floating license right-click the license you are going to uninstall and choose “Uninstall License(s)” from the context menu in the Ranorex license manager tool.

    Uninstalling a floating license

    Confirm uninstall

    In order to uninstall a node-locked license from a machine, please use the uninstall button in the Ranorex License Tool.

    Uninstalling a node-locked license

    Confirm uninstall

    Transfer Licenses

    In order to transfer a license, you have to uninstall the license from the machine you want to transfer it from as described in the section above. After that, the license will be available for installation on a different machine.

    Note icon

    Note

    Node-locked licenses can only be transferred once every 90 days.