Guideline GL35 – 
CUPS Driver Installation Procedure
ASCII-version

Abstract:
This Document describes how to install drivers, especially PPD files and filters, 
for Konica Minolta output devices for use with the Common Unix Printing System (CUPS).  
Both, automatic installation with the provided install script and manual installation, is covered here.

Version 1.4
July 19th 2007
Joerg Soos

System & Solution Support 
International Service & Support 
Konica Minolta Business Solutions Europe GmbH


Conventions used in this Document
Default terms in source code examples, which has to be adapted by users, are in brackets, like [this]
Commands that have to be executed as root are preceded by an #.
Commands that can be executed as user are preceded by an $.
In this Document the word 'driver' is used as a summarizing term for PPD files, 
a set of a PPD file and a filter or other driver related files. 
It is used whenever the exact type of driver does not matter. 

 
Automatic Installation
Most Konica Minolta driver package for CUPS comes with a install script. 
This script will install all needed files, in most cases this are PPD files and the filter.
To use the install script and the filter a working Perl interpreter has to be installed. 
The interpreter binaries are considered to be installed as /usr/bin/perl. 
This is the default location on most systems. If it is installed in another location on your system, 
please adapt the first line of the install script to fit your needs. 
Several settings, such as directory and path names are parsed out of the file 
/etc/cups/cupsd.conf directly by the install script.
If the cupsd.conf file is in a different location please specify the location when executing the install script.

Automatic Installation:

1. Extract the driver package
   To extract the driver package open a terminal, such as xterm or the KDE terminal.
   Extract the package with the command:
   $ tar -xvzf [package.tgz]

2. Call installation script (root privileges are needed here)
   Inside the new directory execute the command:
   # ./install.pl
   In some older driver packages use the command
   # ./install

   If the cupsd.conf file is in a different location please specify it
   # ./install.pl /here/and/there/cupsd.conf
   
   If the cupsd.conf file has a different name please specify it
   # ./install.pl /here/and/there/cups_configuration

3. Restart the CUPS server (root privileges are needed here)
   Restart the CUPS server with the command:
   # /etc/init.d/cups restart       or       # /etc/init.d/cupsys restart
   This command might vary depending on the Linux distribution you are using

4. Driver installation finished
   The driver installation is finished. You can now install printers with the 
   CUPS web interface or your preferred CUPS printer administration tool.


 
Manual Installation:

The files provided with the CUPS driver package can also be installed manually. 
It is not enough to install the PPD files only, you also have to install the filter to use the KM specific functions of the driver. 

A. Install the PPD file 

   Installation of the PPD file is working correspondent to any other PPD file.
   
   1. Extract the driver package
   To extract the driver package open a terminal, such as xterm or the KDE terminal.
   Extract the package with the command:
   $ tar -xvzf [package.tgz]
   
   2. Copy the PPD files to the CUPS PPD directory
   Mostly this directory is  /usr/share/cups/model
   or  /usr/share/ppd/custom
   or  /usr/share/foomatic/db/source/PPD/Custom/
   Otherwise you have to look up the path in the CUPS configuration file /etc/cups/cupsd.conf. 
   Here you can find the location of the DataDir. 
   Inside that directory you will find the directory model.
   After copying make sure the file is set with the correct access rights 644.

B. Install the filter

   You need to have root privileges to copy the filters into that directory. 
   By default the correct directory is /usr/lib/cups/filter.
   Otherwise you have to look up the path in the CUPS configuration file /etc/cups/cupsd.conf. 
   Here you can find the location of the ServerBin. 
   Inside that directory you will find the directory filter.
   After copying make sure the file is set with correct access rights 755.


C. Restart CUPS

  (root privileges are needed here)
   Restart the CUPS server with the command:
   # /etc/init.d/cups restart         or       # /etc/init.d/cupsys restart 
   This command might vary depending on the Linux distribution you are using
   The driver installation is finished. You can now install printers with the 
   CUPS web interface or your preferred CUPS printer administration tool.