The license file contains all site-specific information required by FLEX lm . This information includes:
The license file must be accessible to every machine that runs a FLEX lm -licensed application, and each machine designated as a license server. Before you can use the application you must start the license manager daemon (
lmgrd ) using the following syntax:
-c license_file_path Full pathname to the license file. Only use this option if the license file is not installed in the default location " /usr/local/flexlm/licenses/license.dat ". See Specifying Location of the License File for information about using alternate locations.
License File Format describes the format of the license file. The section Anatomy of a License File includes sample license files.
If your software vendor recommends a specific location for your license file, or if the default is not practical for you, use one of the following two methods to put the license file in another location:
· Read the license file data from
lmgrd , by specifying
LM_LICENSE_FILE as " port@host ", where host is the server hostname and port is the port number from the license file.
Note: port@host is only supported in FLEX lm v2.4 or later versions.
Since the vendor daemon keeps track of license usage, and since the license file contains encrypted data to protect it against modification, you may move and copy the license file as much as you want.
Note: If you are running redundant servers, you should have one copy of the license file (as well as copies of
lmgrdand the vendor daemons) on each server node. If you do not do this, you lose all the advantages of having redundant servers, since the node holding these files becomes a single point of failure.
Before selecting an option you must install
lmgrd (the license manager daemon) and the vendor daemon. Use the /etcdirectory a reasonable location, since the daemons will probably be used at boot time.
Note: The "-c" option overrides the setting of the
LM_LICENSE_FILEenvironment variable for
lmgrd. See Combining License Files for more information about
Note: Everything else is used to compute the encryption code, and should be entered exactly as supplied by your software vendor. All data in the license file is case sensitive, unless otherwise indicated.
The SERVER line specifies the node name and hostid of the license server, and the port number of the license manager daemon (
lmgrd ). Normally a license file has one SERVER line. More than one SERVER line means that you are using redundant servers. For more information about redundant servers, see Selecting Server Nodes . The format of theSERVER line is:
options Full pathname of the end-user specified options file for this daemon. (See Options File ) FLEX lm does not require an options file.
Note: You cannot edit the FEATURE line. Use the FEATURE line exactly as supplied by your vendor.
The FEATURE line specifies the name of the feature to be licensed. A feature can be the name of a program, a program module, or option. Any amount of white space of any type (that is, tabs or spaces) can separate the components of a line. The FEATURE line is as follows:
hostid String returned by lmhostid . Used only if the feature is to be bound to a particular host, whether its use is counted or not. (Numeric hostids are case insensitive). See Hostids for FLEXlm-Supported Machines for more information.
Note: You cannot edit FEATURESET line. Use the FEATURESET line exactly as supplied by your vendor.
SERVER excellent_server 17007ea8 1700
DAEMON xyzd /etc/xyzd
FEATURE xyz_app1 xyzd 1.000 01-jan-1993 10 \ 1EF890030EABF324 ""
FEATURE xyz_app2 xyzd 1.000 01-jan-1993 10 \ 0784561FE98BA073 ""
Concurrent usage means anyone on the network can use the licensed software, up to the limit specified in the license file. (Also referred to as f loating licensing or n etwork licensing .) Concurrent usage licenses do not have hostids on the individual FEATURE lines. This configuration requires an
lmgrd daemon because it is going to count the concurrent usage of the licenses.
Node-locking means the licensed software can only be used on one node. A node-locked license has a hostid on any FEATURE line that is node-locked to a particular host. There are two types of Node-locked licenses; uncounted and counted.
If the number of users is set to 0, then the licenses are uncounted and unlimited use is permitted on the specified node. This configuration does not require an
lmgrd daemon because it is not going to count the concurrent usage of the features.
Another solution is a combination of the node-locked solution in Node-locking and the concurrent option described inConcurrent (floating) usage . This provides a fixed number of floating licenses for use on a set of servers only you define when you request your license.
In this configuration, the license file has one node-locked FEATURE line for each node that is to be able to run the software. Generally, the same number of licenses is specified on each FEATURE line. This configuration requires an
lmgrd daemon because it counts the concurrent usage.
For example, the following license file allows a total of two simultaneous licenses of a feature called, "f1" on any of the three nodes specified, with the daemons running on the license server "lulu":