How To
Summary
Customers have a requirement to identify users who connect to IBM® Rational License Key Server (RLKS) and use licenses each month so that they can forecast monthly license usage. The customer would like the logs to be saved each month and start new logs.
Steps
On Windows:
1) Open the command prompt by right-clicking and selecting the 'Run as Administrator' option.
2) Navigate to license server installation directory
cd C:\Program Files(x86)\IBM\RationalRLKS\common
3) Execute the following command to rotate the log file
lmutil lmswitch [-c license_file_list] vendor new_debug_log
Example-
lmutil lmswitch -c "C:\Program Files(x86)\IBM\RationalRLKS\common\rational_server_perm.dat;C:\Program Files(x86)\IBM\RationalRLKS\common\rational_server_temp.dat" ibmratl lmgrd_Dec2020.log
4) Automation is achieved by adding this command with the complete paths to a Windows Scheduler job, which runs after a specified time period.
On Linux:
1) Navigate to the bin folder within the license server installation directory
cd /opt/IBM/RationalRLKS/bin/
2) Execute the following command to rotate the log file
./lmutil lmswitch [-c license_file_list] vendor new_debug_log
Example-
./lmutil lmswitch -c /opt/IBM/RationalRLKS/config/server_license.lic;/opt/IBM/RationalRLKS/config/rational_server_temp.dat ibmratl lmgrd_Dec2020.log
3) Automation is achieved by adding this command to crontab, which runs after a specified time period.
Additional Information
The latest version RLKS 8.1.6, uses the following 2 log files to store license usage information.
LMGRD.LOG - This is overwritten every time the license service is restarted. It is NOT rotated automatically.
RLKS.LOG - This file is NOT overwritten and is automatically rotated as soon as its size reaches 50MB.
Document Location
Worldwide
Product Synonym
Rational License Key Server; RLKS; LKS
Was this topic helpful?
Document Information
Modified date:
26 November 2020
UID
ibm16372900