Change the Log File Settings

ActivID CMS logging is controlled by a configuration file named logback.xml. You can find this file in the %PROGRAMDATA%\HID Global\Credential Management System\Local Files.

You do not need to restart the system in order for ActivID CMS to take changes into account. ActivID CMS automatically reloads the logging configuration every 60 seconds.

By default, ActivID CMS only logs error messages. If you encounter problems with ActivID CMS, you can change the logging mode to DEBUG. This configures ActivID CMS to provide additional details about the activity of the system. By doing so, the next time a problem occurs, you have more information available to help you resolve the problem.

To change to DEBUG mode:

  1. Open the logback.xml file with a text editor, and replace all instances of ERROR with DEBUG.

  2. Save your changes.

Note: It is not recommended to remain in debug mode permanently. As soon as you have resolved the problems encountered, you should change back to the default logging mode by replacing DEBUG with ERROR in the logback.xml file.

By default, ActivID CMS rotates each log file as soon as it reaches 10 MB, and keeps 20 old “slices” of each log file. Each old slice is renamed with a number.

If you need to change this policy—for example, if you think it is too much—you can change the parameters in the logback.xml file.

To do this:

  1. Open the logback.xml file with a text editor, and replace the following values:

    • <maxIndex>20</maxIndex>

      Replace 20 by the number of slices you want to keep.
      Note: There is one maxIndex value per log file; be sure to change all the relevant ones.

    • <MaxFileSize>10MB</MaxFileSize>

      Replace 10MB by the size you think is appropriate for each slice.
      Note: There is one MaxFileSize value per log file; be sure to change all the relevant ones.

  2. Save your changes.