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. Under the line #debug=on add the line:

Or simply remove the # comment from the existing line.

3. Save the file.

4. Some components may need to be restarted before debug logging is enabled.

• If running Windows: restart the PaperCut Print Provider Service under Control Panel -> Administrative Tools -> Services.
• If running Novell iPrint: restart the Print Manager from iManager.
• No restarts are required on Mac or Linux CUPS.

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