Log files and debugging

Logging can be enabled for the Four Js License Manager (FLM).

Requests and responses that are sent and received by the Four Js License Manager (FLM) may be recorded in log files. These logs are intended for the troubleshooting of licensing issues by decoding and reviewing events. You may be asked to activate logging in order to assist Four Js support with a licensing problem.

FLM logs

Logs can be enabled by setting the log entries in the $FLMDIR/etc/flmprofile.
FLM configuration

To affect licenses managed by the FLM server, enable logging in its configuration file.

; Four Js License Manager configuration

# ...

[log]
enabled=true
directory="${FLMDIR}/log"
categories="error,warning,info" # debug
maxfiles=5
maxsize="512M"
# ...
Where:
  • The enabled option, enables logging.
  • The categories option specifies the type of events to record in the logs; error, warning, info, and debug. The debug category will produce an additional log file with the extension .dlog.
  • The directory option specifies the directory where logs are stored.
  • The maxsize option specifies the maximum log file size. Log files will be rotated automatically when the specified size is reached. The default value is -1 (no limit).
  • The maxfiles option specifies the number of log files to keep before rotating. The default value is -1 (no limit). For more information on log file rotation, see Log file rotation.

After making a configuration change, you will need to restart the FLM. After the restart, you get the log file in the directory you specified.

For more information on working with the configuration file, see Configure the License Manager and Example: flmprofile.

FLM Log files
The FLM tool generates two distinct log files in the specified directory:
  • flmprg.log is the log created by the flmprg command.
  • flmprgd.log is the FLM daemon log file. This file records details of events set in the categories configuration. This file is affected by the log configuration for file rotation specified by maxfiles and maxsize. For more information on log file rotation, see Log file rotation.
  • If the category debug is enabled, the FLM produces an additional log file with the extension .dlog.
    Note: The .dlog logs are encoded and are not intended to be readable by users. These may be requested by your Four Js support center if you encounter issues.
    If logs are enabled and no directory provided, the output goes to stderr.
    Tip: License controller logs can also be enabled locally when using an FLM. For more information see the License logs page in Install and License your Genero Products manual

Contact your local Four Js support center for additional assistance.

Log file rotation

You enable the log rotation mechanism by configuring the maxsize and maxfiles elements. For example, when the FLM rotates the flmprgd.log files, it renames and renumbers the log files; flmprgd.log becomes flmprgd.1.log, flmprgd.1.log becomes flmprgd.2.log, etc.

When a log file reaches the maxsize, the FLM closes the file. It deletes the log file whose number exceeds the maxfiles value and it renames the other log files in the sequence by increasing their file number by one to make room for the new file. It creates a new flmprgd.log.