Skip to main content
Kofax

How to enable Core Worker Unity logging

Question / Problem: 

What are the steps for enabling additional logging for the Core Worker service?

Answer / Solution: 

The following steps explain how to enable/disable additional logging for the Core Worker service.

 

1. Stop the Core Worker service 

2. Navigate to C:\Program Files\Kofax\TotalAgility\CoreWorkerService. Substitute the drive letter used for the KTA installation if different from the C: drive.

3. Open the Agility.Server.Core.WorkerService.exe file in a text editor such as Notepad.

4. Navigate to the system.diagnostics section and locate the system.diagnostics element. It will look similar to the following.

<system.diagnostics>
<!--to enable TA Logging specify a trace listener with KTALog as name-->
<!--<add name="KTALog" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\temp\KTALog.txt">
</add>-->
</system.diagnostics>

5. Remove the comment characters "<!—" and "-->" to uncomment the following lines:

<!--<add name="KTALog" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\temp\KTALog.txt">
</add>-->

6. The resulting section should look like the following:

<system.diagnostics>
<!--to enable TA Logging specify a trace listener with KTALog as name-->
<add name="KTALog" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\temp\KTALog.txt">
</add>
</system.diagnostics>

7. Verify that the folder path for the log location exists. (C:\Temp in this example)

8. Save the changes to the Agility.Server.Core.WorkerService.exe file.

9. Restart the Core Worker service

10. Replicate the behavior that is to be captured in the logging. The results will be in the log file specified in the path.

11. Reverse the steps above to disable the logging once the necessary logs have been created.