Server log file

The server log file tema.log is in the installation_directory/wlp/usr/servers/server1/logs/ directory. The log file saves all actions related to the server and is the primary source of information for troubleshooting purposes. Each action in the log file is reported according to the UTC time zone, but the file also shows information about the local time zone of your server.

10.0.3 Production.log is no longer created. All information is stored in tema.log.

Settings that you can modify

Logging properties are set in the server.xml file that is in one of the following directories:
  • Linux installation_directory/wlp/usr/servers/server1
  • Windows icon installation_directory\wlp\usr\servers\server1
You can change the following settings:
messageFileName
The server log file name. The default name is tema.log.
logDirectory
The server log file location. The default location is:
  • Linux installation_directory/wlp/usr/servers/server1
  • Windows icon installation_directory\wlp\usr\servers\server1
maxFileSize
The maximum size (in MB) that a log file can reach before it is rolled over. To disable this attribute, set the value to 0. The default value is 10.
maxFiles
If an enforced maximum file size exists, this setting is used to determine the maximum number of iterations of the server log file. If the log file reaches the maximum size that is defined in the maxFileSize parameter, the remaining messages roll over to another iteration of the file.

Log level

There are four options to maximize the log level information:
  1. Performance log for data

    Performance logs are automatically enabled. You can disable the log using the query, update adm.control set value = 'false' where name = 'PERFORMANCE_LOGS_ENABLED'. To enable the log again, use the query, update adm.control set value = 'true' where name = 'PERFORMANCE_LOGS_ENABLED'.

  2. Debug log for data imports in Advanced Server setting. Change debug_logging_for_imports parameter before you import the data.
    Note: Enable the setting only when needed by the support team.
  3. BigFix Inventory application debug logs
    Modify jvm.options in one of the following directories:

    • Linux installation_directory/wlp/usr/servers/server1

    • Windows icon installation_directory\wlp\usr\servers\server1

    To modify the file, perform these steps:
    1. Change #-DTEMA_LOG_DEBUG=true to -DTEMA_LOG_DEBUG=true.
      Note: To change the log level from DEBUG to any other level, change the value of the parameter. For example, If the -DTEMA_LOG_DEBUG parameter is enabled, DEBUG level is used. If the #-DTEMA_LOG_DEBUG parameter is disabled, INFO level is used.
    2. Restart BigFix Inventory.
    3. After restarting, tema.log includes logs at DEBUG level.

    Starting from version 10.0.9, BigFix Inventory Server TEMA_LOG_DEBUG jvm.options flag is limited only to the application log. This allows to safely enable the option without impacting the data import log. Data import log is controlled by Advanced Server settings.

  4. Starting from version 11.0.7, you can enable DEBUG and TRACE logs dynamically without requiring a server restart. This is activated by adding a <logging> snippet to the customization.xml file in the installation_directory\wlp\usr\servers\server1 folder. Once enabled, these logs, which currently support Java code only, are written to trace.log and include all standard messages from the tema.log.
    Example:
    Global DEBUG
    <logging traceFormat='ENHANCED' traceSpecification='com.ibm.license.mgm.*=fine'/>
    Global TRACE
    <logging traceFormat='ENHANCED' traceSpecification='com.ibm.license.mgm.*=finer'/>
    Specific Module (e.g., ETL)
    <logging traceFormat='ENHANCED' traceSpecification='com.ibm.license.mgm.etl.*=fine'/>

Time zone

The time of all actions saved in the log file is according to the UTC time zone. You can choose to view these actions in your preferred time zone to analyze the cause. The server time zone is mentioned the beginning of the log file and is repeated every 1000 entries. The following examples are the excerpts from the log file:

Linux
[INFO]: Local Server Time Zone is +0200 Europe/Warsaw
Windows
[INFO]: Local Server Time Zone is CurrentTimeZone=-300 (UTC-06:00) DaylightBias=-60