One critically important part of Samba printer configuration is distributing drivers to Windows clients. This task can be accomplished in several different ways. One approach that requires little explanation is to use the driver CD-ROM that came with the printer (or a generic PostScript driver for Ghostscript-driven printers) to install the driver on all the clients. This approach is simple enough on a small network, but it becomes awkward when many clients are involved. For these cases, SMB/CIFS provides mechanisms to help deliver drivers to many clients, and Samba supports these mechanisms.
Warning
If you fail to configure Linux to deliver a Windows printer driver,
Windows NT/200x/XP clients may display spurious
“unable to connect” error messages.
To avoid this problem, set use
client
driver
=
Yes. However, you should
not use this option if you configure Linux to
deliver printer drivers to Windows NT/200x/XP clients.
You can take a middle ground. Instead of using the semiautomated driver installation mechanisms described here, you can create an ordinary file share that holds the printer drivers. You can then install the drivers from that share on all the clients. This procedure obviates the need to carry a CD-ROM around from one computer to another, or to keep track of the CD-ROM for the benefit of computers you add after setting up the printer.
The first task you must undertake in driver installation is to select the drivers you want to install. To a large extent, this decision depends on whether you share the printer using a PostScript queue or a raw queue. (This difference is moot, of course, in the case of PostScript printers.) In many cases, though, you can choose between drivers from more than one source:
- OS drivers
Windows (and most other operating systems) ship with an array of printer drivers. You may be able to select a driver from among those that ship with the OS. This is true for both PostScript and non-PostScript drivers.
- Printer manufacturer drivers
Printer manufacturers invariably ship Windows drivers with their printers. For older printers, you may need to check the manufacturer’s web site to obtain drivers that can work with more recent versions of Windows.
- Adobe’s PostScript drivers
Adobe makes drivers for PostScript printers available from its downloads page (http://www.adobe.com/support/downloads/). These drivers are generic PostScript drivers that require PPD files to operate. (Adobe makes these available for printers with Adobe interpreters, as well.) They’re also licensed only for printers that use PostScript interpreters written by Adobe.
- The CUPS PostScript driver
A Windows PostScript driver is associated with the CUPS project. Because you can install this driver from the Samba server computer without the help of a Windows system, it’s particularly simple to install, as described in Section 4.4.3.1. The CUPS driver works only on Windows NT/200x/XP systems, however; if you need to deliver drivers to Windows 9x/Me systems, you’ll need another driver source, at least for those clients.
Because of the array of printers available today, I can’t make a blanket recommendation for what driver to use; any of the preceding classes of drivers might work well. In fact, chances are any of them will work well with most printers, with the exception of PostScript drivers if you already know you want to share a non-PostScript printer raw.
Samba 2.2 and later use a special file
share to deliver printer drivers. This share is defined as
[print$]. Ultimately, printer driver files will
reside in this share, but for the moment you must simply create it. A
typical [print$] share looks like this:
[print$] comment = Printer Driver Storage directory = /usr/share/samba/drivers browseable = No read only = Yes write list = gutenberg
The location of the shared directory is somewhat arbitrary, but the
key point is that it must exist. This directory must also be readable
to all those who might want to add printers to their machines.
You’ll typically give one or more users write access
to the share (gutenberg in this example). These
users are the printer administrators; they’re
authorized to add printer drivers to the share. Be sure that the
printer administrators have Linux write privileges to the location
you’ve chosen as the PRINT$ share
directory. You should also list these users on the
printer
admin line in the
[global] section of smb.conf:
printer admin = gutenberg
Before adding drivers, you must also define some printer shares. If
you want to share all the printers on the server, a
[printers] share, as described in the section
Section 4.5.4, should do nicely.
[printers] comment = All Printers path = /var/spool/samba printable = Yes
After you make these changes to smb.conf, you
must either wait a minute or two for Samba to discover and implement
the changes or force Samba to restart or reload its configuration
file.
Tip
Samba stores printer driver files in the PRINT$ share, but it stores information about
these files in Trivial Data Base (TDB) files located
elsewhere—typically in /var/cache/samba
and /var/cache/samba/printing. In theory, you
can edit these files with the help of Samba’s
rpcclient command, but unless
you’re an expert with this tool, doing so is
extremely tedious. In case of errors when installing printer drivers,
you may need to delete these files and start from scratch.
Once you’ve reconfigured
Samba with the PRINT$ share and one or more
printer shares, you can install Windows printer drivers in Samba. You
can perform this task from the Samba server, from another Linux or
Unix system, or from a Windows client. The CUPS driver can only be
installed from a Linux or Unix system, the Adobe PostScript driver
can be installed in either way, and most other drivers can be most
easily installed from a Windows client.
CUPS ships with a program, called cupsaddsmb , which can install Windows printer drivers on a Samba server computer. This command’s syntax is as follows:
cupsaddsmb [-Hsamba-server] [-Usamba-user] [-hcups-server] [-v] {-a |printer-list}
In the simplest case, you can type cupsaddsmb
-a on the server system as the printer
administrator. The system defaults to installing the CUPS drivers
from localhost to localhost. The -a
parameter tells the program to add drivers for all available CUPS
printers. If you don’t share all these printers, you
must specify them individually. The -v parameter
increases the verbosity of the program’s output,
which can be handy for debugging problems.
Of course, cupsaddsmb can’t
conjure printer drivers out of thin air; you must place them
somewhere the program can find them before
executing the program. By default, cupsaddsmb
looks for drivers in /usr/share/cups/drivers.
These drivers can come from one of two sources:
- The CUPS PostScript drivers for Windows
These drivers can be found at http://www.cups.org/windows.php. The CUPS documentation recommends using them. As of CUPS 1.1.20, though, these drivers support only Windows NT/200x/XP.
- The Adobe PostScript drivers for Windows
You can find Adobe’s drivers at http://www.adobe.com/support/downloads/. These drivers support Windows 9x/Me as well as NT/200x/XP.
In either case, you must install driver files in
/usr/share/cups/drivers, but how you place them
there depends on the driver. In the case of the CUPS drivers, you
download a tarball from the CUPS web site, extract the tarball, and
run the cups-samba.install script from the
tarball. This script asks for confirmation and installs the files in
/usr/share/cups/drivers. You can then run
cupsaddsmb to install the drivers on the Samba
server.
The Adobe drivers, on the other hand, were designed to be installed
from a Windows system to a Windows system. They come in the form of a
Windows executable (.EXE) file. This file is a
self-extracting Microsoft Cabinet archive, which can be extracted in
Linux using the cabextract program. (Check your
distribution for this program, or visit http://freshmeat.net/projects/cabextract/ to
download the source code or a binary package.) When you extract the
drivers file, you must copy several files into
/usr/share/cups/drivers, as detailed in Table 4-1. Note that cupsaddsmb
expects these files to appear in all-uppercase, but some of them are
in lowercase or mixed case in the archive; you need to rename some of
the files to change their case. Also, these files are scattered about
in the Windows and WinNT
subdirectories. In my experience, this option works well for Windows
NT/200x/XP, but Windows 9x/Me tends to complain about a missing
.INF file when installing the drivers installed
in this way. If you run into this problem, you may need to install
Windows 9x/Me drivers another way.
Table 4-1. Adobe PostScript driver files
|
Windows 9x/Me |
Windows NT/200x/XP |
|---|---|
|
ADFONTS.MFM |
ADOBEPS5.DLL |
|
ADOBEPS4.DRV |
ADOBEPSU.DLL |
|
ADOBEPS4.HLP |
ADOBEPSU.HLP |
|
DEFPRTR2.PPD |
- |
|
ICONLIB.DLL |
- |
|
PSMON.DLL |
- |
Once you’ve installed the CUPS or Adobe driver
files, you can type cupsaddsmb
-a or whatever variant you need to type, given
your printer administration username and other variables. The program
should ask for your password on the Samba server, copy the driver
files, and configure the server to deliver the files to clients when
they connect, as described in Section 4.4.4.
Unfortunately, cupsaddsmb is rather delicate and
sometimes doesn’t work correctly. Likely problems
include missing driver files, an attempt to install drivers without
appropriate privileges on the server, and a mismatch of CUPS and
Samba printer names (cupsaddsmb assumes that these
names match). If you have problems, check these items. You may also
want to add the -v parameter and check your Samba
log files for clues to the cause of the problem.
Tip
Whenever possible, cupsaddsmb copies the PPD files used by CUPS as part of the driver installation. Both the CUPS and Adobe PostScript drivers for Windows use PPD files. It’s possible, though, that the PPD file used by CUPS for Linux clients will not work well from Windows. If you suspect this is the problem, try replacing the PPD file on the Samba server and then re-install the driver on the clients. Look for a PPD file with your Windows PostScript driver package and copy it to the name and location in which Samba looks for the PPD file for that driver.
In theory, any Windows driver can be installed from Linux. The cupsaddsmb command merely copies files to the server and issues a few commands using the smbclient utility. You should be able to do the same for any printer driver files. In practice, though, the task is tedious without the help of cupsaddsmb, and it only supports the CUPS and Adobe PostScript drivers. For this reason, you may want to install some drivers from Windows clients. (This task can be accomplished only from Windows NT/200x/XP clients; Windows 9x/Me doesn’t support this operation.) Doing so employs the same facilities on the Samba server cupsaddsmb uses, but the Windows driver-installation tools use these features.
Tip
Some drivers, particularly for older printers, come with installation programs that assume the printer will be connected locally or that don’t support network installations. These drivers can be very difficult to install on a network print server. If you have such drivers and can’t find more network-friendly updates, you may want to consider creating an ordinary Samba file share in which you can place the installer. You can then run the installer from each client that needs to use the printer.
When installing drivers from Windows, you must take one extra step on the Samba server computer. Windows printer drivers are installed in fixed directories on the Samba server’s PRINT$ share. You must create these directories and set their permissions so that the user adding the drivers can write to them. Table 4-2 summarizes the directories you must add.
Table 4-2. Windows driver directories in PRINT$ share
|
Client OS |
Directory name |
|---|---|
|
Windows 9x/Me |
|
|
Windows NT/200x/XP for x86 CPUs |
|
|
Windows NT for Alpha CPUs |
|
|
Windows NT for MIPS CPUs |
|
|
Windows NT for PowerPC CPUs |
|
Before proceeding, you should obtain the driver installation files. If you choose to use a driver that ships with Windows, you need only the Windows installation CD-ROM. Alternatively, you can download drivers from the printer manufacturer, from Adobe, or conceivably from some other source. Once you’ve obtained the drivers, follow these steps on the Windows computer to install drivers for the OS you’re running:
In My Network Places, browse to the Samba server on which the share you want to install is located, and open the Printers and Faxes or Printers folder.
Right-click the printer you want to install and select Properties from the resulting pop-up menu. If no driver is installed, Windows asks if you want to install one.
Click No in response to the question about installing a driver. Clicking Yes will install a driver locally, not to the print server. Windows now displays a Properties dialog box.
Select the Advanced tab in the Properties dialog box.
Click the New Driver button in the Advanced tab of the Properties dialog box. Windows launches an Add Printer wizard to help guide you through the driver installation process.
Click Next in the Add Printer wizard’s introductory screen. The result is a dialog box in which you can select the make and model of your printer from a list of standard Windows drivers, as shown in Figure 4-3.
Select the driver for your printer from the list and click Next. Alternatively, click Have Disk to point the wizard at driver files you’ve obtained from another source.
The Wizard informs you that you’re about to add drivers. Click Finish to do so.
This procedure adds drivers for the OS that the client you used to install them is running. If you want to add drivers for additional operating systems, follow these steps.
Open the Properties dialog box for the printer in question, if necessary.
Click the Sharing tab in the Properties dialogue box.
Click the Additional Drivers button in the Sharing tab. This action brings up an Additional Drivers dialog box, as shown in Figure 4-4.
Check the box next to the Windows version for which you want to install drivers.
Click OK. Windows will ask for the location of the drivers.
Enter the path to the driver files or browse to them. The system will present a list of printers similar to that shown in Figure 4-3.
Select the printer and click OK. Windows should install the drivers.
Windows printer drivers, by their very nature, are Windows programs and so must be installed on Windows print clients. Installing them on a Samba server merely makes the drivers available for semiautomatic installation on Windows clients, thus obviating the need to keep track of driver installation CD-ROMs or files. Despite the fact that installing the drivers on the Samba server simplifies client driver installation, this task isn’t wholly automatic, at least not when using SMB/CIFS printing. To install a driver on a Windows client, follow these steps:
Browse to the print server that hosts the printer you want to add to the computer. You should see an icon for the printer you want to add. If you don’t, chances are the server is misconfigured.
Double-click the icon corresponding to the printer you want to add. The result is a notice that you’re about to connect to a printer and add a driver for it.
Click Yes to continue the setup process. In some versions of Windows (most notably Windows 9x/Me), you’ll be asked some additional questions, such as whether you intend to print to this printer from DOS programs.
If all goes well, you’ll see a dialog box summarizing the progress as the client transfers files from the server. An icon for the printer should then appear in your Printers or Printers and Faxes window, which you can open from the Control Panel. Windows 9x/Me asks if you want to print a test page during the install process. You should probably do so to test the printer’s operation, particularly on the first client you install. If you skip this step during installation but want to do so afterwards, right-click the printer icon in the Printers or Printers and Faxes window and select Properties from the resulting menu. This action opens a Properties dialog box. Click Print Test Page from the General tab in this dialog box to print a test page.
Tip
Under Windows NT/200x/XP, one reason you may not be able to print is because the printer data in the Registry didn’t get set correctly. You can set this data by setting the default page orientation in the printer control dialog box.
Some Windows PostScript printer drivers generate PostScript that can confuse Linux printer queues into thinking the file is plain text. The result is a printout of PostScript commands, rather than the file you’d intended to print. If this happens, you can try several solutions.
Look for client-side options to disable a Ctrl-D before the print job. This character, if present, can be the cause of problems.
Look for client-side options to disable printer mode-setting features. Some printer drivers generate special code to kick dual-language printers into PostScript mode, but this code can have the effect of confusing the Linux printer queue.
Define a new raw printer queue on the Samba server and share the printer using that queue rather than the normal queue used from Linux.
Change the driver used on the Windows client. If you’ve installed it in Samba, this action requires reinstalling the driver in Samba, which itself may require deleting TDB files.
Get Linux in a Windows World now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.
