What diagnostic steps should I follow and what information should I gather when there is an issue with Kofax Analytics for MarkView
Summary
13432
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
- 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.
- Check the KAMV_ACTION_RESULT table
- Database Reports Index Errors
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.
- On the Kofax Capture/KTM Workstation
- 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 ;
- On the Kofax Capture/KTM Workstation
- 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
- To enable logging for Insight WCF Service, which can provide additional underlying information please take the steps below:
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.
- On the Kofax Capture/KTM Workstation
- 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
- On the Kofax Capture/KTM Workstation
- 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
- To enable logging for Insight WCF Service, which can provide additional underlying information please take the steps below:
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
Keywords: kamv, diagnostic