Skip Headers
Oracle® Enterprise Manager Configuration Change Console Installation Guide
10g Version for Windows or UNIX

Go to Documentation Home
Go to Book List
Book List
Go to Table of Contents
Go to Feedback page
Contact Us

Go to previous page
Go to next page
PDF · Mobi · ePub

15 Installing and Configuring BI Publisher Reports

This chapter explains how to install and configure BI Publisher Reports.

Overview of BI Publisher Server

This section provides instructions for installing and integrating BI Publisher Server with the Oracle Enterprise Manager 10g Configuration Change Console Application, for use in Change Report generation. The installation of the Oracle Enterprise Manager 10g Configuration Change Console Application and its components must be executed in the order listed below:

  1. Oracle database installation

  2. Configuration Change Console Server installation

  3. Agent installations

  4. BI Publisher Reports Server installation

System Requirements

The Configuration Change Console can integrate with Oracle BI Publisher for offline report generation. Please review the requirements for installing Oracle BI Publisher prior to installing. These requirements are outlined in the Oracle BI Publisher Installation documentation available online from

When integrating the Configuration Change Console with BI Publisher, it is not required to have BI Publisher on the same server. It is recommended that BI Publisher be installed on its own server separately from the Configuration Change Console Server to ensure proper load balancing.

Preparing for Installation

Please review the prerequisites for each supported platform to ensure that the most recent service pack or patch is installed.

Installing BI Publisher Server

This section details all steps involved in installing the BI Publisher Server. For more detailed information covering the individual components of the BI Publisher Server, please see the BI Publisher Installation Documentation. The Configuration Change Console integration is specifically for version of BI Publisher.

Follow these steps to install the BI Publisher Server:

  1. Insert Oracle Business Intelligence Publisher Enterprise Version CD into the server.

  2. Locate and run the setup.exe file in the win32 directory of the cd.

  3. The Oracle Universal Installer will start. Depending on the speed of your machine it may take a few minutes for the initial screen to display. Once loaded, click Next.

  4. Specify the installation destination (Name and Full Path) on the Specify File Locations screen and click Next.

  5. On the Select Installation Type screen select Basic option and click Next.

  6. Set the password for the oc4jadmin administrator user and click Next.

  7. Confirm the installation settings and click Install.

  8. Install the BI Publisher.

  9. After the installation, the installer will initiate the BI Publisher Configuration Assistant automatically. Click Next after the configuration.

  10. The successful install screen will display. Click Exit to end the installation.

Configuring BI Publisher Server

This section covers the steps involved in Publishing the Oracle Enterprise Manager 10g Configuration Change Console Reports to the BI Publisher Server and configuring them for use with the Oracle Enterprise Manager 10g Configuration Change Console Application.

Pre-Configuration for BI Publisher Report Publication

Refer to the sections below for instructions you must complete before configuring the BI Publisher Report Publication.

Creating the Report Folder

To create the report folder, follow these steps:

  1. Login the BI Publisher console as administrator role.

  2. Click the Reports tab and then click the Create a new folder link on the left Folder and Report Tasks panel.

  3. Input the new folder name (for example, EMReports) and click the Create button.

  4. The new report folder is created and is listed on the right panel.

Creating the JDBC Connection

Follow these steps to create the JDBC connection:

  1. Click the Admin tab

  2. Click the JDBC Connection link under the Data Sources section.

  3. Click the Add Data Source button to add a new JDBC connection. The Data Source Name should be hard-coded as gateway because the imported report will use the data source name by default. Click the Test Connection button to test whether the configuration is available. Click the Apply button to save the configuration.


    If during troubleshooting you do not see a list of available BI reports from Configuration Change Console, check to be sure the data source name is 'gateway'.

Installing the Schedule Schema

Follow these steps to install the schedule schema:

  1. Click the Admin tab and click the Scheduler Configuration link under the System Maintenance section.

  2. Input the database connection configurations (you can use the previous JDBC connection settings or another individual connection settings). Click the Test Connection button to test whether the configuration is available. Click the Install Schema button to create scheduler schema on the specified database. Click the Apply button to finish the configuration.

Configuring BI Publisher Report Publication

Follow the steps below to configure BI Publisher Report Publication:

  1. Log in to the BI Publisher console using the administrator role.

  2. Click the Shared Folders link to open the folder list screen.

  3. On the folder list screen click the EMReports folder to open the folder.

  4. Click the Upload a report link on the Folder and Report Tasks panel.

  5. Click the Browse… button and navigate to [integratedsoftware-install} \BIPublisher\Base\\Reports folder (The directory integratedsoftware-install will be generated when you unzip the package that you can download at the same location from which you downloaded the server).

  6. Select the report package (the .zip file) and click the Open button.

  7. Click the Upload button to finish importing the report.

Integrating BI Publisher

This section provides instructions for configuring the BI Publisher connection parameters through the Oracle Enterprise Manager 10g Configuration Change Console application interface.

Follow these steps to integrate BI Publisher:

  1. Log into the Oracle Enterprise Manager 10g Configuration Change Console Product interface using the Administrator login.

  2. From the Navigation tree, select Administration > Server Administration > Configuration > BI Publisher Server.

  3. On the BI Publisher Server Configuration screen enter your server information:

    • Server IP - Hostname or IP address of the BI Publisher server

    • User Name - Username used to access the BI Publisher server. Note that this field is case sensitive

    • Password - Password used to access the BI Publisher server. This password will need to be re-entered in the Password (verify) field

    • Report Folder - The folder path should be the corresponding path in BI Publisher. For example, if the folder was created under Shared Folders and named EMReports, the path should be /EMReports.

    • WSDL definition - The definition URL to access BI Publisher's web service API, in the format, where <host> is the hostname or IP address of the BI Publisher Reports server, and <port> is the port number used to access BI Publisher server. The default port used for BI Publisher is 9704:

      http://<host>:<port>/ xmlpserver/services/PublicReportService_v11?wsdl

  4. Click Save.

Using BI Publisher With Other Locales

When you want to publish BI Publisher reports in other languages that use special fonts such as Chinese or Japanese, you need to ensure that the BI Publisher Java Runtime Environment has the proper fonts available. If you do not deploy the proper fonts, you may see '?' symbols instead of real content.

The that contained the BI reports also contains a zip file under nls-fonts/ that has the required font files. To deploy these fonts to your BI Publisher JRE, unzip this file and place the *.ttf files into the following directory:

{BI Publisher install folder}\jdk\jre\lib\fonts\

After restarting your BI publisher server, you should now be able to generate reports for languages requiring these fonts.