iprntman (1)

Name

iprntman - Manage iPrint Managers and Driver Stores.

Syntax

This section contains iPrint commands and utilities used on the Linux platform.

iprntman <target> <targetcommand><options>

Description

iprntman is a management tool used to manage and configure iPrint print managers, driver stores, printers, and print jobs.

Help

To display help about a specific target, use the following command:

Syntax

iprntman <target> -h or iprntman <target> --help

Example:

iprntman psm -h or iprntman ids --help

Target Summary

A target is the iPrint object type you want to manage. It includes either the target's distinguished name (DN) in LDAP format or just the common name.

NOTE:FDN is used for target’s PSM and iPrint Driver Store (IDS) iprntman commands, and the common name is used for printer iprntman commands.

For example, if you want to modify settings for a printer with the common name colorprinter, the command and target appear as iprntman printer colorprinter.

target_type

driver

target_instance

<repository_name> <driver_name>

target_type

ids

target_instance

<IDS_DN>

target_type

job

target_instance

<printer_agent_name <JOBID>>

target_type

printer

target_instance

<printer_agent_name>

target_type

profile

target_instance

<profile_name>

target_type

psm

target_instance

<print_manager_DN>

All distinguished names (DN) should be in LDAP format. If the name of a target instance or option contains a space, use quotes, for example, "HP LaserJet 4Si".

Target Commands

Target commands indicate which operation to perform for the specified target. For targets whose name is a distinguished name (DN), the DN is given in LDAP format. For example, to modify settings for a PSM with a DN of cn=manager,ou=printing,o=my_company, iprntman would be invoked as follows:

iprntman psm cn=manager,ou=printing,o=my_company

Driver Commands

For driver options, see Driver Options.

Syntax

iprntman driver <repos_name> <driver_name> <command> <options>

Example

iprntman driver driver_windows-nt-5_x86-32_en "HP Color LaserJet 5500 PS" -i

-d | --delete

Deletes a printer driver. This operation prompts interactively to reduce unintentional deletes. To skip the confirmation prompt, use the -f or --force option.

-i | --info

Displays driver information.

-l | --list

Lists drivers in a repository.

--upload

Uploads the driver to the IDS.

--download

Downloads the driver from the IDS.

Driver Store (IDS) Commands

Syntax

iprntman ids <ids_dn> <command> <options>

Example

iprntman ids cn=ids1,ou=print,o=my_company -c --hostname printing.my_company.com --use-directory-server ds.my_company.com

-c | --create

Creates an IDS. See IDS OPTIONS for specific options.

-d | --delete

Deletes an IDS. This operation prompts interactively to reduce unintentional deletes. To skip the confirmation prompt, use the -f or --force option.

-i | --info

Lists information about an IDS.

-l | --list

Lists IDS instances.

--start

Starts IDS. All IDS instances on the server are started.

--status

Displays the status of the IDS.

--stop

Stops IDS. All IDS instances on the server are stopped.

Job Commands

Syntax

iprntman job <printer_name> <job_id> <command> <options>

Example

iprntman job HP_ColorLaserJet 3 -l

-d | --delete

Deletes a print job. This operation prompts interactively to reduce unintentional deletes. To skip the confirmation prompt, use the -f or --force option.

-i | --info

Lists information about a print job.

-l | --list

Lists all jobs for the specified printer.

--pause

Pauses the processing of a print job.

--resume

Resumes the processing of a print job.

--status

Displays the status of a print job.

Print Manager (PSM) Commands

Syntax

iprntman psm <psm_dn> <command> <options>

Example

iprntman psm cn=PrintManager1,ou=print,o=my_company -c --hostname printing.my_company.com --use-ids cn=ids,ou=print,o=my_company --use-directory-server ds.my_company.com

-c | --create

Creates a Print Manager. See PRINT MANAGER (PSM) OPTIONS for specific options.

-d | --delete

Deletes the specified Print Manager. This operation prompts interactively to reduce unintentional deletes. To skip the confirmation prompt, use the -f or --force option.

-i | --info

Lists information about the Print Manager.

-l | --list

Lists the Print Manager instances.

--set-default

Make this Print Manager the default manager. This is useful when you have created several Print Managers running on the same machine and want to specify one to be the default on the next load. When you load a Print Manager, it is automatically set as the default.

--start

Starts the default Print Manager. If the Print Manager DN is given, it starts the Print Manager corresponding to DN; otherwise, the current default Print Manager is started. When a Print Manager is started, it becomes the default Print Manager.

--status

Displays the Print Manager status.

--stop

Stops the running Print Manager. If the Print Manager DN is given, it verifies that the running Print Manager corresponds to the Print Manager DN; otherwise, the currently running Print Manager is stopped.

Printer Commands

Syntax

iprntman printer <printer_name> <command> <options>

Example

iprntman printer Xerox_Color -d -s server1.my_company.com

-c | --create

Creates a Printer Agent. See PRINTER OPTIONS for specific options.

-d | --delete

Deletes the specified Printer Agent. This operation prompts interactively to reduce unintentional deletes. To skip the confirmation prompt, use the -f or --force option.

