openbsd-ports/print/hplip/patches/patch-doc_troubleshooting_html
ajacoutot f8bddf7e5a Major update to hplip-3.9.6b.
Refer to the project homepage for the complete changelog.

This port now comes into 5 subpackages (ala Fedora):
- main: complete hplip functionnalities
- hpijs: deprecated hpijs printer driver
- hpcups: new-gen printer driver
- libs: libraries and helpers used by other subpackages
- gui: graphical tools (systray applet...)

It seems this version works a least as good as the previous one we had
in-tree. I could use some feedbacks for the fancier stuffs that hplip
provides (besides regular printing using hpcups and/or hpijs), like
printer communication, ink levels... because I have no hp equipment, but
at least, there was no regression reported.
(some features are Linux-only and are expected not to work)

Tested by several, thanks!
2009-07-13 08:14:28 +00:00

48 lines
20 KiB
Plaintext

$OpenBSD: patch-doc_troubleshooting_html,v 1.1 2009/07/13 08:14:28 ajacoutot Exp $
--- doc/troubleshooting.html.orig Thu Jun 25 21:04:33 2009
+++ doc/troubleshooting.html Thu Jul 2 17:28:48 2009
@@ -25,7 +25,7 @@ section describes what is currently enabled or disable
example if you are having a problem setting up your parallel printer
check to be sure that pp-build=yes--if it does not you'll need to
reinstall hplip and enable parallel support.<span style="font-style: italic;"><span style="font-style: italic;"><span style="font-style: italic;"><span style="font-style: italic;"></span></span></span><br></span><h3 class="showhide_heading" id="System_Defaults">I/O Problems (Printer is not detected)</h3>
-<p>If the printer is not being detected by hp-setup check the following items:</p><p style="font-style: italic;">Is the printer supported by HPLIP?</p><p style="font-style: italic;">Is the printer powered on?</p><p style="font-style: italic;">Is the printer connected correctly with the proper type of cable?</p><p style="font-style: italic;">Is the printer in an error state? (i.e. out of paper, out of ink, etc.)</p><p style="font-style: italic;">Is the cable (usb/parallel/ethernet) in good working condition?</p><p><span style="font-weight: bold;">USB</span></p><p>If you run "/usr/lib/cups/backend/hp" you should get output similar to the following:</p><span style="font-style: italic;">&nbsp;&nbsp;&nbsp;
+<p>If the printer is not being detected by hp-setup check the following items:</p><p style="font-style: italic;">Is the printer supported by HPLIP?</p><p style="font-style: italic;">Is the printer powered on?</p><p style="font-style: italic;">Is the printer connected correctly with the proper type of cable?</p><p style="font-style: italic;">Is the printer in an error state? (i.e. out of paper, out of ink, etc.)</p><p style="font-style: italic;">Is the cable (usb/parallel/ethernet) in good working condition?</p><p><span style="font-weight: bold;">USB</span></p><p>If you run "${LOCALBASE}/libexec/cups/backend/hp" you should get output similar to the following:</p><span style="font-style: italic;">&nbsp;&nbsp;&nbsp;
direct
hp:/usb/HP_Color_LaserJet_CP1515n?serial=00XXXXXXXXXX "HP Color
LaserJet CP1515n" "HP Color LaserJet CP1515n USB &nbsp;&nbsp;&nbsp;
@@ -42,28 +42,28 @@ enterprises.11.2.3.9.1.1.7.0
LaserJet &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;
3380;CLS:PRINTER;DES:Hewlett-Packard LaserJet
-3380;MEM:23MB;COMMENT:RES=1200x1;" </span><br><br>If it does not there may be an snmp problem on your system and/or network.<br><br><span style="font-weight: bold;">Parallel<br><br></span>Was HPLIP installed with parallel support? &nbsp;Run hp-check -t and look in the for the following output:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; # Following values are determined at configure time and cannot be changed.<br>&nbsp;&nbsp;&nbsp; [configure]<br>&nbsp;&nbsp;&nbsp; network-build=yes<br>&nbsp;&nbsp;&nbsp; pp-build=no<br>&nbsp;&nbsp;&nbsp; gui-build=yes<br>&nbsp;&nbsp;&nbsp; scanner-build=yes<br>&nbsp;&nbsp;&nbsp; fax-build=yes<br>&nbsp;&nbsp;&nbsp; dbus-build=yes<br>&nbsp;&nbsp;&nbsp; cups11-build=no<br>&nbsp;&nbsp;&nbsp; doc-build=yes<br>&nbsp;&nbsp;&nbsp; shadow-build=no<br>&nbsp;&nbsp;&nbsp; foomatic-drv-install=yes<br>&nbsp;&nbsp;&nbsp; foomatic-ppd-install=no<br>&nbsp;&nbsp;&nbsp; foomatic-rip-hplip-install=yes<br>&nbsp;&nbsp;&nbsp; internal-tag=2.8.5.23<br></span><span style="font-style: italic;"></span><br>Find the section:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; pp-build=no<br><br><span style="font-style: italic;"></span></span>This should be "<span style="font-style: italic;">pp-build=yes</span>".<br><br>Is the ppdev module loaded?<br><br>Look for the output results from the hp-check -t for the following:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Checking for dependency: ppdev - Parallel port support kernel module....</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; OK, found.</span><br><span style="font-weight: bold;"><span style="font-weight: bold;"><br></span></span>If you are missing the ppdev module you can try running:<br><br>&nbsp;&nbsp;&nbsp; <span style="font-style: italic;">modprobe ppdev</span><br><br>Is your parallel port set to ECP mode in the BIOS?<br><br>If you run /usr/lib/cups/backend/hp do you should get an output similar to the following:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp;
+3380;MEM:23MB;COMMENT:RES=1200x1;" </span><br><br>If it does not there may be an snmp problem on your system and/or network.<br><br><span style="font-weight: bold;">Parallel<br><br></span>Was HPLIP installed with parallel support? &nbsp;Run hp-check -t and look in the for the following output:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; # Following values are determined at configure time and cannot be changed.<br>&nbsp;&nbsp;&nbsp; [configure]<br>&nbsp;&nbsp;&nbsp; network-build=yes<br>&nbsp;&nbsp;&nbsp; pp-build=no<br>&nbsp;&nbsp;&nbsp; gui-build=yes<br>&nbsp;&nbsp;&nbsp; scanner-build=yes<br>&nbsp;&nbsp;&nbsp; fax-build=yes<br>&nbsp;&nbsp;&nbsp; dbus-build=yes<br>&nbsp;&nbsp;&nbsp; cups11-build=no<br>&nbsp;&nbsp;&nbsp; doc-build=yes<br>&nbsp;&nbsp;&nbsp; shadow-build=no<br>&nbsp;&nbsp;&nbsp; foomatic-drv-install=yes<br>&nbsp;&nbsp;&nbsp; foomatic-ppd-install=no<br>&nbsp;&nbsp;&nbsp; foomatic-rip-hplip-install=yes<br>&nbsp;&nbsp;&nbsp; internal-tag=2.8.5.23<br></span><span style="font-style: italic;"></span><br>Find the section:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; pp-build=no<br><br><span style="font-style: italic;"></span></span>This should be "<span style="font-style: italic;">pp-build=yes</span>".<br><br>Is the ppdev module loaded?<br><br>Look for the output results from the hp-check -t for the following:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Checking for dependency: ppdev - Parallel port support kernel module....</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; OK, found.</span><br><span style="font-weight: bold;"><span style="font-weight: bold;"><br></span></span>If you are missing the ppdev module you can try running:<br><br>&nbsp;&nbsp;&nbsp; <span style="font-style: italic;">modprobe ppdev</span><br><br>Is your parallel port set to ECP mode in the BIOS?<br><br>If you run ${LOCALBASE}/libexec/cups/backend/hp do you should get an output similar to the following:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp;
direct
hp:/par/HP_LaserJet?serial=00XXXXXXXXXX "HP
LaserJet" "HP LaserJet&nbsp;PAR 00XXXXXXXXXX HPLIP"
"MFG:HP;MDL:HP &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;
-LaserJet&nbsp;;CLS:PRINTER;DES:HP&nbsp;LaserJet&nbsp;;SN:00XXXXXXXXXX;"</span><br><br>If the /usr/lib/cups/backend/hp does not detect the printer, HPLIP will not function.<h3 class="showhide_heading" id="Add_ons">Functionality Problems (print, scan, fax)</h3>
-<p style="font-weight: bold;">Print</p><p>Is the printer on-line and not in an error state?</p><p>If you run hp-check -t, are there any problems reported?</p><p>In the "hp-check -t", verify that the printer is configured:</p><p>Verify in the section DISCOVERED USB DEVICES that the printer is displayed.</p><p>Verify in the section INSTALLED CUPS PRINTER QUEUES that the printer queue is displayed.</p><p>Verify on the line PPD: that the ppd file matches the printer model.</p>Example:<br><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; --------------------------</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; | DISCOVERED USB DEVICES |</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; --------------------------</span><br style="font-style: italic;"><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; No devices found.</span><br style="font-style: italic;"><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; ---------------------------------</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; | INSTALLED CUPS PRINTER QUEUES |</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; ---------------------------------</span><br style="font-style: italic;"><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Photosmart_3300</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; ---------------</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Type: Printer</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Installed in HPLIP?: Yes, using the hp: CUPS backend.</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Device URI: hp:/net/Photosmart_3300_series?ip=15.252.39.136</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; PPD: /etc/cups/ppd/Photosmart_3300.ppd</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; PPD Description: HP PhotoSmart 3300 Foomatic/hpijs, hpijs 2.8.2.10 - HPLIP 2.8.2</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Printer status: printer Photosmart_3300 is idle.&nbsp; enabled since Tue 27 May 2008 01:58:02 PM PDT</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Communication status: Good</span><br><br>Are you able to print from any application?<br><br>View the syslog and try to print do you see any errors?<br><br>&nbsp;Run:<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;<span style="font-style: italic;"> tail -f /var/log/messages</span><p>The
+LaserJet&nbsp;;CLS:PRINTER;DES:HP&nbsp;LaserJet&nbsp;;SN:00XXXXXXXXXX;"</span><br><br>If the ${LOCALBASE}/libexec/cups/backend/hp does not detect the printer, HPLIP will not function.<h3 class="showhide_heading" id="Add_ons">Functionality Problems (print, scan, fax)</h3>
+<p style="font-weight: bold;">Print</p><p>Is the printer on-line and not in an error state?</p><p>If you run hp-check -t, are there any problems reported?</p><p>In the "hp-check -t", verify that the printer is configured:</p><p>Verify in the section DISCOVERED USB DEVICES that the printer is displayed.</p><p>Verify in the section INSTALLED CUPS PRINTER QUEUES that the printer queue is displayed.</p><p>Verify on the line PPD: that the ppd file matches the printer model.</p>Example:<br><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; --------------------------</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; | DISCOVERED USB DEVICES |</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; --------------------------</span><br style="font-style: italic;"><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; No devices found.</span><br style="font-style: italic;"><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; ---------------------------------</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; | INSTALLED CUPS PRINTER QUEUES |</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; ---------------------------------</span><br style="font-style: italic;"><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Photosmart_3300</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; ---------------</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Type: Printer</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Installed in HPLIP?: Yes, using the hp: CUPS backend.</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Device URI: hp:/net/Photosmart_3300_series?ip=15.252.39.136</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; PPD: ${SYSCONFDIR}/cups/ppd/Photosmart_3300.ppd</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; PPD Description: HP PhotoSmart 3300 Foomatic/hpijs, hpijs 2.8.2.10 - HPLIP 2.8.2</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Printer status: printer Photosmart_3300 is idle.&nbsp; enabled since Tue 27 May 2008 01:58:02 PM PDT</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Communication status: Good</span><br><br>Are you able to print from any application?<br><br>View the syslog and try to print do you see any errors?<br><br>&nbsp;Run:<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;<span style="font-style: italic;"> tail -f /var/log/messages</span><p>The
possible errors presented in the "messages" log can be varied.
&nbsp;You may need to reference your Linux distribution documentation
for more information.</p><p>View the cups log and try to print do you see any errors?</p><p>To view the cups log:<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; <span style="font-style: italic;">Edit
-the file /etc/cups/cupsd.conf to change the loglevel to debug, then
+the file ${SYSCONFDIR}/cups/cupsd.conf to change the loglevel to debug, then
restart cups /etc/init.d/cups restart (or the command may be /etc/init.d/cupsys
restart depending on your system configuration).</span></p><p style="font-weight: bold;">Scan</p>Is the printer on-line and not in an error state?<br><br>If you run&nbsp;hp-check -t are there any problems?<br><br>Within
the "hp-check -t" output, verify that the sane is configured correctly
in the SANE CONFIGURATION section. &nbsp;Here is an example of what you
-should see after running hp-check -t:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; 'hpaio' in '/etc/sane.d/dll.conf'...</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; OK, found. SANE backend 'hpaio' is properly set up.</span><br style="font-style: italic;"><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Checking output of 'scanimage -L'...</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; No scanners were identified. If you were expecting something different,</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; check that the scanner is plugged in, turned on and detected by the</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; sane-find-scanner tool (if appropriate). Please read the documentation</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; which came with this software (README, FAQ, manpages).</span><br><br>If
+should see after running hp-check -t:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; 'hpaio' in '${SYSCONFDIR}/sane.d/dll.conf'...</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; OK, found. SANE backend 'hpaio' is properly set up.</span><br style="font-style: italic;"><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Checking output of 'scanimage -L'...</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; No scanners were identified. If you were expecting something different,</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; check that the scanner is plugged in, turned on and detected by the</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; sane-find-scanner tool (if appropriate). Please read the documentation</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; which came with this software (README, FAQ, manpages).</span><br><br>If
you do not see this or get an error, edit the dll.conf file and add
hpaio. &nbsp;If the scanner is not detect using the scanimage be
sure that the printer is supported and working correctly.<br><p style="font-weight: bold;">Fax&nbsp;</p>Is the printer powered on and not in an error state?<br><br>If you run hp-check -t are there any problems?<br><br>If
you run hp-check -t is there a fax queue installed? &nbsp;You should
-see output similar to the following after running hp-check -t:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Photosmart_3300_fax</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; -------------------</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Type: Fax</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Installed in HPLIP?: Yes, using the hpfax: CUPS backend.</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Device URI: hpfax:/net/Photosmart_3300_series?ip=15.252.39.136</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; PPD: /etc/cups/ppd/Photosmart_3300_fax.ppd</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; PPD Description: HP Fax</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Printer status: printer Photosmart_3300_fax is idle.&nbsp; enabled since Thu 22 May 2008 01:32:01 PM PDT</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Communication status: Good</span><br><br>Is the phone line connected to the multifunction printer?<br><br>Can you fax a different document? (i.e. ensure that this is not a document-specific problem)<br><br>Is the receiving fax machine or device on-line and able to accept faxes?<br><h3 class="showhide_heading" id="Add_ons"><br></h3>
+see output similar to the following after running hp-check -t:<br><br><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Photosmart_3300_fax</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; -------------------</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Type: Fax</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Installed in HPLIP?: Yes, using the hpfax: CUPS backend.</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Device URI: hpfax:/net/Photosmart_3300_series?ip=15.252.39.136</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; PPD: ${SYSCONFDIR}/cups/ppd/Photosmart_3300_fax.ppd</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; PPD Description: HP Fax</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Printer status: printer Photosmart_3300_fax is idle.&nbsp; enabled since Thu 22 May 2008 01:32:01 PM PDT</span><br style="font-style: italic;"><span style="font-style: italic;">&nbsp;&nbsp;&nbsp; Communication status: Good</span><br><br>Is the phone line connected to the multifunction printer?<br><br>Can you fax a different document? (i.e. ensure that this is not a document-specific problem)<br><br>Is the receiving fax machine or device on-line and able to accept faxes?<br><h3 class="showhide_heading" id="Add_ons"><br></h3>
<p>
</p>