Introduction: Sometimes, diagnosing an issue with PRTK/DNA can be difficult and may necessitate reviewing debug data. The following will allow you to capture debug output from PRTK/DNA which can then be reviewed by QA and/or Development.
Procedure:
PRTK:
- Close PRTK and ensure ADEngineS.exe and ADEngineW.exe are not running
- Navigate to the following folder:
Windows XP/2003: C:\Documents and Settings\All Users\Application Data\AccessData\PR\log
Windows 7/2008: C:\ProgramData\AccessData\PR\log
Linux/Unix: /opt/AccessData/DNA - Delete all existing .log files.
- For each of the files PRTK_logger.conf, Supervisor_logger.conf, Worker_logger.conf, and DictUtil_logger.conf, do the following:
- Open the file in a text editor
- Change the line log4j.rootLogger=info, stdout, AD to say log4j.rootLogger=all, stdout, AD
- Save and close the file - Open PRTK and reproduce the steps to trigger the reported issue
- ZIP all the resulting .log files
- Follow the procedure outlined here to create and submit a ticket, ensuring you attach the ZIP with the logs to the ticket
- To disable logging (so they stop growing), for each of the files PRTK_logger.conf, Supervisor_logger.conf, Worker_logger.conf, and DictUtil_logger.conf, do the following:
- Open the file in a text editor
- Change the line log4j.rootLogger=all, stdout, AD to say log4j.rootLogger=info, stdout, AD
- Save and close the file
DNA Supervisor:
- Close DNA and stop the DNA Supervisor services from services.msc
- Open a Command Prompt (as Administrator)
- Navigate to the DNA folder (usually C:\Program Files\Accessdata\DNA\Supervisor)
- Run the following command to start the Supervisor Service:
java\bin\java -cp engine.jar dna3.Supervisor - Open a second Command Prompt (as Administrator)
- Navigate to the DNA folder (usually C:\Program Files\Accessdata\DNA\Supervisor)
- Run the following command to start the Supervisor GUI:
java\bin\java -cp adpr.jar dna.Main - Reproduce the steps to trigger the reported issue
- Select and copy all the content of the Command Prompt windows in text files
DNA Worker:
- Close DNA and stop the DNA Worker services from services.msc
- Open a Command Prompt (as Administrator)
- Navigate to the DNA folder (usually C:\Program Files\Accessdata\DNA\Worker)
- Run the following command to start the Worker Service:
java\bin\java -cp engine.jar dna3.Worker - Open a second Command Prompt (as Administrator)
- Navigate to the DNA folder (usually C:\Program Files\Accessdata\DNA\Worker)
- Run the following command to start the Worker GUI:
java\bin\java -jar ClientUI.jar - Reproduce the steps to trigger the reported issue
- Select and copy all the content of the Command Prompt windows in text files