The table below lists the various options that can be set using:
The last column in the table points the specific environment variables which can instead used to set a particular option. 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.
Options-Description | Specific Environment Variable |
---|---|
-s <license-file> | |
By default, the license file is named lservrc and it is placed in the same directory in which the License Manager resides. It may contain multiple license codes. Usually, the Sentinel RMS utilities (lslic, WlmAdmin and lsmon) are used to install the license code in the license file. Here are few recommended settings for the license file:
|
LSERVRC |
-e <license-configuration-file> | |
Specifies the name and location of the optional license configuration file. The license configuration file can contain the following:
By default, the License Manager will look for the configuration file in the License Manager local directory. Alternatively, the location of the configuration file can also be provided by the environment variable, LSERVRCCNF or via the -e option. The License Manager appends the .cnf extension to the license configuration file path and filename and searches for license-file-name.cnf. See also: Alert Specifications. |
LSERVRCCNF |
-l < usage-log-file> | |
Sets the name and location of the License Manager’s usage log file. The usage log can give you a very good idea of how much each application is being used. Usage logging remains enabled on license addition for RMS version 7 and later licenses. On Windows, the default name and location for the usage log file is:
On UNIX, the default name of the usage log file is lservsta and is created at the location where the License Manager program (lserv) exists. Do not specify .xml as the extension name of the usage log file. If done, the License Manager will not start. |
|
-extended-log | |
Apart from the information included in the plain logs (generated when the extended-log is not used), the extended log option contains the following additional details:
|
|
-f <trace-log-file> | |
Specifies the name and location of the trace file. By default, trace logging is disabled. |
|
-tr <level> | |
Sets the tracing level defined here. |
|
-z <file-size> | |
Sets the maximum size of both the usage and trace file log (if logging is 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. In other words, if the -x option is specified, the log file (both usage and trace log) will not be backed up on overflow and the License Manager will stop writing further records to the log file.
|
|
-port <port-number> | |
The License Manager port number 5093 is used by the TCP/IP protocol when transferring data between the License Manager and the client. If that port is in use, any other port can be set using the -port startup option. |
LSPORT |
-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. The file, lservrlf, is created using the rlftool or WRlfTool utilities (or by using WlmAdmin to call WRlfTool) to define the redundant License Manager pool. By default, the License Manager’s local directory is searched for the lservrlf file to start the License Manager as a redundant License Manager. 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. 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. The group reservation feature helps you restrict the use of the licensed application to particular users, groups, or computers. A group reservation file lsreserv is generated using the WlsGrMgr utility. It contains information about how many license tokens are reserved for members of different groups. By default, the License Manager uses the lsreserv file in the current directory. |
LSRESERV |
-us | |
Use this option to specify upgrade license file.
If the base licenses lservrc is installed in the same directory in which the License Manager resides, then the upgrade license file ulservrc must reside in the same directory. If the base license is installed at a custom location (using the -s option or LSERVRC environment variable), then the upgrade license location can be configured using the -us option or ULSERVRC environment variable. |
ULSERVRC |
-sbm <socket buffer size multiplier> | |
Use this option to increase the socket buffer size. To change the size of default socket buffer, a multiplier value is assigned using this option. The multiplier increases the current buffer size by n times—subjected to the condition that the resultant socket size is within the maximum permissible size allowed by the operating system. Otherwise, the socket size is not updated. For example, assume the default socket buffer size of 2000 bytes, the multiplier value as 4, and maximum permissible size of socket buffer as 2500 bytes. Here, the given option will not change the socket buffer size to (2000*4) 8000 bytes because this value is more than the maximum permissible size defined by the operating system. The default socket buffer size will remain unchanged (2000 bytes). On Windows, the allocated socket buffer size is logged in the Windows event log after RMS License Manager startup. On UNIX based platforms, this information is displayed on the console while starting the License Manager. If any invalid multiplier value is provided, the default buffer size remains unaltered. On Windows, a message is also added to the Application Event log. On UNIX based platforms, a similar message is displayed on the console.
|
|
-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 the usage log files. As a result, real information for the following entries is shown anonymously in the usage log line:
Correspondingly, an XML file is generated along with the usage log file. The XML file maps the anonymous 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 XML file is as follows: <?xml version="1.0" encoding="UTF-8"?> Where,
|
LS_LOG_ANONYMITY |
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
See Also
Ways to Set the License Manager Options