Common UNIX Printing System (CUPS) is the default printing system on most Linux distributions. This section describes how to set up CUPS for printing from Reports Server.
CUPS printing is disabled by default. To enable CUPS printing, set the environment variable
YES. For more information, see Appendix B, "REPORTS_CUPS_PRINTING".
The primary advantage of CUPS is that it is a standard and modularized printing system that can process numerous data formats on the print server and also supports Internet Printing Protocol (IPP). With this feature, it is possible to directly print PDF files from Reports Server and it also simplifies network printing.
Figure 10-3 shows how Oracle Reports interacts with CUPS.
With this configuration, printers must be configured on all the CUPS running on all the machines where Reports Server is running.
Several text files are used to configure CUPS. For more configuration-related information, see the CUPS Software Administrators Manual at
By default, CUPS does not allow access from other network machines. To configure CUPS to allow access from remote machines, perform the following steps:
Enter the following command to open a CUPS configuration file:
Listen instruction, as follows:
Scroll to the bottom of the configuration file where the other
Listen instructions are declared.
Listen 127.0.0.1:631 and paste it above or below the original.
127.0.0.1 with the Linux server's IP address.
Configure each printer, as follows:
In the configuration file, locate:
Comment the instruction
Deny From All.
Allow from 127.0.0.1 to
Allow from All.
Repeat for all printer or fax queues that you wan to make accessible.
Save the configuration file and restart CUPS.
To stop CUPS, enter the following command:
To start CUPS, enter the following command:
The Red Hat Advanced Server provides a configuration wizard to help you set up your printers. To use the configuration wizard for this task, perform the following steps:
While logged on as the root user, open a command prompt and enter:
to display the Printer configuration window.
Select the New tab to launch the Add a new print queue wizard.
Follow the wizard prompts to:
Enter a queue name.
Select the queue type.
Select the printer model.
Review your selections and click Apply to create your new print queue.
Test your printer on CUPS, as follows:
Launch a browser on RedHat with the URL
Select the Printers tab. The printer you just created will be listed.
Click Print Test Page to test your printer setup. If the test page does not print, repeat the configuration steps. Ensure that your printer type and model selections are correct.
lpadmincan also be used to add a printer from the command line. Refer to the Linux man page for this command for more details.
The default CUPS configuration is to use
localhost as the print server. To make the CUPS use a remote server, you must change the server name in the
Figure 10-4 illustrates adding printers to a single CUPS server, and configuring all other machines running Reports Server to route their print requests to the remote CUPS server.
For information about the various other printing models, refer to the CUPS Software Administrators Manual at
Note:When Oracle Reports adds a printer to the CUPS server, it assigns a printer name, which is the name that must be used when referring that printer. Internally, the name is translated to the proper call depending on the device URI used in the configuration.