
How to Enable Debug (collect logs) in the User Client
Please also see Reporting Problems
PaperCut has special debug options which causes PaperCut to produce a detailed text log of activity. The logs allow our developers to inspect the internal workings of the PaperCut application and pinpoint the cause of problems. Enabling debug logging is usually only requested by the PaperCut Support team.
The User Client is the component of PaperCut that runs on the user workstations. Its purpose is to display the Balance Window, allow job (cost) confirmation, allow charging to shared accounts, and in some cases perform authentication.
Tip: If you’re seeing mysterious behavior with the User Client, but not getting any error messages, check to see if the User Client has been configured to use the —silent option, which suppresses all error messages. Try running the client without this option, and see if the client then gives you any useful error message information first!
Note: There are two ways to enable debug logging: via the config file, or via a launch parameter. If the client is being launched from a network share (e.g. running pc-client-local-cache.exe
or pc-client.exe
from the PCClient
share on the server) then enabling debug in the config file will enable it for all users launching the client from that location. In that case, and if debug logging is only required for one workstation, enabling it via the launch parameter may be more suitable.
To enable debug in the PaperCut User Client:
[app-path]/client/[platform]/config.properties
You’ll find the Mac client config file at
[app-path]/client/mac/PCClient.app/Contents/Resources/config.properties
. To browse inside the PCClient
package option-click it and choose Show Package Contents.
Add a line
debug=Y
to the end and save the file (or remove the #
comment from the existing line).
OR
--debug
to the end of the command/target (ensuring there is a space between the command and the parameter).
pc-client-local-cache.exe
client requires the debug parameter method, not the config file modification.
If the command is quoted, the parameter should be added outside the quotes, separated by a space, e.g., on Windows:
"C:\Program Files\PaperCut\client\win\pc-client-local-cache.exe" --debug
user-client.log
(and pc-client-local-cache.log
if using pc-client.local.cache.exe
).
C:\Documents and Settings\[username]\Local Settings\Temp\user-client.log
C:\Users\[username]\AppData\Local\Temp\user-client.log
/Users/[username]/user-client.log
/tmp/user-client.log
Categories: How-to Articles, Logs, User Client
Keywords: user client tool, user client logs, pcclient logs, pcclient, UIT, user interface tool, balance window, diagnostic, credit display
Comments