2 <!-- SECTION: Getting Started -->
4 <TITLE>Using Network Printers
</TITLE>
5 <LINK REL=
"STYLESHEET" TYPE=
"text/css" HREF=
"../cups-printable.css">
9 <H1 CLASS=
"title">Using Network Printers
</H1>
11 <P>This help document describes how to discover, configure, and use TCP/IP network printers with CUPS.
</P>
13 <H2 CLASS=
"title"><A NAME=
"ADDRESS">Getting the IP Address
</A></H2>
15 <P>Every network printer or print server has a unique Internet Protocol (IP) address associated with it. This address is either configured manually or set using an automatic network protocol such as the
<A HREF=
"#BOOTP">Boot Protocol (BOOTP)
</A>,
<A HREF=
"#DHCP">Dynamic Host Control Protocol (DHCP)
</A>, Reverse Address Resolution Protocol (RARP), or ZeroConf.
</P>
17 <P>You can normally find the IP address of a printer on the printer's control panel or by printing the configuration or status page. The
<A HREF=
"#SNMP">Simple Network Management Protocol (SNMP)
</A> can also be used to get the IP address remotely, which happens automatically when you visit the CUPS administration web page or choose an available CUPS device when adding a printer.
</P>
20 <H2 CLASS=
"title"><A NAME=
"CONFIG">Configuring the IP Address
</A></H2>
22 <P>When you first install a network printer or print server on your LAN, you need to set the Internet Protocol (
"IP") address. Most higher-end
"workgroup" printers allow you to set the address through the printer control panel. However, if you have many printers you will want to assign the addresses remotely - this makes administration a bit easier and avoids assigning duplicate addresses accidentally.
</P>
24 <P>To setup your printer or print server for remote address assignment, you'll need the Ethernet Media Access Control (
"MAC") address, also sometimes called a node address, and the IP address you want to use for the device. The Ethernet MAC address can often be found on the printer test page or bottom of the print server.
</P>
26 <H3><A NAME=
"DHCP">Configuring the IP Address Using DHCP
</A></H3>
28 <P>The DHCP protocol is the usual way of setting the IP address of a printer on a managed network. Using the standard
<TT>dhcpd(
8)
</TT> program supplied with UNIX you simply need to add a line to the
<VAR>/etc/dhcpd.conf
</VAR> file:
</P>
31 host
<I>hostname
</I> {
32 hardware ethernet
<I>mac-address
</I>;
33 fixed-address
<I>ip-address
</I>;
37 <P>Make sure that the hostname you use is also listed in the
<VAR>/etc/hosts
</VAR> file or is registered with your DNS server.
</P>
39 <H3><A NAME=
"BOOTP">Configuring the IP Address Using BOOTP
</A></H3>
41 <P>The BOOTP protocol is used when you need to provide additional information such as the location of a configuration file to the network interface. Using the standard
<TT>bootpd(
8)
</TT> program supplied with UNIX you simply need to add a line to the
<VAR>/etc/bootptab
</VAR> file:
</P>
44 myprinter:ha=
080069001234:ip=
192.0.2.2:
<VAR>t144=myprinter.boot
</VAR>
47 <P>The
<VAR>myprinter.boot
</VAR> file resides in the
<VAR>/usr/local/boot
</VAR> directory by default. If you do not need to provide a boot file you may leave the last part of the line blank.
</P>
49 <BLOCKQUOTE><B>Note:
</B> Some versions of UNIX do not enable the BOOTP service by default. The
<VAR>/etc/inetd.conf
</VAR> or
<VAR>/etc/xinetd.d/bootp
</VAR> file usually contains a line for the BOOTP service that can be uncommented if needed.
</BLOCKQUOTE>
52 <H2 CLASS=
"title"><A NAME=
"VERIFY">Verifying the Printer Connection
</A></H2>
54 <P>To test that the IP address has been successfully assigned and
55 that the printer is properly connected to your LAN, type:
</P>
58 <KBD>ping ip-address
</KBD>
61 <P>If the connection is working properly you will see something
65 <KBD>ping myprinter
</KBD>
66 PING myprinter (
192.0.2.2):
56 data bytes
67 64 bytes from
192.0.2.2: icmp_seq=
0 ttl=
15 time=
5 ms
68 64 bytes from
192.0.2.2: icmp_seq=
1 ttl=
15 time=
3 ms
69 64 bytes from
192.0.2.2: icmp_seq=
2 ttl=
15 time=
3 ms
70 64 bytes from
192.0.2.2: icmp_seq=
3 ttl=
15 time=
3 ms
73 <P>If not, verify that the printer or print server is connected
74 to the LAN, it is powered on, the LAN cabling is good, and the IP
75 address is set correctly. You can usually see the current IP
76 address and network status by printing a configuration or test
77 page on the device.
</P>
80 <H2 CLASS=
"title"><A NAME=
"PROTOCOLS">Network Protocols Supported by CUPS
</H2>
82 <P>CUPS supports most network printers using one of three TCP/IP-based protocols. Printer discovery is currently accomplished using the SNMP protocol, however future versions of CUPS will also include support for multicast DNS service discovery as well.
</P>
84 <H3><A NAME=
"SOCKET">AppSocket Protocol
</A></H3>
86 <P>The AppSocket protocol (sometimes also called the JetDirect protocol, owing to its origins with the HP JetDirect network interfaces) is the simplest, fastest, and generally the most reliable network protocol used for printers. AppSocket printing normally happens over port
9100 and uses the
<tt>socket
</tt> URI scheme:
</P>
89 socket://
<i>ip-address-or-hostname
</i>
90 socket://
<i>ip-address-or-hostname
</i>/?option=value
91 socket://
<i>ip-address-or-hostname
</i>/?option=value&option=value
92 socket://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>
93 socket://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>/?option=value
94 socket://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>/?option=value&option=value
97 <P>The
"contimeout" option controls the number of seconds that the backend will wait to obtain a connection to the printer. The default is
1 week.
</P>
99 <P>The
"snmp" option controls whether the
<tt>socket
</tt> backend queries for supply and page count information via SNMP.
</P>
101 <P>The
"waiteof" option controls whether the
<tt>socket
</tt> backend waits for the printer to complete the printing of the job. The default is to wait.
</P>
103 <H3><A NAME=
"IPP">Internet Printing Protocol (IPP)
</A></H3>
105 <P>IPP is the only protocol that CUPS supports natively and is supported by some network printers and print servers. However, since many printers do not implement IPP properly, only use IPP when the vendor actually documents official support for it. IPP printing normally happens over port
631 and uses the
<tt>http
</tt>,
<tt>ipp
</tt>, and
<tt>ipps
</tt> URI schemes:
</P>
108 http://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>/
<i>resource
</i>
109 http://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>/
<i>resource
</i>?
<i>option=value
</i>
110 http://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>/
<i>resource
</i>?
<i>option=value&option=value
</i>
111 ipp://
<i>ip-address-or-hostname
</i>/
<i>resource
</i>
112 ipp://
<i>ip-address-or-hostname
</i>/
<i>resource
</i>?
<i>option=value
</i>
113 ipp://
<i>ip-address-or-hostname
</i>/
<i>resource
</i>?
<i>option=value&option=value
</i>
114 ipp://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>/
<i>resource
</i>
115 ipp://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>/
<i>resource
</i>?
<i>option=value
</i>
116 ipp://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>/
<i>resource
</i>?
<i>option=value&option=value
</i>
117 ipps://
<i>ip-address-or-hostname
</i>/
<i>resource
</i>
118 ipps://
<i>ip-address-or-hostname
</i>/
<i>resource
</i>?
<i>option=value
</i>
119 ipps://
<i>ip-address-or-hostname
</i>/
<i>resource
</i>?
<i>option=value&option=value
</i>
120 ipps://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>/
<i>resource
</i>
121 ipps://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>/
<i>resource
</i>?
<i>option=value
</i>
122 ipps://
<i>ip-address-or-hostname
</i>:
<i>port-number
</i>/
<i>resource
</i>?
<i>option=value&option=value
</i>
125 <P>The
<tt>ipp
</tt> backend supports many options, which are summarized in
<A HREF=
"#TABLE2">Table
2</A>.
</P>
127 <DIV CLASS=
"table"><TABLE SUMMARY=
"IPP URI Options">
128 <CAPTION>Table
2:
<A NAME=
"TABLE2">IPP URI Options
</A></CAPTION>
137 <TD><TT>compression=gzip
</TT></TD>
138 <TD>Specifies that print data should be compressed before sending.
</TD>
141 <TD><TT>encryption=always
</TT></TD>
142 <TD>Specifies that the connection to the IPP server should be encrypted using SSL.
</TD>
145 <TD><TT>encryption=ifrequested
</TT></TD>
146 <TD>Specifies that the connection to the IPP server should only be encrypted if the server requests it.
</TD>
149 <TD><TT>encryption=never
</TT></TD>
150 <TD>Specifies that the connection to the IPP server should not be encrypted.
</TD>
153 <TD><TT>encryption=required
</TT></TD>
154 <TD>Specifies that the connection to the IPP server should be encrypted using TLS.
</TD>
157 <TD><TT>snmp=false
</TT></TD>
158 <TD>Specifies that SNMP supply and page count queries should not be performed.
</TD>
161 <TD><TT>version=
1.0</TT></TD>
162 <TD>Specifies that version
1.0 of the IPP protocol should be used instead of the default version
2.0.
</TD>
165 <TD><TT>version=
1.1</TT></TD>
166 <TD>Specifies that version
1.1 of the IPP protocol should be used instead of the default version
2.0.
</TD>
169 <TD><TT>version=
2.1</TT></TD>
170 <TD>Specifies that version
2.1 of the IPP protocol should be used instead of the default version
2.0.
</TD>
173 <TD><TT>waitjob=false
</TT></TD>
174 <TD>Specifies that the IPP backend should not wait for the job to complete.
</TD>
177 <TD><TT>waitprinter=false
</TT></TD>
178 <TD>Specifies that the IPP backend should not wait for the printer to become idle before sending the print job.
</TD>
183 <H3><A NAME=
"LPD">Line Printer Daemon (LPD) Protocol
</A></H3>
185 <P>LPD is the original network printing protocol and is supported by many network printers. Due to limitations in the LPD protocol, we do not recommend using it if the printer or server supports one of the other protocols. LPD printing normally happens over port
515 and uses the
<tt>lpd
</tt> URI scheme:
</P>
188 lpd://
<i>ip-address-or-hostname
</i>/
<i>queue
</i>
189 lpd://
<i>username@ip-address-or-hostname
</i>/
<i>queue
</i>
190 lpd://
<i>ip-address-or-hostname
</i>/
<i>queue
</i>?
<i>option=value
</i>
191 lpd://
<i>username@ip-address-or-hostname
</i>/
<i>queue
</i>?
<i>option=value
</i>
192 lpd://
<i>ip-address-or-hostname
</i>/
<i>queue
</i>?
<i>option=value&option=value
</i>
193 lpd://
<i>username@ip-address-or-hostname
</i>/
<i>queue
</i>?
<i>option=value&option=value
</i>
196 <P><A HREF=
"#TABLE3">Table
3</A> summarizes the options supported by the
<tt>lpd
</tt> backend.
</P>
198 <DIV CLASS=
"table"><TABLE SUMMARY=
"LPD URI Options">
199 <CAPTION>Table
3:
<A NAME=
"TABLE3">LPD URI Options
</A></CAPTION>
208 <TD><TT>banner=on
</TT></TD>
209 <TD>Specifies that a banner page should be printed by the server.
</TD>
212 <TD><TT>contimeout=
<I>seconds
</I></TT></TD>
213 <TD>Specifies the number of seconds to wait for the connection to the server to complete.
</TD>
216 <TD><TT>format=c
</TT></TD>
217 <TD>Specifies that the print data is a CIF file.
</TD>
220 <TD><TT>format=d
</TT></TD>
221 <TD>Specifies that the print data is a DVI file.
</TD>
224 <TD><TT>format=f
</TT></TD>
225 <TD>Specifies that the print data is a plain text file.
</TD>
228 <TD><TT>format=g
</TT></TD>
229 <TD>Specifies that the print data is a Berkeley plot file.
</TD>
232 <TD><TT>format=l
</TT></TD>
233 <TD>Specifies that the print data is a raw (preformatted) print file.
</TD>
236 <TD><TT>format=n
</TT></TD>
237 <TD>Specifies that the print data is a ditroff file.
</TD>
240 <TD><TT>format=o
</TT></TD>
241 <TD>Specifies that the print data is a PostScript file.
</TD>
244 <TD><TT>format=p
</TT></TD>
245 <TD>Specifies that the print data is a plain text file that should be
"pretty" printed with a header and footer.
</TD>
248 <TD><TT>format=r
</TT></TD>
249 <TD>Specifies that the print data is a FORTRAN carriage control file.
</TD>
252 <TD><TT>format=t
</TT></TD>
253 <TD>Specifies that the print data is a troff Graphic Systems C/A/T phototypesetter file.
</TD>
256 <TD><TT>format=v
</TT></TD>
257 <TD>Specifies that the print data is a Sun raster file.
</TD>
260 <TD><TT>order=data,control
</TT></TD>
261 <TD>Specifies that the print data files should be sent before the control file.
</TD>
264 <TD><TT>reserve=none
</TT></TD>
265 <TD>Specifies that the backend should not reserve a source port.
</TD>
268 <TD><TT>reserve=rfc1179
</TT></TD>
269 <TD>Specifies that the backend should reserve a source port from
721 to
731 as required by RFC
1179.
</TD>
272 <TD><TT>sanitize_title=no
</TT></TD>
273 <TD>Specifies that the job title string should not be restricted to ASCII characters.
</TD>
276 <TD><TT>sanitize_title=yes
</TT></TD>
277 <TD>Specifies that the job title string should be restricted to ASCII characters.
</TD>
280 <TD><TT>snmp=false
</TT></TD>
281 <TD>Specifies that SNMP supply and page count queries should not be performed.
</TD>
284 <TD><TT>timeout=
<I>seconds
</I></TT></TD>
285 <TD>Specifies the number of seconds to wait for LPD commands to complete.
</TD>
291 <H3><A NAME=
"URI">Common Network Printer URIs
</A></H3>
293 <P>Once you have set the IP address you can access the printer or print server using the
<TT>ipp
</TT>,
<TT>lpd
</TT>, or
<TT>socket
</TT> backends.
<A HREF=
"#TABLE1">Table
1</A> shows a list of common network interfaces and printer servers and the settings you should use with CUPS:
</P>
295 <DIV CLASS=
"table"><TABLE SUMMARY=
"Common Device URIs">
296 <CAPTION>Table
1:
<A NAME=
"TABLE1">Common Device URIs
</A></CAPTION>
299 <TH>Model/Manufacturer
</TH>
300 <TH>Device URI(s)
</TH>
305 <TD>Apple LaserWriter
</TD>
306 <TD>lpd://
<I>address
</I>/PASSTHRU
</TD>
311 <A HREF=
"#AXIS">(see directions)
</A></TD>
312 <TD>socket://
<I>address
</I>:
9100<BR>
313 socket://
<I>address
</I>:
9101<BR>
314 socket://
<I>address
</I>:
9102</TD>
318 <TD>ipp://
<I>address
</I>/LPT1
<BR>
319 ipp://
<I>address
</I>/LPT2
<BR>
320 ipp://
<I>address
</I>/COM1
</TD>
323 <TD>Castelle LANpress
<SUP>TM
</SUP></TD>
324 <TD>lpd://
<I>address
</I>/pr1
<BR>
325 lpd://
<I>address
</I>/pr2
<BR>
326 lpd://
<I>address
</I>/pr3
</TD>
329 <TD>DPI NETPrint
</TD>
330 <TD>lpd://
<I>address
</I>/pr1
<BR>
331 lpd://
<I>address
</I>/pr2
<BR>
332 lpd://
<I>address
</I>/pr3
</TD>
335 <TD>DLink DP-
301P+
</TD>
336 <TD>socket://
<I>address
</I></TD>
339 <TD>EFI
® Fiery
® RIP
</TD>
340 <TD>lpd://
<I>address
</I>/print
</TD>
343 <TD>EPSON
® Multiprotocol Ethernet Interface Board
</TD>
344 <TD>socket://
<I>address
</I></TD>
347 <TD>Extended System ExtendNET
</TD>
348 <TD>lpd://
<I>address
</I>/pr1
<BR>
349 lpd://
<I>address
</I>/pr2
<BR>
350 lpd://
<I>address
</I>/pr3
</TD>
353 <TD>Hewlett Packard JetDirect
</TD>
354 <TD>socket://
<I>address
</I>:
9100<BR>
355 socket://
<I>address
</I>:
9101<BR>
356 socket://
<I>address
</I>:
9102</TD>
359 <TD>Intel
® NetportExpress XL, PRO/
100</TD>
360 <TD>lpd://
<I>address
</I>/LPT1_PASSTHRU
<BR>
361 lpd://
<I>address
</I>/LPT2_PASSTHRU
<BR>
362 lpd://
<I>address
</I>/COM1_PASSTHRU
</TD>
365 <TD>Lexmark
<SUP>TM
</SUP> MarkNet
</TD>
366 <TD>lpd://
<I>address
</I>/ps
</TD>
369 <TD>Linksys EtherFast
®<BR>
370 <A HREF=
"#LINKSYS">(see directions)
</A></TD>
371 <TD>socket://
<I>address
</I>:
4010<BR>
372 socket://
<I>address
</I>:
4020<BR>
373 socket://
<I>address
</I>:
4030</TD>
376 <TD>Linksys PSUS4
</TD>
377 <TD>lpd://
<I>address
</I>/lp
</TD>
381 <TD>lpd://
<I>address
</I>/ps
</TD>
384 <TD>Netgear WGPS606
</TD>
385 <TD>lpd://
<I>address
</I>/L1
<BR>
386 lpd://
<I>address
</I>/L2
</TD>
389 <TD>QMS
® CrownNet
<SUP>TM
</SUP></TD>
390 <TD>lpd://
<I>address
</I>/ps
</TD>
393 <TD>Tektronix
® PhaserShare
<SUP>TM
</SUP></TD>
394 <TD>socket://
<I>address
</I>:
9100</TD>
397 <TD>XEROX
® 4512 NIC
</TD>
398 <TD>lpd://
<I>address
</I>/PORT1
</TD>
401 <TD>XEROX
® XNIC
</TD>
402 <TD>lpd://
<I>address
</I>/PASSTHRU
</TD>
405 <TD>XEROX
® (most others)
</TD>
406 <TD>socket://
<I>address
</I>:
5503</TD>
412 <H2 CLASS=
"title"><A NAME=
"SNMP">Troubleshooting SNMP Discovery Problems
</A></H2>
414 <P>Whenever you view the administration web page or a list of supported device URIs, the
<tt>snmp
</tt> backend can probe the local network(s) using Simple Network Management Protocol (SNMP) v1 broadcasts. Printers that respond to these broadcasts are then interrogated for the make, model, and supported protocols, yielding a device URI that can be used to add the printer.
</P>
416 <P>That said, the SNMP requests sometimes expose problems in vendor implementations. If you are experiencing long delays in loading the CUPS web interface administration page, or if you don't see your printer listed, the following instructions will help you to diagnose those problems and/or provide important feedback to the CUPS developers so that we can correct problems and improve the SNMP backend in future releases.
</P>
420 <P>If you don't use
"public" as your community name, edit or create (as needed) a text file called
<VAR>/etc/cups/snmp.conf
</VAR> and put the following line in it:
</P>
422 <PRE CLASS=
"command">
423 Community
<I>your community name
</I>
426 <P>The SNMP backend will not be able to find any printers on your network if SNMP v1 or broadcasting are not supported on your network.
</P>
428 <H3>Basic Debugging
</H3>
430 <P>The SNMP backend supports a debugging mode that is activated by running it from a shell prompt. If you are using Bash (/bin/bash), Bourne shell (/bin/sh), Korn shell (/bin/ksh), or Z shell (/bin/zsh), you can run the following command to get a verbose log of the SNMP backend:
</P>
432 <PRE CLASS=
"command">
433 CUPS_DEBUG_LEVEL=
2 /usr/lib/cups/backend/snmp
2>&1 | tee snmp.log
436 <P>For C shell (/bin/csh) and TCsh (/bin/tcsh), use the following command instead:
</P>
438 <PRE CLASS=
"command">
439 (setenv CUPS_DEBUG_LEVEL
2; /usr/lib/cups/backend/snmp) |& tee snmp.log
442 <P>On MacOS X you'll find the SNMP backend in /usr/libexec/cups/backend instead:
</P>
444 <PRE CLASS=
"command">
445 CUPS_DEBUG_LEVEL=
2 /usr/libexec/cups/backend/snmp
2>&1 | tee snmp.log
448 <P>The output will look something like this:
</P>
450 <PRE STYLE=
"margin-left: 36pt">
451 1 INFO: Using default SNMP Address @LOCAL
452 2 INFO: Using default SNMP Community public
453 3 DEBUG: Scanning for devices in
"public" via
"@LOCAL"...
454 4 DEBUG:
0.000 Sending
46 bytes to
192.168.2.255...
455 5 DEBUG: SEQUENCE
44 bytes
456 6 DEBUG: INTEGER
1 bytes
0
457 7 DEBUG: OCTET STRING
6 bytes
"public"
458 8 DEBUG: Get-Request-PDU
31 bytes
459 9 DEBUG: INTEGER
4 bytes
1149539174
460 10 DEBUG: INTEGER
1 bytes
0
461 11 DEBUG: INTEGER
1 bytes
0
462 12 DEBUG: SEQUENCE
17 bytes
463 13 DEBUG: SEQUENCE
15 bytes
464 14 DEBUG: OID
11 bytes
.1.3.6.1.2.1.25.3.2.1.2.1
465 15 DEBUG: NULL VALUE
0 bytes
466 16 DEBUG:
0.001 Received
55 bytes from
192.168.2.229...
467 17 DEBUG:
community=
"public"
468 18 DEBUG: request-id=
1149539174
469 19 DEBUG: error-status=
0
470 20 DEBUG: SEQUENCE
53 bytes
471 21 DEBUG: INTEGER
1 bytes
0
472 22 DEBUG: OCTET STRING
6 bytes
"public"
473 23 DEBUG: Get-Response-PDU
40 bytes
474 24 DEBUG: INTEGER
4 bytes
1149539174
475 25 DEBUG: INTEGER
1 bytes
0
476 26 DEBUG: INTEGER
1 bytes
0
477 27 DEBUG: SEQUENCE
26 bytes
478 28 DEBUG: SEQUENCE
24 bytes
479 29 DEBUG: OID
11 bytes
.1.3.6.1.2.1.25.3.2.1.2.1
480 30 DEBUG: OID
9 bytes
.1.3.6.1.2.1.25.3.1.5
481 31 DEBUG: add_cache(addr=
0xbfffe170,
addrname=
"192.168.2.229",
482 uri=
"(null)",
id=
"(null)",
make_and_model=
"(null)")
483 32 DEBUG:
0.002 Sending
46 bytes to
192.168.2.229...
484 33 DEBUG: SEQUENCE
44 bytes
485 34 DEBUG: INTEGER
1 bytes
0
486 35 DEBUG: OCTET STRING
6 bytes
"public"
487 36 DEBUG: Get-Request-PDU
31 bytes
488 37 DEBUG: INTEGER
4 bytes
1149539175
489 38 DEBUG: INTEGER
1 bytes
0
490 39 DEBUG: INTEGER
1 bytes
0
491 40 DEBUG: SEQUENCE
17 bytes
492 41 DEBUG: SEQUENCE
15 bytes
493 42 DEBUG: OID
11 bytes
.1.3.6.1.2.1.25.3.2.1.3.1
494 43 DEBUG: NULL VALUE
0 bytes
495 44 DEBUG:
0.003 Received
69 bytes from
192.168.2.229...
496 45 DEBUG:
community=
"public"
497 46 DEBUG: request-id=
1149539175
498 47 DEBUG: error-status=
0
499 48 DEBUG: SEQUENCE
67 bytes
500 49 DEBUG: INTEGER
1 bytes
0
501 50 DEBUG: OCTET STRING
6 bytes
"public"
502 51 DEBUG: Get-Response-PDU
54 bytes
503 52 DEBUG: INTEGER
4 bytes
1149539175
504 53 DEBUG: INTEGER
1 bytes
0
505 54 DEBUG: INTEGER
1 bytes
0
506 55 DEBUG: SEQUENCE
40 bytes
507 56 DEBUG: SEQUENCE
38 bytes
508 57 DEBUG: OID
11 bytes
.1.3.6.1.2.1.25.3.2.1.3.1
509 58 DEBUG: OCTET STRING
23 bytes
"HP LaserJet 4000
511 59 DEBUG:
1.001 Probing
192.168.2.229...
512 60 DEBUG:
1.001 Trying socket://
192.168.2.229:
9100...
513 61 DEBUG:
192.168.2.229 supports AppSocket!
514 62 DEBUG:
1.002 Scan complete!
515 63 network socket://
192.168.2.229 "HP LaserJet 4000 Series"
516 "HP LaserJet 4000 Series 192.168.2.229" ""
519 <H3>Dissecting the Output
</H3>
521 <P>The first two lines are just informational and let you know that the default community name and address are being used. Lines
3-
15 contain the initial SNMP query for the device type OID (
.1.3.6.1.2.1.25.3.2.1.2.1) from the Host MIB.
</P>
523 <P>Lines
16-
31 show the response we got from an HP LaserJet
4000 network printer. At this point we discover that it is a printer device and then send another SNMP query (lines
32-
43) for the device description OID (
.1.3.6.1.2.1.25.3.2.1.3.1) from the Host MIB as well.
</P>
525 <P>Lines
44-
58 show the response to the device description query, which tells us that this is an HP LaserJet
4000 Series printer.
</P>
527 <P>On line
59 we start our active connection probe and discover that this print server supports the AppSocket (JetDirect) protocol on port
9100.
</P>
529 <P>Finally, line
63 shows the device information line for the print server that is sent to CUPS.
</P>
531 <H3>Reporting Problems
</H3>
533 If you don't see your printer listed, or the wrong information is listed, then you need to gather more information on the printer. The easiest way to do this is to run the snmpwalk command:
535 <PRE CLASS=
"command">
536 snmpwalk -Cc -v
1 -c public
<I>ip-address
</I> | tee snmpwalk.log
539 <P>where
"ip-address" is the IP address of the printer or print server. You should see a
<em>lot
</em> of values stream by - the ones you want to see are:
</P>
541 <PRE STYLE=
"margin-left: 36pt">
542 HOST-RESOURCES-MIB::hrDeviceType
.1 = OID: HOST-RESOURCES-TYPES::hrDevicePrinter
543 HOST-RESOURCES-MIB::hrDeviceDescr
.1 = STRING: HP LaserJet
4000 Series
546 <P>The hrDeviceType line should show hrDevicePrinter; if not, then your printer or print server doesn't identify itself as a printer. The hrDeviceDescr line should provide a human-readable string for the make and model of the printer, although in some cases you'll just see something less useful like
"Axis OfficeBASIC Parallel Print Server".
</P>
548 <P>Once you have collected the snmpwalk output, you should go to the
<A HREF=
"http://www.cups.org/str.php">CUPS Bugs
& Features page
</A> to submit a feature request to support your printer or print server. Be sure to attach those two log files you created - they will help us to identify the SNMP values we need to look for.
</P>
551 <H2 CLASS=
"title"><A NAME=
"SERVERS">Configuring Print Servers
</A></H2>
553 <H3><A NAME=
"AXIS">Configuring Axis Print Servers
</A></H3>
555 <P>The Axis print servers can be configured using BOOTP or DHCP. However, on models that do not provide IPP support an additional step must be performed to configure the TCP/IP portion of the print server for use with CUPS.
</P>
557 <P>Each print server contains a configuration file named
<VAR>config
</VAR> that contains a list of network parameters used by the server. To modify this file you must first download it from the print server using the
<TT>ftp(
1)
</TT> program:
</P>
559 <PRE CLASS=
"command">
560 <KBD>ftp ip-address
</KBD>
561 Connected to ip-address.
562 220 Axis NPS ### FTP Printer Server V#.## MON DD YEAR ready.
563 ftp
> <KBD>user root
</KBD>
564 331 User name ok, need password
565 Password:
<KBD>pass
</KBD> <I>(this is not echoed)
</I>
567 ftp
> <KBD>get config
</KBD>
568 local: config remote: config
569 200 PORT command successful.
570 150 Opening data connection for config (
192,
0,
2,
2),
572 226 Transfer complete.
573 ##### bytes received in #.## seconds (##### Kbytes/s)
578 <P>Next, edit the file with your favorite text editor and locate the lines beginning with:
</P>
580 <PRE CLASS=
"command">
592 <P>Change the
<TT>RTN_OPT
</TT> line to read:
</P>
594 <PRE CLASS=
"command">
595 RTN_OPT. :
<KBD>NO
</KBD>
598 <P>This disables the Reverse TELNET protocol and enables the standard TELNET protocol on the print server. Next, assign a port number for each parallel and serial port on the server as follows:
</P>
600 <PRE CLASS=
"command">
601 RTEL_PR1. :
<KBD>9100</KBD>
602 RTEL_PR2. :
<KBD>9101</KBD>
603 RTEL_PR3. :
<KBD>9102</KBD>
604 RTEL_PR4. :
<KBD>9103</KBD>
605 RTEL_PR5. :
<KBD>9104</KBD>
606 RTEL_PR6. :
<KBD>9105</KBD>
607 RTEL_PR7. :
<KBD>9106</KBD>
608 RTEL_PR8. :
<KBD>9107</KBD>
611 <P>This essentially makes the Axis print server look like a Hewlett Packard JetDirect EX print server. Save the file and then upload the new
<VAR>config
</VAR> file using the
<TT>ftp
</TT> command:
</P>
613 <PRE CLASS=
"command">
614 <KBD>ftp ip-address
</KBD>
615 Connected to ip-address.
616 220 Axis NPS ### FTP Printer Server V#.## MON DD YEAR ready.
617 ftp
> <KBD>user root
</KBD>
618 331 User name ok, need password
619 Password:
<KBD>pass
</KBD> <I>(this is not echoed)
</I>
621 ftp
> <KBD>put config CONFIG
</KBD>
622 local: config remote: CONFIG
623 200 PORT command successful.
624 150 Opening data connection for config (
192,
0,
2,
2), (mode ascii).
625 226 Transfer complete.
626 ##### bytes received in #.## seconds (##### Kbytes/s)
627 ftp
> <KBD>get hardreset
</KBD>
628 local: hardreset remote: hardreset
629 200 PORT command successful.
630 421 Axis NPS ### hard reset, closing connection.
635 <P>Your Axis print server is now ready for use!
</P>
637 <H3><A NAME=
"LINKSYS">Configuring Linksys Print Servers
</A></H3>
639 <P>The Linksys print servers can be configured using BOOTP or DHCP. Like older Axis print servers, an additional step must be performed to configure the TCP/IP portion of the print server for use with CUPS.
</P>
641 <P>Each print server contains a configuration file named
<VAR>CONFIG
</VAR> that contains a list of network parameters used by the server. To modify this file you must first download it from the print server using the
<TT>ftp(
1)
</TT> program:
</P>
643 <PRE CLASS=
"command">
644 <KBD>ftp -n ip-address
</KBD>
645 Connected to ip-address.
646 220 Print Server Ready.
647 Remote system type is Print.
648 ftp
> <KBD>get CONFIG
</KBD>
649 local: CONFIG remote: CONFIG
651 150 Open ASCII Mode Connection.
652 WARNING!
68 bare linefeeds received in ASCII mode
653 File may not have transferred correctly.
654 226 Transfer complete.
655 ##### bytes received in #.## seconds (##### Kbytes/s)
660 <P>Next, edit the file with your favorite text editor and locate the lines beginning with:
</P>
662 <PRE CLASS=
"command">
668 <P>Change the port number for each parallel and serial port on the server as follows:
</P>
670 <PRE CLASS=
"command">
671 0100 L1_PROUT:
<KBD>P1
</KBD>
672 0120 L2_PROUT:
<KBD>P2
</KBD>
673 0140 L3_PROUT:
<KBD>P3
</KBD>
676 <P>This maps each virtual printer with a physical port. Save the file and then upload the new
<VAR>CONFIG
</VAR> file using the
<TT>ftp
</TT> command:
</P>
678 <PRE CLASS=
"command">
679 <KBD>ftp -n ip-address
</KBD>
680 Connected to ip-address.
681 220 Print Server Ready.
682 Remote system type is Print.
683 ftp
> <KBD>put CONFIG
</KBD>
684 local: CONFIG remote: CONFIG
686 150 Open ASCII Mode Connection.
687 226 Transfer complete.
688 ##### bytes received in #.## seconds (##### Kbytes/s)
693 <P>Your Linksys print server is now ready for use!
</P>