IBM Support

How do I enable logging for Datacap Navigator 9.0?

Technote (FAQ)


Question

How do I enable various logging for Datacap Navigator 9.0?

Answer

These are the steps to turn on logging for IBM Datacap Navigator, versions 9.0 or higher. Although there are logging configuration options that can be used for different levels of logging, these steps are specific to providing maximum logging to troubleshoot Datacap Navigator issues when they occur. If desired, logging may be left on continuously for a test or development system, but should be set to minimum on a production server, as it will negatively impact performance.
1. Checking ICN and Daeja Viewer version:
http://<server>:<port>/navigator/Ping

2. Enabling Content Navigator Tracing

    a. Logon to ICN’s admin desktop as an administrative user.
    b. Navigating to Settings-->Logging and set the Application Logging to Debug.
    c. Click Save and Close.
    d. The trace information will be stored in Websphere SystemOut.log. The default location is <profile_root>\logs\ <servername>

3. Enabling wTM Tracing

Turn on wTM tracing by doing one of the following:
    a. Modify C:\datacap\wTM\Web.config if using wTM with IIS
or

    b. Modify c:\Datacap\Taskmaster\wTMservice.exe.config if using wTM Windows Service with the following values:
=========================
<setting name="logSeverity" serializeAs="String">
<value>0</value>
</setting>
<setting name="logOverwrite" serializeAs="String">
<value>False</value>
</setting>
<setting name="logPath" serializeAs="String">
<value>c:\Datacap</value>
</setting>
<setting name="logEnable" serializeAs="String">
<value>True</value>
</setting>
<setting name="logFlushBuffer" serializeAs="String">
<value>True</value>
</setting>
<setting name="logAtmEnable" serializeAs="String">
<value>True</value>

=========================

    c. Restart IIS or ‘Datacap Window Service’ in Windows Services panel for tracing to take effect.

    d. There will be two files: wtm.X.log and aTM.log.X.log in the location specified in the logPath parameter.


If using wTM with IIS, there will be an IIS log . The default location is C:\inetpub\logs\LogFiles\

5. The Datacap Navigator Client log can be seen one of two ways:


    a. Append “?logLevel=4” to the URL. Log will show up in a new window automatically, e.g.

    http://yourServerName:yourServerPort/navigator/?logLevel=4

    NOTE: If you are using a non-default desktop then the URL would look similar to this:

    https://yourServerName:yourServerPort/navigator/?desktop=datacap&logLevel=4



    You may also need to disable the pop up blocker, if applicable, since the log will be shown in a separate browser window.


or

    b. To display the log information in IE’s F12 console, use:

    https://yourServerName:yourServerPort/navigator/?desktop=datacap&logLevel=4&useConsole=true


Document information

More support for: Datacap

Software version: 9.0.0, 9.0.0.1, 9.0.0.2

Operating system(s): Windows

Reference #: 1960297

Modified date: 07 December 2016


Translate this page: