Floating license installation guide

1. If a GWB license service is already running,
   • launch “lmtools.exe” from the licensing directory,
   • move to the Start/Stop/Reread pane, and
   • stop the service.
2. Run the installer executable, following the prompts and taking note of the location of the GwbLicenseServer folder where the GWB Server software was installed.
      Note that if the “lmgrd.exe“ and “hydrokey.exe” files are at any point moved from their initial location, the remaining files in the GwbLicenseServer folder must be moved along with them.
3. Launch the activation utility from the GwbLicenseServer folder or the Windows start menu
4. Select New... in the activation utility
5. When the Activate GWB dialog opens, enter your activation code and press Activate
6. Close the activation utility
7. Launch LMTOOLS, the FLEXlm tools program, from the GwbLicenseServer folder or the Windows start menu
8. If the GWB license service has already been set up and you are simply updating the activation code, go to Step 11
9. On the Server/License File pane in LMTOOLS, make sure ”Configuration using Services” is selected
10. Complete the Config Services pane as follows
    • Specify a Service Name
    • Enter the Path to lmgrd.exe file, which is located in the GwbLicenseServer installation folder
    • Set as well the Path to the license file, found in the same folder. Note that this file is a generic stub license that causes the vendor daemon to look in trusted storage for licenses that have been activated with the activation utility.
    • A Path to the debug log file is optional, but useful when issues arise. Locate the file in a folder where the Windows Local Service user has full control. Setting “C:\Program Data\gwb_license_server.log” should work well.
    • Select the Start Server at Power Up and Use Services options
    • Save the service
11. Move to the Start/Stop/Reread pane and start the service
12. Check the log file to make sure LMGRD was able to start the vendor daemon and locate the activation
13. Assuming the server started correctly, you can proceed to set up client computers so end users may run the GWB applications

To perform a silent installation, run the GWB installer with the “/S” flag set on the command line.

Syntax:

gwb1500_setup.exe /S <64, 32> [/D=install_folder]

Examples:

• Install GWB 64-bit to the default location, the most common option:

  gwb1500_setup.exe /S 64

• Install GWB 32-bit to the default location:

  gwb1500_setup.exe /S 32

• Install GWB 64-bit to a non-default location:

  gwb1500_setup.exe /S 64 /D=C:\myfolder\GWB

To activate the GWB on a client computer using an environmental variable, follow these steps:

1. Define environmental variable HYDROKEY_LICENSE_FILE that points to the license server. The variable setting is the server's URL, preceded by a port number in some cases. You need to specify the latter only if LMGRD is using a custom port (see Server ports). Syntax:

   [optional port number]@server_host_name

   Examples:
   • @lic.example.com
   • @192.168.1.1
   • 27000@192.168.1.1
   • 27201@lic.example.com
2. Open the GWB Activation Utility from the GWB dashboard. If the GWB package is found, you should see Otherwise, you will see an error message
3. Launch the GWB dashboard and verify that the client can check out a license from the server.

The GWB can be activated using the GWB Activation Utility for the current user only. The procedure is as follows:

1. Open the GWB Activation Utility from the GWB dashboard.
2. If the Activate GWB dialog does not open on its own, click New....
3. Where you would normally paste an activation code, specify the license server in the format [port]@host_name, just as you would for an environmental variable
4. Click Activate.
5. Open the GWB Activation Utility from the GWB dashboard. If the GWB package is found, you should see Otherwise, you will see an error message
6. Launch the GWB dashboard and verify that the client can check out a license from the server.

To borrow a seat from the server:

1. On the server, an administrator may wish verify the license supports borrowing. Assuming it does, a “Borrowable count” will be listed in the GWB Activation Utility
2. On the client, open the GWB Activation Utility.
3. Close all GWB apps, including the GWB dashboard, that may be open on the client computer, to ensure a seat is available to borrow.
4. In the GWB Activation Utility, select the license server and click Borrow...
5. When the Borrow License dialog opens, select the product to be borrowed and choose an automatic return date. Click OK
6. Client and server should now see a borrowed license in their respective GWB Activation Utility dialogs.
7. The user can return the license before the automatic return date. He or she should select the borrowed license in the GWB Activation Utility on the client and click Return

The default ports are:

• LMGRD – First available port between 27000-27010
• HYDROKEY – Chosen randomly

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

to

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.

The components making up the server, and their functions are:

• lmgrd.exe – The license manager daemon, which is responsible for connecting clients to the correct vendor daemon.
• hydrokey.exe – GWB's vendor daemon, responsible for providing licensed features to clients and tracking how many licenses are in use.

The communication between a client asking to check out a seat and the server responding to the request can be summarized:

• client → LMGRD — Contact LMGRD at specified port, or at 27000-27010
• client → LMGRD — Where is the vendor daemon for HYDROKEY?
• LMGRD → client — HYDROKEY is at port@hostname
• client → HYDROKEY — Request to check out a feature
• HYDROKEY → client — Accept or decline request

Any firewall position between the clients and the server needs to allow lmgrd.exe and hydrokey.exe to communicate over TCP. Depending on the type of firewall, you need to allow either both applications or the ports assigned to them to traverse the firewall. If you allow by port, you should explicitly assign a port to each application (see Server ports).

1. If the GWB license service is running, stop it via LMTOOLS on the Start/Stop/Reread pane
2. Uninstall the GWB by running the uninstallGWB.exe file in original GWB installation folder.
3. Run the new GWB License Server installer.
4. Change the paths for the GWB License Service on the Config Services pane of LMTOOLS from
   \Program Files\Gwb\License\<file>
   to
   \Program Files\GwbLicenseServer\<file>
5. Start the GWB license service from the Start/Stop/Reread pane of LMTOOLS.