Print Utility for UNIX (Debian Linux) V1.8 16 May 2008 =========================================================================== End User License Agreement ----------- Please read the following End User License Agreement (EULA) before using this software. EULA_en.txt ---> English version EULA_fr.txt ---> French version EULA_it.txt ---> Italy version EULA_de.txt ---> German version EULA_es.txt ---> Spanish version EULA_ja.txt ---> Japanese version Introduction ------------ The Print Utility for UNIX (Linux) allows you to take advantage of your KONICA MINOLTA printer's advanced features from a Linux environment. These features are available via: - kp, an interactive command line utility - kpp, which allows you to "pop up" kp from within an application - kpalias, which saves frequently used print commands for later use - the standard lpr and lp commands. System Requirements ------------------- - Linux 2.4 or higher - glibc - An Intel based computer - 4MB of disk space - LPR, LPRng or CUPS Print Spooler Before Installation ------------------- 1. The printer and print server must be installed and operational before installing this software. The PostScript printer option is required. You will need to know the printer's host name, the port name to print to, and any installed options (e.g. finisher). 2. You also need a PPD file which matches your printer/print server. The following PPD files are automatically installed: PPD file Engine Ko42422u.ppd bizhub 7222, 7322, 7228, 7235 Ko43245u.ppd 7145 Ko51165u.ppd 7155, 7165, Force 65 Ko51A65u.ppd 7255, 7272 Ko60175U.ppd 7075, Force 75 Ko60285u.ppd 7085, Force 85 KO1050U.ppd bizhub PRO 1050/1050P KO350U.ppd bizhub 350/250/200 KO500U.ppd bizhub 500/420/360 KO501U.ppd bizhub 501/421/361 KO750U.ppd bizhub 750/600 KO920U.ppd bizhub 920/PRO 920 KOC250U.ppd bizhub C250/C250P KOC252U.ppd bizhub C252 KOC351U.ppd bizhub C351 KOC352U.ppd bizhub C352/C352P/C300 KOC353U.ppd bizhub C353/C353P/C253/C203 KOC450U.ppd bizhub C450/C450P KOC451U.ppd bizhub C451 KOC650U.ppd bizhub C650/C550 KO8650U.ppd magicolor 8650 If your print system is not listed, please contact KONICA MINOLTA to get the appropriate PPD for your system. Once you have the PPD file, you can install it by copying the file to the ppd directory and setting the file ownership and permissions using: cp /etc/lp/ppd chown daemon /etc/lp/ppd/ chgrp lp /etc/lp/ppd/ chmod 444 /etc/lp/ppd/ 3. You must be logged in as root to perform the installation. 4. If you are upgrading, make a backup copy of /etc/lp/printutility and restore it when you are finished with the installation in order to retain your KONICA MINOLTA printer settings. Installation ------------ Setting up the printer for use under Linux consists of four steps: 1. Installing the software 2. Telling kp which print spooler to use 3. Adding a printer to lp system 4. Configuring the new printer to use the installed software. 1. Installing the software -------------------------- a. The installation kit is provided as a Debian package. Make sure you have the appropriate file for your platform. Intel Distributions: Package FileName: --------------------- ------------------------- Debian GNU/Linux 3.1 kmpu1.8-debian-intel.deb Debian GNU/Linux 4.0 kmpu1.8-debian-intel.deb b. To install it, type the following at the command line. dpkg -i kmpu1.8-debian-intel.deb 2. Telling kp which print spooler to use ------------------------------------ Kp support the traditional lpr, LPRng and CUPS spoolers. In order for kp to work properly, you need to tell kp which spooler to use by running the interactive utility, kpsetlp. It will prompt you for lpr, lprng or CUPS. It is already set to CUPS. If you have changed print spoolers, type the following command line: /opt/kmpu1.8/kpsetlp It will prompt you for lpr, LPRng or CUPS. 3. Adding a printer to the lp system ------------------------------------ a. To add a printer to the lp system, you can use the kpappendprinter utility or edit the /etc/printcap file by hand. Kpappendprinter will prompt you for the local print queue name, the printer's host name, and the printer's port and append the appropriate printcap entries to the printcap file. It also creates the spool directories. /opt/kmpu1.8/kpappendprinter Note: If you use CUPS, you have to use kpappendprinter. Because, kpappendprinter also set the KonicaMinolta filter to the CUPS filter path. a1. Alternatively, you can add printcap entries and create the spool directories by hand. Depending on the print spooling system you are running (LPRng or LPR), add a new printer in the /etc/printcap file that looks like the examples given below for your systems print spooler: [Example 1: For LPRng Spooling Systems] :\ :rm=:\ :rp=:\ :lpd_bounce:\ :sd=/var/spool/lpd/:\ :mx#0:\ :sh:\ :if=/usr/lib/kmpu/printutility.filter: where: printer - name of the local print queue you are creating hostname - the printer host name port - the printer's port, generally print [Example 2: For LPR Spooling Systems] :\ :lp=/dev/null:\ :sd=/var/spool/lpd/:\ :mx#0:\ :sh:\ :if=/usr/lib/kmpu/printutility.filter: :\ :sd=/var/spool/lpd/:\ :mx#0:\ :sh:\ :rm=:\ :rp=: where: lprinter - name of the local print queue you are creating rprinter - name of the remote printer hostname - the printer host name port - the printer's port, generally print a2. Create the spool directories. [Example 1: For LPRng Spooling Systems] mkdir /var/spool/lpd/ chown daemon:lp /var/spool/lpd/ chmod 700 /var/spool/lpd/ where: printer - name of the local print queue you are creating Type "checkpc -f" at the command line to verify that the new printers added to the printcap file have been setup correctly and that there spool queues have had there permissions properly set. [Example 2: For LPR Spooling Systems] mkdir /var/spool/lpd/ chown daemon:lp /var/spool/lpd/ chmod 755 /var/spool/lpd/ mkdir /var/spool/lpd/ chown daemon:lp /var/spool/lpd/ chmod 755 /var/spool/lpd/ where: lprinter - name of the local print queue you are creating rprinter - name of the remote printer b. Stop and start the print daemon. Note that you need to start and stop the print daemon after any change to the printer settings. [Example 1: For LPRng Spooling Systems] /etc/init.d/lprng stop /etc/init.d/lprng start [Example 2: For LPR Spooling Systems] /etc/init.d/lpd stop /etc/init.d/lpd start [Example 3: For CUPS Spooling Systems] /etc/init.d/cupsys stop /etc/init.d/cupsys start c. Make sure your new printer is up. lpc status 4. Configuring the new printer to use the installed software ------------------------------------------------------------ 1. Configure the new printer by using kpconfig. It will prompt you for the printer to configure. Select the printer you just added. You will be asked to pick a PPD file which matches your printer. The list of PPD files installed are displayed. Note that the Print Utility for UNIX will only work with KONICA MINOLTA printers. You will also be asked whether you want a control-D appended to each print job. Control-D is the end of job command and it is not harmful to always send it. It is optional as there are rare cases where this may cause problems. You should choose to append control-D unless you have reason not to. Finally, you will be prompted for "installable options". These are printer specific options such as additional memory, which you may have installed. Select the options which match your printer. /opt/kmpu1.8/kpconfig -a After Installation ------------------ At this point, everything should be operational. A sample postscript file is provided to test the installation. Using lp: cd /opt/kmpu1.8 lp -d test.ps Using kp: cd /opt/kmpu1.8 kp test.ps ============================================================================= FAQ --- 1. How can I determine which printing system is in use on my system? Probably the easiest way is to use rpm: # rpm -q LPRng If aren't using rpm and you have "strings", you can examine the lpd executable: # strings /usr/sbin/lpd | grep LPRng You can also look in /etc for a lpd.conf file which would indicate LPRng, and also if the lpr executable is a symbolic link, that would also indicate LPRng. 2. When I try to install the rpm, it fails the dependency check. What do I do? The normal distributions of kp for linux depend on the shared c runtime library libc.so.6 aka glibc2. As rpm uses it's own database for dependency checking, it may or may not be accurate. So the first step is to determine whether it is really available or not. If it is available, you can install the rpm with the --nodeps option. If it is not available, you can either install it or use the statically linked version of kp. To determine whether libc.so.6 is available on your system, look for libc.so.6 in the trusted system library areas. ls /lib/libc* /usr/lib/libc* 3. When I try to add the printcap entry, it complains about lpd_bounce and I can't print. This is due to running an older version of LPRng. lpd_bounce was introduced in version 3.6.1 of LPRng in March 1999. If you can't upgrade to a newer version, you can change the printcap entry to look like: :\ :bq=@:\ :lp=:\ :sd=/var/spool/lpd/:\ :mx#0:\ :sh:\ :if=/usr/lib/kmpu/printutility.filter: where: printer - name of the local print queue you are creating hostname - the printer host name port - the printer's port, generally print 4. My distribution is not listed. Can I use one of the others? Please contact to KONICA MINOLTA BUSINESS TECHNOLOGIES service person. 5. Should I use the "dynamically linked" or "statically linked" installation kit? The dynamically linked kit contains executables that depend on glibc2, which most modern distributions have installed by default. It is much smaller. The statically linked kit contained executables that are standalone and do not depend on glibc. The binaries are much larger. If you have glibc2, use the dynamically linked kit. 6. Can I set up the print queues without using kpappendprinter? No, if you use CUPS spooler. Yes, if you use lpr or LPRng spooler. The information you need is provided in the readme.txt file. 7. Do you support other spoolers? No, not at this time.