ADEPTA S.A.

2010

Oracle Business Intelligence Enterprise Edition (OBIEE) – Manual de Instalación

TABLA DE CONTENIDO

1.- PRERREQUISITOS 2

A) PERMISOS. 2
B) INSTALACIÓN DE COMPONENTES. 2

2. - RESTRICCIONES EN LINUX 5

A) COMPONENTES RESTRINGIDOS. SOLO ESTÁN DISPONIBLES BAJO LINUX: 5

B) ORACLE ADMINISTRATION TOOLS. 5

3. – PRE-CONFIGURACIÓN EN LINUX 6

A) CREAR DIRECTORIO DE INSTALACIÓN. 6

B) ESTABLEZCA EL PARÁMETRO IDENTIFICADOR DEL LÍMITE PARA ARCHIVOS. 6
C) CHECANDO CON EL SCRIPT UNIXCHK.SH 7

4.- INSTALACIÓN 8

A) MODO GRÁFICO 8
B) MODO CONSOLA 11

5.- TAREAS DE POST-INSTALACIÓN 14

A) ASIGNACIÓN DE MEMORIA PARA OC4J. 14

B) INICIANDO ORACLE BI. 14
C) CONFIGURAR EL CLIENTE DE ORACLE DE BASE DE DATOS. 15

6.- REFERENCIAS – DOCUMENTACIÓN 16

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 1

 ADEPTA S.A. 2010

1.- Prerrequisitos

a) Permisos.

Requisito Que permisos

Red Administrador de Red

Linux Administrador de Sistema o privilegios como root

Base de Datos Administrador DBMS

b) Instalación de Componentes.

Componente Descripción
Java Java SDK 1.5.0 o Superior

Software de Por ejemplo: si Oracle BI Server trabaja con una Base de Datos
Conectividad para Oracle, entonces necesitará el cliente Oracle 10g. En caso de ser
Base de Datos Microsoft SQL, instale el Microsoft Data Access Components (MDAC)

Servidor de Si va a instalar OBIEE en Oracle Application Server (usar la opción

Aplicaciones Oracle Avanzado), Oracle Application Server 10.1.3.1.0 o superior debe
estar instalado.

Pasos para instalar la SDK (JDK):

1.- Descargar el software desde http://java.sun.com/javase/downloads/5u22/jdk, existen diversas
versiones de JDK/SDK para la plataforma Linux, aunque la instalación requiere instalar la versión
1.5 o descargar la versión Java 5 o JDK 5. Esta versión requiere tener al menos un procesador
Pentium 166MHz o superior con un mínimo de 75MB de Disco Libre y un mínimo de 32MB en
RAM.

2.- Instalación en el directorio donde desee realizar la instalación, se recomienda /usr/local/java/,

realice los siguientes pasos:
 "Self-Extracting-Binary" – abrir consola de comandos:
o Cambiar los permisos del archivo con el siguiente comando: chmod a+x j2sdk-
1_4_2_<versión>-linux-i586.bin

o Ejecutar del directorio local: ./j2sdk-1_4_2_<versión>-linux-i586.bin

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 2

 ADEPTA S.A. 2010

o Aceptar la Licencia de Usuario.

o Configuración de Administrador:
Admin User Name: admin
Password: password
Admin Port: 4848
HTTP Port: 8080
HTTPS Port: 8181

o Registrar el Servidor de Aplicaciones e instalación:

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 3

 ADEPTA S.A. 2010

o Iniciar Servidor de Aplicaciones:

file:///usr/local/jdk/jdk/about.html
Start AppServer:
/usr/local/jdk/jdk/bin/asadmin
start-domain domain1
Start AdminConsole:
http:localhost:4848

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 4

 ADEPTA S.A. 2010

2. - Restricciones en Linux

a) Componentes Restringidos. Solo están disponibles bajo Linux:

1. Oracle Business Intelligence JDBC Driver
2. Oracle Business Intelligence Systems Management
3. Oracle Business Intelligence Server
4. Oracle Business Intelligence Cluster Controller
5. Oracle Business Intelligence Scheduler
6. Oracle Business Intelligence Client
7. Oracle Business Intelligence Presentation Services
8. Oracle Business Intelligence Presentation Services Plug-in
9. Oracle Business Intelligence Publisher

b) Oracle Administration Tool está disponible solo en plataformas Windows. El archivo

repositorio (. RPD) puede ser creado y modificar utilizando la Herramienta de administración
de OBI, que sólo está disponible para sistemas operativos Windows.

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 5

 ADEPTA S.A. 2010

3. – Pre-configuració n en Linux

a) Crear directorio de instalación.

Antes de comenzar a instalar Oracle BI:
1.- Crear el directorio de instalación.
Por defecto son "/usr/local/OracleBI" y "/usr/local/OracleBIData"
NOTA: para crear directorios, necesitas permisos de escritura.

TempPanelBean.Destination="OracleBI"
TempPanelBean.TempDir="OracleBIData"

2.- Crear el ID de Usuario:

Cambia el ID Usuario para poder correr los procesos de Oracle Business Intelligence.
PRECAUCION: No se puede instalar Oracle Business Intelligence como usuario root.

3.- Asignar permisos a carpetas:

a) /usr (carpeta para instalar)
b) /tmp (carpeta que debe eliminar los datos temporales)
c) /usr/local (directorios "/usr/local/OracleBI" y "/usr/local/OracleBIData")
d) /usr/local/java

4.- Desinstalar versiones antiguas de Analytics.

Si tiene una versión anterior de la plataforma Siebel Analytics instalada, tiene que desinstalarla
antes de Instalar la infraestructura OBI.
NOTA: El script de instalación crea la configuración de entorno esencial.

5.- Asegúrese de que /dev/random y /dev/urandom están disponibles.

Oracle BI Presentation Services requiere que estos dispositivos pseudo generador de números
aleatorios.

b) Establezca el parámetro identificador del límite para archivos.

Para correr procesos de Oracle BI, el archivo debería tener un límite de al menos 10.240 ó
ilimitado:
- Identificador de archivo límite: al menos 10.240. Ejemplo ulimit -n 10240
- Archivo-descriptor: al menos 10.240
o Para ver la configuración del archivo-descriptor, ejecute el comando “ ulimit-a” o ajuste
el archivo-descriptor con el comando ulimit-n 10240

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 6

 ADEPTA S.A. 2010

c) Checando con el Script UnixChk.sh

Para asegurar que el equipo de instalación cuenta con todos los requisitos necesarios para una
correcta instalación, ejecutar el script de verificación para comprobar los requisitos previos.
El script es ligero y fácil de usar, y comprueba las siguientes condiciones:
1) Sistema operativo compatible
2) Parches y archivos necesarios (si es aplicable)
3) Configuraciones soportadas
4) Adecuado espacio en disco
5) El usuario no es root

El Script UnixChk.sh está instalado en dos lugares:

- El directorio de instalación que contiene setup.sh y setup.jar. Desde aquí, puede ejecutar
UnixChk.sh antes de ejecutar el instalador (es decir, antes de ejecutar setup.sh).
- El directorio OracleBI/configuración/UnixChk.sh. Desde aquí, puede ejecutar
UnixChk.sh después de instalar Oracle BI. Usando:

UnixChk.sh [Oracle_BI_install_dir]

Cuando Oracle_BI_install_dir es el directorio en donde OBI será instalado. Omitir este

argumento si OBI está instalado en el directorio de instalación por defecto
(/usr/local/OracleBI)
Ejemplo 1
$ ./UnixChk.sh
CHECK FAILED - ulimit -n should be at least 10240 or unlimited
FAILURE!! - This machine is NOT configured for Oracle BI 10.1.3.2.1

Ejemplo 2
$ ./UnixChk.sh
SUCCESS!! - This machine is configured for Oracle BI 10.1.3.2.1

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 7

 ADEPTA S.A. 2010

4.- Instalació n

a) Modo Gráfico

Para inicializar la instalación en modo Gráfico, es necesario ingresar el siguiente comando:

“./setup.sh”

1. Correr ./setup.sh desde RH_Linux/server/Oracle_Business_Intelligence

2. Esto abre la pantalla de X-Window para el instalador OBIEE.

3. Después de algunos pasos (aceptar por defecto) escriba los siguientes 2 directorios para
OracleBI y OracleBIData.

4. Instalación OBIEE Linux (Imagen 1)

5. Acepta por defecto presionar Siguiente (Next)

6. Ingresar jdk home path /usr/lib/java/jdk_1_5_0_17

7. Ingresar contraseña para oc4jadmin (oc4jadmin)

8. Escoger el idioma y aceptar los componentes por defecto para Server OBIEE.

9. Esto instalará los componentes del cliente/servidor OBIEE y muestra la aplicación OBIEE
samplesales repositorio/web catálogos bajo /usr/local/ [OracleBI|
OracleBIData] respectivamente (puede tardar de 10 a 20 minutos en instalar)

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 8

 ADEPTA S.A. 2010

10. Instalación OBIEE Linux (Imagen 2)

11. Instalación OBIEE Linux (Imagen 3)

12. Una vez terminado, Editar el user.sh en /usr/local/OracleBI/setup

13. Eliminar comentarios de los parámetros bajo Linux.

14. Revisar si el ORACLE_HOME está bien configurado

/u01/opt/oracle/product/10.2.0/db_1

15. TNS_ADMIN, PATH, LD_LIBRARY_PATH se necesita descomentar desde el Script

16. Iniciar el Oracle BI Presentation Services digitando ./run-saw.sh start

17. iniciar el Oracle BI Server Services digitando ./run-sa.sh start

18. El servicio OC4J es requerido para acceder al OBIEE fuera de la web. Durante la instalación el
servicio es iniciado por defecto.

19. OC4J puede ser reiniciado ejecutando /usr/local/OracleBI/setup/oc4j –start. La

primera vez el oc4jadmin debe ser digitado la contraseña.

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 9

 ADEPTA S.A. 2010

20. OC4j puede ser detenido ejecutando /usr/local/OracleBI/setup/oc4j –stop –port

9704 –password <oc4jadmin>

21. Verificar la instalación OBIEE autenticándose dentro de la base de datos sample sales
dashboard iniciando sesión en http://<Linux Host Name>:9704/analytics/saw.dll?Dashboard
con contraseña (Administrator/Administrator)

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 10

 ADEPTA S.A. 2010

b) Modo Consola

Para inicializar la instalación en modo Consola, es necesario ingresar el siguiente comando:

“./setup.sh –console”

InstallShield Wizard
Inicializando InstallShield Wizard...
Preparando la Java(tm) Virtual Machine...
-------------------------------------------------------------------------------
Please read the information below.
IMPORTANT!!! The complete installed Oracle BI EE suite requires at least 2.5 GB of free disk space.
At least 200 MB of free disk space in the /tmp and /var/tmp directories is required for installing Oracle BI EE.
Press 1 for Next, 3 to Cancel or 4 to Redisplay [1]
-------------------------------------------------------------------------------
Oracle Business Intelligence Installation
Welcome. Oracle Business Intelligence will be installed.
Browse or Enter the Installation Location: [/usr/local/OracleBI] (Directorio de Instalación ORACLE_BI_HOME)
Browse or Enter the Data Location: [/usr/local/OracleBIData] (Directorio de la DATA de Oracle_BI)
Select the Installation Type:
[X] 1 - Basic: Minimum security. Installs Oracle Containers for J2EE (OC4J). (Instalación básica, ya que la avanzada es
para instalar productos independientes, requieren tener pre-instalado el OBI server en la maquina)
[ ] 2 - Advanced: Enhanced security. Requires Oracle Application Server 10.1.3.1.0 or greater.
To select an item enter its number, or 0 when you are finished: [0]
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
-------------------------------------------------------------------------------
Choose the setup type that best suits your needs.
[X] 1 - Complete
All Oracle Business Intelligence components will be installed. (corresponde a la Instalación completa)
[ ] 2 - Oracle Business Intelligence Server
Only server components will be installed. (Includes Oracle Business Intelligence Server, Cluster Controller,
Scheduler, Systems Management.)
[ ] 3 - Oracle Business Intelligence Presentation Services
Only presentation services components will be installed. (Includes Oracle Business Intelligence Presentation
Services, Presentation Services Plug-in, BI Office, Systems Management.)
[ ] 4 - Oracle Business Intelligence Client Tools
Only client components will be installed. (Includes Oracle Business Intelligence Client Tools.)
[ ] 5 - Oracle Business Intelligence Publisher
Oracle Business Intelligence Publisher will be installed.
[ ] 6 - Custom
The program will be installed with the features you choose. Recommended for advanced users.

To select an item enter its number, or 0 when you are finished: [0]
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
-------------------------------------------------------------------------------
Java Development Kit (JDK) Location
Java Development Kit 1.5.0 or greater is required.

Browse or Enter the JDK Location (JAVA_HOME): [/usr/local/jdk] /usr/local/Java/jdk (Directorio de Instalación de la
Maquina Virtual de Java, incluido el JDK)

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 11

 ADEPTA S.A. 2010

Set the password for the oc4jadmin administrator user. This password should be used for any OC4J operations post-
install. Remember the password because it cannot be reset and will be used for uninstallation.

Administrator username:
oc4jadmin

Administrator password: <ingresar contraseña administrador>

Confirm password: <ingresar contraseña administrador>

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

-------------------------------------------------------------------------------

Error Message Language Selection (este error se debe por el idioma default es inglés, solo hay que cambiar el idioma.
Referencia: “Oracle Business Intelligence Infrastructure Installation and Configuration Guide Version 10.1.3.2.1” Tabla 7
pagina 60, documento referenciado al final de este manual)

A chosen component requires the selection of a language for presentation of error messages. Please select one of the
following languages:

[X] 8 - English

To select an item enter its number or 0 when you are finished: [0] 25 (corresponde al idioma español)

[ ] 1 - Arabic
[ ] 2 - Chinese (Simplified)
[ ] 3 - Chinese (Traditional)
[ ] 4 - Croatian
[ ] 5 - Czech
[ ] 6 - Danish
[ ] 7 - Dutch
[ ] 8 - English
[ ] 9 - Finnish
[ ] 10 - French
[ ] 11 - German
[ ] 12 - Greek
[ ] 13 - Hebrew
[ ] 14 - Hungarian
[ ] 15 - Italian
[ ] 16 - Japanese
[ ] 17 - Korean
[ ] 18 - Norwegian
[ ] 19 - Polish
[ ] 20 - Portuguese (Brazilian)
[ ] 21 - Portuguese (European)
[ ] 22 - Romanian
[ ] 23 - Russian
[ ] 24 - Slovak
[X] 25 - Spanish
[ ] 26 - Swedish
[ ] 27 - Thai
[ ] 28 - Turkish

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 12

 ADEPTA S.A. 2010

To select an item enter its number, or 0 when you are finished: [0]
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
Please wait...
-------------------------------------------------------------------------------
Oracle Business Intelligence 10.1.3.4.1 will be installed in the following location:
/usr/local/OracleBI with the following features:
Oracle Business Intelligence JDBC Driver
Oracle Business Intelligence Systems Management
Oracle Business Intelligence Server
Oracle Business Intelligence Cluster Controller
Oracle Business Intelligence Scheduler
Oracle Business Intelligence Client
Oracle Business Intelligence Presentation Services
Oracle Business Intelligence Presentation Services Plug-in and BI Office
Oracle Business Intelligence Publisher
For a total size: 2626.9 MB
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
Installing $L(com.siebel.analytics.install.AnyStringConstants,InstallConfig.ProductName)
$P(SiebelAnalyticsProductBean.productNumber). Please wait...
|-----------|-----------|-----------|------------|
0% 25% 50% 75% 100%
||||||||||||||||||||||||||||||||||||||||||||||||||
Installing Oracle Business Intelligence 10.1.3.4.1. Please wait...
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Creating uninstaller...
Please wait...
-------------------------------------------------------------------------------
The InstallShield Wizard has successfully installed Oracle Business Intelligence 10.1.3.4.1. Choose Next to continue the
wizard.
Press 1 for Next, 3 to Cancel or 4 to Redisplay [1] 1
-------------------------------------------------------------------------------
Oracle Business Intelligence Installation Summary

The installation of Oracle Business Intelligence Enterprise Edition 10g (10.1.3.4.1) was successful.
Access the Welcome Page at /usr/local/OracleBI/index_bi_ee.html (Página de Inicio Oracle BI)

Oracle Containers for J2EE (OC4J) is automatically started at the end of installation.
OC4J can be manually started by running the command:
/usr/local/OracleBI/setup/oc4j –start (Por defecto en la instalación quedan todos los servicios corriendo)

Press 1 for Next, 3 to Finish or 4 to Redisplay [1]

Finaliza la instalación

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 13

 ADEPTA S.A. 2010

5.- Tareas de Post-Instalació n

a) Asignación de memoria para OC4J.

Asigne suficiente memoria en Oracle Containers for Java (OC4J) para ejecutar Oracle BI
Publisher. Para asignar memoria adicional para OC4J:
* Detenga OC4J, utilizando el comando Stop OC4J: “ OracleBI_HOME/oc4j_bi/bin/”
-shutdown -port <ORMI port> -password <password>: stop OC4J

Diríjase a OracleBI_HOME/oc4j_bi/bin.
 Edite el archivo oc4j.cmd para iniciar OC4J con mas memoria.
Asignar un mínimo de 256 MB de memoria mediante el aumento de la memoria permanente
para la generación de 128m, además de regular el tamaño del montón.
 Busque la siguiente línea:
set JVMARGS=-Djava.library.path=\OracleBI\server\Bin;\OracleBI\web\bin
-DSAROOTDIR=\OracleBI -DSADATADIR=\OracleBIData %OC4J_JVM_ARGS%
 En esta línea, entre las variables -DSADATADIR=\OracleBIData y %OC4J_JVM_ARGS%, agregue el siguiente
texto:
-XX:MaxPermSize=128m -Xmx512m
 Grabar oc4j.cmd.

b) Iniciando Oracle BI.

En Linux, no es necesario proceso de inicialización. Inicie los servidores mediante la ejecución de

los scripts de Shell que figuran en Korn, Bourne o Bash Shells. El directorio es
OracleBI_HOME/setup y el orden en que los servicios se detienen y reinician es importante.
Use la siguiente secuencia:

 Oracle Business Intelligence Server service. (run-sa.sh)

 Oracle Business Intelligence Presentation Services service. (run-saw.sh)
 Oracle Business Intelligence Scheduler Server service. (run-sch.sh)
 Oracle Business intelligence Cluster Controller service (run-ccs.sh)

Testeando el Oracle BI Server

Por defecto, el Oracle BI Server se inicia automáticamente cuando la máquina en que está
instalada se reinicia. Si ha seleccionado el tipo de inicio manual durante la instalación, el siguiente
procedimiento probará su instalación del servidor Oracle BI.
Inicie el Oracle BI Server desde el OracleBI_HOME/<directorio de instalación>, ejemplo:
/usr/local/OracleBI/setup, ejecutando el siguiente comando:

./run-sa.sh start

Testeando el Cliente de Oracle BI

Para probar el cliente de Oracle BI:

 Correr el Cliente de Oracle BI abriendo otra sesión (otra sesión de usuario)

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 14

 ADEPTA S.A. 2010

 Desde el directorio de Instalación OracleBI_HOME/setup, correr el comando:

./sa-cli.sh

Para probar la conectividad del cliente/servidor, ejecutar el comando:

nqcmd

 Si el test es exitoso, presione la tecla Enter varias veces para quitar el “nqcmd”.
 Si el test no es exitoso, verifique que todos los clientes estén desconectados del Oracle Business
Intelligence Server, y enseguida detenga el servidor ejecutando el siguiente comando:

./run-sa.sh stop

c) Configurar el cliente de Oracle de base de datos.

a) Crear 3 variables de entorno para encontrar su cliente de Oracle DB en servidor Linux. (editar user.sh)
b) export ORACLE_HOME=/opt/app/oracle/product/10.2.0.3
c) export TNS_ADMIN=/var/opt/oracle
d) export LD_LIBRARY_PATH=$ORACLE_HOME/lib32:$LD_LIBRARY_PATH

e) La guía de Instalación del OBIEE sugiere colocarlos en el Script

f) ./OracleBI/setup/user.sh

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 15

 ADEPTA S.A. 2010

6.- Referencias – Documentació n

Oracle Business Intelligence Infrastructure Installation and Configuration Guide

(http://download.oracle.com/docs/cd/E10415_01/doc/bi.1013/b31765.pdf)

Manual de Instalació n Oracle Business Intelligence Enterprise Edition (OBIEE) Pá gina 16