Enabling logging for FastDoc

To enable logging for FastDoc, you must edit the FastDoc.exe.config file and enable logging for Rulerunner Service. To confirm that logging is functional, complete an action in FastDoc and review the RRS.log file and the FastDoc.log file.

About this task

Although there are different levels of logging, these steps enable maximum logging to troubleshoot FastDoc when problems occur.

Procedure

To enable logging forFastDoc:

  1. Enable executable file logging.
    1. Go to the \Datacap\FastDoc folder and open the FastDoc.exe.config file.
    2. In the User Settings section, set Log = True and save the file.
  2. If you are running FastDoc in Local Mode, enable logging for the Rulerunner Service by completing these steps.
    1. Go to the \Datacap\FastDoc folder and open the BatchProfiles.xml file.
    2. Locate the rrslog tag that is specific to the task for which logging is needed and set ServiceLog=”5”.
    3. Save the BatchProfiles.xml file.
  3. If you are running FastDoc in Datacap Mode, enable logging for the Rulerunner Service by completing these steps.
    1. In the Rulerunner Service log settings for the workflow task in your web client administration panel, set the Rulerunner service log field to 5 and select the Flush Buffer check box.
      Note: Selecting the Flush Buffer option slows down the process because every line that is logged is written to the log file on disk, instead of being buffered in memory.
  4. Start FastDoc and start a task for which logging information is needed. Two log files are generated:
    • The X_rrs.log, where X is the name of the task. The file is in the batch folder of the application (for example, C:\datacap\TravelDocs\batches\20130924.00001\pageid_rrs.log), and contains information about actions that are completed by the Rulerunner engine.
    • The FastDoc.log. This file is in the \Users\username\AppData\Local\IBM\IBM Datacap\9.0.0.xx folder, and contains information about the FastDoc executable file.

What to do next

Disable the FastDoc executable file logging by setting Log = False in the FastDoc.exe.config file. You cannot completely disable the FastDoc Rulerunner logging, but you can create minimum logging by setting Rulerunner service log, Batch log, and Action log level to 0. Be sure to clear the Flush Buffer check box to avoid reduced performance.
Parent topic: Log files