Installing floating licenses

A floating license file is to be used by the dGB FlexNet license server. This license server can run on Linux, Mac or Windows. See here for instructions on how to install the license server on Linux and how to install the license server on Windows.

Once the license server is running we can then instruct the client on how to borrow the license. There are two ways for installing the floating license on a client:

1. By setting the DGBLD_LICENSE_FILE environment variable

2. By using the FlexNet lmpath tool via console/command prompt or on Windows through the License Manager Tools (lmtools.exe)

Setting the DGBLD_LICENSE_FILE environment variable

The DGBLD_LICENSE_FILE environment variable can be set to a license file or to the server host.

On a Linux client the variable can be set with the export or setenv command.

On a Windows client the variable can be set via Control Panel > System > Advanced system settings > Environment Variables. Please note that a user environment variable is only available for the user who sets the variable. It might be a better choice to set the variable as a system environment variable. It then can be globally accessed by all users.

The possible values are:

• port@host

• @host

• path to license file

- port = the TCP/IP port the license server is using. If port is not specified in front of @home a default TCP/IP port number in the range of 27000-27009 is used.
- host = the hostname of the license server. This comes from the SERVER line in the license file.
- path to license file = exactly that. Place the license file in a network location available to all machines running OpendTect or copy it to all of the machines running OpendTect (Typically: C:\Licenses)

Using the FlexNet lmpath tool

The lmpath tool can be used to add to, override, or get the current license path settings.
This and other FlexNet tools are packaged in a single executable lmutil or lmutil.exe.
OpendTect 6.6.0 ships these tools. They can be found in the following paths: 

• For Linux: OpendTect/6.6.0/bin/lux64/lm.dgb

• For Windows: OpendTect\6.6.0\bin\win64\lm.dgb

To set it on Linux run:
./lmutil lmpath -override dgbld port@host or ./lmutil lmpath -override dgbld licensefile

On Windows run:
lmutil.exe lmpath -override dgbld port@host or lmutil.exe lmpath -override dgbld licensefile

Note: lmpath sets the file $HOME/.flexlmrc on Linux and the FlexNet Licensing registry entry on Windows platforms.

To display the current license path setting, use on Linux the command:
./lmutil lmpath -status
Or on Windows:
lmutil.exe lmpath -status

For a status of the currently in use licenses, use on Linux the command:
./lmutil lmstat -a -c port@host
Or on Windows:
lmutil.exe lmstat -a -c port@host