Administering Printers and the Print Scheduler by Using LP Print Commands (Task Map)

Task	Description	For Instructions
Delete a printer and remove printer access.	If a printer needs to be replaced or moved to a different location, you can delete information about the printer from the print-client	How to Delete a Printer and Remove Printer Access by Using LP Print Commands
Check the status of printers.	Use the `lpstat` command to check the status of all printers or a specific printer. This command allows you to determine which printers are available for use and enables you to examine the characteristics of those printers.	How to Check the Status of Printers
Stop the print scheduler.	If the print scheduler stops accepting print requests, you might need to stop and restart the print scheduler.	How to Stop the Print Scheduler
Restart the print scheduler.	After you stop the print scheduler, you will need to restart the print scheduler, so the printer can begin accepting requests.	How to Restart the Print Scheduler
Start the print scheduler with options.	There are two ways to pass options to the print scheduler under the Solaris Management Facility (SMF). You can set options for the duration of a call, or you can set options to remain over a system boot.	How to Set Print Option Values Only for the Duration of a Call How to Set Printer Option Values That Remain Over a System Reboot

How to Delete a Printer and Remove Printer Access by Using LP Print Commands

Use this procedure when you remove a printer from service, and you want to remove the printer access from the print clients. Then, remove the printer information from the print server.

Log in as superuser, lp, or assume an equivalent role on a print client that has access to the printer you want to delete.
On the system that is the print client, delete information about the printer.
```
# lpadmin -x printer-name
```
-x

Deletes the specified printer.

printer-name

Specifies the name of the printer you want to delete.
Log in as superuser, lp, or assume an equivalent role on the print server.
On the system that is the printer server, stop accepting print requests for the printer.
```
# reject printer-name
```
reject printer-name rejects print requests for the specified printer.
This step prevents any new requests from entering the printer's queue while you are in the process of removing the printer. For a detailed description, see How to Accept or Reject Print Requests for a Printer.
On the system that is the print server, stop the printer.
```
# disable printer-name
```
This step stops print requests from printing. For a detailed description on how to stop printing, see How to Enable or Disable a Printer.
Move any print requests that are still in the queue to another printer.
For information about how to move print requests to another printer, see How to Move Print Requests to Another Printer.
On the system that is the print server, delete the printer.
```
# lpadmin -x printer-name
```
Verify that the printer information has been deleted:
1. Confirm that the printer information has been deleted on the print client.
```
$ lpstat -p printer-name -l
```
  In the command output, you should receive an error indicating that the printer does not exist.
2. Confirm that the printer information has been deleted on the print server.
```
$ lpstat -p printer-name -l
```
  In the command output, you should receive an error indicating that the printer does not exist.

Example 5-1 Deleting a Printer and Remote Printer Access

The following example shows how to delete the printer luna from the print client terra and from the print server jupiter. This example also shows how to delete the print client terra from the print server.

terra# lpadmin -x luna
Removed “luna”.
terra# lpstat -p luna -l 
jupiter# lpadmin -x luna
Removed “terra”.
jupiter# lpstat -p luna -l

Checking Printer Status

Many routine printer administration tasks require information about the status of the LP print service or a specific printer. For example, you can determine which printers are available for use. You can also examine the characteristics of those printers. You can use the lpstat command to find status information about the LP print service or a specific printer.

If a PPD file was used to create or modify a print queue, the specific PPD file is listed in the lpstat output. If a PPD file was not specified when the print queue was created, the PPD entry in the lpstat output is none.

How to Check the Status of Printers

Log in to any system on the network.
Check the status of printers.
Only the most commonly used options are shown here. For other options, see thelpstat(1) man page.
```
$ lpstat [-d] [-p] printer-name [-D] [-l] [-t]
```
-d

Shows the system's default printer.

-p printer-name

Shows if a printer is active or idle, when the printer was enabled or disabled, and whether the printer is accepting print requests.
You can specify multiple printer names with this command. Use a space or a comma to separate printer names. If you use spaces, enclose the list of printer names in quotation marks. If you don't specify printer-name, the status of all printers is displayed.

-D

Shows the description of the specified printer-name.

-l

Shows the characteristics of the specified printer-name.

-t

Shows status information about the LP print service, including the status of all printers, such as whether they are active and whether they are accepting print requests.

Example 5-2 Checking the Status of Printers

The following example shows how to display the system's default printer.

$ lpstat -d
system default destination: luna

The following example shows how to display the status of the printer luna.

$ lpstat -p luna
printer luna is idle. enabled since Jul 12 11:17 2001. available.

The following example shows how to display the description of the printers asteroid and luna.

$ lpstat -p "asteroid luna" -D
printer asteroid faulted. enabled since Jan 5 11:35 2004. available.
unable to print: paper misfeed jam

Description: Printer by break room
printer luna is idle. enabled since Jan 5 11:36 2004. available.
Description: Printer by server room.

The following example shows how to display the characteristics of the printer luna.

$ lpstat -p luna -l
printer luna is idle. enabled since Thu Jul 12 15:02:32 PM PDT
        Form mounted: 
        Content types: postscript
        Printer types: PS
        Description:
        Connection: direct
        Interface: /usr/lib/lp/model/standard
                PPD: none
        After fault: continue
        Users allowed:
                (all)
        Forms allowed:
                (none)
        Banner not required
        Character sets:
                             (none)
                Default pitch:
        Default page size: 80 wide 66 long
        Default port settings:

