.
Oracle Business Intelligence Enterprise
Edition 10.1.3.3 on AIX server Install
Guide
[AIX 5.3 64 bits mode]
Date: 16 November 2007
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
INFORMATION
Author
----------------------------------------------------------Christophe Menichetti
----------------------------------------------------------Email address
----------------------------------------------------------Christophe.Menichetti@fr.ibm.com
----------------------------------------------------------Date
----------------------------------------------------------November 1, 2007
-----------------------------------------------------------
Abstract
----------------------------------------------------------Describe all mandatory steps to succeed in Oracle Business Intelligence Enterprise
Edition version 10.1.3.3 installation on IBM System p520 (running on AIX 5.3)
----------------------------------------------------------Component Description
----------------------------------------------------------OBI EE version: 10.1.3.3 (OBIEE 10g R3 plus)
OBI EE Servers OS: AIX 5.3
Database version: anyone according to DB version supported
Database Server OS: anyone according to DB vendors
Web Server OS: AIX 5.3
Web Server: IBM Web Sphere Application Server 5.1.1
Web Client version: Internet explorer 6.0.2900
----------------------------------------------------------Version
----------------------------------------------------------Version 1.0.1: Creation and first redaction
Version 1.0.2:
----------------------------------------------------------Special Thanks to
----------------------------------------------------------Thierry Plumeau – IBM France
Paul Bramy – Oracle US
And All IBM/Oracle Joint Solution Center
-----------------------------------------------------------
© Copyright IBM Corporation, 2007
2/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
INTRODUCTION .................................................................................................................................................... 4
DOCUMENT PURPOSE............................................................................................................................................ 4
DOCUMENT CONTEXT ........................................................................................................................................... 4
OBI EE BRIEF DESCRIPTION ................................................................................................................................. 6
DOCUMENT ICON GLOSSARY ................................................................................................................................. 7
DOCUMENT HARDWARE PREREQUISITES ................................................................................................................ 8
Hardware and network for OBI Server Environment ....................................................................... 8
DOCUMENT SOFTWARE PREREQUISITES ................................................................................................................. 9
Supported platform for OBI Server Environment ............................................................................. 9
Supported platform for OBI Client Environment ............................................................................ 10
ORACLE BUSINESS INTELLIGENCE 10.1.3.3 CODE ...................................................................................... 12
DOWNLOADING STEPS......................................................................................................................................... 12
WHAT’S NEW? .................................................................................................................................................... 15
NEW ADDITIONAL INSTALLER FEATURES ............................................................................................................. 15
NEW INSTALLATION TYPES PROVIDED BY OBI INSTALLER..................................................................................... 15
NEW KEY CHANGES ............................................................................................................................................ 16
NEW PARAMETER CHANGES ................................................................................................................................ 16
PREPARING TO INSTALL OBI PRODUCT ......................................................................................................... 18
PLANNING THE INSTALLATION ............................................................................................................................. 18
OBI ARCHITECTURE OVERVIEW .......................................................................................................................... 19
AIX OS ADMINISTRATION TASKS ......................................................................................................................... 20
VERIFYING DISK SPACE ....................................................................................................................................... 24
INSTALLING ALL THIRD-PARTY COMPONENTS ....................................................................................................... 25
Installing JDK 1.5 on AIX ....................................................................................................................... 25
DEPLOYING WEB APPLICATION SERVER ............................................................................................................... 30
WAS 5.1 Installation Steps ................................................................................................................... 32
WAS 5.1.1 Installation Steps................................................................................................................ 43
Starting WAS 5.1.1 ................................................................................................................................. 49
LICENSE CONSIDERATIONS .................................................................................................................................. 51
RUNNING “CHECK SCRIPT” TO VERIFY ALL PRE REQUISITES .................................................................................. 52
PERFORMING OBI INSTALLATION ................................................................................................................... 57
INSTALLATION STEPS .......................................................................................................................................... 57
CONFIGURING OBI INSTALLATION .................................................................................................................. 66
START/STOP ORACLE BI COMPONENTS ............................................................................................................... 66
MAIN ORACLE BI CONFIGURATION FILES ............................................................................................................. 67
CONFIGURING HTTP WEB SERVER ..................................................................................................................... 68
Deploying the Web Archive file ........................................................................................................... 69
Deploying the Web Archive file ........................................................................................................... 69
Update the web server plug-in ............................................................................................................ 76
Restart Web sphere server .................................................................................................................. 77
© Copyright IBM Corporation, 2007
3/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Introduction
Document Purpose
The goal of this document is to explain all different steps mandatory to success
Oracle Business Intelligence Enterprise Edition (OBI EE) 10.1.3.3 on IBM AIX 5.3
server (IBM p520 machine).
This paper provides you step by step guide through install process to help you to
correctly install your solution.
At the end of this documentation, you should be able to better understand OBI
install tasks and be able to start your new version of Oracle Business Intelligence.
Reader must keep in mind that he can not find any information about Oracle
Business Intelligence administration or even performance tuning.
This paper is neither an OBI upgrade guide, nor an OBI concept and architecture
white paper, nor an OBI first step guide.
Document Context
In this document, we are using the following hardware configuration:

