How to Enable Debug in the Net Provider

KB Home   |   How to Enable Debug in the Net Provider

Please also see Reporting Problems

This is an advanced procedure and should only be undertaken when requested by the PaperCut Support team.

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.

The Net Provider is the component in PaperCut n-tiered architecture that interfaces with the Internet proxies. It is the layer closest to the proxy and hence debug here can help diagnose monitoring related problems.

To enable debug in PaperCut Net Provider:

1. Open the file:

[app-path]/providers/net/lib/log4j.properties
in a text editor.

2. Find the line that says log4j.logger.biz.papercut=info and change the info to debug.

3. Save the file.

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

5. Access a few web sites in a browser, 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 web pages (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/net/logs/net-provider.log
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 archive before sending.

8. Disable logging by reversing step 2.


Categories: Debugging, Troubleshooting


Keywords: net module,

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.

Article last modified on October 10, 2011, at 05:41 AM
Printable View   |   Article History   |   Edit Article