Skip Navigation Links | |
Exit Print View | |
System Administration Guide: Printing Oracle Solaris 11 Express 11/10 |
1. Introduction to Printing in the Oracle Solaris Operating System
2. Planning for Printing (Tasks)
3. Setting Up and Administering Printers by Using CUPS (Tasks)
4. Setting Up and Administering Printers by Using Print Manager for LP (Tasks)
5. Setting Up and Administering Printers by Using Oracle Solaris Print Manager (Tasks)
6. Setting Up Printers by Using LP Print Commands (Tasks)
7. Administering Printers by Using LP Print Commands (Tasks)
8. Customizing LP Printing Services and Printers (Tasks)
9. Administering the LP Print Scheduler and Managing Print Requests (Tasks)
10. Administering Printers on a Network (Tasks)
11. Administering Character Sets, Filters, Forms, and Fonts (Tasks)
12. Administering Printers by Using the PPD File Management Utility (Tasks)
Administering PPD Files by Using the PPD File Management Utility (Task Map)
Overview of the PPD File Management Utility
Specifying a PPD File Repository
Locating PPD File Label and Repository Information in Oracle Solaris Print Manager
Using the PPD File Manager (ppdmgr) Utility
How to Add a PPD File to a System by Using the ppdmgr Utility
How to Add a PPD File to a System by Using the lpadmin -n Command
How to Update or Rebuild the PPD Cache File by Using the ppdmgr Utility
13. Printing in the Oracle Solaris Operating System (Reference)
14. Troubleshooting Printing Problems in the Oracle Solaris OS (Tasks)
This procedure describes how to use the ppdmgr utility to add a new PPD file to the system. You can also specify a PPD file label, PPD repository, or the source path of the PPD file, by using the appropriate arguments with the ppdmgr -a command. Note that when you add a PPD file to the system by using the ppdmgr command, the file is copied to the label and repository that you specify and then compressed.
# ppdmgr -a ppd-file-path [ -L label ] [ -R repository ] [-w]
Copies the PPD file that is specified in ppd-file-path to the PPD repository, then updates the information in the cache file to reflect the change.
If the -L option is not specified, the default label that is assigned to the PPD file is user.
If the -R option is not specified, the default repository that is assigned to the PPD file is user.
Specifies the source path to the PPD file and the name of that file. This file is used with the -a option to add a copy of ppd-file-path to the specified label within the specified repository with the specified label. The ppdmgr utility accepts a valid PPD file that has either a .ppd or .ppd.gz extension.
Specifies a PPD file label. The default label is user. Label names must contain characters that are in the portable file name character set. Label names must not begin with a hyphen (-) or contain a semicolon (:). Label names cannot be a reserved label name.
The following label names are reserved and cannot be used with the -a option:
caches
ppdcache
manufaliases
all
Specifies the name of a PPD file repository that represents one of the PPD file installation locations. When using this option, one of the following PPD file repositories can be specified:
user (default)
admin
Displays the full path where the PPD file was copied. The -w option is only valid if it is used with the -a option. Otherwise, this option is ignored.
For instructions, see How to Start Oracle Solaris Print Manager.
If the PPD file that you specified was added successfully, the information is displayed in the Printer Driver field. See Description of the Printer Driver Field in Oracle Solaris Print Manager.
Example 12-1 Adding a PPD File to a System
This example shows how to add a PPD file, myHPprinter.ppd, to the system.
Note that in this example and the examples that follow the path that is specified varies.
# ppdmgr -a /net/somesystem/myHPprinter.ppd
The path to where the copy of the PPD file can be found on the system is /var/lp/ppd/user/HP/myHPprinter.ppd.gz.
Using this command, with the -a option, copies the file to the user label within the user repository.
Example 12-2 Adding a PPD File to a System With a Specified Label
This example shows how to add the PPD file myHPprinter.ppd, with the specified label, Photos, to the system.
# ppdmgr -a /net/somesystem/myHPprinter.ppd -L Photos
The path to where the copy of the PPD file can be found on the system is /var/lp/ppd/Photos/HP/myHPprinter.ppd.gz.
Using this command, with the -a and the -L options, copies the PPD file to the Photos label within the user repository.
Example 12-3 Adding a PPD File to a System to a Specified Repository
This example shows how to add a PPD file, myHPprinter.ppd, to the admin repository on a system.
# ppdmgr -a /net/somesystem/myHPprinter.ppd -R admin
The path to where the copy of the PPD file can be found on the system is /usr/local/share/ppd/user/HP/myHPprinter.ppd.gz.
Using this command with the -a and -R options copies the file to the user label directory within the admin repository.
Example 12-4 Adding a PPD File to a System With a Specified Label to a Specified Repository
This example shows how to add a PPD file, myHPprinter.ppd, to a system, specifying the Photos label and the admin repository.
# ppdmgr -a /net/somesystem/myHPprinter.ppd -L Photos -R admin
The path to where the copy of the PPD file can be found on the system is /usr/local/share/ppd/Photos/HP/myHPprinter.ppd.gz.
Using this command with the -a, -L, and -R options copies the file to the Photos label within the admin repository.
Example 12-5 Adding a PPD File to a System and Displaying the Full Path to Where the File Was Copied
This example shows how to add a PPD file, myHPprinter.ppd, to a system by displaying the destination path of the PPD file. Use the ppdmgr command with this option to determine where on the system the PPD file was copied.
# ppdmgr -a /net/somesystem/myHPprinter.ppd -w
The path to where the copy of the PPD file can be found on the system is /var/lp/ppd/user/HP/myHPprinter.ppd.gz.
Using this command with the -a and -w options copies the specified file to the user label within the user repository.
The -w option is only valid when used in combination with the -a option. Otherwise, this option is ignored.
For a detailed description of the ppdmgr command-line options and for guidelines on adding PPD files, see Description of the Command-Line Options for the ppdmgr Utility.
This procedure shows how to use the lpadmin command to modify an existing print queue configuration to associate a specified PPD file with the print queue.
If you use the lpadmin command with the -n option to add a PPD file to a system, you cannot specify a label or a repository. Instead, the user label is assigned to the file, and the file is then copied to the user repository. If you want to specify a user-defined label or repository, use the ppdmgr utility to add the PPD file. See How to Add a PPD File to a System by Using the ppdmgr Utility.
# lpadmin -p print-queue -n ppd-file-path
Administrative command that is used to configure the LP print service.
Specifies the print queue. Note that the print queue is sometimes referred to as the printer-name.
Copies the PPD file that is specified in the ppd-file-path to the default user label directory that is located within the default user PPD file repository.
Specifies the source path to the PPD file and the name of that file. This file is used with the -a option to add a copy of ppd-file-path to the specified label within the specified repository. The ppdmgr utility accepts a valid PPD file with either a .ppd or .ppd.gz extension.
for instructions, see How to Start Oracle Solaris Print Manager.
If the PPD file that is associated with the print queue was added successfully, it is displayed in the Printer Driver field. See Description of the Printer Driver Field in Oracle Solaris Print Manager.
$ lpstat -p print-queue -l
If the PPD file was added to the print queue successfully, the PPD file name is included in the PPD field of the lpstat command's output.
Example 12-6 Adding a PPD File to an Existing Print Queue by Using the lpadmin -n Command
This example shows how to modify the print queue, printer1, to associate it with a copy of the specified PPD file.
# lpadmin -p printer1 -n /path/mynewHPppdfile.ppd
The specified PPD file is stored in /var/lp/ppd/user/HP/mynewHPppdfile.ppd.gz.
An update of the PPD cache file on a system updates the existing information in the PPD cache file.
You might the request and update of the PPD cache file on a system in the following instances:
If you add a PPD file to the system by using the pkgadd command.
If you copied a PPD file to a label directory, within a known PPD file repository manually.
Any changes that you make are reflected in Oracle Solaris Print Manager after the update has completed.
A rebuild of the PPD cache file removes the existing cache and builds a completely new cache. This process can be time-consuming, especially if many PPD files are on the system. Therefore, only request a rebuild of the PPD cache file in troubleshooting situations. For guidelines that pertain to updating and rebuilding the PPD cache file, see Description of the Command-Line Options for the ppdmgr Utility.
This procedure describes how to update or rebuild the PPD cache file by using either the -u or the -r option of the ppdmgr utility.
To update the PPD cache file, use the ppdmgr command with the -u option.
To rebuild the PPD cache file, use the ppdmgr command with the -r option.
# ppdmgr -u | -r [ -R repository ] [ -L label ]
Updates the PPD cache file with information about the PPD file, or files, that are assigned to the specified label within the specified repository. The default label is user. The default repository is also user. If no changes are identified, no changes are made to the cache file.
Removes the existing PPD cache file, then rebuilds the file with the PPD file information for the PPD file, or files, within the specified label.
If no label is specified, the default label is user, within the specified repository. If a repository is not specified, the default repository is also user.
Under normal circumstances, you do not need to request a rebuild of the PPD cache file. Use this option only if you suspect that the PPD cache file has become corrupted.
Specifies a PPD file repository to update. You can specify one of the following PPD file repositories:
admin
all (Specifies all available PPD file repositories on a system)
system
user (default)
vendor
Specifies a PPD file label.
The default label is user. Label names must contain characters that are in the portable file name character set. Label names must not begin with a hyphen (-) or contain a semicolon (:). Label names cannot be a reserved label name.
The following label names are reserved:
caches
ppdcache
manufaliases
all
For instructions, see How to Start Oracle Solaris Print Manager.
If the PPD file that you specified was added successfully, the information is displayed in the Printer Driver field. See Description of the Printer Driver Field in Oracle Solaris Print Manager.
$ lpstat -p printer-name -l
If the PPD file was added to the system successfully, the PPD file name is included in the PPD field of the lpstat command's output.
Example 12-7 Updating the PPD Cache File by Using the ppdmgr Utility
This example shows how to update the PPD cache file to reflect information from the PPD files that are assigned in all the labels within the user repository.
# ppdmgr -u
This example shows how to update the PPD cache file to reflect information from the PPD files that are assigned in the Photos label within the user repository.
# ppdmgr -u -L Photos
This example shows how to update the PPD cache file to reflect the information from the PPD files that are assigned in all the labels within the admin repository.
# ppdmgr -u -R system
This example shows how to update the PPD cache file to reflect information from the PPD files that are assigned in the Photos label within the admin repository.
# ppdmgr -u -L Photos -R admin
The Service Management Facility (SMF) service for updating the PPD cache file, application/print/ppd-cache-update, is run once during system reboot to ensure that modifications made to any PPD file repositories on a system are reflected in the ppdcache file. The service instance is svc:/application/print/ppd-cache-update. This service is enabled by default when you install the Oracle Solaris software. To enable or disable the service, use the svcadm command.
Note - During a software installation or an upgrade, the cache file entries are generated for all PPD files that are delivered to the system repository, /var/lp/ppd. As a result, when the system reboots, it might take longer for the service to make the transition to an online state.
For instructions, see How to Enable or Disable the ppd-cache-update Service. For information about using SMF and the svcadm command, see the smf(5) and svcadm(1M) man pages.
# svcadm enable|disable application/print/ppd-cache-update
# svcs application/print/ppd-cache-update
If the service is enabled, the output is as follows:
# svcs application/print/ppd-cache-update STATE STIME FMRI online Apr_26 svc:/application/print/ppd-cache-update:default
If the service is disabled, the output is as follows:
# svcs application/print/ppd-cache-update STATE STIME FMRI diabled Apr_26 svc:/application/print/ppd-cache-update:default
For step-by-step instructions on using the ppdmgr utility with the -u option to update the PPD cache file, see How to Update or Rebuild the PPD Cache File by Using the ppdmgr Utility.