Chapter 4 Setting Up Printers (Tasks)

This chapter describes how to set up a printer and to make the printer accessible to systems on the network by using Solaris Print Manager.

For information on the procedures associated with setting up printers by using Solaris Print Manager, see Setting Up Printing (Task Map).

For overview information about printers, see Chapter 2, Managing Printing Services (Overview).

Setting Up Printing (Task Map)

Setting Up Printing by Using Solaris Print Manager

Solaris Print Manager is a Java-based graphical user interface that enables you to manage local and remote printer configuration. This tool can be used in the following name service environments: LDAP, NIS, NIS+, NIS+ with Federated Naming Service (xfn), and files. You must be logged in as superuser to use this tool.

You can use Solaris Print Manager to set up print servers (Add New Attached Printer or Add a Network Printer) and print clients (Add Access to Printer). A local or attached printer is a printer which is physically cabled to the print server. A network printer is physically attached to the network. You can use Solaris Print Manager to add a local printer or a network printer. Adding access to a printer, or adding remote access, is the process of giving print clients (all those machines which are not the server) access to the printer.

Printer Setup With Solaris Print Manager

The following table describes each printer attribute to help you determine the information that is needed to set up a printer with Solaris Print Manager.

Solaris Print Manager and Special Characters

Solaris Print Manager checks user input for the various text fields in the input screens. There are two types of checking: general illegal input and input that is illegal for specific fields.

Solaris Print Manager does not accept the following characters as input, except for the help screens:

