4.6 Windows Client: Using Additional Features

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

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

4.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, check the check box and 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, and 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.

For more information about the settings, see Section 4.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 do not receive notifications. To restart the applet, see Using the iPrint Client Tray Icon.

Password Management Enhancements

Beginning with iPrint Client v4.16 for Windows, the following enhancements were made:

Using Novell Client Credentials

If the Novell Client is installed and was used to authenticate to eDirectory, the iPrint Client retrieves the username and password from the Novell Client and uses the credentials to authenticate to secure printers. Depending on your configuration, NetIdentity might no longer be needed to share credentials.

Maintaining Grace Login Balance

Depending on your configuration, the iPrint Client will attempt to maintain the grace logins by failing all secure printing requests that would use a grace login. To print, a user must change their password to eliminate the grace login condition. Use of this feature requires the following:

  • The user is authenticated to a tree where the print service is running.
  • The tree is using grace logins.
  • The user must be using the Novell Client for Windows

Grace login checking is enabled by default. To disable grace login checking, edit the HKEY_LOCAL_MACHINE\SOFTWARE\Novell-iPrint\Settings\GraceLoginsOn registry entry. Change the value to 0 to turn off grace login checking.

Formatting Login Credentials

The iPrint Client caches the credentials entered in the iPrint Printer Authentication dialog in the appropriate eDirectory or LDAP style for use with any of the iPrint back-end services (NetWare 6.5 and earlier or Open Enterprise Server.)

For example, entering user.novell in the login dialog is cached as follows:

  • user.novell for eDirectory credential
  • CN=user,O=novell for LDAP_DN credentials
  • user for the LDAP credential

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.

Controlling iPrint Settings through the Windows Registry

You can control the availability of the iPrint Tray Icon in the Windows System Tray and some of the iPrint Settings attributes using the associated registry entries. Depending on the version of the iPrint Client, the registry keys are located in one of the following locations:

Table 4-4 iPrint Client Registry Key Locations

iPrint Client Version

Registry Location

4.15 and earlier


4.16 and later


Regardless of the iPrint Client version, the same registry entries are used. The numeric values use hexadecimal.You can also change the text that should be displayed. For example, you can change the URL associated with the Find/Install Printers link in the Tray Icon Menu to one that your company uses by editing the value of the Tray Icon Link entry.

Table 4-5 iPrint Client Registry Entry Settings

Registry Entry



Job Notify Setting

Pop-up messages in the System Tray about the status of a print job.

0 = Off 1 = On

The default is 1.

Proxy Server URI

URL to be used for a proxy server

User defined. Use a URL such as http://ProxyServer_Or_Addr:port_number

Proxy Server ZEN URI

This entry is modified by ZENworks.

WARNING: Modifying this setting outside of ZENworks might cause ZENworks to fail.

Proxy Settings

Enable/disable the use of the Proxy Server URI

10000 = Off 10001 = On

The default is 10000.

Tray Icon Link

URL associated with the Find/Install Printers link in the Tray Icon Menu.

User defined.

The default is myurls.com.

Tray Icon Setting

Enables/disables the tray icon in the system tray. To receive notifications, the tray icon must be enabled (On).

0 = Off 1 = On The default is 1. Requires a workstation restart to take affect.

NOTE:All changes take affect immediately except the Tray Icon Setting, which requires you to logout and log back in or restart the workstation before for the changes to take affect.

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



LPTx or L=x where x is the port number

The port you want to capture.


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


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

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

icapture l=2 p=printer1


icapture lpt2 p=printer1

To end the capture, you would 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-7 Parameters used with iprntcmd



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


iprntcmd parameters


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

4.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 Client 32 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.6.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 can be found in the following locations





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 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 do 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.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, 2000, and XP 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.

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