Please also see Reporting Problems

The enable debug option causes 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 debugging is only usually required if requested by the PaperCut Support team.

The Print Provider is the component in PaperCut n-tiered architecture that interfaces with the print queues. It is the layer closest to the printers and hence debug here can help diagnose monitoring related problems.

To enable debug in PaperCut Print Provider:

1. Open the file:

2. Remove the # from the start of the line #debug=on (i.e. remove the comment marker).

3. Save the file.

4. If running on Windows, restart the PaperCut Print Provider Service under Control Panel -> Administrative Tools -> Services. This step is not required on Mac or Linux.

5. Print a few test documents from a network workstation, or perform the problem action. Try to select a situation that is likely to cause the issue being investigated.

6. Record the approximate time of the problem and/or the name of any printed documents (or the time you performed the test action). This 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.

7. Zip and email the file:

            [app-path]/providers/print/[platform]/print-provider.log

8. Disable logging by reversing step 2.

Categories: Debugging, Troubleshooting