Changes

== Cups for SME Server ==

{{Note box|This original version of this information is located [http://mirror.contribs.org/smeserver/contribs/rvandenaker/testing/smeserver-cups/documentation/ here].}}

 

=== Support ===

Although there is a maintainer for this Howto, there is not one location to request or provide support for this Howto.  Here are links to search results for [http://forums.contribs.org/index.php?action=search2&search=%22wiki.contribs.org/Cups%22&sort=id_msg|desc|"wiki.contribs.org/Cups" ] and [http://forums.contribs.org/index.php?action=search2&search=%22wiki.contribs.org/Cups%22&sort=id_msg|desc|"cups" ] in the forums.  You may want to research if others have had issues before continuing.

 

For '''SME Server 8''', CUPS installation can be found [http://wiki.contribs.org/Cups_for_SME_Server_8 here].

=== Maintainer ===

=== Maintainer ===

Installing CUPS is not difficult and can easily be reversed. These instructions are for both installing and uninstalling CUPS.

Installing CUPS is not difficult and can easily be reversed. These instructions are for both installing and uninstalling CUPS.

{{Warning box|To succesfully install this contrib you will need to remove a package from the base installation of SME Server}}

{{Warning box|To succesfully install this contrib you will need to remove a package from the base installation of SME Server}}

<ol></li><li>Remove e-smith-LPRng with yum

<ol><li>Remove e-smith-LPRng with yum</li>

yum remove e-smith-LPRng

  yum remove e-smith-LPRng

</li><li>Add the 'rvandenaker-cups' repository to yum

 

</li><li>Install cups and friends with yum

 

  wget http://mirror.contribs.org/contribs/rvandenaker/testing/smeserver-cups/repositories/7.0/RPMS/i386/gimp-print-cups-de-4.2.7-2.rvda.1.i386.rpm

wget http://mirror.contribs.org/contribs/rvandenaker/testing/smeserver-cups/repositories/7.0/RPMS/noarch/foomatic-filters-3.0.2-02.noarch.rpm

wget http://mirror.contribs.org/contribs/rvandenaker/testing/smeserver-cups/repositories/7.0/RPMS/noarch/smeserver-PrintAnalyzer-0.0.1-01.noarch.rpm

wget http://mirror.contribs.org/contribs/rvandenaker/testing/smeserver-cups/repositories/7.0/RPMS/noarch/urw-fonts-2.2-6.1.rvda.1.noarch.rpm

yum localinstall *

<ol><li="a">To install the CUPS printing system:

Then follow the instructions in the Installing Printers section below.

yum install cups --enablerepo=

<li>Add the 'rvandenaker-cups' repository to yum</li>

<li>Install cups and friends with yum

<ol><li="*">To install the CUPS printing system:</li>

</li><li="b">To install the CUPS printing system and the PrintAnalyzer reporting tool:

<li="*">To install the CUPS printing system and the PrintAnalyzer reporting tool:</li>

</ol><li>Clean up and reboot. Run the post-upgrade event and reboot your server:

</li></ol>

<li>Clean up and reboot. Run the post-upgrade event and reboot your server:

  /sbin/e-smith/signal-event post-upgrade

  /sbin/e-smith/signal-event post-upgrade

This step only applies to those who have completed steps 1 through 4, having picked option (a) in step 3, and then decide they want to install PrintAnalyzer!

This step only applies to those who have completed steps 1 through 4, having picked option (a) in step 3, and then decide they want to install PrintAnalyzer!

  yum install cups-printanalyzer --enablerepo=

  yum groupinstall cups-printanalyzer --enablerepo=rvandenaker-cups

  /sbin/e-smith/signal-event cups-upgrade

  /sbin/e-smith/signal-event cups-upgrade

</li></ol>

</li></ol>

===Uninstalling===

===Uninstalling===

<ol></li><li>Use yum to remove cups and friends

<ol></li><li>Use yum to remove cups and friends

Most conversion filters will get their input from the inbuilt pstoraster filter, a filter that converts PostScript to a generic raster format. This filter requires a gs binary with the cups device built in. A suitable ghostscript package is provided and is installed with your cups package. If you only want to use the inbuilt CUPS printer drivers, that's all you need. However, most people will want to install additional printer drivers. To install additional drivers for the en locale (to have English-language PPD's installed) do (this assumes you have added the rvandenaker-cups repository to your yum configuration):

Most conversion filters will get their input from the inbuilt pstoraster filter, a filter that converts PostScript to a generic raster format. This filter requires a gs binary with the cups device built in. A suitable ghostscript package is provided and is installed with your cups package. If you only want to use the inbuilt CUPS printer drivers, that's all you need. However, most people will want to install additional printer drivers. To install additional drivers for the en locale (to have English-language PPD's installed) do (this assumes you have added the rvandenaker-cups repository to your yum configuration):

  yum install cups-drivers-en

  yum --enablerepo=rvandenaker-cups groupinstall cups-drivers-en

Alternatively, substitute "de", "es", or "fr" for "en" to have German, Spanish, or French-language PPD's installed.

Alternatively, substitute "de", "es", or "fr" for "en" to have German, Spanish, or French-language PPD's installed.

The PPD adds a new "model" to the CUPS web interface. The PPD that I installed in the example adds the "HP DeskJet 400, Foomatic + cdj500 (en)" model in the "Hewlett-Packard" category. I had to change some of the driver settings (this is done through the "Configure Printer" option on the printers page in the CUPS web interface) before I was able to successfully print a test page. The only "color mode" that worked with my black ink cartridge was "Floyd-Steinberg Gray". I was not pleased with the result of the test page: printing was dead slow and the output quality rather poor. I then installed the PPD for the "pcl3" driver, and that was much better, so I removed the printer that used the "cdj500" driver and kept the "pcl3" printer.</li></ol>

The PPD adds a new "model" to the CUPS web interface. The PPD that I installed in the example adds the "HP DeskJet 400, Foomatic + cdj500 (en)" model in the "Hewlett-Packard" category. I had to change some of the driver settings (this is done through the "Configure Printer" option on the printers page in the CUPS web interface) before I was able to successfully print a test page. The only "color mode" that worked with my black ink cartridge was "Floyd-Steinberg Gray". I was not pleased with the result of the test page: printing was dead slow and the output quality rather poor. I then installed the PPD for the "pcl3" driver, and that was much better, so I removed the printer that used the "cdj500" driver and kept the "pcl3" printer.</li></ol>

====Adding a PDF printer through the CUPS web interface

====Adding a PDF printer through the CUPS web interface====

There are two types of PDF printers you can add: a raw PDF printer and a filtering PDF printer.

There are two types of PDF printers you can add: a raw PDF printer and a filtering PDF printer.

I recommend the filtering PDF printer because it does everything the raw PDF printer does and then some.

I recommend the filtering PDF printer because it does everything the raw PDF printer does and then some.

===Installing the pdfdistiller plugin===

===Installing the pdfdistiller plugin===

Either type of PDF printer requires the pdfdistiler plugin for CUPS. Install it with yum (this assumes you have added the 'rvandenaker-cups' repository to your yum configuration).

Either type of PDF printer requires the pdfdistiler plugin for CUPS. Install it with yum (this assumes you have added the 'rvandenaker-cups' repository to your yum configuration).

  yum install cups-pdfdistiller

  yum --enablerepo=rvandenaker-cups install cups-pdfdistiller ghostscript

====Adding a filtering PDF printer====

====Adding a filtering PDF printer====

You can either install the Adobe PostScript driver and basically follow the instructions for the other Windows versions, or you can install the cups-samba package, which contains a free PostScript driver for Windows NT4/2000/XP from the makers of CUPS, and use the cupsaddsmb command as explained below. The cupsaddsmb command exports the PostScript driver from the cups-samba package and the PPD('s) associated with your filtering CUPS queues to the Samba printer drivers directory, making them available for semi-automatic download to Windows NT4/2000/XP hosts.

You can either install the Adobe PostScript driver and basically follow the instructions for the other Windows versions, or you can install the cups-samba package, which contains a free PostScript driver for Windows NT4/2000/XP from the makers of CUPS, and use the cupsaddsmb command as explained below. The cupsaddsmb command exports the PostScript driver from the cups-samba package and the PPD('s) associated with your filtering CUPS queues to the Samba printer drivers directory, making them available for semi-automatic download to Windows NT4/2000/XP hosts.

<ol><li></li>Make sure that you've added at least one filtering queue and that you've "synchronized the printer lists" from the server-manager's printer panel.

<ol></li><li>Make sure that you've added at least one filtering queue and that you've "synchronized the printer lists" from the server-manager's printer panel.

<li></li>Install the cups-samba package, which provides a freely distributable PostScript driver for Windows NT4/2000/XP, with yum (this assumes you have added the 'rvandenaker-cups' repository to your yum configuration).

</li><li>Install the cups-samba package, which provides a freely distributable PostScript driver for Windows NT4/2000/XP, with yum (this assumes you have added the 'rvandenaker-cups' repository to your yum configuration).

  yum install cups-samba

  yum --enablerepo=rvandenaker-cups install cups-samba

<li></li>Set "use client driver = no" in smb.conf through the UseClientDriver database property.

</li><li>Set "use client driver = no" in smb.conf through the UseClientDriver database property.

  db configuration setprop smb UseClientDriver no

  db configuration setprop smb UseClientDriver no

  service smb restart

  service smb restart

<li></li>Run cupsaddsmb from the root prompt to "export" your printers. You can export individual printers with the command line

</li><li>Run cupsaddsmb from the root prompt to "export" your printers. You can export individual printers with the command line

  cupsaddsmb -U admin -v printer1 [printer2...printerX]

  cupsaddsmb -U admin -v printer1 [printer2...printerX]

These command lines connect to the samba server as admin, so you need to supply the admin password when prompted.

These command lines connect to the samba server as admin, so you need to supply the admin password when prompted.

<li></li>Printer setup on your Windows NT4/2000/XP hosts should now be a "Point 'n Print" affair. Just browse to a printer on your SME Server share, right click on it and select "Install..." or "Connect..." (depending on Windows version).

</li><li>Printer setup on your Windows NT4/2000/XP hosts should now be a "Point 'n Print" affair. Just browse to a printer on your SME Server share, right click on it and select "Install..." or "Connect..." (depending on Windows version).

<li></li>Repeat the previous step for all printers.</li></ol>

</li><li>Repeat the previous step for all printers.</li></ol>

====Printing from Windows 2000/XP over IPP====

====Printing from Windows 2000/XP over IPP====

====Printing from Linux through a local LPR spooler or standalone lpd client====

====Printing from Linux through a local LPR spooler or standalone lpd client====

CUPS provides the cups-lpd daemon for serving lpd clients. There is usually no need to enable this service, but in the rare case that your site does require it, [http://http://mirror.contribs.org/smeserver/contribs/rvandenaker/testing/smeserver-cups/documentation/howtos/hidden-settings.html#cups-lpd here] is how.

CUPS provides the cups-lpd daemon for serving lpd clients. There is usually no need to enable this service, but in the rare case that your site does require it, [http://mirror.contribs.org/smeserver/contribs/rvandenaker/testing/smeserver-cups/documentation/howtos/hidden-settings.html#cups-lpd here] is how.

=== Additional information ===

=== Additional information ===

Please report bugs to the maintainer of the contrib listed at the top as there is no category in the bugtracker for this contrib.

Please report bugs to the maintainer of the contrib listed at the top as there is no category in the bugtracker for this contrib.

----

----

[[Category: Contrib]]

[[Category: Howto]]

[[Category: Administration:Printing]]