Knowledge Base
Home » Main » How to Enable Debug in the Application Server

How to Enable Debug in the Application Server

Please also see Reporting Problems

PaperCut has special debug options which cause PaperCut to produce a detailed text log of activity. The log allows our developers to inspect the internal workings of the PaperCut application and pinpoint the cause of problems. Enabling debug logging is only usually required of requested by the PaperCut Support team.

To enable debug in PaperCut's Application Server:

  1. Open the Admin interface and login as an admin user.
  2. Select the Options section, then the Advanced tab.
  3. Turn on the Enable debug option (a checkbox) and click Apply.
  4. Perform the problem action (e.g. Print a few test documents from a network workstation). Try to select a situation that is likely to cause the issue being investigated.
  5. Record the following information:
    • date and time of the print job that demonstrates the problem
    • name of any printed documents
    • username
    • printer-name
    • the IP and workstation name of the workstation that sent the job to the printer

All of this information will help the developers match up log entries with your test activity. Additional information such as what was observed or what was expected would also be useful.

  1. Zip up and email all files in: 
            [app-path]/server/logs/*.*
Include an explanation of the steps taken, along with any other other information requested by the PaperCut Developers.
Note: if the files are large, please place in a zip or equivalent archive before sending.
Note: if you archive the files, please check the archive before emailing it to see that it contains all the files you intended to send. (We have seen cases of zip files missing some logs.)

If requested to enable debugging in the PaperCut print provider, see here.

keywords: debug logging, debug mode

Categories: Debugging, Troubleshooting

Page last modified on March 29, 2011, at 02:35 AM

Comments

Share your findings and experience with other PaperCut users. Feel free to add comments and suggestions about this Knowledge Base article. Please don't use this for support requests.