3.6 Windows Client: Using Additional Features

3.6.1 Updating the iPrint Client

Periodically, users need updates to the Novell iPrint Client. You need to decide how to manage this. You can allow iPrint to automatically update the clients or you can choose to distribute a newer client using a software distribution package like Novell’s ZENworks.

See Updating the iPrint Client Automatically for more information.

3.6.2 Using the iPrint Client Tray Icon

On Windows workstations, the iPrint Client adds an icon to the system tray. The iPrint icon lets you receive notification when a job has printed and access iPrint client settings quickly. Right-clicking the icon displays the following menu options:

iPrint Settings: Opens the iPrint Client Settings.

Document Status: Lets you check the status and other information for the last 10 documents printed.

Launch Printer Folder: Opens the Windows printer folder.

Find/Install Printers: (Optional) Opens a browser window to the Menu Link URL specified on the Tray Icon tab.

Close: Removes the iPrint icon from the system tray until the next reboot. To make the icon reappear in your system tray, click Start > Programs > Novell iPrint > iPrint Client Settings > Tray Icon and deselect the Enable the iPrint icon in the system tray. Click OK. Then repeat to enable the icon.

To permanently remove the tray icon, see Managing iPrint’s System Tray Icon.

3.6.3 Configuring the iPrint Client Settings

Using a Proxy Server

A proxy server sits between a client and another server that the client is trying to communicate with. Often proxy servers are used in conjunction with a firewall to keep internal addresses private while only exposing the proxy server’s address to external users. If you are using a proxy server and have users that need to submit print jobs through a proxy server, you can use the iPrint Clients Proxy setting. The Client sends all print-related requests, like a print job, to the proxy server. The proxy server then redirects the print job to the correct iPrint server.

For example, Juan is a laptop user and has installed and printed to a variety of iPrint printers at the company’s headquarters. While on the road, Juan wants to submit a report to his boss. Rather than sending the report by e-mail or fax, Juan decides to send it to the printer near his boss. When he tries to send the report to the printer, he receives an error that the printer cannot be found. He knows that the company uses a firewall and a proxy server. He types the proxy server address in the iPrint Proxy settings, then tries to print the report again. This time the print job is accepted. The print job travels from his laptop to the proxy server. The proxy server redirects the print job to the printer’s Print Manager, where the print job is spooled and forwarded to the printer.

To set the proxy server address in iPrint:

  1. Click Start > Programs > Novell iPrint > iPrint Settings > Proxy.

  2. To use a proxy server, select the check box, then specify the URL for the proxy server.

  3. Click OK.

To disable using a proxy server, deselect the check box.

Managing Passwords for Remote iPrint Servers

You can manage passwords for print services that you indicated should be remembered by your workstation. The ability to delete passwords is useful if you are connected to a print service that you no longer use.

To manage passwords for print services:

  1. Click Start > Programs > Novell iPrint > iPrint Settings > Passwords.

  2. Select the password you want to remove, then click Clear Password.

Managing iPrint’s System Tray Icon

The iPrint icon in the system tray lets you receive notification when a job has printed and view a list of print jobs that you have submitted.

  1. Click Start > Programs > Novell iPrint > iPrint Settings > Tray Icon.

  2. Modify the settings.

  3. Click OK

For more information about the settings, see Section 3.6.2, Using the iPrint Client Tray Icon.

Managing Print Job Notifications

iPrint can notify you when your document has printed or needs attention by way of a pop-up message in the system tray.

To turn iPrint notification on or off:

  1. Click Start > Programs > Novell iPrint > iPrint Settings > Notifications.

  2. Select or deselect the check box as indicated.

NOTE:If you close the iPrint applet running in the system tray, you cannot receive notifications. To restart the applet, see Using the iPrint Client Tray Icon.

Setting Up iPrint on Terminal Servers

You can set up iPrint on a terminal server to allow terminal server clients to install and print to iPrint printers.

Installing the iPrint Client on a Terminal Server
  1. Log in to the terminal server with Administrator or equivalent rights.

  2. Install the iPrint Client.

    You can download the iPrint Client from the iPrint Printer List or you can copy and execute nipp.exe from the iPrint server in sys:\apache2\htdocs\ippdocs.

