What diagnostic steps should I follow and what information should I gather when there is an issue with Kofax Analytics for MarkView

Applies To

• ERP System : Oracle
• MarkView Version: 8.0 and higher Insight 5.3.0 and above

Overview

Kofax Analytics for MarkView is an extension of Kofax MarkView that produces a graphical business intelligence dashboard based on near real- time data collected during the batch processing workflow. Kofax Analytics for MarkView presents finance process data in graphical and interactive reports.

Troubleshooting Steps

If you encounter an issue with Kofax Analytics for MarkView, please review the following steps:

• Data is not coming into the Reports
  • Kofax Analytics for MarkView - Verification steps for troubleshooting data not coming into reports correctly
• Actions are failing to complete
  • Check the KAMV_ACTION_RESULT table    
    • The ERROR_MESSAGE column contains any relevant error messages.
    • The Result column is either 1 indicating a success or 0 indicating a failure.
• Database Reports Index Errors
  • Kofax Analytics for MarkView- Errors in Alert.log for Indexes Being Marked as Unusable.

Logging

Enable Debug Logging

• Kofax Analytics for MarkView Workflow Agent:
  • On the Kofax Capture/KTM Workstation
    • Open <AgentFolder> (the default location for the agent folder is usually in C:\Program Files (x86)\Kofax\Capture\Bin\ directory) Backup the KMWA.Agent.dll.config file.
    • Edit the KMWA.Agent.dll.config
    • Find the log4net configuration (<log4net>…</log4net>)
    • Find the line <root>
           <level value="INFO" />
    • Change the level from INFO to DEBUG
    • Restart all opened KC modules.
• Kofax Analytics for MarkView Workflow Service
  • On the Kofax Capture/KTM Workstation
    • Open <WinService> directory (as chosen when you did the initial install of the Workflow Service)
    • Backup the KMWA.WindowsService.exe.config
    • Edit the KMWA.WindowsService.exe.config
    • Find the log4net configuration (<log4net>…</log4net>)
    • Find the line <root>
           <level value="INFO" />
    • Change the level from INFO to DEBUG
    • Restart the Kofax for MarkView Analytics Service (from the windows services [services.msc] Middle Tier Application Server Logging WebLogic ;
• Kofax Insight Logging
  • To enable logging for Insight WCF Service, which can provide additional underlying information please take the steps below:
    • Navigate to the C:\Program files\Kofax\Insight 5.3.0\WcfDataService directory on the Insight Server.
    • Backup the web.config file.
    • Open the web.config file for editing.
    • Find the line containing "Insight.DataProcessing.Readers.IsLoggingEnabled"
    • Set the value to true
    • Then right click on the report that is causing problems, and select Logging.
    • Then Right click on the report and select reset

Disable Debug Logging

• Kofax Analytics for MarkView Workflow Agent:
  • On the Kofax Capture/KTM Workstation
    • Open <AgentFolder> (the default location for the agent folder is usually in C:\Program Files (x86)\Kofax\Capture\Bin\ directory)
    • Backup the KMWA.Agent.dll.config file.
    • Edit the KMWA.Agent.dll.config
    • Find the log4net configuration (<log4net>…</log4net>)
    • Find the line <root>
           <level value="DEBUG" />
    • Change the level from DEBUG to INFO
    • Restart all opened KC modules.
• Kofax Analytics for MarkView Workflow Service
  • On the Kofax Capture/KTM Workstation
    • Open <WinService> directory (as chosen when you did the initial install of the Workflow Service)
    • Backup the KMWA.WindowsService.exe.config
    • Edit the KMWA.WindowsService.exe.config
    • Find the line <root>
           <level value="DEBUG" />
    • Change the level from DEBUG to INFO
    • Restart the Kofax for MarkView Analytics Service (from the windows services [services.msc] Middle Tier Application Server Logging
• Kofax Insight Logging
  • To enable logging for Insight WCF Service, which can provide additional underlying information please take the steps below:
    • Navigate to the C:\Program files\Kofax\Insight 5.3.0\WcfDataService directory on the Insight Server.
    • Backup the web.config file.
    • Open the web.config file for editing.
    • Find the line containing "Insight.DataProcessing.Readers.IsLoggingEnabled"
    • Set the value to FALSE
    • Then right click on the report that is causing problems, and select Logging.
    • Then Right click on the report and select reset

Log File Location:

File location: All MarkView Components - Log File Locations

The Workflow Agent. and WorkFlow Service both log to the Application Event Viewer Log

The Following Log files Exist for Kofax Insight:

• WcfDataService.log
  • Info on services used to get data from MetricsMart to dashboardard service
  • Insight Authentication/administration service log
• DataProcessing.log
  • Logs dashboard queries to MetricsMart to get data for dashboard display
• InsightServer_WinApp.log
  • Execution details for data load
• Scheduler.log
  • Information on scheduled data load execution