Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle Business Intelligence Publisher (Oracle Fusion Applications Edition)
11g Release 1 (11.1.1)
  Go To Table Of Contents
Go To Index


A Setting Up Print Servers

This appendix describes how to set up print servers for BI Publisher.

It includes the following topics:

A.1 Setting Up CUPS on Linux

The delivery manager requires Common UNIX Printing System (CUPS) to print and fax documents. This section describes how to set up CUPS for printing and faxing on RedHat Linux.

Figure A-1 shows the integration between BI Publisher and CUPS.

Figure A-1 Integration of BI Publisher and CUPS

Description of Figure A-1 follows
Description of "Figure A-1 Integration of BI Publisher and CUPS"

The following procedures describe how to add a printer or fax to CUPS and how to test your setup. For more information, see CUPS Software Administrators Manual ( and the Redhat Advanced Server online help.

A.1.1 Prerequisites

  • RedHat Advanced Server 3.0 or later

  • Fax Modem connected to the Linux box

  • Development Tools for the RedHat Advanced Server installed

  • CUPS (Installed by default when installing RedHat AS 3.0 or later)

A.1.2 Setting Up a Printer on CUPS

The RedHat Advanced Server provides a configuration wizard to help you set up your printers.

To use the RedHat Printer Configuration Wizard to set up a printer:

  1. Run "redhat-config-printer"

    While logged on as the root user, open a terminal and execute "redhat-config-printer". This invokes the Printer configuration window.

  2. Select the New tab to launch the Add a new print queue wizard.

  3. Follow the wizard prompts to:

    • Enter a queue name.

    • Select the queue type.

      Select "Networked_JetDirect" to set up a network printer. For this selection, you must also enter the following:

      • Printer — Enter a hostname or IP address.

      • Port — Enter a port.

      If the printer driver is installed in Microsoft Windows, then the Printer and Port information is available from the Properties dialog for the printer (Settings > Printers and Faxes > (select printer) > File > Properties).

    • Select the printer model.

      If the printer supports PostScript, then select the following:

      • Manufacturer: "Generic"

      • Model: "PostScript Printer"

    • Review your selections and select "Apply" to create your new print queue.

  4. The new queue is displayed in the Printer configuration window.

To test the printer on CUPS:

  1. Launch a browser on RedHat and enter the following URL:


  2. Select the Printers tab. The printer you just created is listed.

    To use the Windows browser to access this page, see Section A.1.4, "Making CUPS Accessible from Other Machines."

  3. Select 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.

A.1.3 Installing and Setting Up Fax for CUPS

This section describes how to install efax-0.9 software and configure it for CUPS.

To install the fax software:

  1. Download efax-0.9 from one of the following locations:

  2. Extract the files to a working directory using the following commands:

    • gunzip efax-0.9.tar.gz

    • tar xvf efax-0.9.tar

  3. Compile and install using the following commands (see the Readme for more information):

    • make

    • make install


    You must have make and gcc installed in your RedHat AS.

  4. Test the fax.

    Enter the following command:

    fax send <fax_number><tiff file>

    For example:

    fax send 1234567 test.tiff

    The fax is successful if you get the return code:

    done, returning 0 (success)

  5. Download fax4CUPs. It is available from the following site:

  6. Install fax4CUPS as follows:

    1. Extract the tar file to a temporary directory

    2. Change the directory: cd fax4CUPS-1.23

    3. Open the INSTALL file and follow all steps.

  7. Restart CUPS using the following command:

    /etc/rc.d/init.d/cups restart

To set up a fax on CUPS:

  1. Launch a browser and go to the following URL:


  2. Enter the admin user name and password in the dialog that launches.

  3. From the Admin page, select Add Printer.

  4. Add a Fax queue as follows:

    In the Add New Printer region, enter the following fields:

    • Name — Enter a meaningful name for the item, such as "efaxserver". This item is referred to as "ipp://serverName:631/printers/efaxserver".

    • Location — Optional.

    • Description — Optional.

  5. Select a device for the fax queue.

    Select "Faxmodem (efax on /dev/modem)". In some cases, "/dev/ttySxx" is shown instead.

  6. Select a model for the fax queue.

    Select "efax". You can also select either "HylaFAX" or "mgetty-fax" if these have been installed.

  7. Select the driver for the fax queue.

    Select "efax (en)".

  8. Verify that the new fax queue appears on the CUPS Admin Web page.

  9. Text the fax on CUPS.

    Enter the following command to test the fax:

    /usr/bin/lp -d <printer name> -t <phone#> test.pdf


    /usr/bin/lp -d efax1 -t 5556231 myfax.pdf

A.1.4 Making CUPS Accessible from Other Machines

By default, CUPS does not allow access from other network machines. However, it can be configured to allow access.

To make CUPS accessible from other machines:

  1. Open a CUPS configuration file using the following command:

    Open /etc/cups/cupsd.conf
  2. Add a "Listen" instruction.

    • Scroll to the bottom of the configuration file where the other Listen instructions are declared.

    • Copy "Listen" and paste it above or below the original.

    • Replace "" with the Linux server's IP address.

  3. Configure each printer.

    • In the configuration file, locate:

      <Location /printers/your_printer_queue>

    • Comment the instruction "Deny From All".


      # Deny From All

    • Change "Allow from" to "Allow from All"

    • Repeat for all printer or fax queues that you wan to make accessible.

  4. Save the configuration file and restart CUPS.

    • Use the following command to stop CUPS:

      /etc/rc.d/init.d/cups stop

    • Use the following command to start CUPS:

      /etc/rc.d/init.d/cups start

  5. Test the accessibility from other machines.

    Launch a browser from another machine and enter one of the following URLs to ensure that the CUPS web page can be accessed:

    • http://linux_server_name:631

    • http://linux_ip_address:631

A.2 Setting Up Internet Printing Protocol (IPP) on Windows

This section describes how to set up Internet Printing Protocol (IPP) on a Windows XP server.

A.2.1 Setting Up IPP Printers on Windows XP Professional

To set up IPP printers:

  1. Install Internet Information Services (IIS).

    1. Open the Control Panel. Select Add or Remove Programs, then Add/Remove Windows Components.

    2. Select the option for Internet Information Services (IIS) from the list of available Windows Components.

    3. With IIS highlighted, select Details. Ensure that World Wide Web Service is selected in the Internet Information Services (IIS) dialog.

    4. With World Wide Web Service highlighted, select Details. Ensure that Printers virtual directory is selected in the World Wide Web Service dialog.

  2. Restart Windows XP.

  3. Share the printers:

    1. From the Start menu, select Settings, then Printers and Faxes.

    2. Right-click the printer icon and select Sharing.

    3. In the printer Properties dialog, select Share this printer and assign a Share name (for example: myprinter1).


      The Share name must not contain spaces.

  4. Configure the Windows Firewall to open a port to the XMLP Server:

    1. From the Start menu, select Settings, then Control Panel.

    2. From the Control Panel, select Windows Firewall.

    3. From the Windows Firewall dialog, select the Exceptions tab.

    4. Create an entry in the list of Programs and Services as follows:

    5. To allow access from a specific IP address only:

      • Select your entry, then select Edit.

      • From the Edit a Program dialog, select Change Scope.

      • Choose Custom list, and enter the IP address of the XMLP Server.

        Note that if you use the HTTP proxy server in BI Publisher Server, then you must enter the IP address of the proxy server.

  5. Change the virtual directory security setting.

    • From the Control Panel, select Administrative Tools, then Internet Information Service.

    • Navigate the Internet Information Service directory hierarchy as follows: Internet Information Services > [your server name] > Web Sites > Default Web Site > Printers. Right-click Printers and choose Properties.

    • From the Printers Properties dialog, select the Directory Security tab.

    • In the Anonymous access and authentication control region, select Edit.

    • In the Authentication Methods dialog, select the Anonymous access check box.

  6. Open a browser in a remote machine and enter the following URL: http://<your server name>/printers

    You see the list of shared printers.