How to Enable Debug in the Web Print Server

KB Home   |   How to Enable Debug in the Web Print Server

Main.HowToEnableDebugInWebPrint History

Hide minor edits - Show changes to output

August 19, 2019, at 11:56 PM by Brian - Added commands for systemD
Changed lines 29-30 from:
--> Restart the PaperCut Web Print service via [@/etc/init.d/pc-web-print restart@].
to:
--> Using Init scripts: Restart the PaperCut Web Print service via [@/etc/init.d/pc-web-print restart@].
--> Using systemd: Restart the PaperCut Web Print service via [@sudo systemctl status pc-web-print.service
@].
March 07, 2019, at 05:03 AM by timg - Privacy update
Changed lines 45-46 from:
'''8.''' [[https://www.papercut.com/contact/ | Submit your ticket]]!
to:
'''8.''' [[https://www.papercut.com/contact/ | Submit your ticket]]! By the way: your log files and other information you send to us will be treated with care in accordance with our [[https://www.papercut.com/privacy-policy/|privacy policy]].
Changed line 50 from:
''Categories:'' [[Category.WebPrint|+]]
to:
''Categories:'' [[Category.WebPrint|+]]
Added line 10:
February 13, 2019, at 01:26 PM by Jack Lawless - Title change, formatting
Changed lines 1-2 from:
(:title How to Enable Debug in the Web Print server :)
to:
(:title How to Enable Debug in the Web Print Server :)
Changed line 9 from:
!!To enable debug in the PaperCut Web Print Server:
to:
!!!To enable debug in the PaperCut Web Print Server:
February 13, 2019, at 01:24 PM by Jack Lawless - Re-formatted, grammar, URL links, added section for temp debug files locations
Changed lines 5-11 from:
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 ''Web Print Server'' is the component in PaperCut n-tiered architecture that accepts user uploaded documents and prints them on behalf of the user.

!!To enable debug in PaperCut Web Print Server:

'''1.''' Open the file:
to:
PaperCut has special '''debug options''' which cause PaperCut to produce a more 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 [[https://www.papercut.com/support/resources/manuals/ng-mf/applicationserver/topics/mobile-print.html | Web Print]] Server is the component in PaperCut that accepts user uploaded documents and prints them on behalf of the user.

!!To enable debug in the PaperCut Web Print Server:

'''1.''' Open the file in a text editor (for example, Notepad on Windows):
Changed lines 13-14 from:
->in a text editor (e.g. Notepad on Windows).
 
to:
Changed lines 19-21 from:
'''4.''' Restart Web Print according to your platform:
* '''If running in Sandbox Mode on a Windows system:'''
--> Restart the PaperCut Web Print GUI application (or restart the sandbox system).
to:
'''4.''' Restart Web Print according to your Operating System:
Changed lines 22-23 from:
--> Restart the service @@PaperCut Web Print@@ at '''Control Panel -> Administrative Tools -> Services'''
* '''If running on Mac OS X
in Simple Mode:'''
to:
--> Restart the @@PaperCut Web Print@@ service in the @@Services.msc@@ located in '''Control Panel -> Administrative Tools -> Services'''
* '''If running on Windows in Sandbox Mode:'''
--> Restart the PaperCut Web Print GUI application (or restart the server).
* '''If running on macOS
in Simple Mode:'''
Changed lines 30-32 from:
'''5.''' Print a few test documents via the end-user Web Print interface to duplicate/demonstrate '''the problem'''.

'''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.
to:
'''5.''' Print a few test documents via the end-user Web Print interface to duplicate/demonstrate the issue you're having.

'''6.''' Record the approximate time and date of the problem and the name of any printed documents (or the time you performed the test action).  This will help the Support Team and Developers match up log entries with your test activity.  Additional information such as what was observed or what was expected is always useful.
Changed lines 38-43 from:

->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 steps 2, 3 and 4.
to:
->If you're running on Web Print in [[https://www.papercut.com/support/resources/manuals/ng-mf/applicationserver/topics/mobile-print-setting-up-sandbox-mode.html | Sandbox Mode]], also zip up all the files located in:

            @@[=%USERPROFILE%=]\web-print-logs@@

->The User Profile will be the PaperCut Service account you created for your Sandbox Server as part of the installation.

'''8.''' [[https://www.papercut.com/contact/ | Submit your ticket]]!

'''9.''' Disable debug
logging by reversing steps 2, 3 and 4.
July 05, 2018, at 07:48 PM by Aaron Pouliot - Added category Web Print
Changed line 46 from:
''Categories:'' [[Category.Debugging|+]], [[Category.Troubleshooting|+]]
to:
''Categories:'' [[Category.WebPrint|+]]
Changed lines 20-25 from:
'''4.''' If running on Windows in Standard Mode, restart the ''PaperCut Web Print'' Service under '''Control Panel -> Administrative Tools -> Services'''.  If running on in Sandbox Mode, restart the PaperCut Web Print GUI application or restart the Sandbox system.

If running on Mac OSX you will need to restart the server running the PaperCut Application Server.

If running on Linux you can restart
the PaperCut Web Print service via [@/etc/init.d/pc-web-print restart@].
to:
'''4.''' Restart Web Print according to your platform:
*
'''If running in Sandbox Mode on a Windows system:'''
--> Restart the PaperCut Web Print GUI application (or restart the sandbox system).
* '''If running on Windows in Simple Mode:'''
--> Restart the service @@PaperCut Web Print@@ at '''Control Panel -> Administrative Tools -> Services'''
* '''If running on Mac OS X in Simple Mode:'''
--> Restart the system running the PaperCut Application Server.
* '''If running on Linux in Simple Mode:'''
--> Restart
the PaperCut Web Print service via [@/etc/init.d/pc-web-print restart@].
Changed lines 5-6 from:
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.
to:
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..
Changed lines 26-27 from:
'''5.''' Print a few test documents via the end-user Web Print interface to duplicate/demonstrate the problem.
to:
'''5.''' Print a few test documents via the end-user Web Print interface to duplicate/demonstrate '''the problem'''.
Changed lines 39-40 from:
'''8.''' Disable logging by reversing step 2.
to:
'''8.''' Disable logging by reversing steps 2, 3 and 4.
Changed lines 24-25 from:
If running on Linux you can restart the PaperCut Web Print service via '''/etc/init.d/pc-web-print restart'''.
to:
If running on Linux you can restart the PaperCut Web Print service via [@/etc/init.d/pc-web-print restart@].
Added lines 22-25:
If running on Mac OSX you will need to restart the server running the PaperCut Application Server.

If running on Linux you can restart the PaperCut Web Print service via '''/etc/init.d/pc-web-print restart'''.

Added lines 1-38:
(:title How to Enable Debug in the Web Print server :)

''Please also see [[ReportingProblems|+]]''

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 ''Web Print Server'' is the component in PaperCut n-tiered architecture that accepts user uploaded documents and prints them on behalf of the user.

!!To enable debug in PaperCut Web Print Server:

'''1.''' Open the file:
->[@[app-path]/providers/web-print/[platform]/web-print.conf@]
->in a text editor (e.g. Notepad on Windows).
 
'''2.''' Change the line [@debug=off@] to:
->[@debug=on@]
 
'''3.''' Save the file.
 
'''4.''' If running on Windows in Standard Mode, restart the ''PaperCut Web Print'' Service under '''Control Panel -> Administrative Tools -> Services'''.  If running on in Sandbox Mode, restart the PaperCut Web Print GUI application or restart the Sandbox system.

'''5.''' Print a few test documents via the end-user Web Print interface to duplicate/demonstrate the problem.

'''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 ''all'' files in:

            @@[app-path]/providers/web-print/[platform]/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 archive before sending.

'''8.''' Disable logging by reversing step 2.

----
''Categories:'' [[Category.Debugging|+]], [[Category.Troubleshooting|+]]

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 August 19, 2019, at 11:56 PM
Printable View   |   Article History   |   Edit Article