-i | --info

Lists printer information.

-l | --list

Lists target instances.

-m | --modify

Modifies properties of the printer. See PRINTER OPTIONS for specific options.

--pause-input

Pauses printer input.

--pause-output

Pauses output from the printer.

--purge-all-jobs

Deletes all jobs queued for this printer.

--resume-input

Resumes printer input.

--resume-output

Resumes output from the printer.

--start

Starts the Printer Agent when it is shut down.

--status

Displays the printer status.

--stop

Shuts down the Printer Agent.

Profile Commands

Syntax

iprntman profile <platform> <driver_name> <profile_name> <command> <options>

Example
iprntman profile winxp "HP Color LaserJet 5500 PS" HP5500_A4 -l -s server1.my_company.com
-l | --list

Lists printer profiles on the server.

Options

Options modify the command specified. General options can be used with all commands in conjunction with target specific options.

General Options

-f | --force

Suppresses the display of interactive confirmation prompts for the delete and other operations.

-p | --passfile <filename>

Specifies a file containing a password for the eDirectory user performing the operation. By default, if a password is required, the user is prompted. For security purposes, ensure that your password file is not readable by other users.

-P | --password

Specifies the password for the eDirectory user performing the operation. Use of this option should be limited because other users can see command line options, including the password. Use --passfile instead.

-s | --server <host>

Specifies a server host on which to perform the operation, where host is a hostname or IP address. Defaults to localhost.

-u | --username <username>

Specifies a username that is in LDAP format, using the FDN of the eDirectory user performing the operation. For example: cn=admin,o=myorganization

-v | -vv | -vvv | -vvvv | -verbose

Determines the level of detail to display about the execution of operations, with -v displaying a minimum amount of detail and -vvvv displaying the most detail.

-w | --warnings

Disables any warning messages from appearing.

--accept-cert

Automatically accepts any certificates when you make your first IPP connection or your first direct eDir access through the JNDI library.

Driver Store (IDS) Options

--hostname <hostname>

When you create URIs for drivers and repositories associated with this IDS, this hostname is used. If it is not specified, it defaults to whatever is specified by --server.

Example: --server server2.my_company.com --hostname ids.my_company.com

--use-directory-server <ds_hostname>

The directory servers this IDS uses. The hostname can be followed by an optional port, if the directory server is running on a non-standard port. This option can be specified up to three times to designate a primary server and two backup directory servers.

Example: --use-directory-server ds1.my_company.com use-directory-server ds2.my_company.com

Driver Options

--from-ids-zip <zipfile>

For use with the --upload command. The <zipfile> is a .zip file that came directly from an iPrint Driver Store. This option is intended to facilitate scripts for IDS backup/restore or IDS synchronization.

--from-ppd <ppdfile>

For use with the --upload command. The <ppdfile> is a .ppd file for Linux or Mac OS X clients.

Print Manager (PSM) Options

--hostname <hostname>

Use this hostname when you create URIs for services associated with this Print Manager. If it is not specified, it defaults to whatever is specified by --server. You should use this option with the create (-c) and modify (-m) commands.

Example: --server server1.my_company.com --hostname printserver.my_company.com

--use-ids <DN>

Specifies the IDS that printers on this Print Manager will use. This option is required when creating a Print Manager.

Example: --use-ids cn=ids,ou=print,o=my_company

--use-directory-server <ds_hostname>

The directory server this Print Manager uses. The host name can be followed by an optional port, if the directory server is running on a non-standard port.

Example: --use-directory-server ds1.my_company.com:663

Printer Options

--audit-enable <yes|no>

Enables auditing for this printer.

--banner <banner_name>

Specifies the banner you want to use for this printer.

Example: --banner BigBanner

--container <container_DN>

Only valid on printer creation. A directory object corresponding to the printer is created with the DN CN=<printer_name>,<container_DN>. If this option is not used, the Print Manager's object container is used.

Example: --container ou=printers,o=my_company

--description <description_string>

Set the description of the printer.

Example: --description "Marketing color laser printer"

--direct-print-enabled <yes|no>

Enables or disables iPrint Direct, which lets you print directly to the printer and bypass the Print Manager.

--driver-<platform> <driver_name>

Set the IDS driver associated with the printer for the specified platform (win9x, winnt, win2k, winxp, win732, win764, vista32, vista64, linux, mac). The driver_name is the name of the driver in the iPrint Driver Store used by the iPrint Print Manager for the printer.

Example --driver-winxp "HP 5 Si/Mx"

--gateway-load-string <load_string>

Lets you specify the gateway load string information. This load string is usually used to specify the printer's IP address. You must use the entire syntax, as shown in the example, every time this option is used. This field is required when creating a Printer Agent.

Example: --gateway -load -string "iprintgw PORT=LPR HOSTNAME=192.168.0.100 PRINTERNAME=PASSTHROUGH"

If you need to connect to a printer using port 9100, use PORT=RAW.

See iprintgw for options that can be passed to the gateway in the load string.

--accounting-load-string<arg>

Lets you set the accounting load string for the printer.

