Environment Variables for Licensing

You can control your licensing environment with environment variables, most of which are optional. Either the LM_LICENSE_FILE or MGLS_LICENSE_FILE environment variable is required.

The applications and utilities use the LM_LICENSE_FILE FlexNet environment variable or the MGLS_LICENSE_FILE Mentor environment variable to determine the location of the license files or servers. For Mentor applications, the MGLS_LICENSE_FILE setting overrides the LM_LICENSE_FILE setting.

Note:

To add, delete, or edit environment variables on Windows systems, refer to “How to set an environment variable on Windows” on Support Center.

Table 1. Environment Variable Summary
Environment Variable	Description
LM_LICENSE_FILE	LM_LICENSE_FILE is the FlexNet client environment variable and, if MGLS_LICENSE_FILE is not set, is the first place Mentor applications check to determine the license file or server location.
MGLS_LICENSE_FILE	MGLS_LICENSE_FILE is a Mentor-specific client environment variable and is the first environment variable Mentor applications check to determine the license file or server location.
MGLS_CONN_TIMEOUT	Use the MGLS_CONN_TIMEOUT environment variable to specify a timeout value, in seconds, for a TCP/IP connection between an application and the license server.
MGLS_DEBUG_LOG_DIR	Use the MGLS_DEBUG_LOG_DIR environment variable to enable Mentor licensing system debugging. Setting this variable creates a client debug log file.
MGLS_EXP_WARN_DAYS	Use the MGLS_EXP_WARN_DAYS environment variable to set the number of days before the license expiration date that warning messages are displayed to stderr.
MGLS_HOME	Use the MGLS_HOME environment variable to define the location of the licensing software.
MGLS_INCLUDE_LICENSES and MGLS_EXCLUDE_LICENSES	Use the MGLS_INCLUDE_LICENSES and MGLS_EXCLUDE_LICENSES client-side environment variables to control access to certain licenses.
MGLS_LICENSE_SEARCH	Use the MGLS_LICENSE_SEARCH environment variable to change the license search behavior to emulate the default behavior on Linux.
MGLS_LICENSE_SOURCE	Use the MGLS_LICENSE_SOURCE environment variable to specify the order of the features that licensing considers in license check-out requests.