NOTE:On terminal servers, the client auto-update does not work. To update the client with a newer release, you must install it manually.

Configure iPrint for Terminal Server Clients

You can configure iPrint to work in any of the following ways, depending on the rights the terminal server client has.

  • Install user printers only: User printers can only be installed and deleted by the user who installed the printer. User printers are not available to other users on the workstation.

  • Install workstation printers only: Workstation printers can be installed and deleted only by users with sufficient rights. After a workstation printer is installed, all users using the workstation can print to it.

  • Try to install workstation printer first: If the user has insufficient rights to install the printer, the printer is installed as a user printer.

To configure iPrint for terminal server clients:

  1. Log in to the terminal server with Administrator or equivalent rights.

  2. Click Start > Programs > Novell iPrint > iPrint Settings.

  3. Click Terminal Server, then select the configuration option you want.

  4. Click OK.

Using the Novell iCapture LPT Port Redirector Utility

The Novell iCapture LPT Port Redirector lets you capture LPT ports and redirect the output to iPrint printers. Novell iCapture is installed when you install the iPrint Client. Before using the LPT Port Redirector, you must have iPrint printers installed on the workstation and the Print Manager and Printer Agents must be up and running. This feature is not available on terminal servers.

For example, Olga uses a legacy MS-DOS* application to run reports. The application can print only to an LPT port. With the iPrint Client installed, Olga installs an iPrint printer on her workstation and uses Novell iCapture to capture the LPT port. iCapture redirects any data sent to the LPT port to the iPrint printer. Olga can now run her MS-DOS application from her Windows workstation and send print jobs to an iPrint Printer.

To run the utility:

  1. Click Start > Programs > Novell iPrint > iPrint Settings > iCapture.

  2. Select the port you want to capture.

  3. Click Select Printer, select the iPrint printer you want, then click Capture.

    If the printer you want is not listed, check to see that the printer agent is up and running and that the printer has been installed as an iPrint printer.

  4. Click OK.

You can also use the LPT Port Redirector to end a printer capture by selecting the port and clicking End Capture.

IMPORTANT:Existing port assignments are not displayed, and iPrint port assignments supersede all other port assignments. iPrint port assignments remain in effect, even after the workstation restarts, until you end the capture.

3.6.4 Implementing iPrint Using DOS Commands

The following DOS commands let you install iPrint printers without a Web browser and capture LPT ports to iPrint printers. These commands are useful when you have legacy applications that require output to an LPT port, or when you want to add printers through a login script.

Using Icapture.exe to Capture Printer Ports

Icapture.exe is a DOS command line utility that lets you capture LPT ports and redirect the output to iPrint printers. The utility is installed when you install the iPrint Client, and it can be used from a DOS-box command line, called from a batch file, or called from a login script. Icapture.exe is compatible with Windows NT/2000/XP/2003.

IMPORTANT:Icapture.exe requires that the iPrint printer be installed before the command is run. You can install a printer from the DOS command line using iprntcmd.exe.

Use the following parameters when executing the icapture.exe command.

Table 3-4 Parameters for icapture

Parameter

Description

LPTx or L=x where x is the port number

The port you want to capture.

P=printer_name

The name of the printer that appears in the Printers Folder after the iPrint printer is installed.

EndCap

Ends the capture to the specified port.

NOTE:Captured ports remain captured, even through a workstation restart, until you end the capture.

Show

Displays the status of currently captured ports and their associated printers.

Syntax
icapture parameters
Examples

For example, to capture a printer named Printer1 to port number 2, you would enter either:

icapture l=2 p=printer1

or

icapture lpt2 p=printer1

To end the capture, you would enter either:

icapture endcap l=2

or

icapture endcap lpt2

Using iprntcmd.exe to Install iPrint Printers

If you need to install an iPrint printer but cannot use a Web browser, you can use the iprntcmd.exe command at a DOS prompt. The iprntcmd.exe command can install, remove, or set a printer as the default printer. This command is most often used in login scripts in conjunction with the icapture.exe command.

