Skip to main content
Kofax

Controlsuite : How to collect logs for Equitrac Workstation Client for Mac

Article # 3042469 - Page views: 80

Question:

In Controlsuite, how are Equitrac Workstation Client log files on a Mac created to assist in troubleshooting an issue?

Answer:

To generate trace files (log files) on the MAC workstation, perform the following steps:

  1. Open Terminal on the Mac.
  2. Navigate to the directory where Equitrac files are stored.
    • For MacOS 10.10 and newer: Library/Application Support/Equitrac (see attached PDF for screenshot)
    • For MacOS 10.9 and older: Library/Printers/Equitrac
  3. Create the following files in this location. NOTE* Be sure to match the file names EXACTLY, including the upper and lower case letters:
  • EOController.log
  • EOPrinterUtil.log
  • EOSharedEngine.log
  • EOTransport.log
  • EOPMon.log
  • EQDRESrv_Tracing_On.txt
  • EQDRESrv.log

Use the following commands to create the files:

touch EOController.log EOPrinterUtil.log EOSharedEngine.log EOTransport.log EOPMon.log EQDRESrv_Tracing_On.txt EQDRESrv.log

To add the correct file permissions, run the chmod command:

chmod a+rw EOController.log EOPrinterUtil.log EOSharedEngine.log EOTransport.log EOPMon.log EQDRESrv_Tracing_On.txt EQDRESrv.log

This will ensure there are correct Read/Write permissions set on the files.

4. Reboot the Mac where possible and reproduce the issue in question.

5. Open each file to verify contents. Some files may contain no data depending on what components are installed on the workstation.  In some cases, some files may show 0KB in size but still contain data.

6. Send a copy of all files to your Equitrac product support representative that requested them, together with the detailed steps to reproduce, including date/time, username, IP addresses, etc.

7. To disable the trace files, delete the seven files from the workstation.

rm EOController.log EOPrinterUtil.log EOSharedEngine.log EOTransport.log EOPMon.log EQDRESrv_Tracing_On.txt EQDRESrv.log

 

Attachments

Yosemite 10.10.pdf (125 KB)