OBIEE 10G - Linux OEL 5 x86 Installation version


Steps to perform a simple and complete install of OBIEE on Linux OEL 5 (Linux - Installation)


Component Installation

Compoenent Description
Java Java SDK 1.5.0 or higher (installation procedure)
<note warning>not 1_5_0_7, go directly to JDK 5.0 update 11 </note>
Database connectivity software For example, If the Oracle BI Server has to access an Oracle Database, install the Oracle 10g client. If the Oracle BI Server is to access MS SQL Server database, install Microsoft Data Access Components (MDAC).

Get the software

To download the OBIEE software for Linux, you must

  • Full in your informations (name, company)
  • Select Product Pack as “Oracle Business Intelligence” and Platform “Linux x86”and hit the Go button
  • Click op de “Oracle Business Intelligence (10.1.3) Media Pack for Linux x86” link

  • Download the media part V16379-01 “Oracle Business Intelligence Suite Enterprise Edition for Linux x86 (Red Hat / Oracle Enterprise)”
  • Copy it to a temporay directory, unzip and untar it
[[email protected] tmp]$ unzip
[[email protected] tmp]$ cd Media
[[email protected] Media]$ tar -xf biee_linux_x86_redhat_101341_1of1.tar

Restrictions on Linux

Component Restrictions

The Administration Tool is available only for Windows operating systems

The repository (.rpd) file can be created and modified only using the Oracle Business Intelligence Administration Tool, which is available only for Windows operating systems.

Linux Pre-configuration

Create the installation directories and the User ID

Choose a user ID that can run all Oracle Business Intelligence processes. You may need to contact your UNIX Administrator to create this user ID.

You cannot install Oracle Business Intelligence as the user root

The installation script’s default installation directories are /usr/local/OracleBI and /usr/local/OracleBIData

  • Creation of the install group
[[email protected] ~]# groupadd oinstall
  • Creation of the OBI User (obi/obi)
[[email protected] ~]# /usr/sbin/useradd obi -g oinstall
[[email protected] ~]# passwd obi
Changing password for user obi.
New UNIX password:
BAD PASSWORD: it is WAY too short
Retype new UNIX password:
passwd: all authentication tokens updated successfully.
  • Creation of the OBI directories
mkdir -p /usr/local/OracleBI
chown -R obi:oinstall /usr/local/OracleBI
chmod -R 775 /usr/local/OracleBI
mkdir -p /usr/local/OracleBIData
chown -R obi:oinstall /usr/local/OracleBIData
chmod -R 775 /usr/local/OracleBIData


  • Linux - chown: Change owner to the user obi
  • chmod 775: Everything is allowed for the owner and read and execute access are allowed for everyone

Make sure that /dev/random and /dev/urandom are available

Oracle BI Presentation Services requires these pseudo random-number generator devices.

[[email protected] ~]# cd /dev
[[email protected] dev]# ls *random
random  urandom

Set the File Handle Limit parameter

  • Set the hard and soft limit to the OBI user by modifying the file limits.conf such as for a database installation:
obi                 soft    nofile  1024
obi                 hard    nofile  65536

The maximum File-descriptor must be at least 10240

  • To discover the file-descriptor settings, run the command ulimit -a
  • Or set file-descriptor using the command ulimit -n 10240
[[email protected] dev]# ulimit -a|grep open
open files                      (-n) 1024

Environment Variable

You can set them in the .bash_profile shell startup script of the obi user.

# File Descriptor Limit
ulimit -n 10240

# Java Home
export JAVA_HOME

# Local Binary

# OBI Setup Script
export PATH

# Database Parameters
export TNS_ADMIN
export PATH

The OBIEE install guide suggests to place the database variable in the shell script OracleBI_Home/setup/ (Locating the Database Setup Script Under UNIX - p126).

You can also in this script seen a lot of code to set environment variable for all others Unix plateform.

Verification of the shell

You must use bash (Bourne-Again Shell) when running Oracle BI scripts under Linux systems.

[[email protected] dev]# echo $SHELL

Pre-configuration check with the Script is a script for UNIX-based installations (including Linux). In order to make sure that the installation machine has all the necessary requirements for a successful installation, run this UNIX check script to check the prerequisites. The script is lightweight and easy to use, and checks for the following conditions:

  • Supported operating system
  • Required patches and filesets (if applicable)
  • Supported configurations
  • Adequate disk space
  • User is not root

The script is installed in the installer directory containing and setup.jar.


  • To get the help
[[email protected] Oracle_Business_Intelligence]$ ./ --help
Usage: [-b] [-s | <Oracle_BI_install_dir>]
    -b    Check build requirements in addition to runtime requirements
    -s    Skip installation directory checks

    If neither -s nor <OracleBI_install_dir> are specified, this script assumes
      <OracleBI_install_dir> = /usr/local/OracleBI
  • To test the installation under the obi user for the directory /usr/local/OracleBI
[[email protected] Oracle_Business_Intelligence]$ ./ -b /usr/local/OracleBI   
SUCCESS!! - This machine is configured for Oracle BI EE


If you plan to install the Oracle BI Server and Oracle BI Presentation Services on two separate machines, read this article before selecting the component that you want : OBIEE 10G - Installing Oracle BI Components on Different Machines

As the Java Development Kit 1.5.0 or greater installation location and all its files and subdirectories must have the writable user or user group permissions for the user installing Oracle Business Intelligence, run the following as root:

chmod -R 777 /usr/java/jdk1.5.0_22

To run the Oracle BI Installer in graphics mode under Linux:

  • Set the DISPLAY variable using one of the shell commands shown in the following table, if you plan to install OBIEE in graphic mode (no need in console mode).
