This guide is intended for GWB license server setup with custom ports or a specific hostname. To see related topics, please see our Floating license installation page.
If your configuration does not require custom ports or a specific hostname, please see our Basic installation guide.
For guidance on installing the license server on cloud services (e.g. Amazon Web Services), please see our Cloud installation guide.
You may install the GWB license server components on any non-ARM CPU based version of Windows currently supported by Microsoft.
Begin by locating the following:
To set custom ports or specify a hostname for the server, you need to edit “gwb.lic” in the installation directory on the server. While the actual licensing rights are provided by your activation code the license file is still used to configure certain aspects of the server.
You may need to run a text editor as administrator to modify the file.
If you are performing this step on a service currently running, you will need to ReRead License File on the Start/Stop/Reread pane in LMTOOLS after saving the “gwb.lic” file. If you encounter issues with ReReading the license file, please consult our troubleshooting page.
Typically custom ports are needed when an external firewall or other access control is between the clients and the server and the firewall needs to know explicitly which ports to allow. In such cases custom ports should be set for both LMGRD and HYDROKEY.
The default ports are:
You can set the ports explicitly on the first two lines of the license file, which initially look like:
SERVER this_host ANY VENDOR hydrokey
To run LMGRD on port 27200, for example, and HYDROKEY on port 27201, edit the two lines to read:
SERVER this_host ANY 27200 VENDOR hydrokey port=27201
When LMGRD tells a client how to connect to HYDROKEY, it by default transmits the server's hostname. To check the string sent to the client, open a command line on the server and enter the command “hostname”. In most cases, this is the Windows computer name, without the domain name.
Clients can commonly reach the server using the computer name alone. If a client is set to use a fully qualified domain name (FQDN) to contact the server, it may not be able to connect in this way. The result of such a configuration is an excessively slow or entirely failed license checkout.
Resolve such issues by making sure LMGRD reports HYDROKEY's hostname in the same form clients will use to contact LMGRD. To specify the FQDN of the server, edit the server's license file and change the SERVER line from
SERVER this_host ANY
SERVER FQDN ANY
For example, if the server's Windows name is lic with domain set to example.com, the clients would need to connect to it at lic.example.com. In this case, you would change the SERVER line to:
SERVER lic.example.com ANY
As well, you can set the IP address assigned to the server as its hostname
SERVER 192.168.1.100 ANY
As a final note, the hostname on the SERVER line must match the actual windows settings for computer and domain name, or the IP address assigned to the machine. If this restriction becomes an issue, please see instructions for Connecting to HYDROKEY directly.
If you have an existing service and need to add another service simply start typing in the Service Name entry, fill out the rest of the details, and once saved you will have multiple services in the Service Name dropdown to choose between.
Now that you have your GWB license server installed and configured successfully, you can proceed to either the basic client installation page for setting up clients individually or the advanced client installation page for setting up multiple clients at once so end users may run the GWB applications
If you follow the instructions on this page and encounter issues setting up a floating license, please consult our troubleshooting guide.