Optimizing your Tricerat License Server Configuration

Each time you install the Tricerat License Server, your configuration file, lmx-serv.cfg, is reset to default values.  Many customers are running with default license server settings, but you might want to consider the suggestions below.

Before you start

Your license configuration file is located on your license server and is usually found in the C:\Program Files\Tricerat\Licensing or C:\Program Files\Tricerat\Simplify Licensing folder depending on your license server version.  The file lmx-serv.cfg controls your license server configuration.  Copy the lmx-serv.cfg file to your Desktop.  All edits will take place on your Desktop\lmx-serv.cfg copy.

Any line in the configuration file that begins with a # is a comment and the rest of the line is ignored.

Log Format

Here is the section of the configuration that specifies the log format: 

1 2 3 4 5 6 7 8 9 10 11 12 13 #************************************************* # Set the log file format. # The following formats are valid: # NORMAL, EXTENDED # Setting the log file format to EXTENDED causes # additional information to be included in the log # file, such as license server HostIDs, whether the # license server is a virtual machine, etc., which # is useful for debugging purposes. # #************************************************* # Examples: LOG_FORMAT = NORMAL

Two options are available, NORMAL and EXTENDED.  You may want to consider setting this to EXTENDED.  This will provide more information about your license server at startup and a summary after each check-out or check-in that describes the remaining available licenses.  Suggested:

 

1 LOG_FORMAT = EXTENDED

Log Exclude

Here is the section of the configuration that specifies data to exclude from the log:

1 2 3 4 5 6 7 8 9 10 11 12 #************************************************* # Exclude messages from the log. # The following messages can be excluded: # CHECKOUT, CHECKIN, STATUS, BORROW, BORROW_RETURN, # REMOVE_USER, REMOTE_RESTART, REMOTE_SHUTDOWN or # AUTOMATIC_DISCOVERY # # Syntax: # LOG_EXCLUDE = <message1, message2, etc.> #************************************************* # Example: # LOG_EXCLUDE = CHECKOUT, CHECKIN, STATUS

 Here is your chance to eliminate the status messages that occur every 5 seconds when the Tricerat License Server Console is running!  These messages add no useful information to the log file and just make the logfile larger.  Suggested:

 

1 LOG_EXCLUDE = STATUS

Log File Rotation

Here is the section of the configuration that specifies log file rotation:

1 2 3 4 5 6 7 8 9 10 11 #************************************************* # Specify how often to rotate the log file. # Valid values are "day," "week," or "month." # The log file rotation occurs at midnight for any of these settings. # Setting this to any value other than those given above disables log file rotation. # # Syntax: # LOGFILE_ROTATE_INTERVAL = <rotation_interval> #************************************************* # Example: # LOGFILE_ROTATE_INTERVAL = day

 The default is no rotation so the lmx-serv.log file just continues to grow day after day.  Three options are available, day, week, or month.  To help keep the logfile a reasonable size, we suggested rotating the log file daily.  Log files are rotated at midnight during a typically low activity period.  You can delete older log files to keep your system tidy.  Suggested:

 

1 LOGFILE_ROTATE_INTERVAL = day

Wrapping up

Now that you have edited your Desktop\lmx-serv.cfg copy of the configuration file, you are ready to update your configuration.  Suggested:

  • Rename the existing lmx-serv.cfg in the Licensing or Simplify Licensing folder to lmx-serv.cfgORIG

  • Copy your Desktop\lmx-serv.cfg to the Licensing or Simplify Licensing folder

  • Re-start the license server to take effect.  You can use the Services control panel or the Tricerat License Console.

  • Once the license service is re-started, look at the end of the lmx-serv.log and make sure no errors are noted.  You should see information about activation codes and feature names.

  • One of the best messages to see at the end of the log file is “Ready to serve...”

We hope you found this article interesting and informative.  If you have any questions, please contact Tricerat Customer Support.