Oracle Business Intelligence Publisher Installation Guide

Skip Headers

Contents

Introduction

This chapter discusses the installation of BI Publisher using the Oracle Universal Installer.

Performing a Basic Install

Basic Installation

The following steps guide you through the installer.

Run the Oracle Universal Installer

Access the installation files.
- For Windows install:
  
  From the Oracle BI Publisher product media, navigate to the install directory.
  
  Run the program setup.exe.
- For Linux or Unix install:
  
  From the Oracle BI Publisher product media, navigate to the install directory:
  
  cd install
  
  Execute the runInstaller script.
  
  ./runInstaller
The installation program window appears and prompts you through each screen. Provide the requested input for each screen.

To continue to the next screen, click Next. To return to a previous screen, click Back.
Specify file locations.

Accept the default drive and directories, or click Browse to change them. Do not change the Source Path. You may accept the default Destination Name and Path or change them as you wish.
Select installation type.

The installation type screen allows you to choose between Basic and Advanced installs. The Basic type installs BI Publisher into a standalone OC4J bundled within the install. The Advanced type installs BI Publisher into an existing Oracle Application Server 10.1.3.1 (or later).

Select Basic.
Choose your OC4J Administrator (oc4jadmin) password.

The Basic install provides a standalone OC4J. Enter the password you wish to use for this OC4J.

The Administrator password must be a minimum of 5 characters, maximum of 30 characters, and include at least one digit.
Review the summary information, which lists the components to be installed and shows the installation location and size.
Click Install to begin the installation and display the Install screen.

The Install Screen

The Install screen displays the current task and the installation progress bar. The installation process consists of three general phases:

Copy Files

Setup

Configuration

Click Stop Installation if you want to terminate the install process.

The Configuration Assistants Screen

This screen shows the name, status, and tool type for tools recommended to be run before completing the installation.

This installer includes one tool: the BI Publisher Configuration Assistant.

The tool may have one of the following states, as shown in the status column:
- Succeeded: The tool ran successfully.
- Failed: The tool ran, but failed.
- Pending: The tool is waiting to run.
- Cancelled: The tool was cancelled by the user (by clicking Stop).
- In Progress: The tool is currently running.
When the configuration assistant completes, OUI automatically proceeds to the next page.

If the configuration assistant does not complete, the installation screen displays the error message, and the configuration assistant writes its result code to the following log file: C:\Program Files\Oracle\Inventory\logs\installActionstimestamp.log

For all failed or skipped tools, OUI generates a list of the tool names and the commands used to run them; you can copy/paste this information directly into a shell script or batch file to run these tools after installation is complete. The generated script file is named configtoolcmds.pl and is located in the ORACLE_HOME\bin directory. The script is generated after you exit the installer.

The End of Installation Screen

The End of Installation screen informs you that installation was successful and provides instructions on starting and stopping BI Publisher, the BI Publisher login URL and additional details about your installation. These details will also be saved in BI_Publisher_readme.txt in the Destination path you specified in the second screen of the installation procedure.

Log in to the BI Publisher Server

At the end of the installation the BI Publisher server will be running.

Note: If you attempt to start BI Publisher when it is running, the start command will return errors.

Launch the BI Publisher application using one of the following methods:
- On Windows:
  
  From the Start menu, navigate to:
  
  Start > Programs > Oracle - OracleHomeName > BI Publisher Server
  
  OracleHomeName refers to the name you gave the Oracle Home where you installed Oracle BI Publisher.
- Open your browser to http://hostname:port/xmlpserver
  
  For example:
  
  http://localhost:9704/xmlpserver
Log in with user name "Administrator" and password "Administrator".

Important: Please change the Administrator password on the Account tab under Preferences.

Continue with Postinstallation Tasks.

Performing an Advanced Install

Advanced Installation

The following steps guide you through the installer for an Advanced installation.

Important: The BI Publisher installer requires that the OC4J home into which you install BI Publisher be named "home". If there is no instance of an OC4J home named "home", the installation will fail.

If you wish to install into an instance not named "home" please follow the manual install instructions. See Installing Manually into a J2EE Application Server.