How to enable Document Services and Data Layer logging

Issue

How do I enable Document Services (DS) & Data Layer (DL) logging in KTA?

Solution

WARNING: The recommendation is to attempt this on a lower environment before enabling in production.

Before proceeding be sure to make backup copies of the original config files.  In the relevant config file, replace the <system.diagnostics> section with the contents of the attached file (system diagnostics.txt).  To change the location the log files are written to, modify the initializeData property in the below lines.

 <add name="DocumentServicesTxt" initializeData="c:\temp\DocumentServices.TXT.log" type="System.Diagnostics.TextWriterTraceListener" 
 traceOutputOptions="ThreadId,DateTime">
     <filter type="System.Diagnostics.EventTypeFilter" initializeData="All"/>
 </add>
 <add name="DataLayerAll" initializeData="c:\temp\Kofax.CEBPM.DataLayer.log" type="System.Diagnostics.TextWriterTraceListener" 
 traceOutputOptions="ThreadId,DateTime"/>

To enable the DS & DL logging in the KTA website, the changes need to be made to the KTA web.config file (%INSTALLDIR%\TotalAgility\Agility.Server.Web).

NOTE: After making this change, an IISRESET will be needed for it to take affect.

To enable the DS & DL logging in the Core Worker service, the changes need to be made to the Agility.Server.Core.WorkerService.exe.config file (%INSTALLDIR%\TotalAgility\CoreWorkerService).

NOTE: After making this change, the Core Worker service will need restarted for it to take affect.

Level of Complexity 

Moderate

Applies to