1 IBM power5 logical partition (LPAR) on one IBM p520 machine for all BI
Servers
All OBI products are located in the same System p logical partition.
Hereafter, an example of possible OBI architecture (OBI product integrated with an
Oracle RAC database):
© Copyright IBM Corporation, 2007
4/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
5/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Document Prerequisites
In order to better understand our documentation context, readers, who are not
comfortable with Siebel Analytics, are strongly advised to refer to
“Analytics7851_Installation_on_AIX_server_Guide.doc” documentation.
This documentation describes how to successfully install Siebel Analytics 7.8.5.2 on
AIX 5.3 platform. It explains the step before upgrade.
OBI EE Brief Description
Oracle Business Intelligence is a Business Intelligence tool helping decision makers
to analyze enterprise data and take right decisions. It is composed by 2 main
components:


OBI Server
OBI Presentation Server
OBI Server is the core server behind Oracle Business Intelligence Solution. It
provides the power behind Intelligent Dashboards (web-displayed Reports) for
access and analysis of structured data. It allows a single information request (for
reports for example) to query multiple data source.
OBI Presentation Server is the core server behind HTML pages viewed by users. It
provides the formatting and presentation of Intelligent Dashboards (web-displayed
Reports). OBI presents a lot of reports (table, chart, pivot and so on …) to web
users.
© Copyright IBM Corporation, 2007
6/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Document Icon Glossary
In order to make this document easier to read and easier to find quickly topics,
along the whole document, readers can find the following icons/symbols.
Each symbol is standing for a particular topic/section playing as “reminder” and
“guide”, allowing readers to know importance and nature of the paragraph pointed
by the symbol.
Hereafter, you can find the meaning of each symbol of the document:
Marking an important section, reader should be extremely careful
Marking a special note to the reader’s attention, reader should keep it in mind
Marking the first step of an action set, reader should execute the following
actions step by step
Marking an Operating System Command, reader should execute it into
“terminal”
Marking the action/command result (screenshot), reader should get this result
TEXT
Marking text we want to highlight to reader’s attention
Marking a summary section, like a reader help
Marking a (possible) error during an execution, reader may find this error BUT
IT IS NOT MANDATORY TO FACE THIS ERROR.
© Copyright IBM Corporation, 2007
7/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Document Hardware Prerequisites
This section describes the hardware and network requirements for the OBI Server
environment and the OBI Client environment.
Hardware and network for OBI Server Environment
Concerning UNIX Operating System hosting OBI Stack:
The number of servers and the CPU and memory resources required for
operation of OBI increases with the number and types of users and OBI reports
deployed.
© Copyright IBM Corporation, 2007
8/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Document Software Prerequisites
This section describes the supported platforms for the OBI Server environment and
the OBI Client environment.
ATTENTION: This section is a short overview of supported platforms for the
current OBI Deployment. To get more information on the following described
products or on other OBI products, you are strongly advised to read System
Requirements and Supported Platform Oracle documentation
Supported platform for OBI Server Environment
OBI Server OS
© Copyright IBM Corporation, 2007
9/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
OBI Web Server
Supported platform for OBI Client Environment
Web Browsers
OBI Tools
© Copyright IBM Corporation, 2007
10/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Supported Microsoft Applications with OBI
© Copyright IBM Corporation, 2007
11/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Oracle Business Intelligence 10.1.3.3 code
Downloading Steps
Execute the following steps in order to download Oracle Business Intelligence
Enterprise Edition (OBI EE) version 10.1.3.3 for AIX platform
ATTENTION: There is a lot of different possible situation than our situation we
are going to describe. That’s why your download steps could be different than
the following one
NOTE: We processed like that. First we downloaded OBI code into Window
Platform. Then we transferred OBI Code to AIX platform with “FileZila” (FTP
software tool) and then we untar code using VNC interface
1. Go to:
http://edelivery.oracle.com/
2. Then click on continue button
© Copyright IBM Corporation, 2007
12/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
3. If you are requested, enter your information (name, company and so on)
to access download screen
4. Select OBI EE product for AIX platform
5. Select version 10.1.3 and click continue
© Copyright IBM Corporation, 2007
13/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
6. Download the 3 part of AIX DVD
© Copyright IBM Corporation, 2007
14/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
What’s new?
New Additional Installer Features
The following bullets list changes in this new version (10.1.3.3) since the old one
(version 7.8.2.5 and 10.1.3.2):