Shell Command Syntax
C setenv DISPLAY=“<IP_address>”:0.0
Korn and bash export DISPLAY=“<IP_address>”:0.0
  • Change directory to the installation directory.
  • Run the installer :
    • in graphics mode, use the following command: ./
    • in console mode (text), use the following command: ./ -console

The meanings and default for each screen and prompt for complete Oracle BI EE Infrastructure installation in graphics mode are listed in this Table.

The instructions for a console mode installation are in this topic : Complete Oracle BI Installation (Linux) in Console Mode

  • Provide the requested input for each screen.
    • Installation Location: /usr/local/OracleBI
    • Data Location: /usr/local/OracleBIData
    • Installation Type: Basic
    • Set up type: Complete
    • JDK Location: /usr/java/jdk1.5.0_22
    • Administrator Credential : oc4jadmin/oc4jadmin
    • Language: English
  • To continue to the next screen, click Next. To return to a previous screen, click Back.
  • To view the help page for each screen, click Help.

In Console Mode, the summary :

Oracle Business Intelligence will be installed in the following


with the following features:

Oracle Business Intelligence JDBC Driver
Oracle Business Intelligence Systems Management
Oracle Business Intelligence Server
Oracle Business Intelligence Cluster Controller
Oracle Business Intelligence Scheduler
Oracle Business Intelligence Client
Oracle Business Intelligence Presentation Services
Oracle Business Intelligence Presentation Services Plug-in and BI Office
Oracle Business Intelligence Publisher

for a total size:

 2626.9 MB

Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1] 

Installing $L(,
InstallConfig.ProductName) $P(SiebelAnalyticsProductBean.productNumber). Please

0%         25%         50%         75%        100%

Installing Oracle Business Intelligence Please wait...

Creating uninstaller...

Please wait...

The InstallShield Wizard has successfully installed Oracle Business
  • Restore the JDK directory permission as root:
chmod -R 755 /usr/java/jdk1.5.0_22

Post Installation Tasks

Memory Allocation for OC4J

Starting Oracle BI

Shell scripts

Oracle BI uses shell scripts located in the directory OracleBI_HOME/setup to set environment variables and run specific component shell commands.

The main administration scripts (scripts which call other scripts) are:

  • oc4j (start OC4J)
  • (calls and starts the Oracle BI Server)
  • (calls and starts the Oracle BI Presentation Services.)
  • (for BI Scheduler)
  • (for the Cluster Controller)
  • (Sets up the environment for running the Oracle BI Client)

The scripts details are listed on this page: Scripts for Korn, Bourne, or Bash Shells.

Under Linux, no initialization process is necessary.

The order in which the services are stopped, then restarted, is important. Use the following sequence to start the OBI Component:

  • OC4J
  • Oracle Business Intelligence Server service.
  • Oracle Business Intelligence Presentation Services service.
  • Oracle Business Intelligence Scheduler Server service.

Then to start, launch the script in this order

./oc4j -start
./ start
./ start
./ start  # Oracle BI Cluster Controller

And to stop: stop stop stop
oc4j -shutdown -port 23791 -password oc4jadmin

Testing the Oracle BI Client

To test the Oracle BI Client :

  • Run Oracle BI Client by opening another session.
  • From the setup directory OracleBI_HOME/setup, run the shell command:

To test the client/server connectivity, run the command:

  • If the test is successful, press the Enter key several times to quit nqcmd.


BI Publisher Performance - JDK version 1_5_0_7

This issue applies to Versions,,,,, and

There is a bug in Java SE Development Kit (JDK) 5.0 version 1_5_0_7 that impacts the performance of Oracle BI Publisher. For better performance, upgrade to JDK 5.0 update 11 (1_5_0_11). Download and install this update from the following location:

After installing the JDK update, you must modify the OC4J start-up script or batch file to point to the new JDK location.

To modify the OC4J start-up script:

  1. On Windows, open <OracleBI>\oc4j_bi\bin\oc4j.cmd for editing. On Linux or UNIX machines, open $OracleBI\setup\ for editing.
  2. Set the JAVA_HOME variable to point to the new JDK location. For example, JAVA_HOME=D:\Program Files\Java\jdk1.5.0_11.

If you installed Oracle BI Presentation Services using the Basic Install option on the machine where JDK has been updated, then you must modify the instanceconfig.xml file to point to the new JDK location:

To modify the instanceconfig.xml file:

  1. Open the <OracleBIData>/web/config/instanceconfig.xml file for editing.
  2. Set the JavaHome parameter to the point to the new JDK location. For example, <JavaHome>D:\Program Files\Java\jdk1.5.0_11</JavaHome>.

How to check that a service is running?

With Linux - ps (process statut)

[[email protected] ~]#  ps -ef|grep sawserver
obi       5102     1  0 15:16 pts/3    00:00:00 /bin/sh /usr/local/OracleBI/setup/
obi       5109  5102  0 15:16 pts/3    00:00:08 /usr/local/OracleBI/web/bin/sawserver
root      5984  4661  0 15:39 pts/2    00:00:00 grep sawserver
[[email protected] ~]#  ps -ef|grep nqsserver
obi       5081     1  0 15:16 pts/3    00:00:12 /usr/local/OracleBI/server/Bin/nqsserver -quiet
root      6001  4661  0 15:40 pts/2    00:00:00 grep nqsserver

If you have only the grep line, the service doesn't run


Execute the tail command to check a logfile. For instance for the Oracle BI Server

tail -f /usr/local/OracleBI/server/Log/NQServer.log
  • Oracle BI Java Host start-up details: /usr/local/OracleBIData/web/log/javahost.out.log
  • Oracle BI Java Host log files directory after starting up: /usr/local/OracleBIData/web/log/javahost
  • Oracle BI Presentation Services log files directory: /usr/local/OracleBIData/web/log

Documentation / Reference

Powered by ComboStrap