In this chapter, learn how to install Perpetual Floating Licenses in the Ranorex License Manager on server machines, with or without an internet connection.
Also, learn about:
- Install the Ranorex License Manager (Perpetual floating license server)
- Understand the different Perpetual Floating license types
- Connect client machines to the server so they can lease floating licenses
Note: This article applies to Perpetual Floating licenses. For Subscription licenses, refer to Install a Subscription License
Ranorex License Manager
Use Ranorex License Manager to install and manage Perpetual Floating licenses. The machine where the License Manager is installed acts as a license server: it automatically distributes and revokes floating licenses to and from client machines as needed. For this reason, you should install the License Manager on a machine that is reachable over the network from all machines that will use a floating license.
In the Licensing documentation, the server machine is referred to as the server, and the client machines as the client(s).
Install the Ranorex License Manager
When you purchase a Perpetual Floating license, you receive an email with instructions and a download link for the License Manager.
To install the License Manager:
- From the link in the email for your floating license, download the License Manager to the server.
- Run the installer and follow the instructions in the installation wizard.
Note:
- Required C++ runtime libraries are installed automatically if they are not already present on the server, and a restart may be required.
- Always install the latest supported version of the Ranorex License Manager.
- License Manager supports IPv4, IPv6, and mixed networks.
- Ensure port 7266 (TCP/UDP) is open on the server and reachable from client machines.
- C++ libraries will be installed if not already present on the server, and the server may have to be restarted during the installation.
After the installation, the License Manager Windows service starts automatically. In rare cases, it might fail to start. In that case, check the Ranorex Solutions and Best Practices documentation for licensing solutions.
Install with an internet connection
Before you can use a Perpetual Floating license, it must be installed in the Ranorex License Manager on your server. The License Manager then registers and authenticates the license with the Ranorex License Authentication Server (a Ranorex company server, not your own license server for clients).
To install floating licenses:
- On the server, open Ranorex License Manager.
- Under Install licenses, paste the license key(s) you received by email.
- Click Install license(s).
- Click OK.
The floating license(s) appear in the list of installed licenses once they have been authenticated by the Ranorex License Authentication Server. At that point, installation is complete and clients can lease the licenses.
Install without internet connection
If you try to install a Perpetual Floating license and the server is not connected to the internet, the online activation fails. In that case, you can authenticate the license on a different machine that has internet access.
To install a floating license without an internet connection:
- On a machine with an internet connection, go to http://auth.ranorex.com/license/
- Under License Key, enter your license key
- Under Machine Name, enter the machine name of your server
-
Click Authenticate and confirm the machine name of your server
The Ranorex License Authentication Server creates an authenticated license file based on your data. You need to download this file and transfer it to the offline machine. - Click Download Authenticated License File and transfer the downloaded file to the offline machine, e.g. using a USB stick
- In the License Manager, click Load license…
- Browse to the authenticated license file and click Open.
- Click OK.
The license appears under the installed floating licenses. Once the license has been installed and authenticated on the server, clients can lease it. The server does not need an internet connection for normal operation, but it must remain connected to the same network as the clients.
Configure a client
Once you’ve installed a Perpetual Floating license on the server, you need to configure the clients so they can lease the license.
Make sure the client is connected to the same network as the server and can access it.
To configure a client for a Perpetual Floating license:
- On the client, open Ranorex Studio
- Go to Help > Licensing. The license configuration dialog opens
- Click Floating
- Under Server, enter the machine name or IP address of your server, or click the Refresh icon to see a list of machines with installed Ranorex License Managers in the network.
- The other fields are configured automatically.