€¦ · Web viewSupported platform for OBI Server Environment 9 Supported platform for OBI Client...

.

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


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



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):



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.



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.



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.



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



OBI Web Server

Supported platform for OBI Client Environment

Web Browsers

OBI Tools



Supported Microsoft Applications with OBI



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



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



6. Download the 3 part of AIX DVD



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



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.



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.



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



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



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



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



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



5. Set the File handler Limit Parameter

For running OBI processes, the file handle limit must be at least 10240 or unlimited.



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__



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



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



7. Enter F4 to list all software available to be installed

8. Do NOT forget to accept automatically license agreement



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!



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



[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)



WAS 5.1 Installation Steps



Disable java doc component and MQ component



[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



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)



[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



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



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



4. Launch a web browser client to connect to your application server

http://localhost:9090/admin


http://localhost:9090/admin


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



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.



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.



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



[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



[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



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



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



4. Run the setup script

> ./setup.sh



[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



5. Follow the different screens as the following



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:



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.



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:



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


http://yourmachine:9090/admin


2. Go to application > install new application

3. Browse the war file



4. Click next

5. Click next



6. Click continue

7. Click next



8. Again



9. Click FINISH

10. And then save the configuration



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



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


€¦ · Web viewSupported platform for OBI Server Environment 9 Supported platform for OBI Client...

Documents

Transcript of €¦ · Web viewSupported platform for OBI Server Environment 9 Supported platform for OBI Client...