Use the following parameters when executing the iprntcmd command.

Table 3-5 Parameters for iprntcmd

Parameters

Description

-a or --addprinter options printer_uri

Installs the specified printer. You can replace options with any or all of the following:

  • no-gui: Does not display the printer installation dialog box when installing a printer.
  • default: Installs the specified printer as the default printer.
  • temp: The installed printer is removed when the workstation is rebooted.

NOTE:These options are available on the Windows Client only.

-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.

-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

Lists iPrint printers on the specified Print Manager where psm-hostname or psm-address can be a DNS name or IP address.

-p or --printfile printer-uri file path

Sends a printer-ready file to the specified iPrint printer.

-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.

-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.

Syntax

iprntcmd parameters

Example

To install a printer named ColorPrinter1 and set it as the default printer, you would enter the following:

iprntcmd -a -d ipp://printing.my_company.com/ipp/ColorPrinter1

3.6.5 Using iPrint with NetIdentity

The NetIdentity agent works with eDirectory authentication to provide background authentication to Windows Web-based applications that require eDirectory authentication. iPrint supports the NetIdentity agent included with the Novell Client32™ running on Windows NT/2000/XP only. If the NetIdentity agent is installed on the workstation, iPrint uses NetIdentity when authenticating. For more information on using NetIdentity, see the NetIdentity Administration Guide for NetWare 6.5.

3.6.6 Managing Global Actions through Iprint.ini

A configuration file named iprint.ini is located on each server where a Print Manager is running. To provide a consistent print environment, you should configure each setting the same in the iprint.ini file, except ShortInstallName, which must be unique across all print servers on the network. The iprint.ini file should be synchronized across all servers where iPrint and a Print Manager are running. The iprint.ini file is found in the following locations

Linux

/var/opt/novell/iprint/htdocs/

NetWare

sys:\apache2\htdocs\ippdocs\

The file controls the following tasks:

IMPORTANT:Beginning with NetWare® 6.5 Support Pack 6, your iprint.ini settings are saved and integrated with the updated iprint.ini in the Support Pack. You no longer need to manually copy your settings.

However, when you upgrade or apply a support pack prior to Support Pack 6, the existing iprint.ini file is saved as iprint.bak and the new iprint.ini is used. If you made changes to the old iprint.ini file, you must delete the new iprint.ini file from the support pack and rename iprint.bak to iprint.ini, then customize the settings to include the new functionality included with the latest iprint.ini.

Updating the iPrint Client Automatically

When a workstation boots up, iPrint checks the default printer to ensure the workstation is using the latest Novell iPrint Client. When needed, a newer client is installed. Using a configuration file, you can control how this update takes place.

An iprint.ini configuration file is located in on each server where iPrint is installed. This file controls whether the user is prompted before the updated client is installed or the updated client is installed without user intervention. When the client is installed without user intervention, the user still sees the installation program.

  1. Using a text editor, edit iprint.ini.

    Linux

    /var/opt/novell/iprint/htdocs/

    NetWare

    sys:\apache2\htdocs\ippdocs\

  2. Change the AllowAutoUpdate setting for the desired behavior.

  3. Save the file.

IMPORTANT:The iprint.ini file should be synchronized across all servers where iPrint and a Print Manager are running.

After the iPrint Client is updated, Windows 9x users must restart their machines. Windows NT/2000/XP users should not need to immediately reboot, unless they are using iPrint utilities to capture LPT ports.

Creating a Short Printer Name Profile

By default, the installed printer name on the client follows the full UNC/URL format: \\ipp://dns_name\printer_name. An example of a printer name in this format is \\ipp://Printing.My_Company.Denver.Com\ColorPrinter1. These printer names are often too long to fit in an application’s display field for the printer name. Using a Short Printer Name Profile, you can replace the UNC server name (or dns_name) for all printers on a Print Manager with any name you want to be displayed. For example, if you chose a ShortInstallName of Denver, the above example would display as \\Denver\ColorPrinter1 on the workstation.

NOTE:The name must be unique across all iprint.ini files on your network; otherwise, printing might become sporadic or cease to work. You should keep the UNC path and printer name to less than 32 characters.

