Log files

Kofax Import Connector provides log files that can help with troubleshooting. Log files are stored in the application / program data folder of all users. The exact path (<path>) depends on the operating system:

  • C:\ProgramData\Kofax\KIC-ED (Windows Server 2012 R2, Windows 10 and later)

Manage logs in Message Connector

  1. Start Message Connector Configuration utility from the Kofax Import Connector group in the Windows Start menu.
  2. Click Advanced to display additional configuration options.
  3. Edit the settings on the Advanced tab.
    • The default values (TraceLevel 10 and MessageTraceSize 1) provide basic trace information (that is often sufficient) without negatively impacting performance.

    • Troubleshooting values (TraceLevel 40 and MessageTraceSize 100000) provide lot of information; these are more suitable when duplicating error situations in controlled environment.

    Refer to the Message Connector Help for more information about the parameters.

  4. Find log files in <path>\MC\log.
  5. Click Save and then click Exit and restart service.

Manage logs in KC Plug-In

  1. Go to the folder <path>\KC Plug-In\logconfig.
  2. Open the file Logger.config in a text editor.
  3. Edit the line starting with "<level value=". Use INFO for normal operation; use DEBUG for troubleshooting.
  4. Find log files in <path>\KC Plug-In\log.
  5. Restart the KC Plug-In service to make the changes effective.

Manage logs in KFXConverter

The default name of the log file is KFXConverter.log. The default location is C:\ProgramData\Kofax\KFXConverter. The maximum log file size is 5 MB. The file is overwritten when the maximum size is reached. You can specify another log file using the command line option -logFile <path>\<filename>. For example -logFile C:\temp\mylog.log.

For PDF/A normalization using Standard option in PDF to PDF/A conversion engine in Message Connector, conversion results are logged in StandardPDFAEngine.log.

For logging additional trace statements in case of errors or exceptions, do the following:

  1. In KC Plug-In Destination configuration, open the required destination.
  2. Select Advanced conversion details and click the AdvancedConversions button.

    The AdvancedConversionDetails window is displayed.

  3. Set the value of DebugLog parameter to True.
  4. Click Save and then Close.
  5. Save the destination.

Manage log data size

For Message Connector or KC Plug-In, you can configure different parameters to limit the size of log data.

  1. Open the Logger.config file in a text editor.
    Default path for:
    • KC Plug-In: C:\ProgramData\Kofax\KIC-ED\KCPlugIn

    • Message Connector: C:\ProgramData\Kofax\KIC-ED\MC\LogConfig

  2. Use the following parameters to maintain the log data size:

    • maximumFileSize: Maximum size of the log file. If size of the log file reaches the configured file size, it is saved as a backup file. For example, logfilename_yyyyMMddHHmmssffff.log. Default: 5120KB

    • maxDayRollBackups: Maximum the number of days for which a backup log files is retained. Any backup log file is deleted after maxDayRollBackups days.

      For example, to retain the backup log for three days, configure as shown:

      <maxDayRollBackups value="3" />

  3. Save and close the file.