3.4.2. Debug logging

Important notes

Risks of debug logging

Debug logging is not designed to be constantly enabled. It should only be used for investigating issues for short periods of time.

Keeping it enabled permanently may impact performances. If running for too long, the log file can become huge and significantly reduce the available disk space.

Required settings

In each case below, both of logfile and loglevel must be set or none of them.

Step-by-step guide

Windows

Enable debug logging

Perform the following steps to enable debug logging:

  1. Make sure that Central Management service is stopped.

    > net stop mdcentralmgmt

  2. Open the Windows Registry with regedit. Go to the HKEY_LOCAL_MACHINE\SOFTWARE\OPSWAT\Centralmgmt\logger entry.

  3. Add or modify the following entries with the following values:

    1. loglevel: debug,

    2. logfile: Path to the logfile, for example C:\Program Files\OPSWAT\Metadefender Central Management\data\mdcentralmgmt.log.

      Please note that the directory path must exist, logs are not written if the directory is not present.

  4. Close the registry editor.

  5. Start Central Management.

    > net start mdcentralmgmt

Disable debug logging

Perform the following steps to disable debug logging:

  1. Make sure that Central Management is stopped.

    > net stop mdcentralmgmt

  2. Open the Windows Registry with regedit. Go to the HKEY_LOCAL_MACHINE\SOFTWARE\OPSWAT\Centralmgmt\logger entry.

  3. Delete the following entries:

    1. loglevel,

    2. logfile.

  4. Close the registry editor.

  5. Start Central Management.

    > net start mdcentralmgmt

The log level debug can also be set for the wineventlog_level entry. Sending debug logs to the Windows Events would, however, flood the Event Viewer and as so it is not recommended.

Linux

Enable debug logging

Perform the following steps to enable debug logging:

  1. Make sure that Central Management service is stopped.

    # service mdcentralmgmt stop

  2. Open the configuration file: /etc/mdcentralmgmt/mdcentralmgmt.conf.

  3. Add or modify the following entries with the following values under the [logger] section:

    1. loglevel: debug,

    2. logfile: Path to the logfile, for example: /var/log/mdcentralmgmt/mdcentralmgmt.log (default) .

      Please note that the directory path must exist, logs are not written if the directory is not present.

  4. Save the configuration file.

  5. Start Central Management.

    # service mdcentralmgmt start

Disable debug logging

Perform the following steps to disable debug logging:

  1. Make sure that Central Management service is stopped.

    # service mdcentralmgmt stop

  2. Open the configuration file: /etc/mdcentralmgmt/mdcentralmgmt.conf.

  3. Delete the following entries:

    1. loglevel,

    2. logfile.

  4. Save the configuration file.

  5. Start Central Management.

    # service mdcentralmgmt start

See also

For information on how to modify the logging settings of the product see: 3.4.1. Configuration

For information on other data that OPSWAT support might require see: Knowledge Base/How to create support package?

For information on how to interpret the log files contents see: Knowledge Base/How to read the centralmgmt log?