When you implement a Short Printer Name Profile, printers that are already installed are not affected. Only printers installed after the change have the shortened name. For printers already installed, you must delete and reinstall the printers to change their names. The Short Printer Name Profile is available only on Windows NT, 2000, and XP workstations.

  1. Edit iprint.ini in a text editor.

    Linux

    /var/opt/novell/iprint/htdocs/

    NetWare

    sys:\apache2\htdocs\ippdocs\

  2. Change the value of the ShortInstallName parameter.

    ShortInstallName=your_name
    

    where your_name is the value you want displayed. To reset the parameter to its default setting, use “default” as the value.

IMPORTANT:To ensure a consistent print environment, the iprint.ini file should be synchronized across all servers where an Print Manager is running; however, the ShortInstallName must be unique in each iprint.ini. The Installed Printer Name Profile affects all printers on a Print Manager.

Installing User Printers

To install an iPrint Printer and the associated printer driver users, you must have Administrator or equivalent permissions on Windows NT/2000/XP or Power User permissions on Windows NT/2000. User Printers let you control what permissions are required to install a printer. To implement User Printers, edit the iprint.ini file and change the value for AllowUserPrinters = entry to one of the following:

Table 3-6 User Printers Settings

Value

Description

0

Follow Windows standards and only let users with sufficient permissions to install the printer to the desktop. This allows ALL USERS to see and use this printer. This is considered a global or Workstation Printer.

1

If the current user does not have permissions to add a Workstation Printer (option 0), automatically add the printer so that only the current user can install, view, modify, or delete this printer. This is considered a private or User Printer.

2

Only add User Printers. All users (including Administrator or power user) that add a printer can install, view, modify, or delete the printer they installed. All printers are private or User Printers.

3

Only add Workstation Printers. No permissions required. All users have rights to install, view, modify, or delete iPrint printers even if the Windows workstation has been locked down. Non-iPrint printers are not affected.

For example, three workers—Albert, Juan, and Carla—share the same computer during the day. Albert prints to an accounting printer, Juan prints to a plotter, and Carla prints to a printer in the CEO’s office. The administrator set AllowUserPrinters= 2. Each worker can install the printer they need but cannot see printers installed by the other users.

Upgrading NDPS Printers to iPrint Printers

NDPS® Printers that are installed on the workstation can easily be upgraded to iPrint printers, giving additional features like global access to printers, printer profiles, and end of job notification. This requires that currently existing NDPS printers be iPrint enabled (see Section 4.8, Enabling iPrint on Existing Printers) and the iPrint client be installed on the workstation.

You control the upgrade through UpgradeNDPSPrinter= entry in the iprint.ini using the following values:

Table 3-7 UpgradeNDPSPrinter Settings

Option

Description

0

(Default) Leave NDPS installed printers alone.

1

Prompt the user to upgrade the printer to an iPrint printer.

2

Silently upgrade the printer to an iPrint printer. No user intervention required.

The next time the user reboots and logs in, their NDPS printers is upgraded to an iPrint printer installed and the NDPS printer is removed, except for printers using a captured ports.

Upgrading QMS Printers to iPrint Printers

Queue-based printers installed on the workstation can be upgraded to iPrint printers after associating an iPrint printer with the eDirectory Queue object and installing the iPrint client on the workstations. Once the associations are complete, you control the upgrade through the UpgradeQMSPrinters= entry in the iprint.ini using the following values:

Table 3-8 UpgradeQMSPrinters Settings

Option

Description

0

(Default) Leave QMS installed printers alone.

1

Prompt the user to upgrade the printer to an iPrint printer.

2

Silently upgrade the printer to an iPrint printer. No user intervention required.

The next time the user reboots and logs in, their Queue-based printers are deleted and the associated iPrint printer installed.

Informing Users about Print Updates

You can choose to disable dialog boxes informing users about printers, drivers, driver profiles that have been updated, renamed, deleted or moved.

Table 3-9 UpgradeQMSPrinters Settings

Option

Description

0

Do not inform the user of changes.

1

(Default) Inform user of changes via message box.