OBI Installer installs OBI Publisher, which provides advanced reporting
capabilities

OBI Installer can now perform 2 different installation types
(Basic and Advanced)
New Installation Types provided by OBI Installer
During installation, you will be asked to choose a type of installation. The selection
you will make is only based on the type of web server on which OBI will be
deployed.


Basic Installation Type = the web server is a J2EE Application Server
Advanced Installation Type = the web server is Oracle Application Server
The following are the Basic Installation type requirements and actions:
Requires J2SE 5.0 (other name of 1.5)
Provides a choice to deploy the Presentation services and plug-in in Oracle
Containers for J2EE (OC4J)
Installs demonstration application that includes a repository, presentation catalog
and XML data source
The following are the Advanced Installation type requirements and actions:
You plan to link OBI with Oracle Single Sign-on (OSSO or OAID)
Provides a choice to deploy the Presentation services and plug-in in Oracle
Application Server
Installs demonstration application that includes a repository, presentation catalog
and XML data source
© Copyright IBM Corporation, 2007
15/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
New Key Changes
The OBI Infrastructure includes the following major features that are either new
with OBI or represent substantial changes from Siebel Analytics that might be
relevant to your deployment after the upgrade is complete.

The OBI Presentation Catalog architecture has changed from that of the
Siebel Analytics Web Catalog. It is no longer a single file, but is split across
multiple files that are stored in directories on the operating system. There is
a utility tool to migrate the web catalog (see later)

The OBI infrastructure 10.1.3.2 Clustering now includes support for
clustering servers running Presentation Services and clustering servers
running OBI scheduler
New Parameter Changes
The OBI Infrastructure includes new Configuration parameters of OBI server.
© Copyright IBM Corporation, 2007
16/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
New Names for OBI
Siebel Business Analytics Platform became Oracle Business Intelligence Enterprise
Edition (OBI EE). Now, there is a new naming for OBI components, mapped on the
old Siebel one.
© Copyright IBM Corporation, 2007
17/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Preparing to install OBI product
Planning the installation
Hereafter the installation tasks plan:
1.
2.
3.
4.
5.
Obtaining appropriate permissions
Installing third-party products
Deploying Web Application Servers
Installation Requirements for UNIX platform
License Considerations
NOTE: UNIX administrators should keep in mind they need to install some OBI
components under Windows Systems. Hereafter you can find the list of OBI
components to be installed under Windows Systems
© Copyright IBM Corporation, 2007
18/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
OBI Architecture Overview
The following schema is an out-of-the-box deployment without any configuration.
This diagram is giving an architecture overview to better understand what we are
going to install
© Copyright IBM Corporation, 2007
19/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
AIX OS Administration Tasks
Before you install Oracle Business Intelligence, you must have the appropriate
permissions for installing and configuring on your company system, as shown in the
following table. Make sure that you have write access to the installation directory
that you plan to specify in the installer.
NOTE: Reader is aware we are describing one specific method to install OBI
product, using third-party software, especially for remote access and using
specific name conventions. Obviously, you can easily act in a different way.
The following tasks should be completed before installing OBI software under AIX:
1. If you are planning to run the AIX installation remotely, or on a PC-based
machine, install third-party X window software (for graphic mode install)
a. Create a VNC desktop, by running VNC server
© Copyright IBM Corporation, 2007
20/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
b. Connect to this virtual VNC desktop with VNC viewer
c. Think about DISPLAY variable
Export DISPLAY = node12:0 (an example)
d. Use FileZilla (FTP Client) to download different binaries
© Copyright IBM Corporation, 2007
21/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
2. Determine your installation directory and create it if it is necessary (here
installation directory can be /Siebel/obiee10.1.3.3)
3. Choose a user ID that can run all OBI processes (here user is siebel)
ATTENTION: YOU CANNOT INSTALL OBI EE AS THE USER ROOT
So, don’t forget to switch as user siebel for instance
4. Make sure that /dev/random and /dev/urandom are available
OBI presentation services requires these pseudo random number generator
devices
© Copyright IBM Corporation, 2007
22/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
5. Set the File handler Limit Parameter
For running OBI processes, the file handle limit must be at least 10240 or
unlimited.
© Copyright IBM Corporation, 2007
23/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Verifying Disk space
Before upgrading you must verify disk space on your machine, because Oracle
Installer will need the following disk space:


2Gb for OBI EE installation
At least 200 MB for temporary directories (/tmp and /var/tmp)
TO be sure of disk space of your machine, execute the following command:
> df –m__
In case of insufficient disk space, please perform the following command in the
concerned directory:
> chfs –a size=+xxxM <your directory>__
For example:
> chfs –a size=+1000M /tmp__
© Copyright IBM Corporation, 2007
24/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Installing all third-party components
Before installing your OBI Platform, you should install all third-party components or
deployment components which need to be installed.
For instance, Presentation Services Servlet, database software or ODBC drivers.
For AIX, you must install Java Development Kit (JDK) 1.5 or higher before
installing
Installing JDK 1.5 on AIX
1. Determine your kernel bit mode (32 or 64 bit)
In aixterm console
> bootinfo-K
> 64
2. Download right JDK with the following web site link
http://www-128.ibm.com/developerworks/java/jdk/aix/service.html
In our case it is:
Select the following items
© Copyright IBM Corporation, 2007
25/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
26/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
3. Untar your tar file downloaded in your target machine (in any
directories)
> tar –xvf Java5_64.sdk.tar
4. Create the AIX table of Content for installation
> inutoc .
5. Execute smitty utility to install JDK
> smitty installp
© Copyright IBM Corporation, 2007
27/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
6. Enter “.” To select the current Directory
7. Enter F4 to list all software available to be installed
8. Do NOT forget to accept automatically license agreement
© Copyright IBM Corporation, 2007
28/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
9. At the end status will be OK
At the end you need to execute the following command to check if your
Installation succeeds
> java -version
If you don’t get this result, think about changing your path!
© Copyright IBM Corporation, 2007
29/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Deploying Web Application Server
Before installing OBI components (especially OBI Presentation server) you should
install web server on AIX.
In our case, we are installing IBM Web Sphere Application Server (WAS) 5.1.1
NOTE: Reader is aware we are describing one specific method to install OBI
product, using third-party software, especially for remote access and using
specific name conventions. Obviously, you can easily act in a different way.
To launch WAS5.1 installer, you must execute the following steps:
1. Login as root user
2. Setup PATH variable to point to java repository present in WAS install
repository
3. Execute : ./install
© Copyright IBM Corporation, 2007
30/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
[ERROR] a suitable JVM could not be found
Let try the following things to solve the issue
You can check:
a. If you are pointing to the right java repository in WAS installing
repository
b. If you have execution permission on this java repository
c. If you have the right java version in PATH variable (jvm 1.3)
d. If you have the right PATH variable
e. If you are able to execute “./launchpad.sh” in WAS installing
repository
f. If you created the right JAVA_HOME variable (excluding “bin”
repository in the java path)
© Copyright IBM Corporation, 2007
31/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
WAS 5.1 Installation Steps
© Copyright IBM Corporation, 2007
32/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
33/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
34/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Disable java doc component and MQ component
© Copyright IBM Corporation, 2007
35/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
36/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
[ERROR] Insufficient Disk Space to install selected component
Let try the following things to solve the issue
You can add disk space with following command:
> chfs –a size=+1000M /usr
Then Cancel the installation wizard
And try again
© Copyright IBM Corporation, 2007
37/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
38/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
39/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
40/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Then we are planning to install WAS 5.1 fix pack 1 (was 5.1.1)
Before you can try to start your Web Sphere Server
(And so don’t click exit but verify installation or start server)
© Copyright IBM Corporation, 2007
41/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
[ERROR] Server doesn’t start because of initialization failure
The cause could be port 9090 already used
Here the reason is indeed port 9090 already used by another application:
 websm is running on port 9090 (IBM application for System p
administration)
In order to stop this application and to free the port:
Go to inetd.conf file
Comment websm line
Save the change and exit
Refresh the change
© Copyright IBM Corporation, 2007
42/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
WAS 5.1.1 Installation Steps
1. still Logged as root user
2. Go to Fix Pack 1 directory and execute updateWizard.sh script
> updateWizard.sh
© Copyright IBM Corporation, 2007
43/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
44/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
45/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
46/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
47/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
48/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Starting WAS 5.1.1
1. Go to Web Sphere directory
2. Execute the following script to set up Web Sphere environment
> . ./setupCmdLine.sh
3. Then start the server 1
> startServer.sh server1
© Copyright IBM Corporation, 2007
49/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
4. Launch a web browser client to connect to your application server
http://localhost:9090/admin
© Copyright IBM Corporation, 2007
50/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
License Considerations
Before installation, you should be sure to get right license key and right XML file
corresponding to installation file.
Oracle BI license file are xml files
If you don’t have right license keys or you don’t know where you can get these
files, go to this following link:
http://licensecodes.oracle.com/oracle_bi.html
© Copyright IBM Corporation, 2007
51/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Running “check script” to verify all pre requisites
“UnixChk.sh” 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 file sets (if applicable)
■ Supported configurations
■ Adequate disk space
■ User is not root
The UnixChk.sh script is installed in two locations:
 The installer directory containing setup.sh and setup.jar. From here, you can
