Setting the License Search Path Using an Environment Variable

Most applications specify a location where they expect to find the license file and install it automatically. However, you can change the license file location by setting the LM_LICENSE_FILE environment variable to a license search path. Wherever a license search path is specified, it can consist of one or more of the following entries. On UNIX, the license search path entries are separated by colons ‘:’ and on Windows, the entries are separated by semicolons ‘;’.

The full path to the license file
A directory containing one or more license files with a .lic extension
One of the following port settings:
The port setting port@host setting, where port and host are the TCP/IP port number and host name from the SERVER line in the license file.
The shortcut specification, @host, if the license file SERVER line uses a default TCP/IP port or specifies a port in the default port range (27000–27009).
A three-server redundant triad. The triad is a single entry on the license search path and is specified using a comma-separated list of three port@hosts (for example, port1@host1,port2@host2,port3@host3).

The following table shows some examples of LM_LICENSE_FILE and VENDOR_LICENSE_FILE environment variable settings.

Environment Variable Specification Examples

LM_LICENSE_FILE or VENDOR_LICENSE_FILE Setting

Description

40000@myserver

Used where the SERVER line in the license file is the following:

SERVER myserver 17007ea8 40000 

host = myserver 
port = 40000 

@myserver

Used where the SERVER line in the license file is the following:

SERVER myserver 17007ea8 

host = myserver 
port = None specified. A default TCP/IP port number in the range of 27000-27009 is used.

C:\licenses; 40000@host1,40000@host2,40000@host3 

License search path on a Windows system. Unserved licenses are stored in C:\licenses; served licenses are obtained from the three-server redundant triad 40000@host1,40000@host2,40000@host3.

licenses:40000@myserver:40000@mybackupserver 

License search path on a UNIX system. Unserved licenses are stored in the local directory licenses; served licenses are obtained from either myserver or mybackupserver. In the first instance, a license is requested from myserver; if this fails, mybackupserver is tried.

Applications accept an environment variable (or Windows Registry) named VENDOR_LICENSE_FILE, where VENDOR is the vendor daemon name, for example, DEMO_LICENSE_FILE. This environment variable’s scope is limited to just those applications from software publisher using the VENDOR name.

With lmgrd and lmutil (lmstat, lmdown, and so on), the -c option overrides the setting of the LM_LICENSE_FILE environment variable.

Note:Some applications do not recognize the LM_LICENSE_FILE environment variable. FlexEnabled Java applications, in particular, do not recognize it.