iprntman - Manage iPrint Managers and Driver Stores.
This section contains iPrint commands and utilities used on the Linux platform.
iprntman <target> <targetcommand><options>
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.
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
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.
driver
<repository_name> <driver_name>
ids
<IDS_DN>
job
<printer_agent_name <JOBID>>
pool
<pool_name>
printer
<printer_agent_name>
profile
<profile_name>
psm
<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 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
For driver options, see Driver Options.
iprntman driver <repos_name> <driver_name> <command> <options>
iprntman driver driver_windows-nt-5_x86-32_en "HP Color LaserJet 5500 PS" -i
Deletes a printer driver. This operation prompts interactively to reduce unintentional deletes. To skip the confirmation prompt, use the -f or --force option.
Displays driver information.
Lists drivers in a repository.
Uploads the driver to the IDS.
Downloads the driver from the IDS.
iprntman ids <ids_dn> <command> <options>
iprntman ids cn=ids1,ou=print,o=my_company -c --hostname printing.my_company.com --use-directory-server ds.my_company.com
Creates an IDS. See IDS OPTIONS for specific options.
Deletes an IDS. This operation prompts interactively to reduce unintentional deletes. To skip the confirmation prompt, use the -f or --force option.
Displays information about an IDS.
Lists IDS instances.
Starts IDS. All IDS instances on the server are started.
Displays the status of the IDS.
Stops IDS. All IDS instances on the server are stopped.
iprntman job <printer_name> <job_id> <command> <options>
iprntman job HP_ColorLaserJet 3 -l
Deletes a print job. This operation prompts interactively to reduce unintentional deletes. To skip the confirmation prompt, use the -f or --force option.
Displays information about a print job.
Lists all jobs for the specified printer.
Pauses the processing of a print job.
Resumes the processing of a print job.
Displays the status of a print job.
iprntman pool <pool_name> <command> <options>
iprntman pool Xerox_printer_pool -c --add-printer Xerox_printer -s ds.my_company.com
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.
Deletes the specified printer pool. This operation prompts interactively to reduce unintentional deletes. To skip the confirmation prompt, use the -f or --force option.
Modifies the printer pool.The modification includes adding or removing printers from the pool.
Adds the printer to the printer pool. This option works only with the -c option or -m option.
iprntman pool Xerox_printer_pool \-m --add-printer Xerox_printer
Removes the printer from the printer pool. This option works only with the -m option.
iprntman pool Xerox_printer_pool \-m --remove-printer Xerox_printer
iprntman psm <psm_dn> <command> <options>
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
Creates a Print Manager. See PRINT MANAGER (PSM) OPTIONS for specific options.
Deletes the specified Print Manager. This operation prompts interactively to reduce unintentional deletes. To skip the confirmation prompt, use the -f or --force option.
Displays information about the Print Manager.
Lists the Print Manager instances.
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.
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.
Displays the Print Manager status.
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.
iprntman printer <printer_name> <command> <options>
iprntman printer Xerox_Color -d -s server1.my_company.com
Creates a Printer Agent. See PRINTER OPTIONS for specific options.
Deletes the specified Printer Agent. This operation prompts interactively to reduce unintentional deletes. To skip the confirmation prompt, use the -f or --force option.
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.
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.
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.
Displays printer information.
Lists target instances.
Modifies properties of the printer. See PRINTER OPTIONS for specific options.
Renames the printer.
Pauses printer input.
Pauses output from the printer.
Deletes all jobs queued for this printer.
Resumes printer input.
Resumes output from the printer.
Starts the Printer Agent when it is shut down.
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.
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.
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.
Displays the printer status.
Shuts down the Printer Agent.
iprntman profile --list [platform] <options>
iprntman profile --import ["profile1,profile2,.."] <options>
iprntman profile --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.
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.
Overwrites the existing profile.
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.
Specify the user (LDAP format) who has the privileges to perform the import operation. For example: cn=admin,o=iPrintAppliance.
Specify the password of the user performing the import operation.
Options modify the command specified. General options can be used with all commands in conjunction with target specific options.
Suppresses the display of interactive confirmation prompts for the delete and other operations.
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.
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.
Specifies a server host on which to perform the operation, where host is a hostname or IP address. Defaults to localhost.
Specifies a username that is in LDAP format, using the FDN of the eDirectory user performing the operation. For example: cn=admin,o=myorganization
Determines the level of detail to display about the execution of operations.
Disables any warning messages from appearing.
Automatically accepts any certificates when you make your first IPP connection or your first direct eDirectory access through the JNDI library.
Sets the log level to one of these: SEVERE (highest), WARNING, INFO, CONFIG, FINE, FINER, or FINEST.
MIME type of the file during job submission.
Version of the User Agent that submits the job.
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
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
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.
For use with the --upload command. The <ppdfile> is a .ppd file for Linux or Mac OS X clients.
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
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
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
Enables auditing for this printer.
Specifies the banner you want to use for this printer.
Example: --banner BigBanner
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
Set the description of the printer.
Example: --description "Marketing color laser printer"
Enables or disables iPrint Direct, which lets you print directly to the printer and bypass the Print Manager.
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"
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.
Lets you set the accounting load string for the printer.
Set the location string of the printer
Example: --location "Second floor, South West corner"
Allows the printer to accept LPR print jobs.
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"
Specifies whether or not Secure Sockets Layer (SSL) is required for clients to print to this printer.
Enables the printer for automatic driver and profile updates.
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.
iprntman ids <IDS_DN> -c --hostname <DNS_name> --use-directory-server <ds_hostname>
iprntman ids cn=ids1,ou=print,o=my_company -c --hostname printing.my_company.com --use-directory-server ds.my_company.com
iprntman psm <print_manager_DN> -c --hostname <DNS_name> --use-ids <IDS_DN> --use-directory-server <ds_hostname>
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
iprntman printer <printer_agent_name> -c --container <container_DN> --gateway-load-string "iprintgw port=lpr hostaddress=<IP_address> printername=passthrough"
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'
On OES, non-root local users can also create and delete printers.
Add the non-root local user to the LUM group.
Set the required permissions for the directory by using the command chmod -R 775 /var/opt/novell/log/iprntmgmt/.
Provide LUM group rights to the directory by using the command chgrp <group> /var/opt/novell/log/iprintmgmt.
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.
iprntman driver <repository_name> -l
iprntman driver driver_windows-nt-5_x86-32_en -l
iprntman driver <repository_name <driver_name>> --upload
iprntman driver driver_windows-nt-6.1_x86_32_en --upload --from-ids-zip /root/drivers/drv.zip
iprntman printer <printer_agent_name> -m --driver-<platform> <driver_name>
iprntman printer "HP LaserJet 4" -m --driver-winxp "HP LaserJet 4Si"
iprntman profile --import ["profile1, profile2.."] -s <host> -u <username> -P <password> --source-server <source_servername> --source-username <source_username> --source-password <source_password>
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.
iprntman profile --import ["profile1, profile2.."] -s <host> -u <username> -P <password> --source-server <source_servername> --source-username <source_username> --source-password <source_password>
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.
iprntman profile --import ["profile1, profile2.."] --overwrite -s <host> -u <username> -P <password> --source-server <source_servername> --source-username <source_username> --source-password <source_password>
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.
iprntman printer <printer_agent_name> -m --audit-enabled yes --ssl-required yes
iprntman printer "HP LaserJet 4" -m --audit-enabled yes --ssl-required yes
iprntman printer <printer_agent_name> -m --location <location_info> --description <description_info>
iprntman printer "HP LaserJet 4" -m --location "Next to front desk" --description "Color printer with envelope tray"
iprntman printer <printer_agent_name> -d
iprntman printer "HP Color LaserJet 5000" -d
iprntman printer <printer_agent_name> -i
iprntman printer "HP LaserJet 4Si" -i
iprntman printer <printer_agent_name> -m --driver-<platform> <driver_name>
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>
The iprintman.keystore file is available in the user’s home directory.