17.16 Printing

17.16.1 How to Set Up Print Queues (Oracle Solaris 10)
17.16.2 How to Set Up Print Queues (Oracle Linux)
17.16.3 How to Make Sun Ray Printers Available to a Windows Session
17.16.4 How to Manage Printer Configurations for Users
17.16.5 Printers Troubleshooting

The Windows connector supports printing for the following printer configurations:

Here are some important notes about setting up printers for the Windows connector.

17.16.1 How to Set Up Print Queues (Oracle Solaris 10)

This procedure describes how to set up a raw print queue on a Sun Ray server running Oracle Solaris 10 so that a Windows system can access it. This procedure is typically needed for printers locally attached to the Sun Ray server.

If a network printer is visible on the Sun Ray server, this typically indicates that the queue has been set up already and you should not have to perform this task. These instructions pertain to raw print queues, which are print queues configured without a printer driver. Please consult your operating system documentation for instructions about setting up queues for PostScript drivers. See also the lp and lpadmin man pages.

  1. Specify the printer and printer device node using the lpadmin command.

    # /usr/sbin/lpadmin -p printer-name \
    -v /tmp/SUNWut/units/IEEE802.mac-address/dev/printers/device-node
    
  2. Enable the print queue.

    # /usr/bin/enable printer-name
    
  3. Accept the print queue.

    # /usr/sbin/accept printer-name
    

To update the Windows session with the available print queues on the Sun Ray server, you must restart the Windows connector with the relevant print queues specified on the command line. See Section 17.16.3, “How to Make Sun Ray Printers Available to a Windows Session” for details.

17.16.2 How to Set Up Print Queues (Oracle Linux)

This procedure describes how to set up a raw print queue on a Sun Ray server running Oracle Linux, so that it can be accessed by a Windows system. This procedure is typically needed for printers locally attached to the Sun Ray server.

If a network printer is visible on the Sun Ray server, the queue has been set up already and you should not have to perform this task. These instructions pertain to raw print queues, which is a print queue configured without a printer driver. Please consult your operating system documentation for instructions on setting up queues for PostScript drivers. See also the lp and lpadmin man pages.

  1. Uncomment the following line from the /etc/cups/mime.convs file:

    application/octet-stream application/vnd.cups-raw 0 -
    
  2. Uncomment the following line from the /etc/cups/mime.types file:

    application/octet-stream
    
  3. Restart the cups daemon.

    # /etc/init.d/cups restart
    
  4. Create a soft link to the Sun Ray printer node in /dev/usb

    For example, if the device node is /tmp/SUNWut/units/IEEE802.mac-address/dev/printers/device-node, then use the following command:

    # ln -s /tmp/SUNWut/units/IEEE802.mac-address/dev/printers/device-node \
    /dev/usb/sunray-printer
    

    Use this soft link (/dev/usb/sunray-printer) as the Device URI while creating the print queue.

    Note

    After rebooting, you might have to create the /dev/usb directory and re-create the soft link.

  5. To complete the procedure, set up a raw print queue.

    # /usr/sbin/lpadmin -p printer-name -E -v usb:/dev/usb/sunray-printer
    

To update the Windows session with the available print queues on the Sun Ray server, you must restart the Windows connector with the relevant print queues specified on the command line. See Section 17.16.3, “How to Make Sun Ray Printers Available to a Windows Session” for details.

17.16.3 How to Make Sun Ray Printers Available to a Windows Session

The Windows session is aware only of the print queues specified in the command line when the Windows connector is started. To update the Windows session with the available print queues on the Sun Ray server, you must restart the Windows connector with the relevant print queues specified on the command line.

Before You Begin
  • Make sure the print queues are set up on the Sun Ray server. See Section 17.16.1, “How to Set Up Print Queues (Oracle Solaris 10)” and Section 17.16.2, “How to Set Up Print Queues (Oracle Linux)” for details.

  • Printer data is created on the Windows system, so make sure to specify the name of the printer's Windows driver and install it on the Windows system. If you make a printer available without specifying a driver, the Windows connector defaults to a PostScript driver.

  • To find the printer driver name on a Windows system, check the Windows Registry key at:

    MyComputer/HKEY_LOCAL_MACHINE/System/CurrentControlSet\
    /Control/Print/Environments/Windows NT x86/Drivers/Version-3
    

    All the printer drivers installed on the system are displayed on this list.

Steps
  • To specify a printer's Windows driver:

    % /opt/SUNWuttsc/bin/uttsc -r printer:printer-name="windows-printer-driver-name" hostname.domain
    

    where printer-name is a valid raw print queue on the Sun Ray server and windows-printer-driver-name is the name of the printer exactly as shown on the Windows server. Double quotes are required around the name of the printer.

  • To make a printer available without specifying a driver:

    % /opt/SUNWuttsc/bin/uttsc -r printer:printer-name hostname.domain
    

    where printer-name is a valid raw print queue on the Sun Ray server.

  • To make multiple printers available:

    % /opt/SUNWuttsc/bin/uttsc -r printer:printer1=driver1,printer2=driver2 hostname.domain
    

17.16.4 How to Manage Printer Configurations for Users

Sun Ray Software automatically keeps track of the printer configuration changes on a remote Windows system for each user. Whenever a user changes the printer configuration on a remote Window system for any of the printers specified through the uttsc command, the Sun Ray server saves those changes to the Sun Ray data store. The Sun Ray server then restores the saved printer configurations whenever the user reconnects to the Windows system through the Windows connector.

The uttscprinteradm command helps you manage this information. You can use it to list the available printer information and to perform cleanup in case of user or printer deletion. See the uttscprinteradm man page for details.

17.16.5 Printers Troubleshooting

17.16.5.1 Problem: "Failed to open the printer port" message.

Verify that the printer node used for configuring the printer has been created and is available under /tmp/SUNWut/units/IEEE802.macid/dev/printers.

If the printer node is not available, reboot the client.