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, pools, and print jobs. You can also import driver profiles from one server to the another.

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

pool

target_instance

<pool_name>

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, run the following command:

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

Displays 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

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

Pool Commands

Syntax

iprntman pool <pool_name> <command> <options>

Example

iprntman pool Xerox_printer_pool -c --add-printer Xerox_printer -s ds.my_company.com

-c | --create

Creates a printer pool on the server. Creation of an empty pool is not allowed. It is mandatory to pass the --add-printer option with this command.

-d | --delete

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

-m | --modify

Modifies the printer pool.The modification includes adding or removing printers from the pool.

--add-printer <printer_name>

Adds the printer to the printer pool. This option works only with the -c option or -m option.

Example

iprntman pool Xerox_printer_pool \-m --add-printer Xerox_printer

--remove-printer <printer_name>

Removes the printer from the printer pool. This option works only with the -m option.

Example

iprntman pool Xerox_printer_pool \-m --remove-printer Xerox_printer

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

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

--grant-access <object_DN>

Adds the object as a user to the printer's Access Control List (ACL), explicitly granting print access to the object. If the printer is a secure printer (see --ssl-required), only supervisors and users with rights to the printer can access the printer. Access can be granted to User, Group, and Container objects. Granting access to a group or container allows contained users and groups to inherit access.

--grant-operator <object_DN>

Adds the object as an operator to the printer's ACL list, explicitly granting Operator Role access to the object. Only supervisors and users with Operator or Manager rights to the printer can manage the printer. Access can be granted to User, Group, and Container objects. Granting access to a group or container allows contained users and groups to inherit access.

--grant-manager <object_DN>

Adds the object as a manager to the printer's access ACL list, explicitly granting print access to the object. If the printer is a secure printer (see --ssl-required), only users with rights to the printer and supervisors can access the printer. Access can be granted to User, Group, and Container objects. Granting access to a group or container allows contained users and groups to inherit access.

-i | --info

Displays printer information.

-l | --list

Lists target instances.

-m | --modify

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

-n | --new-name

Renames the printer.

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

--revoke-access <object_DN>

Removes the object as a user from the printer's ACL list, revoking explicitly granted print access from the object.

Removing a user, group, or container from the ACL might not take away the access rights because they might also inherit access based on other permissions.

For example, if the ACL contains a user named “Bob” and the group named “Sales”, and Bob is also a member of the group Sales. Revoking access from Bob is not sufficient to prohibit Bob's access to the printer. Bob still inherits the rights as a member of the group Sales.

--revoke-manager <object_DN>

Removes the object as a manager from the printer's ACL list revoking the explicitly granted print access from the object.

Removing a user, group, or container from the ACL might not take away the access rights because they might also inherit access based on other permissions.

For example, if the ACL contains user named “Bob” and the group “Sales”, and Bob is also a member of group Sales. Revoking access from Bob is not sufficient to prohibit Bob's access to the printer. Bob still inherits rights as a member of the group Sales.

--revoke-operator <object_DN>

Removes the object as an operator from the printer's ACL list revoking the explicitly granted printer access.

Removing a user, group, or container from the ACL might not take away the access rights because they might also inherit access based on other permissions.

For example, suppose that the ACL contains user Bob and the group Sales, and Bob is also a member of group Sales. Revoking access from Bob is not sufficient to prohibit Bob's access to the printer. Bob still inherits rights as a member of the group Sales.

--status

Displays the printer status.

--stop

Shuts down the Printer Agent.

Profile Commands

Syntax

iprntman profile --list [platform] <options>

iprntman profile --import ["profile1,profile2,.."] <options>

Example
iprntman profile --list
-l | --list

Lists all the driver profiles on the server. You can also specify the platform (win9x, winnt, win2k, winxp, vista32, vista64, win732, win764, win832, win864,win1032, win1064, linux, mac)for which you want to list the profiles.

For example, to list the driver profiles for Windows 7 platform, specify the value as Windows 7, Windows 7 (x64), or win764. To list the driver profiles for Windows 8 or 8.1 platform, specify the value as Windows 8/8.1, Windows 8/8.1 (x64), or win864. The profiles for Windows 8 or Windows 8.1 are same.

--import

Imports all the driver profiles from one server to another. You can also specify the profiles to be imported in a comma separated format. The Print Manager must be running on both the servers.

--overwrite

Overwrites the existing profile.

--source-server

Specify the hostname or IP address of the server from where to copy the driver profiles. The Print Manager service must be running on this server.

--source-username

Specify the user (LDAP format) who has the privileges to perform the import operation. For example: cn=admin,o=iPrintAppliance.

--source-password

Specify the password of the user performing the import operation.

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

Determines the level of detail to display about the execution of operations.

-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 eDirectory access through the JNDI library.

--log-level

Sets the log level to one of these: SEVERE (highest), WARNING, INFO, CONFIG, FINE, FINER, or FINEST.

-mime | --mimetype <arg>

MIME type of the file during job submission.

-version | --UserAgentVersion <arg>

Version of the User Agent that submits the job.

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.

--auto-driver-update <yes|no>

Enables the printer for automatic driver and profile updates.

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, 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"

Import Driver Profiles from One Server to Another Server

Syntax

iprntman profile --import ["profile1, profile2.."] -s <host> -u <username> -P <password> --source-server <source_servername> --source-username <source_username> --source-password <source_password>

Example

iprntman profile --import -s ds.my_company.com -u cn=admin,o=iPrintAppliance -P novell --source-server 192.168.0.100 --source-username cn=admin,o=iPrintAppliance --source-password novell

The import command is executed on the server ds.my_company.com. All the driver profiles are imported from the source server 192.168.0.100 to the server ds.my_company.com.

Imports specific driver profiles

Syntax

iprntman profile --import ["profile1, profile2.."] -s <host> -u <username> -P <password> --source-server <source_servername> --source-username <source_username> --source-password <source_password>

Example

iprntman profile --import "Profile1, Profile 2" -s ds.my_company.com -u cn=admin,o=iPrintAppliance -P novell --source-server 192.168.0.100 --source-username cn=admin,o=iPrintAppliance --source-password novell

The import command is executed on the server ds.my_company.com.The driver profiles “Profile1” and “Profile 2” are imported from the source server 192.168.0.100 to the server ds.my_company.com.

Overwrites profiles that already exists on the server

Syntax

iprntman profile --import ["profile1, profile2.."] --overwrite -s <host> -u <username> -P <password> --source-server <source_servername> --source-username <source_username> --source-password <source_password>

Example (Profile 2 exists on the ds.my_company.com server)

iprntman profile --import "Profile1, Profile 2" --overwrite -s ds.my_company.com -u cn=admin,o=iPrintAppliance -P novell --source-server 192.168.0.100 --source-username cn=admin,o=iPrintAppliance --source-password novell

The import command is executed on the server ds.my_company.com. The driver profile “Profile1” is imported from the source server 192.168.0.100 to the server ds.my_company.com. The “Profile 2” on the server is overwritten with the corresponding attributes from the source server 192.168.0.100.

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.