LICENSE.DAT(5)

NAME

license.dat − license configuration file for FLEXlm licensed applications

SYNOPSIS

/usr/local/flexlm/licenses/license.dat

DESCRIPTION

The license.dat file contains the information used by the FLEXlm network licensing package to determine what licenses are available at a particular site. The license.dat file contains the following information:

list of server nodes
list of vendor daemons
list of features enabled for this site
list of featureset lines for this site

Some of the information in the license file is changeable by the system administrator at the end-user site, allowing him to configure the licensed software to fit into his environment.

FLEXlm programs and routines find the license file by an algorithm described below in the section "FINDING THE LICENSE FILE."

Each line in the license.dat file starts with a keyword which identifies the information on that line. The keyword is one of SERVER, DAEMON, FEATURE, or FEATURESET.

The SERVER line is of the form

SERVER nodename hostid [port-number]

The hostids from all of the server lines are encrypted into the FEATURE lines, so they can not be changed by the site administrator. The optional port-number field can be changed at any time. This allows the site administrator to select a port number which does not conflict with the other services, software packages, or FLEXlm vendors on his system. The site administrator can also change the nodename if he wishes, as long as the hostid does not change. On sites with multiple redundant servers, one of the servers is selected as the master node. If the order of the server lines is the same in the license files for all of the redundant servers, then the first server in the list will be the master; otherwise, the server whose name is alphabetically first will be the master.

The DAEMON line is of the form

DAEMON daemon-name path options-file

The site administrator can change the path field, which allows him to place the vendor daemon in any convenient location. The site administrator can also change the location of the options-file, which describes various options that the site administrator can modify (see license.options(8)).

The FEATURE line describes the features that are enabled for this site. None of the information in the FEATURE line is changeable by the site administrator.

The FEATURESET line is a vendor-optional line; some vendors may choose to use this line, some may choose not to use it. The FEATURESET line encodes the encryption codes of all of the features for the specified vendor. This line is not changeable by the site administrator. If the license file contains a FEATURESET line, then no FEATURE lines for that vendor may be added or removed.

FINDING THE LICENSE FILE

Most programs which read the license.dat file accept a command line option (typically -c) which can be used to specify the location of the license file if other than /usr/local/flexlm/licenses/license.dat. If no command line switch is given, then the value of the environment variable LM_LICENSE_FILE will be used to find the license file. If neither of these are specified, the default location, /usr/local/flexlm/licenses/license.dat, will be used.

The LM_LICENSE_FILE environment variable can be used to specify a number of different license files. To do this, the environment variable should be set to a single string which contains all of the license file paths separated by colons. For example (in csh):
setenv LM_LICENSE_FILE /usr/local/foo.dat:/u2/flexlm/bar.dat:/u12/lic.dat

(on VMS systems, separate the file names with the ’/’ character).

EXAMPLE

Here is an example of a license.dat file.

SERVER pat 17003456 1700
SERVER lee 17004355 1700
SERVER terry 17007ea8 1700
DAEMON GSI /etc/mydaemon
FEATURE great_program gsi 1.000 01-jan-1989 10 1EF890030EABF324 ""
FEATURE greater_program gsi 1.000 01-jan-1989 10 0784561FE98BA073 ""

This example illustrates the license file for a single vendor with two features, and a set of three server nodes, any two of which must be running for the system to function.

FILES