Upload
others
View
10
Download
0
Embed Size (px)
Citation preview
.
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- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [email protected] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
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.3Database version: anyone according to DB version supportedDatabase Server OS : anyone according to DB vendorsWeb Server OS: AIX 5.3Web Server: IBM Web Sphere Application Server 5.1.1Web Client version: Internet explorer 6.0.2900- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Version- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Version 1.0.1: Creation and first redactionVersion 1.0.2: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Special Thanks to- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Thierry Plumeau – IBM FrancePaul Bramy – Oracle US
And All IBM/Oracle Joint Solution Center- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
© Copyright IBM Corporation, 2007 2/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
INTRODUCTION....................................................................................................................................................4
DOCUMENT PURPOSE......................................................................................................................................4DOCUMENT CONTEXT......................................................................................................................................4OBI EE BRIEF DESCRIPTION........................................................................................................................6DOCUMENT ICON GLOSSARY.........................................................................................................................7DOCUMENT HARDWARE PREREQUISITES...................................................................................................8
Hardware and network for OBI Server Environment......................................................8DOCUMENT SOFTWARE PREREQUISITES....................................................................................................9
Supported platform for OBI Server Environment.............................................................9Supported 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.................................................................................................15NEW INSTALLATION TYPES PROVIDED BY OBI INSTALLER.................................................................15NEW KEY CHANGES.......................................................................................................................................16NEW PARAMETER CHANGES........................................................................................................................16
PREPARING TO INSTALL OBI PRODUCT...........................................................................................18
PLANNING THE INSTALLATION.....................................................................................................................18OBI ARCHITECTURE OVERVIEW.................................................................................................................19AIX OS ADMINISTRATION TASKS.............................................................................................................20VERIFYING DISK SPACE................................................................................................................................24INSTALLING ALL THIRD-PARTY COMPONENTS.........................................................................................25
Installing JDK 1.5 on AIX................................................................................................................25DEPLOYING WEB APPLICATION SERVER..................................................................................................30
WAS 5.1 Installation Steps...........................................................................................................32WAS 5.1.1 Installation Steps.......................................................................................................43Starting WAS 5.1.1............................................................................................................................49
LICENSE CONSIDERATIONS..........................................................................................................................51RUNNING “CHECK SCRIPT” TO VERIFY ALL PRE REQUISITES..............................................................52
PERFORMING OBI INSTALLATION.......................................................................................................57
INSTALLATION STEPS....................................................................................................................................57
CONFIGURING OBI INSTALLATION......................................................................................................66
START/STOP ORACLE BI COMPONENTS...................................................................................................66MAIN ORACLE BI CONFIGURATION FILES................................................................................................67CONFIGURING HTTP WEB SERVER..........................................................................................................68
Deploying the Web Archive file.................................................................................................69Deploying the Web Archive file.................................................................................................69Update the web server plug-in..................................................................................................76Restart Web sphere server..........................................................................................................77
© Copyright IBM Corporation, 2007 3/83 [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/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 5/83 [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/83 [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/83 [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/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 9/83 [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 10/83 [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 11/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
Supported Microsoft Applications with OBI
© Copyright IBM Corporation, 2007 12/83 [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 13/83 [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
© Copyright IBM Corporation, 2007 14/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
5. Select version 10.1.3 and click continue
© Copyright IBM Corporation, 2007 15/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
6. Download the 3 part of AIX DVD
© Copyright IBM Corporation, 2007 16/83 [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 ServerInstalls demonstration application that includes a repository, presentation catalog and XML data source
© Copyright IBM Corporation, 2007 17/83 [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 18/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 19/83 [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 20/83 [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. Obtaining appropriate permissions2. Installing third-party products3. Deploying Web Application Servers4. Installation Requirements for UNIX platform5. 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 21/83 [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 22/83 [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 23/83 [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 24/83 [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 ROOTSo, 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 25/83 [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 26/83 [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 27/83 [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:
© Copyright IBM Corporation, 2007 28/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
Select the following items
© Copyright IBM Corporation, 2007 29/83 [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
6. Enter “.” To select the current Directory
© Copyright IBM Corporation, 2007 30/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
7. Enter F4 to list all software available to be installed
8. Do NOT forget to accept automatically license agreement
© Copyright IBM Corporation, 2007 31/83 [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 32/83 [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 33/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
[ERROR] a suitable JVM could not be foundLet 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 34/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
WAS 5.1 Installation Steps
© Copyright IBM Corporation, 2007 35/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 36/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 37/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 38/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
Disable java doc component and MQ component
© Copyright IBM Corporation, 2007 39/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 40/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
[ERROR] Insufficient Disk Space to install selected componentLet 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 41/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 42/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 43/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 44/83 [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 45/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
[ERROR] Server doesn’t start because of initialization failureThe 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 46/83 [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 47/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 48/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 49/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 50/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 51/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 52/83 [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 53/83 [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 54/83 [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 55/83 [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 56/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 57/83 [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 58/83 [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 59/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
[ERROR] The default locale for OBI is not foundWe 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 60/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 61/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
[ERROR] xLC.aix50.rte needs to be fixed to another versionWe 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 62/83 [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 63/83 [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 64/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
4. Run the setup script
> ./setup.sh
© Copyright IBM Corporation, 2007 65/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
[ERROR] Home Directory is not writable, you can not installYou 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 66/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
5. Follow the different screens as the following
© Copyright IBM Corporation, 2007 67/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 68/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 69/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 70/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 71/83 [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 72/83 [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 fileinstanceconfig.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 73/83 [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 74/83 [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 75/83 [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 76/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
4. Click next
5. Click next
© Copyright IBM Corporation, 2007 77/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
6. Click continue
7. Click next
© Copyright IBM Corporation, 2007 78/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
8. Again
© Copyright IBM Corporation, 2007 79/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
9. Click FINISH
10. And then save the configuration
© Copyright IBM Corporation, 2007 80/83 [author] Christophe Menichetti
Europe Oracle|Siebel IBM Support Center Montpellier – PSSC
© Copyright IBM Corporation, 2007 81/83 [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 82/83 [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 83/83 [author] Christophe Menichetti