4.5 Windows Client: Using Additional Features

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

4.5.2 Using the iPrint Client Tray Icon

On Windows workstations, the iPrint Client adds an icon to the notification area. 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 notification area until the next reboot. To make the icon reappear in your notification area, 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 Notification Area Icon.

4.5.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 and then specify the URL for the proxy server.

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

  3. Click OK.

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, and then click Clear Password.

Managing iPrint’s Notification Area Icon

The iPrint icon in the notification area 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.

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

Managing Print Job Notifications

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

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 notification area, you do not 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.

Configuring 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 supercede all other port assignments. iPrint port assignments remain in effect, even after the workstation restarts, until you end the capture.

4.5.4 Implementing iPrint by Using the Command Line

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 command line, called from a batch file, or called from a login script. Icapture.exe is compatible with Windows NT/2000/XP.

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 4-5 Parameters used with icapture.exe



LPTx or L=x where x is the port number

The port you want to capture.


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

You can use -l from iprntcmd to get the printer URI.


Ends the capture to the specified port.

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


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


icapture parameters


To capture a printer named Printer1 to port number 2, enter either:

icapture l=2 P=printer uri


icapture lpt2 P=printer uri

where, printer uri=ipp://ServerName/ipp/Sales_color_printer or printer uri=ipp://ServerIP/ipp/Sales_color_printer

To end the capture, enter either:

icapture endcap l=2


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 4-6 Parameters used with iprntcmd



-a | --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 | --delprinter printer_uri

Removes the specified printer.

-f | --fetchdriverlocal printer_uri

Pulls drivers from the server and stores them in the local cache directory. For example, c:\ndsp\drvr_cache directory.

-g | --getdefault

Displays the default printer installed on the workstation.

-h | --help

Displays help for the command.

-j | --listjobs printer_uri

Lists the print jobs for the specified printer that are on the server in a pending or printing state.

-l | --listlocalprinters

Lists printers installed on the workstation.

-L | --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 | --printfile printer-uri file path

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

This option is to test the print path (job flow) from client workstation to server and subsequently to printer. This requires a print ready file as an input. The printer or the driver needs not to be installed on the client workstation for this.

-P | --ppdlist

Lists the PPDs installed on this workstation.

-s | --setdefault printer_uri

Sets the specified printer as the default.

-t | --testpage printer_uri

Prints a test page to the specified printer.

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

-U | --uploaddriver <ids-address> or <ids-hostname> <username> <password> [INF-Filepath <model-name>]

Uploads printer drivers.

IMPORTANT:INF-Filepath and model-name are mandatory only for Windows XP platforms.

-w | --trustedwebsiteforInternetExplorer printer_installation_page_uri

Adds the specified URI of the printer installation page to the trusted site list for Internet Explorer.

The Trusted site list feature allow users to view and add the printers directly from the printer IPP site or printer map page, without having to run the Internet Explorer browser with administrator privileges on Windows Vista.

For example, http://printing.my_company.com/ipp.


Clears the password from the cache.

NOTE:Use quotes around printer-uri if it contains spaces.


iprntcmd parameters


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

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

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

4.5.6 Manage Global Actions through Iprint.ini

A configuration file named iprint.ini is located on each server where an Print Manager is running. The iprint.ini file should be synchronized across all servers where iPrint and a Print Manager are running. The iprint.ini file is located at the following location:



The file controls the following tasks:

IMPORTANT:When you apply a support pack, the existing iprint.ini file is saved as iprint.bak and a new iprint.ini is copied over. If you made changes to the iprint.ini file, you must delete the new iprint.ini file from the support pack and rename iprint.bak to iprint.ini. If you want new functionality included with the latest iprint.ini, you should duplicate the settings in iprint.bak in the new iprint.ini.

Updating the iPrint Client Automatically

When a workstation boots up, iPrint checks the default printer to ensure that 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.



  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 an Print Manager are running.

After the iPrint Client is updated, Windows 9x users must restart their machines. Windows NT/2000/XP users need not reboot immediately, 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.Com\ColorPrinter. 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 want to display just the company name, the above example would display as \\My_Company\ColorPrinter.

NOTE:You should keep the UNC path and printer name to less than 32 characters.

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

  1. Edit iprint.ini in a text editor.



  2. Change the value of the ShortInstallName parameter to the value you want displayed.


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

    NOTE:When changing the value use only lower ASCII characters and do not use slash, quote, space, or comma.

IMPORTANT:The iprint.ini file should be synchronized across all servers where iPrint and a Print Manager are running. 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 4-7 User Printer Settings




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.


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.


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.


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.