Switching the licensing debug log to reduce file size

The rlmswitch utility switches the debug log file written by a particular ISV daemon by closing the existing bug log for that ISV daemon and starting a new debug log with a new file name. Before proceeding, you should delete or archive the old file.

It also starts a new debug log file written by that ISV daemon if one does not already exist.

Using rlmswitch can be useful, as debug log files can become very large over time.

To execute the utility, you will first need to create it in your <server_install>/3rdparty/bin directory. Navigate to <validate_install>/3rdparty/bin. Now run the following command from <validate_install>/3rdparty/bin :

rlmutil rlmswitch <isv> <new_debug_log>

where

  • <isv> is the ISV daemon in the license file
  • <vendor> is the vendor daemon in the license file
    In this case, the vendor will always be validate (must be all lower case).
  • <new_debug_log> is the path to the new debug log file
rlmswitch also allows you to keep separate log files for different ISV.

Note that this can be set up to run automatically. On Windows, it can be done using the Windows Task Scheduler; on Unix, it can be done using a cron job.

Important: If the License Server is restarted, you need to specify the log file, or the default log file will be overwritten.