The LSERVOPTS environment variable is used on the License Manager host system to affect its performance or configuration. The following options can be set.
See also, Ways to Set the License Server Options:
Options | Summary |
---|---|
-s license-file |
Specifies the name and location of the license code file. By default, the License Manager will use the file, lservrc, in the local directory. The location of the license code file can also be specified by the environment variable, LSERVRC. |
-e license-configurationfile |
Specifies the name and location of the optional license configuration file, which can contain configuration information for alerts and remap statements for readable license codes.
By default, the license server will use the file, license-file.cnf (appends extension .cnf to the license file path it uses). The location of the configuration file can also be provided by the environment variable, LSERVRCCNF. See Alert Specifications for more details. |
-l usage-log-file |
Specifies the name and location of the License Manager’s usage log file, which enables usage logging. By default, usage logging is disabled. |
-f <trace-log-file> |
Specifies the name and location of the trace file. |
-tr <level> |
Sets the tracing level defined here. |
-z <file-size> |
The maximum size of the usage and trace file log (if enabled). The size can be specified in bytes,kilobytes, or megabytes. For instance, -z 2000 means 2000 bytes, -z 2k means 2 kilobytes, -z 2m means 2 megabytes. The default value is 50,00000 bytes (approximately 4.76MB). |
-x |
Disables automatic backup of the usage and trace log files in case of overflow. The License Manager will stop writing further records to the file. By default, when the log file reaches its maximum size the contents of the log file are moved into a new file that has the same name as the original log file but has two numeric digits appended to its name. For example, if the original log file is named lserv.log, the first backup file will be named lserv.log.00. The next time a backup file is created, the new file will use the next available backup number (for example, lserv.log.01). The maximum number of backup files is 99, beyond which the existing files will be overwritten sequentially. If clients are connected to the License Manager when the backup file is created, dummy records are created for any pending transactions in the backup file; corresponding dummy records are created in the new file. The dummy records are identified by the user name LM_SERVER. If the -x option is specified, the file will not be backed up on overflow. |
-port port-number |
The License Manager port number is used by the TCP/IP protocol when transferring data between the License Manager and the client. You will rarely need to change this. See License Manager - Specific Environment Variables - LSPORT - Set the License Manager TCP/IP Port. |
-com percentage |
Commuter licensing uses the same license tokens as other network licenses. To ensure that not all license tokens are used up by commuters, set the -com option to the percentage of license tokens you want to be used for commuter licensing. Once that percentage of tokens are used by commuter licenses, no more will be made available to commuters until tokens are returned. |
-rlf redundant-license-file |
Starts the License Manager as a redundant License Manager using the specified redundant license file. You do not need to use this option to start the License Manager as a redundant License Manager if a lservrlf redundant license file is in the same directory as the License Manager. |
-lfe encryption-level |
Specifies the level of encryption with which license transactions will be written to the license server log file, 1 to 4. For a discussion of why you might want to encrypt transactions and for information on the different levels, see Setting Usage Logging. Note that your vendor can override your encryption level choice for specific license codes. |
-u group-reservations-file |
Specifies the name and location of the optional group reservations file. By default, the license server uses the lsreserv file in the current directory. The location of the reservations file can also be provided by the environment variable, LSRESERV. |
-us |
Use this option to specify upgrade license file is missing from the table. |
-q |
Quiet mode. When this option is specified, the License Manager will start up quietly without displaying its banner. Unexpected conditions will still be logged as usual. (UNIX only.) |
-log-anonymity |
Allows anonymous logging in usage log files. As a result, anonymous user name and host name details are used instead of the real ones. With this option, an XML file is also generated along with the usage log file. The XML file maps the anonymous user details with the real ones. It would be kept at the same path and will have the same name as the usage log file and .xml extension. The format of the log file is as follows: <?xml version="1.0" encoding="UTF-8"?> Where,
TipAlternatively, the LS_LOG_ANONYMITY environment variable can be used on the License Manager to allow creation of anonymous user details. |
Some License Manager options have a specific environment variable which can be used to set them. Refer to License Manager Specific Variables for details. You can also set any of these options using LSERVOPTS but this isn’t recommended. Any settings made with LSERVOPTS will be overridden by any settings made using a specific environment variable. To avoid contradictory settings, it’s recommended that the specific environment variables be used whenever possible.
For example, to tell the License Manager running on a Windows computer to set a 2 megabyte limit on the log file, to stop logging when the file size limit is reached, and to start the License Manager in quiet mode, use the following command:
SET LSERVOPTS=-z 2m -x -q