• Shell metacharacters, such as “\$^&*(){}`'|;:?<>, except for the destination field on the network printer screen, which accepts colons (:)

• Multibyte characters

• Pound signs (#), spaces, or tabs, except the description field, which accepts tabs

Starting Solaris Print Manager

To start Solaris Print Manager, either select Printer Administrator from the CDE Workspace menu or start the Print Manager from the command line. See the following section for details.

How to Start Solaris Print Manager

1. Verify that the following prerequisites are met. To use Solaris Print Manager, you must:

   • Have a bitmapped display monitor, such as the standard display monitor that comes with a Sun workstation. Solaris Print Manager can be used only on a system with a console that is a bitmapped screen.

   • Be running an X Window System, such as the CDE environment, or be using the remote display feature on a system running an xhost environment.

   • Be logged in as superuser on the print server to install an attached or network printer, or on the print client to add access to a printer.

   • Have the required access privileges for managing the LDAP, NIS, NIS+, or NIS+ (xfn) database:

     • If your name service is LDAP, you must have the following:

       • The distinguished name (DN) of a printer administrator and password in the directory.

       • The name or IP address of an LDAP server hosting the administered domain. This information is usually displayed and selected automatically.

         For more information about using LDAP to manage printer information, see Printing Support in the Name Service Switch.

     • If your name service is NIS, you must have the root password for the NIS master.

     • If you name service is NIS+, you might need to do the following:

       1. Log in to the NIS+ master as superuser.

       2. Identify the group that owns the printers table:

          # niscat -o printers.org_dir.domain_name.com . . . Group : "admin.domain_name.com"

       3. If necessary, add the system that runs Solaris Print Manager to the NIS+ admin group authorized to update the printers.org_dir.<domain> file.

          # nisgrpadm -a admin.domain_name.com host_name

       4. Log in to the system that runs Solaris Print Manager as superuser. Your NIS+ configuration may make it necessary to run the /usr/bin/keylogin command. For more information, see keylogin(1).

     • If your name service is NIS+ (xfn), you might need to do the following:

       1. Log in to the NIS+ master as superuser.

       2. Identify the group that owns the federated naming table:

          # niscat -o fns.ctx_dir.domain_name.com . . . Group : "admin.domain_name.com"

       3. If necessary, add the system that runs Solaris Print Manager to the NIS+ admin group authorized to update the fns.ctx_dir.<domain> file.

          # nisgrpadm -a admin.domain_name.com host_name

       4. Log in to the system that runs Solaris Print Manager as superuser. Your NIS+ configuration may make it necessary to run the /usr/bin/keylogin command. See keylogin(1) for more information.

   • Have the SUNWppm package installed.

     # pkginfo | grep SUNWppm system SUNWppm Solaris Print Manager

2. Start Solaris Print Manager by one of the following methods:

   • Select Printer Administrator from the Tools option of the CDE Workspace menu.

   • Select the Applications menu from the CDE front panel, and click the Printer Administrator icon in the Application Manager's System_Admin window

   • Type the following command at the command line:

     # /usr/sadm/admin/bin/printmgr &

   The Select Naming Service window overlays the Solaris Print Manager main window.

   If you want to use Solaris Print Manager from a remote system, do the following:

   Use the xhost command on the local system to give the remote system display access:

   # xhost +remote-system

   Then log in to the remote system, set the DISPLAY environment variable, and start Solaris Print Manager:

   # DISPLAY=local-system:display_number # export DISPLAY # /usr/sadm/admin/bin/printmgr &

   ---

   Note –

   If Solaris Print Manager fails to start from the CDE menu or from the command line, check the following:

   1. Superuser (root) might not have permission to connect to the X-server process on the local or remote system. If this happens, type the following:

      $ xhost +hostname $ su (Enter the root password) # /usr/sadm/admin/bin/printmgr &

      Replace hostname with either the local or remote system name before restarting Solaris Print Manager.

   2. Verify that the SUNWppm package is installed on the local or remote system.

      # pkginfo | grep SUNWppm

   ---

3. Select the name service that is used in your network from the Select Naming Service window. Choices are: NIS+ (xfn), NIS+, NIS, or files.

4. Check that the domain name is correct.

   The Solaris Print Manager main menu is displayed after the name service is loaded successfully.

Setting Up a Print Server

When you install an attached printer or a network printer to a system, the printer is made accessible to the local system. The system on which you install the printer becomes the print server.

The following procedure describes how to use Solaris Print Manager to add a new attached printer with the expanded printer support that is available in this release. For information about how to use Solaris Print Manager to add a new attached printer without specifying PPD files, see Reverting to Previous Solaris Print Manager Printer Definition Screens.

For overview information about the new or changed Solaris Print Manager features in this release, see What's New in Printing?.

How to Add a New Attached Printer by Using Solaris Print Manager

In this release, the printer definitions that you can assign with Solaris Print Manager have been modified. The printer type and file content type printer definitions are no longer available. You are now required to specify the printer make, model, and driver when adding a new attached printer or modifying an existing attached printer with Solaris Print Manager.

For overview information about new or modified Solaris Print Manager features in this release, see What's New in Printing?.

1. Select the system to be the print server.

2. Connect the printer to the print server. Turn on the power to the printer.

   Consult the printer vendor's installation documentation for information about the hardware switches and cabling requirements.

3. Start Solaris Print Manager on the print server where you connected the printer.

   For instructions, see How to Start Solaris Print Manager.

4. Select New Attached Printer from the Printer menu.

   The New Attached Printer window is displayed.

5. Fill in the required fields with the appropriate information.

   If you need information to complete a field, click the Help button.

   For example, to add a new attached printer with PPD files, complete the following fields:

   Printer Name: Description: Printer Port: Printer Make: Printer Model: Printer Driver: Fault Notification: Options: Default Printer Always Print Banner User Access List:

   The Printer Server field is filled in by Solaris Print Manager.

   To add a new attached printer without PPD files, complete the following fields:

   Printer Name: Description: Printer Port: Printer Type: File Contents: Fault Notification: Options: Default Printer Always Print Banner User Access List:

   The Printer Server field is filled in by Solaris Print Manager.

   To add a new attached printer without PPD files, see Reverting to Previous Solaris Print Manager Printer Definition Screens.

6. Click OK.

7. Verify that the printer has been installed. Check for the new printer entry in the Solaris Print Manager main window.

8. Verify that the printer can print requests.

   $ lp -d printer-name filename

9. Exit Solaris Print Manager.

   Choose Exit from the Print Manager Menu.

Verifying That the New Solaris Print Manager Feature Is Working

In this release, the printer definitions that you can assign with Solaris Print Manager have been changed. The printer type and file content type options have been replaced with the printer make, printer model, and printer driver screen options.

When you are using Solaris Print Manager to create or modify a print queue, choose the files option as the name service. Select the Printer -> New Attached Printer option from the menu. If the drop-down menu displays printer make and printer model, the new feature is working.

Verifying That the RIP Feature Is Working

The RIP enables you to print to printers that do not have resident PostScript processing capabilities.

To ensure that the RIP feature is working you need to create a new print queue by selecting one of the make/model combinations that is available in the New Attached Printer and New Network Printer screens used by Solaris Print Manager. Then, try printing to the new printer. If the output of the print job is recognizable, the RIP feature is working. If the output of the print job is unrecognizable, then the RIP feature is not working.

How to Add a New Attached Printer by Using LP Print Service Commands

The following procedure describes how to add a new attached printer with the expanded printer support that is available in this release. The -n option to the lpadmin command enables you to specify a PPD file when adding a new attached printer or modifying an existing attached printer. Two examples follow this procedure. The first example shows you how to add a new attached printer with PPD files. The second example shows you how to add a new attached printer without PPD files.

1. Connect the printer to the system, and turn on the power to the printer.

   Consult the printer vendor's installation documentation for information about the hardware switches and cabling requirements.

2. Collect the information that is required to configure an attached printer with PPD files.

   • Printer name and port device

   • File content type

   • PPD file

     To determine the PPD file that the printer will use, first define the printer make, model, and driver.

     For overview information about using PPD files when adding a printer or modifying an existing printer by using LP print service commands, see What's New in Printing?.

3. Define the printer name, port device, file content type, and PPD file that the printer will use.

   When using PPD files, the file content type is usually PostScript.

   1. Specify the printer name and the port device that the printer will use.

      # lpadmin -p printer-name -v /dev/printers/0

      The device to use is /dev/printers/0.

   2. Specify the interface script that the printer will use.

      # lpadmin -p printer-name -m standard_foomatic

   3. Specify the file content type and the PPD file that the printer will use.

      # lpadmin -p printer-name -I content-type -n /usr/lib/lp/model/ppd/manufacturer/ppdfile

      The PPD file that you supply is located in the /usr/lib/lp/model/ppd/manufacturer directory.

   4. Specify the printer description.

      # lpadmin -p printer-name -D "printer-description"

   For more information, see the lpadmin(1M) man page.

4. (Optional) Add filters to the print server.

   # cd /etc/lp/fd # for filter in *.fd;do > name=`basename $filter .fd` > lpfilter -f $name -F $filter > done

5. Enable the printer to accept print requests and to print those requests.

   # accept printer-name # enable printer-name

6. Verify that the printer is correctly configured.

   # lpstat -p printer-name

   The output of the lpstat command will list the PPD file that you used.

Example—Adding a New Attached Printer With PPD Files by Using LP Print Service Commands

This example shows how to add a new attached printer with PPD files. The -n option to the lpadmin command enables you to add a new print queue by specifying PPD files. The following information is used as an example. The information that you provide will vary:

• Printer name: paper

• Port device: /dev/printers/0

• File content type: postscript

• PPD file: /usr/lib/lp/model/ppd/Lexmark/Lexmark-Optra_E312-Postscript.ppd.gz

# lpadmin -p paper -v /dev/printers/0 1
# lpadmin -p paper -I postscript 2
# lpadmin -p paper -m standard_footmatic 3
# lpadmin -p paper -n /usr/lib/lp/model/ppd/Lexmark/ \
Lexmark-Optra_E312-Postscript.ppd.gzmake4
# lpadmin -p paper -D "Color printer on third floor, rm 3003" 5
# cd /etc/lp/fd
# for filter in *.fd;do 
   > name=`basename $filter .fd`
   > lpfilter -f $name -F $filter 
   > done 6
# accept paper
	destination “paper” now accepting requests 
# enable paper	7 
printer “paper” now enabled 
# lpstat -p paper 8
printer paper is idle. enabled since Feb 28 11:21 2004. available. 

1. Defines the printer name and the port device that the printer will use

2. Sets the file content types to which the printer can print to directly

3. Specifies the interface script for utilizing PPD files

4. Specifies the PPD file

5. Adds a description for the printer

6. Adds print filters to the print server

7. Accepts print requests for the printer and enables the printer

8. Verifies that the printer is ready for printing

Example—Adding a New Attached Printer Without PPD Files by Using LP Print Service Commands

This example shows how to add a new attached printer without PPD files. The commands in this example must be executed on the print server where the printer is connected. The following information is used as an example. The information that you provide will vary:

• Printer name: luna

• Port device: /dev/term/b

• Printer type: PS

• File content type: postscript

  # chown lp /dev/term/b # chmod 600 /dev/term/b 1 # lpadmin -p luna -v /dev/term/b 2 # lpadmin -p luna -T PS 3 # lpadmin -p luna -I postscript 4 # lpadmin -p luna -D "Room 1954 ps" 5 # cd /etc/lp/fd # for filter in *.fd;do > name=`basename $filter .fd` > lpfilter -f $name -F $filter > done 56 # accept luna destination “luna” now accepting requests # enable luna 7 printer “luna” now enabled # lpstat -p luna 8 printer luna is idle. enabled since Feb 28 11:21 2003. available.

1. Gives lp ownership and sole access to a port device

2. Defines the printer name and the port device that the printer will use

3. Sets the printer type of the printer

4. Specifies the file content types to which the printer can print directly

5. Adds a description for the printer

6. Adds print filters to the print server

7. Accepts print requests for the printer and enables the printer

8. Verifies that the printer is ready

Where to Go From Here

Use the following table to determine which tasks to complete next.

Setting Up a Print Client

A print client is a system that is not the server for the printer, yet has access to the printer. A print client uses the services of the print server to spool, schedule, and filter the print jobs. Note that one system can be a print server for one printer and be a print client for another printer.

Access to a printer can be configured on a domain-wide basis or on a per-machine basis depending on whether you add the printer information to the name service database.

The following sections describe how to use the new Solaris Print Manager to add access to a printer on a print client. The example that follows this procedure describes how to add printer access by using lp commands.

How to Add Printer Access by Using Solaris Print Manager

1. Start Solaris Print Manager on the system where you want to add access to a remote printer.

   For instructions, see How to Start Solaris Print Manager.

2. Select Add Access to Printer from the Printer menu.

   The Add Access to Printer window is displayed.

3. Fill in the window.

   If you need information to complete a field, click the Help button.

4. Click OK.

5. Verify that access to the printer is added. Check for the new printer entry in the Solaris Print Manager main window.

6. Verify that the printer can print requests.

   $ lp -d printer-name filename

7. Exit Solaris Print Manager.

   Choose Exit from the Print Manager Menu.

Example—Adding Printer Access by Using LP Print Service Commands

If you want to print to a remote printer, you must add access to the remote printer. This example shows how to configure access to a printer named luna, whose print server is saturn. The system saturn becomes a print client of the printer luna.

# lpadmin -p luna -s saturn 1
# lpadmin -p luna -D "Room 1954 ps" 2
# lpadmin -d luna 3
# lpstat -p luna 4

1. Identifies the printer and the print server.

2. Adds a description for the printer.

3. Sets the printer as the system's default printer destination.

4. Verifies that the printer is ready.

Setting Up a .printers File

There is no need to set up a .printers file in the users home directories if the users don't need customized printer information. However, the .printers file enables users to establish their own printer aliases. You can use the _default alias to make a printer the default. You can also set up a special _all alias to define a list of printers affected when you cancel a print request or check the status of printers.

Keep in mind that the use of the .printers file by the LP print service is controlled by the name service switch (/etc/nsswitch.conf). The default configuration is that the print service checks a user's home directory to locate printer configuration information before its checks the other name services. This means that you can tailor a user's printer configuration file to use custom printer information rather than the shared information in the name service.

For more information about the .printers file, see printers(4). For more information about the name service switch, see nsswitch.conf(4).

How to Set Up a .printers File

1. Log in to the user's system as superuser.

2. Start the file editor that you want to use to create a .printers file in the user's home directory.

3. (Optional) Set up the _default alias to make a specific printer your default printer. Use an entry that is similar to the entry shown in the following example.

   _default printer-name

4. (Optional) Set up the _all alias to define the printers affected when you cancel a print request or check the status of printers, using an entry similar to the one shown in the next example.

   _all printer1,printer2,printer3

5. Save the file as .printers.

Adding a Network Printer

A network printer is a hardware device that is directly connected to the network. This means the printer can be accessed from a print server without actually connecting it to the print server with a cable. The network printer has its own system name and IP address. Even though a network printer is not connected to a print server, it is necessary to set up a print server for the printer. The print server provides queuing capabilities, filtering, and printing administration for the network printer.

You can add a network printer by using the LP print service commands or by using Solaris Print Manager. For information about new printing features that are new or changed in this release, see What's New in Printing?.

Network printers might use one or more special protocols that require a vendor-supplied printing program. The procedures to set up the vendor-supplied printing program can vary. If the printer does not come with vendor-supplied support, the Solaris network printer support can be used with most devices. Use the print vendor-supplied software when possible.

The vendor might supply an SVR4 printer interface script to replace the standard printer interface script. If so, their SVR4 interface script calls the vendor-supplied printing program to send the job to the printer. If not, you need to modify the standard interface script to call the vendor-supplied printing program. You can do this by editing the per-printer copy of the standard interface script to call the vendor-supplied printing program.

The following terms are used in network printer configuration:

• Print server – The machine that spools and schedules the jobs for a printer. The print server is the machine on which the printer is configured.

• Printer-host device – The printer-host device is the software and hardware supplied by a vendor that provides network printer support for a non-network capable printer. The combination of the printer-host device with one or more printers attached to the device creates a network printer.

• Printer node – The printer node is either the physical printer or the printer-host device. It is the physical printer when the network support resides in the physical printer. It is the printer-host device when an external box is used to provide the network interface. The printer node name is the machine name given with the IP address. This name is selected by the system administrator and has no default or vendor requirement. The printer node name, as with all nodes, must be unique.

• Printer name – The name entered on the command line when using any of the printer commands. The printer name is selected by the system administrator at the time of printer configuration. Any one physical printer can have several printer or queue names; each provides access to the printer.

• Destination or network printer access name – The internal name of the printer node port that is used by the printer subsystem to access the printer. The access name is the name of the printer node, or the name of the printer node with a printer vendor port designation. Any printer vendor port designation is explicitly defined in the printer vendor documentation. The designation is printer specific. If the printer is a printer-host device and a printer, the port designation is documented in the printer-host device documentation. The format is:

  printer-node-name

  or

  printer-node-name:port-designation

• Protocol – The over-the-wire protocol used to communicate with the printer. The documentation from the printer vendor supplies the information regarding the protocol to select. The network printer support supplies both BSD Printer Protocol and raw TCP. Due to implementation variations, you might want to try both.

• Timeout, or retry interval Timeout – Is a seed number representing the number of seconds to wait between attempting connections to the printer. This seed number is the smallest amount of time to wait between attempted connections, and increases with an increase in failed connections. After repeated failures to connect to the printer, a message is returned to the user requesting possible human intervention. Attempts to reconnect continue until successful or the job is cancelled by the job owner.

Printer Vendor-Supplied Software for Network Printers

Network printers often have software support provided by the printer vendor. If your printer has printer vendor-supplied software, use the printer vendor software when possible. The software is designed to support the attributes of the printer and can take full advantage of the printer capabilities. Read the printer vendor documentation to install and configure the printer under an LP print system.

Sun Support for Network Printers

If the network printer vendor does not provide software support, the Sun supplied software is available. The software provides generic support for network printers and is not capable of providing full access to all possible printer attributes.

A general discussion of how to add a network printer is provided in Chapter 4, Setting Up Printers (Tasks). The following is a discussion of printer management using the Sun supplied software.

Invoking the Network Printer Support

The software support for network printers is called through one of the following interface scripts:

• With PPD files — netstandard_foomatic

• Without PPD files — netstandard

The configuring of a network printer with the network interface script causes the network printer support module to be called.

The command to configure the printer for network support with PPD files is as follows:

# lpadmin -p printer-name -m netstandard_foomatic 

The command to configure the printer for network support without PPD files is as follows:

# lpadmin -p printer-name -m netstandard

Selecting the Protocol

The print subsystem uses BSD print protocol and raw TCP to communicate with the printer. The printer vendor documentation provides the information about which protocol to use. In general, the TCP protocol is more generic across printers.

Type one of the following commands to select the protocol:

# lpadmin -p printer-name -o protocol=bsd

# lpadmin -p printer-name -o protocol=tcp

If the protocol that is selected is the BSD print protocol, you can further select the order of sending the control file to the printer. Some printers expect the control file, then the data file. Others expect the reverse. For this information, see the printer vendor documentation. The default is to send the control file first.

Type either one of the following commands to select the order:

# lpadmin -p printer-name -o bsdctrl=first

# lpadmin -p printer-name -o bsdctrl=last

Selecting the Printer Node Name

The system administrator selects the printer node name. This name must be unique, as with any node on the network. The printer node name is associated with the IP address of the printer.

Selecting the Destination (or Network Printer Access) Name

The print subsystem requires access information for the printer. The subsystem uses the destination name when making the network connection to the printer. This name is supplied by the system administrator to the print subsystem by using the lpadmin command. It becomes part of the printer configuration database. The printer access name is the name of the printer node, sometimes qualified by a port name. Port designation varies across printer vendors. You will find information about port designation in the documentation that is provided with the printer by the printer vendor. The format of printer access name is:

printer_node-name[:port-designation]

Example 1—Destination (or Network Printer Access Name) With Port Designation (Number)

A common port designation with TCP is 9100. If the printer node name is pn1, and the printer vendor defines the port as 9100, then the printer access name is: pn1:9100. To configure a printer in this case use:

# lpadmin -p printer_name -o dest=pn1:9100

Example 2—Destination (or Network Printer Access Name) With Port Designation (Name)

When using the BSD protocol, the port designation might not be a number, but some name defined by the printer vendor, for example: xxx_parallel_1. If the printer node name is cardboard, then the printer access name is: cardboard:xxx_parallel_1. To configure a printer in this case use:

# lpadmin -p printer-name -o dest=cardboard:xxx_parallel_1

Example 3—Destination (or Network Printer Access Name) With No Port Designation

If there is no port designation, and the printer node name is newspaper, the printer access name is the printer node name: newspaper. To configure a printer in this case use:

# lpadmin -p printer_name -o dest=newspaper

Setting the Timeout Value

The timeout option allows the user to select the amount of time (in seconds) to wait between successive attempts to connect to the printer. Some printers have a long warm up time and a longer timeout value is advised. The default is 10 seconds.

The timeout value does not impact the success or failure of the print process. The value is a seed value which the software uses as the initial timeout count. On repeated failures, this count is increased. A message is sent to the spooler when repeated attempts to connect to the printer fail. This alerts the user that intervention might be required. The failure could be anything from the printer being turned off to the printer being out of paper. Should these messages be produced too often, for example when the printer is warming up, increasing the timeout value will eliminate spurious messages.

The system administrator can experiment to find the optimal timeout value. Type the following command to set the timeout value:

# lpadmin -p printer-name -o timeout=n

Managing Network Printer Access

Each network printer should have only one server that provides access to the printer. This restriction enables the server to manage the access to the printer and keep jobs coherent.

The default device for the network printer is /dev/null. This device is sufficient when there is only one queue for the printer. Should more queues be required, set the device to a file. This setting enables the print system to restrict access to the printer across queues. The following commands create a device file and configure it as the network printer device.

# touch /path/filename
# chmod 600 /path/filename
# lpadmin -p printer-name -v /path/filename

The following is an example of how to create a device file called devtreedown.

# touch /var/tmp/devtreedown
# chmod 600 /var/tmp/devtreedown
# lpadmin -p treedown -v /var/tmp/devtreedown

How to Add a New Network Printer With Printer Vendor-Supplied Tools

1. Connect the printer to the network and turn on the power to the printer.

   Consult the printer vendor's installation documentation for information about the hardware switches and cabling requirements. Get an IP address and select a name for the printer node. This is equivalent to adding any node to the network.

2. Follow the printer vendor instructions to add the network printer.

   Use the printer vendor instructions to configure the network printer. These instructions are specific to the vendor and printer.

3. Add client access to the new printer.

   Now that the printer has been added, create access to the printer for the clients. For more information, see How to Add Printer Access by Using Solaris Print Manager.

4. Optional tasks to complete.

   There are several optional tasks that you might want to complete when setting up a network printer. For pointers to the remaining tasks, see Setting Up Printing (Task Map).

How to Add a New Network Printer by Using Solaris Print Manager

In this release, the printer defintions that you can assign with Solaris Print Manager have been modified. For overview information about new or modified Solaris Print Manager features, see What's New in Printing?.

1. Select the system to be the print server.

2. Connect the printer to the network. Turn on the power to the printer.

   Consult the printer vendor's installation documentation for information about the hardware switches and cabling requirements.

3. Start Solaris Print Manager on the print server.

   For instructions, see How to Start Solaris Print Manager.

4. Select New Network Printer from the Printer menu.

   The New Network Printer window is displayed.

5. Fill in the required fields with the appropriate information.

   If you need information to complete a field, click the Help button.

   For example, to add a new network printer with PPD files, complete the following fields:

   Printer Name: Description: Printer Port: Printer Make: Printer Model: Printer Driver: Fault Notification: Destination: Protocol: Options: Default Printer Always Use Banner User Access List:

   The Printer Server field is filled in by Solaris Print Manager.

   To add a new network printer without PPD files, complete the following fields:

   Printer Name: Description: Printer Port: Printer Type: File Contents: Fault Notification: destination: Protocol: Options: Default Printer Always Use Banner User Access List:

   The Printer Server field is filled in by Solaris Print Manager.

   To use Solaris Print Manager to add a new network printer without PPD files see Reverting to Previous Solaris Print Manager Printer Definition Screens.

6. Click OK.

7. Verify that the printer has been installed. Check for the new printer entry in the Solaris Print Manager main window.

8. Verify that the printer can print requests.

   $ lp -d printer-name filename

9. Exit Solaris Print Manager.

   Choose Exit from the Print Manager Menu.

How to Add a New Network Printer by Using LP Print Service Commands

This procedure describes how to add a new network printer with the expanded printer support that is available in this release. There are two examples that follow this procedure. The first example shows you how to add a new network printer with PPD files by using lp commands. The second example shows you how to add a new network printer without PPD files by using lp commands.

The following steps are necessary to set up a network printer by using the network printer support software. The use of this software is intended for printers that do not come with vendor-supplied software.

For overview information about adding a new network printer or modifying an existing network printer with PPD files, see What's New in Printing?.

1. Connect the printer to the network, and turn on the power to the printer.

   Consult the printer vendor's installation documentation for information about the hardware switches and cabling requirements. Get an IP address and select a name for the printer node. This step is equivalent to adding any node to the network.

2. Collect the information that is required to configure a new network printer with PPD files.

   • Printer name and port device

   • Network printer access name

   • Protocol

   • Timeout

   • File content type

   • PPD file

     To determine the PPD file, first define the printer make, model, and driver that the printer will use.

   For more information, see the terms that are described inAdding a Network Printer.

3. Define the printer name, port device, file content type, and PPD file that the printer will use. When using PPD files, the file content type is usually PostScript.

   1. Specify the printer name and the port device that the printer will use.

      # lpadmin -p printer-name -v /dev/null

      The device to use is /dev/null.

   2. Specify the interface script that the printer will use.

      # lpadmin -p printer-name -m netstandard_foomatic

      The interface script that is supplied with the support software for network printer is /usr/lib/lp/model/netstandard_foomatic.

   3. Specify the file content type and PPD file that the printer will use.

      # lpadmin -p printer-name -I content-type -n /usr/lib/lp/model/ppd/manufacturer/ppdfile

      The PPD file that you specify is located in the /usr/lib/lp/model/ppd/manufacturer/ directory

      For more information, see lpadmin(1M).

   4. Specify the printer description.

      # lpadmin -p printer-name -D "printer-description"

4. Set the printer destination, protocol, and timeout values.

   # lpadmin -p printer-name -o dest=access-name:port -o protocol=protocol -o timeout=value

   -p printer-name	Specifies the network printer name.
   -o dest=access-name:port	Sets the printer destination to the network printer access name and a designated printer vendor port, if the port is defined in the printer vendor documentation.
   -o protocol=protocol	Sets the over-the-wire protocol used to communicate with the printer. Both BSD and raw TCP are supported.
   -o timeout=value	Sets a retry timeout value that represents a number of seconds to wait between attempting connections to the printer.

5. (Optional) Add filters to the print server.

   # cd /etc/lp/fd # for filter in *.fd;do > name=`basename $filter .fd` > lpfilter -f $name -F $filter > done

6. Enable the printer to accept print requests and to print those requests.

   # accept printer-name # enable printer-name

7. Verify that the printer is correctly configured.

   # lpstat -p printer-name

8. Add client access to the new printer.

   Now that the printer has been added, create access to the printer for the clients. For more information, see Setting Up a Print Client. For information about how to define a print client by using a name service, see

9. Complete any optional tasks.

   There are several optional tasks that you might want to complete when setting up a printer. For pointers to the remaining tasks, see Setting Up Printing (Task Map). For information abot how to define print clients by using the name service, see Printing Support in the Name Service Switch.

Example—Adding a New Network Printer With PPD Files by Using LP Print Service Commands

This example shows how to add a new network printer with PPD files. The -n option to the lpadmin command enables you to add a new print queue by specifying PPD files. The commands used in this example must be executed on the print server. The following information is used as an example only. The information that you provide will vary.

• Printer name : luna1

• Device: /dev/null

• Interface: /usr/lib/lp/model/netstandard_foomatic

• Network printer access name: nimquat:9100

• Protocol: tcp

• Timeout: 5

• File content type: postscript

• PPD file: /usr/lib/lp/model/ppd/manufacturer/ppdfile

  # lpadmin -p luna1 -v /dev/null 1 # lpadmin -p luna1 -m netstandard_foomatic 2 # lpadmin -p luna1 -o dest=nimquat:9100 -o protocol=tcp -o timeout=5 3 # lpadmin -p luna1 -I postscript 4 # lpadmin -p luna1 -n /usr/lib/lp/model/ppd/manufacturer/ppdfile 5 # lpadmin -p luna1 -D "Second floor color printer"6 # cd /etc/lp/fd # for filter in *.fd;do > name=`basename $filter .fd` > lpfilter -f $name -F $filter > done 7 # accept luna1 destination "luna1" now accepting requests # enable luna1 8 printer "luna1" now enabled # lpstat -p luna1 9 printer luna1 is idle. enabled since Mon Apr 19 15:31:15 2004. available.

1. Defines printer name and sets the device to /dev/null

2. Defines the interface script for network printers

3. Sets the destination, protocol, and timeout

4. Specifies the file content types to which the printer can print to directly

5. Specifies the PPD file to use

6. Adds a description for the printer

7. Adds print filters to the print server

8. Accepts print requests for the printer and enables the printer

9. Verifies that the printer is ready to print

Example—Adding a New Network Printer Without PPD Files by Using LP Print Service Commands

This example shows how to add a new network printer without PPD files. The commands must be executed on the print server. The following information is used as an example. The information that you provide will vary.

• Printer name: luna1

• Device: /dev/null

• Interface: /usr/lib/lp/model/netstandard

• Network printer access name: nimquat:9100

• Protocol: tcp

• Timeout: 5

• File content type: postscript

• Printer type: PS

# lpadmin -p luna1 -v /dev/null 1
# lpadmin -p luna1 -m netstandard 2
# lpadmin -p luna1 -o dest=nimquat:9100 -o protocol=tcp 
-o timeout=5 3
# lpadmin -p luna1 -I postscript -T PS 4# lpadmin -p luna1 -D "Room 1954 ps" 5
# cd /etc/lp/fd
# for filter in *.fd;do	
	   > name=`basename $filter .fd`	
	   > lpfilter -f $name -F $filter	
	   > done 6
# accept luna1
	destination "luna1" now accepting requests
# enable luna1	 7
printer "luna1" now enabled 
# lpstat -p luna1 8
 printer luna1 is idle. enabled since Feb 28 11:21 2003.  available.

1. Defines printer name and sets the device to /dev/null

2. Defines the interface script for network printers

3. Sets the destination, protocol, and timeout

4. Specifies the file content type to which the printer can print directly, and the printer type

5. Adds a description for the printer

6. Adds print filters to the print server

7. Accepts print requests for the printer and enables the printer

8. Verifies that the printer is ready for printing

Converting Printer Configuration Information

This section explains how to convert the printer configuration information from systems that are running the SunOS 5.5.1 release. This section also explains how to copy this information to print clients so that the clients can access existing printers.

If you have only a few existing printers, add access to the printers by using Solaris Print Manager rather than by converting the printer configuration information and distributing it to print clients. For information on adding access to printers, see Setting Up Printing (Task Map).

Converting Printer Configuration Information (Task Map)

The following task map identifies the tasks that are associated with converting printer configuration information.

Converting Existing Printer Configuration Information

Existing printer configuration information is automatically converted when installing or upgrading to the Solaris 9 release. This section explains how to convert the printer configuration information for a system running SunOS 5.5.1 release or a system running a lpd-based print server to the /etc/printers.conf printer configuration file. You'll use one of two print administration commands to automate the conversion task:

• The conv_lp command enables you to convert information in the /etc/lp/printers directory on a SunOS 5.9 system to entries in the system's /etc/printers.conf file. For instructions, see How to Convert Printer Information For a System Running the Solaris 2.5.1 Release.

• The conv_lpd command enables you to convert information in an /etc/printcap configuration file from a system running an lpd-based print server to entries in an /etc/printers.conf file. For instructions, see How to Convert Printer Information For a System Running an lpd-based Print Server.

If you are not using a name service, you should create a master /etc/printers.conf file that includes the existing printers at your site. You can then copy the master file to all the print clients or by loading the file into the NIS or NIS+ name service. This step is a good way to initially enable all the new print clients access to the existing printers at your site.

If you are using the NIS or NIS+ name service to configure printer information, do not use a /etc/printers.conf file on your print clients. A print client uses the /etc/printers.conf file first to locate a printer. However, the /etc/printers.conf file might conflict with the printer information in the NIS or NIS+ maps and cause unexpected results. To avoid this problem, remove the /etc/printers.conf file on print clients when you want the clients to use NIS or NIS+ for printer information.

How to Convert Printer Information For a System Running the Solaris 2.5.1 Release

1. Log in as superuser on the system running the Solaris 9 release.

2. Convert the printer configuration information in the system's /etc/lp/printers directory to the /etc/printers.conf file.

   # /usr/lib/print/conv_lp

How to Convert Printer Information For a System Running an lpd-based Print Server

1. Copy the /etc/printcap file from a system running an lpd-based print server to a system running the Solaris 9 release.

2. Log in as superuser on the system running the Solaris 9 release where you copied the /etc/printcap file.

3. Convert the printer configuration information in the /etc/printcap file to the /etc/printers.conf file.

   # /usr/lib/print/conv_lpd