FLEXnet Licensing Environment Variables

Appendix D

---

Environment variables are not required in order to use FLEXenabled applications. Environment variables are normally used for debugging or for changing license default location.

How to Set Environment Variables

FLEXnet Licensing environment variables are set in two different ways:

In the process' environment
In the registry (Windows v6.0+) or in $HOME/.flexlmrc (UNIX v7.0+), which functions like the registry for FLEXnet Licensing on UNIX.

Registry

On Windows, the FLEXnet Licensing registry location is:

HKEY_LOCAL_MACHINE\Software\FLEXlm License Manager

On UNIX, the equivalent information is stored in $HOME/.flexlmrc. In this file, the syntax is variable=value.

Precedence

If the variable is LM_LICENSE_FILE or VENDOR_LICENSE_FILE, then both the environment and the registry are used, with the environment used first, and the registry appended to the path.

If it's a different variable, then if the environment set, only that is used, otherwise the registry is used. That is, the registry is only used if the environment is not set.

Environment Variables

Variable	Definition
FLEXLM_BATCH	Windows only: prevents interactive pop-ups from appearing. Set to 1 if a batch application. (Version 7.0+ clients)
FLEXLM_DIAGNOSTICS	Used for debugging where applications don't print FLEXnet Licensing error message text. Set to 1, 2, or 3, depending on the amount of diagnostic information desired. See "FLEXLM_DIAGNOSTICS." (Version 5.0+ clients)
FLEXLM_TIMEOUT	Windows only: Sets the timeout value a FLEXenabled application uses when attempting to connect to a license server system port in the range 27000-27009. Values are in microseconds, within the range 0 through 2147483647. The default setting is 100000 microseconds.
LM_BORROW	Used for initiating license borrowing and setting the borrow period. See "Initiating License Borrowing" for more details. On UNIX platforms, $HOME/.flexlmborrow is used for the registry instead of $HOME/.flexlmrc.
LM_PROJECT	LM_PROJECT's value is logged in the report log file and later reported on by FLEXnet Manager. Limited to 30 characters. (v5.0+ client required.) This can also be used to RESERVE, INCLUDE, etc. licenses with PROJECT. For example: RESERVE 1 f1 PROJECT airplane v5.0+ clients and v7.0+ vendor daemon are required for this feature.
LM_SERVER_HIGHEST_FD	Used to set the highest file descriptor value, above which the license server will not access.
LM_UTIL_CASE_SENSITIVE	Used by the FLEXlm utilities. If set to 1, the utilities process license file lines as case sensitive. By default, this variable is set to 0; license files are treated as case insensitive. This environment variable is applicable only when the license server, itself, has been configured by your vendor to treat license files in a case sensitive manner.
TCP_NODELAY	Improves FLEXnet license server system performance when processing license requests. Set to 1 to enable performance enhancements. Use with caution: when enabled it may cause an increase in network traffic.
LM_LICENSE_FILE or VENDOR_LICENSE_FILE	Reset path to license file. Can be a license-file list, separated by " : " on UNIX and " ; " on Windows. If VENDOR_LICENSE_FILE used, VENDOR is the vendor daemon name used by this application. For example, Macrovision products use GSI_LICENSE_FILE. Can be a file name, or port@host. See also "Setting the Path with an Environment Variable." (VENDOR_LICENSE_FILE requires v6.0+ clients.)