--location <location_string>

Set the location string of the printer

Example: --location "Second floor, South West corner"

--lpr-input-enabled <yes|no>

Allows the printer to accept LPR print jobs.

--profile-<platform> <profile>

Set the printer profile you want associated with the printer for the specified platform (win9x, winnt, win2k, winxp, win7, vista, linux, or mac). The profile is the name of the profile used by the iPrint Print Manager for the printer.

Example --profile -winxp "HP 5 Si/Mx A4paper"

--ssl-required <yes|no>

Specifies whether or not Secure Sockets Layer (SSL) is required for clients to print to this printer.

iprntman.conf File

The iprntman.conf file defines the scope of search when authenticating short user names. You can use either iprintssl.conf or iprntman.conf. To use iprintssl.conf, you must change the iprintssl.conf parameter to yes in the iprntman.conf file. The iprntman.conf file is located at /etc/opt/novell/iprintmgmt/conf/iprntman.conf, and the iprintssl.conf file is located at /etc/opt/novell/iprint/httpd/conf/iprint_ssl.conf.

Examples

Creating a Driver Store

Syntax

iprntman ids <IDS_DN> -c --hostname <DNS_name> --use-directory-server <ds_hostname>

Example

iprntman ids cn=ids1,ou=print,o=my_company -c --hostname printing.my_company.com --use-directory-server ds.my_company.com

Creating a Print Manager

Syntax

iprntman psm <print_manager_DN> -c --hostname <DNS_name> --use-ids <IDS_DN> --use-directory-server <ds_hostname>

Example

iprntman psm cn=PrintManager1,ou=print,o=my_company -c --hostname printing.my_company.com --use-ids cn=ids,ou=print,o=my_company --use-directory-server ds.my_company.com

Creating a Printer

Syntax

iprntman printer <printer_agent_name> -c --container <container_DN> --gateway-load-string "iprintgw port=lpr hostaddress=<IP_address> printername=passthrough"

Example

iprntman printer "HP Color LaserJet 5000" -c --container ou=print,o=my_company --gateway-load-string 'iprintgw port=lpr hostaddress=192.0.34.166 printername=passthrough'

Creating a Printer As a Non-Root User

On OES 11 SP2, non-root local users can also create and delete printers.

  1. Add the non-root local user to the LUM group.

  2. Set the required permissions for the directory by using the command chmod -R 775 /var/opt/novell/log/iprntmgmt/.

  3. Provide LUM group rights to the directory by using the command chgrp <group> /var/opt/novell/log/iprintmgmt.

  4. Modify the Logger.properties file located at /opt/novell/iprintmgmt/lib/Logger.properties by adding %h on line 19.

    For example: java.util.logging.FileHandler.pattern=/var/opt/novell/log/iprintmgmt/%h/iprintman%g.log.

Log files are created for each user individually.

List Printer Drivers in Repository for Windows 2000

Syntax

iprntman driver <repository_name> -l

Example

iprntman driver driver_windows-nt-5_x86-32_en -l

Upload Printer Driver

Syntax

iprntman driver <repository_name <driver_name>> --upload

Example

iprntman driver driver_windows-nt-6.1_x86_32_en --upload --from-ids-zip /root/drivers/drv.zip

Assign Print Driver to Printer

Syntax

iprntman printer <printer_agent_name> -m --driver-<platform> <driver_name>

Example

iprntman printer "HP LaserJet 4" -m --driver-winxp "HP LaserJet 4Si"

Enable Auditing and SSL on Printer

Syntax

iprntman printer <printer_agent_name> -m --audit-enabled yes --ssl-required yes

Example

iprntman printer "HP LaserJet 4" -m --audit-enabled yes --ssl-required yes

Modify Printer Location and Description

Syntax

iprntman printer <printer_agent_name> -m --location <location_info> --description <description_info>

Example

iprntman printer "HP LaserJet 4" -m --location "Next to front desk" --description "Color printer with envelope tray"

Delete a Printer

Syntax

iprntman printer <printer_agent_name> -d

Example

iprntman printer "HP Color LaserJet 5000" -d

Display Information about a Printer

Syntax

iprntman printer <printer_agent_name> -i

Example

iprntman printer "HP LaserJet 4Si" -i

Associate Drivers to an Existing Printer

Syntax

iprntman printer <printer_agent_name> -m --driver-<platform> <driver_name>

Examples

iprntman printer printer1 -m --driver-winxp "HP LaserJet 4200 PCL 5e"

iprntman printer printer1 -m --driver-win2k "HP LaserJet 3200 Series PCL 5e"

iprntman printer printer1 -m --driver-linux "HP LaserJet 8000 Series"

You can list the drivers in the Driver Store by using the following Linux command:

ll /var/opt/novell/iprint/resdir/<platform>

Files

The iprintman.keystore file is available in the user’s home directory.

Authors

Copyright 2005–2014, Novell, Inc. All rights reserved. http://www.novell.com

See Also

legal(5)

For more information, see the iPrint Administration Guide for Linux at http://www.novell.com/documentation/oes11/iprint_lx/data/front.html.