run UnixChk.sh before running the installer (that is, before running setup.sh)
 The directory OracleBI/setup/UnixChk.sh. From here, you can run UnixChk.sh
after installing Oracle BI
Usage:
UnixChk.sh [Oracle_BI_install_dir]
where Oracle_BI_install_dir is the directory in which Oracle BI is to be installed.
Omit this argument if Oracle BI is to be installed in the default installation
directory (/usr/local/OracleBI).
Hereafter, the procedure to execute script checking all pre requisites
ATTENTION: It is a very important step; since after running this script, you will
be sure that your platform is “ready” for OBI EE installation. Not running this
check script is bound to drive you to a very risky installation in term of
installation success.
© Copyright IBM Corporation, 2007
52/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
1. Switch to non-root user
> su - siebel
NOTE: Reader is aware we are describing one specific method to install OBI
product, including user name. You could decide to use another user name but
you have to select one non root user
2. Go to installer directory
> cd /distrib/So*Oracle/OracleBI/OBIEE10133/Server/*
NOTE: Again, Reader is still aware we are describing one specific method to
install OBI product, including related path for code source. Your code source
path could be probably different from this one.
© Copyright IBM Corporation, 2007
53/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
3. Execute the script
> UnixChk.sh /siebel/OBIEE10.1.3.3
NOTE: We are using /Siebel/OBIEE10.1.3.3 as install directory. You can decide
to have another install directory; you have to just specify your install
directory as check script option
At the end, you should get the following
© Copyright IBM Corporation, 2007
54/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
[ERROR] The default locale for OBI is not found
We need to install language file sets bos.loc.utf.EN_US
In order to solve the problem, launch smitty :
SMITTY > System Environment > Manager Language environment > Add
additional language env. > Cultural convention > Escape 4 > US-english
F4 and precise path where your files set is located
© Copyright IBM Corporation, 2007
55/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
[ERROR] xLC.aix50.rte needs to be fixed to another version
We need to install a higher version of C compiler (at least 8.0.0.8)
In order to solve the problem, launch smitty installp :
> smitty installp
Precise path where your file set is located
Put preview mode on
Put commit mode off
© Copyright IBM Corporation, 2007
56/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Performing OBI Installation
Installation Steps
Hereafter, you will find all steps to run OBI 10.1.3.3 installer.
1. First you need to ‘unarchive” the archive file (.cpio archive format)
> cpio –idvB < yourFile
2. You must be sure to use the right JDK version (1.5)
> java -version
© Copyright IBM Corporation, 2007
57/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
3. Be sure to use non root user
4. Be sure to have display functionalities
> xclock
NOTE: You should keep in mind that you are likely using different names than
document names for code directory, non root user and so on. Do not forget to
adapt names to your convention
© Copyright IBM Corporation, 2007
58/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
4. Run the setup script
> ./setup.sh
© Copyright IBM Corporation, 2007
59/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
[ERROR] Home Directory is not writable, you can not install
You need to change directory mode
In order to solve the problem, execute the following command as root
user:
> chmod –R a+rwx /siebel
© Copyright IBM Corporation, 2007
60/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
5. Follow the different screens as the following
© Copyright IBM Corporation, 2007
61/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
62/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
63/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
64/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
65/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Configuring OBI Installation
Start/Stop Oracle BI Components
Oracle BI uses shell scripts to set environment variables and run specific
component shell commands. These scripts provide for the basic setup of UNIX
systems. These scripts are located in the directory OracleBI_HOME/setup.
The following tables are summarizing the 2 main commands to start/stop Oracle BI
components:
© Copyright IBM Corporation, 2007
66/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Main Oracle BI Configuration files
Initialization automatically updates the component configuration files after
installation for the default, out of the box configuration. Upon start-up, Oracle
Business Intelligence uses initialization files to set parameters.
There is one main configuration file for Oracle BI server and another one for Oracle
Presentation server:
Presentation Server Configuration
Configuration settings for the Oracle BI Presentation Services are made in the file
instanceconfig.xml, located in the directory OracleBIData_HOME\web\config.
You can customize the Presentation Server by modifying the entries in
“instanceconfig.xml” and adding new entries to override internal default settings.
You need to make changes to instanceconfig.xml only if you want to change default
parameters, such as the name of the Presentation Server Catalog, or override
internal default settings, such as the time for client connections to expire.
Analytics Server Configuration
The Oracle Business Intelligence Server software uses an initialization file named
NQSConfig.INI to set parameters upon startup. This file includes parameters to
customize behavior based on the requirements of each individual installation.
© Copyright IBM Corporation, 2007
67/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Configuring HTTP Web Server
A default pre-packaged WebARchive (WAR) file, analytics.war, is included with the
Oracle BI Presentation Services installation, located as shown in the following
table.
However, if you modify the web.xml file (for example, to reconfigure the Web
server location and listening port), then you should recreate the analytics.war file.
This task uses the jar utility included in the Java JDK 1.5 package (found in the
<JAVA_HOME>/bin directory).
This procedure uses the following file locations and commands:
© Copyright IBM Corporation, 2007
68/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Deploying the Web Archive file
We are going to deploy the web application contained in the analytics.war file
1. Open a web browser and go to http://yourmachine:9090/admin
© Copyright IBM Corporation, 2007
69/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
2. Go to application > install new application
3. Browse the war file
© Copyright IBM Corporation, 2007
70/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
4. Click next
5. Click next
© Copyright IBM Corporation, 2007
71/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
6. Click continue
7. Click next
© Copyright IBM Corporation, 2007
72/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
8. Again
© Copyright IBM Corporation, 2007
73/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
9. Click FINISH
10. And then save the configuration
© Copyright IBM Corporation, 2007
74/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
© Copyright IBM Corporation, 2007
Montpellier – PSSC
75/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Update the web server plug-in
After the successful deployment the web server plug-in has to be updated, to
reflect the new access URL to the application.
In the WAS console go to
> Environment > Update Web server Plug-in
Click OK to update
© Copyright IBM Corporation, 2007
76/77
[author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center
Montpellier – PSSC
Restart Web sphere server
Restart your Web Sphere application server.
Go to Web Sphere directory and then “bin” directory and execute the following
command
> setupCmdLine.Sh
> stopServer.sh server1
> setupCmdLine.Sh
> stopServer.sh server1
© Copyright IBM Corporation, 2007
77/77
[author] Christophe Menichetti