Stopping and Restarting the Print Scheduler

The print scheduler, lpsched, handles print requests on print servers. However, the print scheduler might sometimes stop running on a system, so print requests stop being accepted or printed. The lpadmin command automatically enables the lpsched service when local printers are added to the system and disables it when the last local printer is removed. The following procedures describe how to stop and restart the print scheduler. If a print request was printing when the print scheduler stopped running, the print request will be printed in its entirety when you restart the print scheduler.

How to Stop the Print Scheduler

Log in as superuser, lp, or assume an equivalent role on the print server.
Determine if the print scheduler is running.
```
# svcs application/print/server
```
You can also use the lpstat -r command to determine if the print scheduler is running.
If the print scheduler is not running, the message scheduler is not running is displayed.
If the print scheduler is running, stop it.
```
# svcadm disable application/print/server
```
You can also use the lpshut command to stop the print scheduler.

How to Restart the Print Scheduler

Log in as superuser, lp, or assume an equivalent role on the print server.
Determine if the print scheduler is running.
```
# svcs application/print/server
```
You can also use the lpstat -r command to determine if the print scheduler is running.
If the print scheduler is not running, the message scheduler is not running is displayed.
If the print scheduler is not running, start it.
```
# svcadm enable application/print/server
```
You can also use the /usr/lib/lpsched command to start the print scheduler. For more information about the difference between starting the print scheduler by using the /usr/lib/lpsched command or by using the svcadm enable application/print server command, see Starting the Print Scheduler With Options.

Starting the Print Scheduler With Options

There are two ways to pass options to the print scheduler by using SMF:

By modifying option values only for the duration of a call.
Use the /usr/lib/lpsched command with the appropriate options when you only want to pass options to the print scheduler for the duration of a call. Before setting options, see the lpsched(1M) man page for more information about these default values and reasons for changing them.
By maintaining option values over a system reboot, or if the print scheduler is restarted.
The SMF manifest for the print server contains properties that are utilized by the print server start-up script. These property values are passed on to the print scheduler and represent the options, which are set by using the svccfg command.
The properties are as follows:
- lpsched/num_filters
- lpsched/num_notifiers
- lpsched/fd_limit
- lpsched/reserved_fds
Any options that are not set with the svccfg command will use the default values that are in the print scheduler. For more information about using the svccfg command, see the svccfg(1M) man page.

How to Set Print Option Values Only for the Duration of a Call

Become superuser, lp, or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.
Set option values.
```
# /usr/lib/lpsched option value
```
-f num_filters

Specifies the number of concurrent slow filters that can be run on a print server.

-n num_notifiers

Specifies the number of concurrent notification processes that can run on a print server.

-p fd_limit

Specifies the file descriptor resource limit for the lpsched process.

-r reserved_fds

Specifies the number of file descriptors that the scheduler reserves for internal communications under heavy load.

Example 5-3 Setting Option Values Only for the Duration of a Call

This example shows how to set the number of filters to 2. The remaining options will use the defaults that are in the print scheduler.

# /usr/lib/lpsched -f 2

To use the default options that are in the print scheduler, run the /usr/lib/lpsched command without any options.

Note that starting the print scheduler by using the /usr/lib/lpsched command does not utilize the values that are set with the svccfg command.

How to Set Printer Option Values That Remain Over a System Reboot

Become superuser, lp, or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

Set one or all options.

# svccfg svc:> select svc:/application/print/server svc:/application/print/server> setprop property = value . . . svc:/application/print/server> quit

For each option that you want to set, repeat the setprop property = value command on a separate line.

Verify that the option has been correctly set by displaying the current values of the print server properties.
```
# svcprop svc:/application/print/server
```
Restart the print scheduler.
- If the print scheduler is not running, use the following commands:
```
# svcadm refresh svc:/application/print/server
# svcadm enable svc:/application/print/server
```
- If the print scheduler is running, use the following commands:
```
# svcadm refresh svc:/application/print/server
# svcadm restart svc:/application/print/server
```
To determine if the print scheduler is running, run the svcs application/print/server command.

Example 5-4 Setting Printer Option Values That Remain Over a System Reboot

This example shows how to set the number of filters to 1. This option will remain set over a system reboot, or if you restart the print scheduler.

# svccfg svc:> select svc:/application/print/server svc:/application/print/server> setprop lpsched/num_filters = count: 1 svc:/application/print/server> quit

This example shows how to set all options.

# svccfg svc:> select svc:/application/print/server svc:/application/print/server> setprop lpsched/num_filters = count: 1 svc:/application/print/server> setprop lpsched/num_notifiers = count: 1 svc:/application/print/server> setprop lpsched/fd_limit = count: 4096 svc:/application/print/server> setprop lpsched/reserved_fds = count: 2 svc:/application/print/server> quit

The following is a sample script that sets all options.

#!/bin/ksh

svccfg <<-EOF
select svc:/application/print/server
setprop lpsched/num_filters = count: 1
setprop lpsched/num_notifiers = count: 1
setprop lpsched/fd_limit = count: 4096
setprop lpsched/reserved_fds = count: 2

EOF