SUSE
Linux Enterprise Desktop
10
March 2006
www.novell.com
IPRINT CLIENT USER GUIDE
Legal Notices
Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and
specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose.
Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time,
without obligation to notify any person or entity of such revisions or changes.
Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims
any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc.
reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to
notify any person or entity of such changes.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the
trade laws of other countries. You agree to comply with all export control regulations and to obtain any required
licenses or classification to export, re-export, or import deliverables. You agree not to export or re-export to entities
on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export
laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses.
Please refer to www.novell.com/info/exports/ for more information on exporting Novell software. Novell assumes no
responsibility for your failure to obtain any necessary export approvals.
Copyright © 2005-2006 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied,
stored on a retrieval system, or transmitted without the express written consent of the publisher.
Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this
document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S.
patents listed at http://www.novell.com/company/legal/patents/ and one or more additional patents or pending patent
applications in the U.S. and in other countries.
Novell, Inc.
404 Wyman Street, Suite 500
Waltham, MA 02451
U.S.A.
www.novell.com
Online Documentation: To access the online documentation for this and other Novell products, and to get
updates, see www.novell.com/documentation.
Novell Trademarks
Novell is a registered trademark of Novell, Inc. in the United States and other countries.
SUSE is a registered trademark of SUSE LINUX AG, a Novell business.
Third-Party Materials
All third-party trademarks are the property of their respective owners.
Preface
This manual is designed to introduce you to the iPrint Linux* Client include with SUSE® Linux
Enterprise Desktop and show you how to configure printing on your desktop.
This guide contains information about the following:
• “Understanding iPrint” on page 7
• “Installing the iPrint Linux Client” on page 9
• “Installing Printers” on page 11
• “Removing iPrint Printers” on page 11
• “Using iprntcmd” on page 12
• “Uninstalling the iPrint Client” on page 14
Feedback
We want to hear your comments and suggestions about this manual and other documentation
included with this product. Please use the User Comments feature at the bottom of each page of the
online documentation, or go to www.novell.com/documentation/feedback.html and enter your
comments there.
Additional Documentation
For information about installing and administering SUSE Linux Enterprise Desktop, see the SUSE
Linux Enterprise Desktop Deployment Guide (http://www.novell.com/documentation/nld/
nld_deployment/data/front.html).
Documentation Conventions
®
In Novell
items in a cross-reference path.
A trademark symbol (
trademark.
When a single pathname can be written with a backslash for some platforms or a forward slash for
other platforms, the pathname is presented with a backslash. Users of platforms that require a
forward slash, such as Linux or UNIX*, should use forward slashes as required by your software.
documentation, a greater-than symbol (>) is used to separate actions within a step and
®
, TM, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party
5
6 SUSE Linux Enterprise Desktop iPrint Client User Guide
1
Setting Up iPrint on Client Workstations
When installing SUSE® Linux Enterprise Desktop (SLED), you can choose to install the iPrint
Linux Client. The iPrint Client lets you easily install printers using your Web browser. The
following sections help you understand and use the iPrint client:
• Section 1.1, “Understanding iPrint,” on page 7
• Section 1.2, “Understanding Security,” on page 8
• Section 1.3, “Installing the iPrint Linux Client,” on page 9
• Section 1.4, “Installing Printers,” on page 11
• Section 1.5, “Removing iPrint Printers,” on page 11
• Section 1.6, “Managing Print Jobs from the Client,” on page 12
• Section 1.7, “Using iprntcmd,” on page 12
• Section 1.8, “Uninstalling the iPrint Client,” on page 14
1.1 Understanding iPrint
The iPrint system consists of two pieces: the iPrint Manager that runs on the server and the iPrint
Client that runs on the workstation.
1
1.1.1 iPrint Manager
The iPrint Manager does the following:
• Spools print jobs from clients
• Sends print jobs to printers
• Maintains printer status information
• Manages the print database
• Maintains the iPrint Printer List page used to install and monitor printers
1.1.2 iPrint Client
The iPrint Client lets Linux workstations install iPrint printers and includes the following
components:
• Browser plug-in: The iPrint Client contains a browser plug-in for Mozilla*-based browsers.
This plug-in lets you install printers into CUPS using your Web browser.
• Console utility: The Linux iPrint client includes the iprntcmd utility that lets you install
printers, print test pages, and upload drivers to a driver store from a console prompt. For more
information, see Section 1.7, “Using iprntcmd,” on page 12.
• CUPS Integrator: The client integrates with the CUPS backend and uses the CUPS local
spooler to send print jobs to the Print Manager.
Setting Up iPrint on Client Workstations
7
•CASA: CASA (Common Authentication Services Adapter) is a separate package that you
install with the iPrint client to cache your username and password for secure printers. If you do
not access secure printers, then you do not need CASA.
Figure 1-1 Using iPrint
The following steps are taken when installing a printer and printing to it:
1. Using your Web browser, you access the iPrint Printers List or a custom map, as specified by
your administrator.
2. When you click a printer in the list or on a map, the iPrint plug-in creates the printer and installs
the associated PostScript* Printer Definition (PPD) file in CUPS. After a printer is installed,
you do not need to repeat this process for the same printer.
3. With the iPrint printer installed, you can print from any application as you normally would. The
printer appears as printer in your printer list. The application sends the print job to CUPS for
processing.
4. CUPS gives the print job to the iPrint backend, which sends it to the iPrint Manager. When the
printer is ready, the iPrint Manager sends the job to the printer.
1.2 Understanding Security
The Linux iPrint Client is packaged in two different, specialized installations that control access to
the workstation's print system. The following table explains the differences between the two clients.
8 SUSE Linux Enterprise Desktop iPrint Client User Guide
Client Filename Workstation Access Description
novell-iprint-xclient-shrelease_date.i586.rpm
novell-iprint-xclient-slrelease_date.i586.rpm
Security high. Limited
access to the print
system.
Security low. Unlimited
access to the print
system.
This client requires workstation users to
be defined with lppasswd to install,
delete, or administer printers on the
workstation. When performing one of
these print operations, the user is
challenged for a password.
This client allows all users of the
workstation to install, delete, or
administer printers and print jobs on the
workstation, including printers and print
jobs of other users. By default, the iPrint
Printer List Web page installs this rpm.
The above clients do not affect installation of the iPrint Client, just access to the workstation print
system. To install the iPrint Client you still need root permissions. Also, these clients do not limit
printing capabilities.
IMPORTANT: To install the iPrint Client you need root permissions. To upload drivers from the
system, you need to be defined with lppasswd or know the root password; otherwise, when you
attempt to add drivers from the system, the driver list is blank. To define a user to be part of
lppasswd, you can use the following command:
lppasswd -a linux_user_account -g sys
For more information on the client installed on your SUSE Linux Enterprise Desktop workstation,
consult with your network administrator.
1.2.1 Printing to Secure printers
When installing a secure iPrint printer, you might be prompted twice for your username and
password. First you are prompted to provide your network credentials to verify that you have access
to the printer (it would be no use installing a printer that would not allow you to print). The second
prompt is for CUPS to ensure you have rights to install printers on the client machine. Each time you
perform a print operation with a secure printer, you are prompted for your username and password.
If you installed CASA (Common Authentication Services Adapter), your credentials are cached.
Printing to secure printers is supported only when you are logged in to the desktop. If for any reason
the CUPS iPrint backend cannot deliver the job to a secure printer, the job is requeued on the client
with a hold. You can then see the held job and release it after you log in to the desktop.
1.3 Installing the iPrint Linux Client
The following sections provide information about installing the iPrint Linux Client:
• Section 1.3.1, “Requirement,” on page 10
• Section 1.3.2, “Procedure,” on page 10
Setting Up iPrint on Client Workstations 9
1.3.1 Requirement
In order for iPrint to work properly, your workstation needs to have a Mozilla-based browser
such as Firefox, which is included with SLED. If it is not already installed, KDE users should
use YaST to install Firefox.
1.3.2 Procedure
You can install the iPrint Client during SLED installation or using YaST after SLED is installed.
• “Installing during SLED Installation” on page 10
• “Installing after SLED Installation” on page 10
Installing during SLED Installation
Shortly after the installation program begins, you can choose to install the iPrint client using the
following steps. You can also install the client later using the YaST Control Center.
1 After selecting your preferred desktop, scroll down the list of Installation Settings and click
Software.
2 Click Detailed Selection.
3 Change the Filter to Search, and search for iPrint,
4 Select the iPrint Client you want installed.
For more information about the iPrint Linux Client, see Section 1.1.2, “iPrint Client,” on
page 7 or contact your network administrator.
5 (Optional) Search for and select CASA (Common Authentication Service Adapter).
CASA retains your username and password for printers that require authentication.
6 Click Accept.
Installing after SLED Installation
1 Start YaST.
•GNOME: Click Computer > More Applications > System > YaST Control Center.
•KDE: Click the main menu button > System > YaST (Control Center).
2 Search for iPrint.
3 Select the iPrint Client you want installed.
For more information about the iPrint Linux Client, see Section 1.1.2, “iPrint Client,” on
page 7 or contact your network administrator.
4 (Optional) Search for and select CASA (Common Authentication Service Adapter).
CASA retains your username and password for printers that require authentication.
5 Click Accept.
10 SUSE Linux Enterprise Desktop iPrint Client User Guide
1.4 Installing Printers
Depending on how your administrator has configured your iPrint system, you install iPrint printers
in one of the following ways. Contact your administrator for details on how you should access the
iPrint system.
• Section 1.4.1, “Using the iPrint Printer List Web Page,” on page 11
• Section 1.4.2, “Using Location-Based Printing Web Pages,” on page 11
1.4.1 Using the iPrint Printer List Web Page
iPrint generates a list of printers associated with a Print Manager that can be used to install the iPrint
Client, install an iPrint printer, or check the status and configuration of a printer including a list of
print jobs.
1 Enter the iPrint URL in your Web browser Address field.
The iPrint Printer List is located at http://server_IP_ address_or_dns_name/ipp.
2 From the list of available printers, select the printer you want to install.
During the printer installation, iPrint downloads and installs the printer driver called a PPD file,
if one is associated with the printer, and installs the printer on the user's workstation. The first
time a printer is installed, this PPD file is forced to the workstation, even if the workstation
contains a newer PPD file.
1.4.2 Using Location-Based Printing Web Pages
Location-based printing lets you use your Web browser to select printers based on locations by
using a list view or a map, both of which are created by your iPrint administrator.
1.5 Removing iPrint Printers
To remove iPrint printers, use the CUPS management utility included with your Linux distribution.
GNOME* users can use the printer folder in Computer > Control Center > Printers, and KDE users
can use the Printing Manager by clicking the main menu button > Tools > Printing > Printing
Manager.
GNOME users of SUSE Linux Enterprise Desktop cannot delete printers. If security is not an issue
and you are running the low-security iPrint Linux Client, you can use the following instructions to
configure GNOME so that all desktop users can add and delete printers.
WARNING: The following procedure should be implemented only if security is not an issue,
because it lets all users of the desktop access the print system.
1 On the SLED workstation, log in as root.
2 Edit /etc/sudoers and add the following line to the end of the file:
ALL ALL = NOPASSWD: /opt/gnome/bin/gnome-cups-manager
3 Edit /opt/gnome/share/control-center-2.0/capplets/
printconf.desktop by doing the following:
• Change TryExec=gnome-cups-manager to TryExec=gnome-cups-manager-root.
Setting Up iPrint on Client Workstations 11
• Change Exec=gnome-cups-manager to Exec=gnome-cups-manager-root.
4 Create a text file with the following:
#!/bin/bash
sudo /opt/gnome/bin/gnome-cups-manager
5 Save the file as /opt/gnome/bin/gnome-cups-manager-root.
6 Open a terminal as user root and change the permissions of the /bin/gnome-cups-
manager-root file by executing the following command:
chmod 755 /opt/gnome/bin/gnome-cups-manager-root
To test the new settings
1 Log in to GNOME as a normal user, not as root (not root).
2 Click Computer > Control Center.
3 Double-click Printers.
4 In the Printers folder, right-click a printer.
If the Remove menu item is listed, then the procedure worked correctly. If the Remove item is
not listed, repeat the procedure again.
1.6 Managing Print Jobs from the Client
Users can monitor and manage their own print jobs from their workstations using the CUPS
management utility included with your Linux distribution. GNOME users can use the printer folder
in Computer > Control Center > Printers, and KDE users can use the KJobViewer by clicking the
main menu button > Tools > Printing > KJobViewer (Print Jobs).
NOTE: If the iPrint server is busy when your installed printer attempts to communicate, CUPS
moves the printer into an error state and holds all print jobs. To release print jobs, use a printer
management utility to restart the printer.
1.7 Using iprntcmd
The Linux iPrint Client includes the iprntcmd utility that lets you install printers, print test pages,
and upload drivers to a driver store from a terminal prompt. The iprntcmd utility is located in /
opt/novell/iprint/bin/iprntcmd.
Use the following parameters when executing the iprntcmd command:
Table 1-1 Parameters Used with iprntcmd
Parameters Description
-a or --addprinter printer_uri Installs the specified printer.
-d or --delprinter printer_uri Removes the specified printer.
-g or --getdefault Displays the default printer installed on the
workstation.
-h or --help Displays help for the command.
12 SUSE Linux Enterprise Desktop iPrint Client User Guide
Parameters Description
-j or --listjobs printer_uri Lists the print jobs for the specified printer that are
on the server in a pending or printing state.
-l or --listlocalprinters Lists printers installed on the workstation.
-L or --listprintersonserver psm-hostname or
psm-address
-p or --printfile printer-uri file path Sends a printer-ready file to the specified iPrint
-P or --ppdlist Lists the PPDs installed on this workstation.
-s or --setdefault printer_uri Sets the specified printer as the default.
-t or --testpage printer_uri Prints a test page to the specified printer.
-u or --upload ids_uri ids_user ppd Uploads the specified PPD files to the indicated
-U or --upload RMS rms_uri rms_user
rms_address ppd
Lists iPrint printers on the specified Print Manager
where psm-hostname or psm-address can be a
DNS name or IP address.
printer.
driver store where ids_uri is the IP Address or
DNS name for the driver store, ids_user is the
username with rights to add drivers to the driver
store, and ppd is the directory path and filename
to the PPD files. You can use wildcards in the
PPD filename.
Uploads the specified PPD files to the indicated
Broker where rms_uri is the IP Address or DNS
name for the Broker's associated print manager,
rms_user is the username with rights to add
drivers to the broker, rms_address is the IP
address or DNS name of the broker, and ppd is
the directory path and filename to the PPD files.
You can use wildcards in the PPD filename.
-v or --version server_uri server_user Displays the server platform and version
information where server_uri is the URI for the
server and server_user is a valid user for the
server.
1.7.1 Syntax
iprntcmd parameters
IMPORTANT: You must use quotes around parameter information that contains a space, such as
printer names and printer drivers.
1.7.2 Example
To install a printer named Color Printer 1 and set it as the default printer, you would enter the
following for nonsecure printing:
iprntcmd -a "ipp://printing.my_company.com/ipp/Color Printer 1"
You should use ipp:// instead of http:// or https://.
Setting Up iPrint on Client Workstations 13
1.8 Uninstalling the iPrint Client
You can remove the iPrint Linux Client RPM from a terminal prompt using the following
commands, depending on the client installed.
rpm -e novell-iprint-xclient-sh
rpm -e novell-iprint-xclient-sl
NOTE: When you uninstall the Linux iPrint Client, all iPrint printers remain installed on the
workstation and you can still print to the printers until the printer is deleted from the workstation.
14 SUSE Linux Enterprise Desktop iPrint Client User Guide
Loading...