troubleshooting printing with CUPS under FreeBSD June 29, 2007
Print jobs can get stuck at various points:
on the client workstation
in the CUPS queue
in the print server's buffer
in the printer's memory
To clear a stuck job:
turn off the printer
reboot the workstation
reset the CUPS queue for that printer in the CUPS control panel (see below)
reset the print server (using the CUPS control panel may work, if not, try a power cycle)
To reset the CUPS queue (the CUPS control panel may say 'LPR failed'):
access the control panel
click printers
check for all green lights - any red or orange are issues, yellow means 'in use'
stop the printer with issues
cancel all jobs
start the printer
Notes on accessing the CUPS control panel:
local users use the address https://IP.address.of.server:631/ - for example, https://192.168.1.100:631/
remote users use the address https://localhost:3000/ (because they see the server from the other side of an
SSH tunnel - this requires a L3000-R631 tunnel). If using remotely, the CUPS control panel may try to access localhost.yourdomain.com,
this will fail, correct the URL manually, or click a link - it only screws up when it does auto-refresh)
if a message is displayed "426 Upgrade Required", you are not using SSL. Change the
address in your browser to start with HTTPS, not HTTP.
if your browser prompts you to accept a certificate from the server, accept it (this is required to create an SSL session)
if the control panel prompts for a username and password, enter the root user's username and password
CUPS logs:
click the Administration tab in the CUPS control panel to view
they are stored on the server at /var/log/cups:
https://localhost:3000/admin/log/page_log
https://localhost:3000/admin/log/error_log
cat /var/log/cups/error_log | grep -v "[CGI]" | more
cat /var/log/cups/error_log | grep " \[Job " | more
set loglevel debug at top of cupsd.conf
misc:
CUPS can be restarted by altering the daemon configuration in the CUPS control panel
CUPS can be restarted from the commandline with /usr/local/etc/rc.d/cupsd restart
also on this site:
search: