Guía de Instalación del producto O3 BI v6

Introducción

Dependiendo de la plataforma sobre la que se desee instalar el producto se deberá elegir entre los diferentes mecanismos de instalación.

Para plataformas Windows y Linux existen instaladores específicos, mientras que para otras plataformas se debe utilizar el instalador multiplataforma. Sin embargo este instalador multiplataforma también puede usarse para Windows o Linux.

Los pasos para la ejecución en Windows y Linux se detallan a continuación, una vez iniciado el instalador la secuencia de pasos es similar para todas las plataformas.

...

Iniciando el instalador en plataformas Windows

El nombre del instalador para plataformas Windows es es O3BI-vXv6.X.XXX-AAAAMMDDaaaammdd-windows32/64bitswindowsBB.exe.

aaaa = Año mm = mes dd = día BB = 32/64 bits 

1. Insertar el CD DVD con la distribución de O3 en la lectora de CD-ROM y el proceso iniciará automáticamente.
   De no iniciar en forma automática deberá ejecurarse el archivo
   O3BI-vX.X.XXX-AAAAMMDD-windows32/64bits.exe
2. De lo contrario simplemente ejecutar el archivo O3BI-vX.X.XXX-AAAAMMDD-windows32/64bits.exe descargado del sitio de Ideasoft
3. DVD-ROM, si se bajo la versión de internet seguir al siguiente paso.
4. Ejecutar el archivo Correspondiente a su plataforma (32/64bits).

Iniciando el instalador en plataformas Linux

El nombre del instalador para plataformas Linux es O3BI-vX.X.XXX-AAAAMMDD-linux32/64bits.es O3Setup.bin.

1. Ejecutar el archivo archivo O3BI-vXv6.X.XXX-AAAAMMDD-linux32/64bits del CD aaaammdd-linuxBB.sh. del DVD de instalación. o De lo contrario simplemente ejecutar el archivo O3BI-vX.X.XXX-AAAAMMDD-linux32/64bits  descargado del sitio de Ideasoft.

2. Info
   title Nota
   Para otros detalles sobre la instalación sobre Linux referirse a Solución de problemas en Linux

Iniciando el instalador multiplataforma

Para utilizar este procedimiento de instalación es necesario disponer de una Máquina Virtual Java instalada en el sistema (ya sea Java Development Kit - JDK o Java Runtime Environment - JRE, versión 1.5 o superior6).

Para verificar la versión de java instalada en el sistema ejecutar en una línea de comandos

java \-version

Esto despliega algo similar a la información siguiente:

java version "1.56.0_0627"
Java(TM) 2SE Runtime Environment, Standard Edition (build 1.56.0_0627-b05b07)
Java HotSpot(TM) Client64-Bit Server VM (build 1.5.0_06-b0520.2-b06, mixed mode, sharing)

La version  La versión debe de ser mayor o igual a 1.56

Visitar el sitio de SUN para [bajar la JVM|http://java.com/es/download/linux_manual.jsp]

Una vez instalada la Máquina Virtual Java, se deben seguir los siguientes pasos para instalar la versión de Ideasoft O3:

1. Abrir una consola de línea de comando

2. Ejecutar lo siguiente:
   java -jar <CDROM>/Disk1/InstData/Java/O3Setup.jar
   donde <CDROM> es la ruta a la lectora de CD

   Info

   title	Nota

   En el caso de no disponer de ambiente gráfico o que la invocación anterior presentara algún error, se deberá agregar la opción "-i console" a la invocación, lo cual iniciará el instalador sin consola gráfica.
   Ej: java -jar <path>/O3Setup.jar -i console

   ./O3BI-v6.0.000-rc-20111226-linuxmultiplatforma32_64bits.sh

Luego de finalizado el proceso de instalación, deberá realizarse los siguientes ajustes de configuración:

1. Editar el archivo <O3>/sh/settings.sh que se encuentra en el directorio sh de la instalación.

2. Localizar las siguientes líneas

   Code Block
   JVMPATH=$INSTALL_DIR/jre JVM=$JVMPATH/bin/java

3. Realizar los siguientes cambios de modo de comentar estas líneas y agregar la nueva ruta:
   

   Code Block
   #JVMPATH=$INSTALL_DIR/jre #JVM=$JVMPATH/bin/java JVM=<path_a_jvm>/java

    

4. Editar el archivo <O3>/sh/jboss.sh o <O3>/bat/jboss.bat

5. Localizar las siguientes líneas
   

   Code Block
   CLASSPATH=. # Uncomment this line and change the location of the JDK JAVA_HOME="$INSTDIR/../jre"

6. Substituirlas por:

   Code Block
   JAVA_HOME=<path_al_directorio_de _jvm>

   En general este path debe de ser hasta llegar al directorio donde estan entre otras carpetas bin del jvm.
    

7. Finalmente buscar <O3>/jre/lib/Tool.jar y copiarlo en:
   <path_al_directorio_de_jvm>/lib, si no existe crearlo
    

...

Proceso de instalación

...

Como primer paso debemos ejecutar el instalador correspondiente.
El proceso de instalación dará comienzo, mostrando una pantalla con el logo de Ideasoft O3

...

.

...

Image Added

1. Seleccionamos el idioma, continuamos y nos da la bienvenida al asistente de instalación. 
   Para continuar con la instalación se debe presionar el botón siempre debemos seleccionar Siguiente.
   Pantallas similares a la que se describe en este punto se mostrarán durante todo el proceso de instalación.
   En ellas se indicará en el panel de la izquierda la fase de instalación que se esté ejecutando, y en el panel de la derecha las instrucciones a seguir u opciones que deberán ser seleccionadas.En la siguiente fase se desplegará el acuerdo
   de licencia, Debe leerse Image Added
   
   
2. A continuación se muestra el consentimiento de licencia, el cual debemos leer detenidamente y en caso de estar de acuerdo, luego de seleccionar la opción "Yo Acepto los términos del acuerdo de licencia", se debe presionar el botón Siguiente.." y continuar.
   
   Image Added
   
   
3. Una vez aceptados los términos de la licencia de uso , se solicita especificar la ruta de instalación del producto.
   En este paso La guía de la instalación se sugiere una ruta por defecto "C:\Ideasoft\O3" (para el caso de Windows, y ) o /<usuario>/Ideasoft/O3 (para el caso de Linux).
   La misma puede ser modificada en caso de preferir otra ubicación para la instalación del producto.
   Se , teniendo en cuenta que se recomienda no utilizar rutas que contengan caracteres espacios en blanco (espacios).
   Presione el botón Siguiente para pasar a la siguiente fase de la instalación.
4. En la siguiente fase se deben seleccionar los componentes de Ideasoft O3 que se desean instalar.
   Para facilitar el proceso de instalación, se puede seleccionar alguno de los conjuntos de módulos predefinidos que el instalador ofrece. De lo contrario, se deben seleccionar de a uno, todos los módulos que se desean instalar mediante la opción Personalizada
   Las opciones para instalar un conjunto de módulos predefinidos son:
   • Cliente
   • Diseñador
   • Servidor
   • Personalizada
     Para realizar una instalación Personalizada, se deberán elegir los componentes deseados, uno a uno.
5. En la siguiente fase, se establece la ubicación del acceso directo a la aplicación. Automáticamente el instalador selecciona un lugar por defecto.
   Luego de seleccionar la opción deseada, se debe presionar el botón Siguiente.

6. La siguiente fase, se refiere a la instalación de Servicios, debiéndose indicar si se desea que el servidor de aplicaciones JBoss sea instalado como servicio del sistema operativo.
   Esta opción aparece sólo si se seleccionó el JBoss entre la lista de componentes a instalar
   Si se elige instalar el servicio JBoss, es posible indicar la configuración deseada de para el inicio del servicio: Automática o Manual, así como el nombre del mismo.

   Info
   title Nota
   No se recomienda cambiar el nombre del servicio de JBoss a menos que se sepa que conflictúa con otro servicio

7. Como último paso de la configuración de la instalación se muestran las opciones seleccionadas, pudiendo volver atrás para hacer las modificaciones correspondientes.
8. 
   

   Se debe presionar el botón Instalar para iniciar el proceso de instalación.
   Al finalizar, un mensaje informará sobre la instalación exitosa del producto, debiendo presionar el botón Terminadopara cerrar el diálogo del proceso de instalación.

   Note

   title	Instalación y Activación de Licencias

   El paso siguiente a la instalación es el de instalación y activación de licencias. Más información sobre este paso puede encontrarse aquíImage Added
   
   
9. En esta etapa el asistente le sugiere los componentes a ser instalados, nombre de servidor y por último la creación de una carpeta en el menú de inicio "O3 Business Intelligence", donde encapsular los componentes instalados.
   
   Image Added
   
   
10. Una vez finalizados los pasos anteriores, el asistente comienza la instalación propiamente dicha.
    
    Image Added
    
    
11. Una vez finalizada la instalación, el asistente presenta el exito de la operación.
    
    Image Added

Proceso de instalación sin interfaz gráfica

1. Copiar instalador en el servidor y otorgarle permisos de ejecución: chmod +x ./O3BI-v6-linux64bits.sh

2. Ejecutar instalador: ./O3BI-v6-linux64bits.sh 

   
   

   Seleccionamos el idioma:

   Unpacking JRE ...
   Preparing JRE ...
   Starting Installer ...
   Please select a language:
   1: English [Enter]
   2: Spanish
   [1 - 2]

   
   

   Confirmamos la instalación:
   Esto instalará O3 Business Intelligence en su ordenador.
   OK [o, Enter], Cancelar [c]

    

   Aceptamos los términos de la licencia:

   Yo Acepto los términos de licencia.
   Si­ [1], No [2]

    

   Indicamos el directorio de la instalación (por defecto /opt/ideasoft/o3bi):

   ¿Dónde será instalado O3 Business Intelligence?
   [/opt/ideasoft/o3bi]

    

   Seleccionamos el tipo de instalación:
   ¿Qué componentes desea instalar?
   1: Client [*1]
   2: Server
   3: O3Server
   4: Eportal
   (Para mostrar la descripción de un componente, por favor, introduzca uno de *1)
   Please enter a comma-separated list of the selected values or [Enter] for the default selection:
   [1,3,4]

    

   Instalación Server, definimos el nombre o ip del equipo (por defecto localhost):

   Enterprise Portal
   Nombre del servidor
   [localhost]

    

   Crear enlaces simbólicos:
   ¿Crear enlaces simbólicos?
   Si­ [y], No [n, Enter]

    

   Finalizando instalación

Acciones a realizar si su instalación es en ambiente de producción:

• Instalar O3BI como servicio: Windows y Linux.
• Para poder acceder al servidor de O3 desde maquinas clientes utilizando su nombre o direccion IP deberá realizar la siguiente configuración: Cambiar nombre o IP luego de instalar.
• Si los equipos clientes deben acceder al servidor de O3 a través de un Firewall deberá abrir los puertos que se indican en el siguiente link: Configurando O3 a través de un Firewall.
• En caso de necesitarlo Ud. podrá modificar la asignación por defecto de los puertos utilizados tanto para Jboss (puerto: 8080) como para Liferay (puerto: 8380). Para conocer el procedimiento debe hacer click en el siguiente enlace: Cambiar puertos del Servidor O3 (JBoss y Liferay).
   Tenga en cuenta que tanto Jboss como Liferay deben ser previamente ejecutados al menos una vez para luego poder realizar esta configuración.
• Es aconsejable también modificar la asignación de memoria por defecto de los diversos módulos de O3. En el siguiente link se detalla el procedimiento que deberá realizar para tal fin: Memory Management.
• Si necesita configurar un servidor LDAP o Active Directory como soporte para la definición de roles y usuarios puede consultar el siguiente link: Seguridad de O3 en LDAP y Active Directory.
• También se recomienda cambiar la base de datos que utilizan por defecto los módulos de O3 (hsql) para ello dispone de la siguiente guía: Configurar JBoss 7 con Diferentes Bases de Datos.

||Completed||Priority||Locked||CreatedDate||CompletedDate||Assignee||Name||
|F|M|F|1367262098274|          |acampopiano|Instalar la version segun sistema operativo y plataforma|
|F|M|F|1367262112144|          |acampopiano|Instalar la licencia|
|F|M|F|1367262120779|          |acampopiano|Instalar servicios si corresponde|
|F|M|F|1367262132033|          |acampopiano|Modificar los archivos jboss.bat/jboss.sh y liferay.bat/liferay.sh y cambiar los parametros de memoria en ambos archivos(verificar memoria 	  del servidor antes):   Buscar: -Xmx{asignar valor}m y -XX:MaxPermSize={asignar valor}|
|F|M|F|1367262144122|          |acampopiano|Si se esta migrando desde una version anterior a la 6.3.3 verificar el valor de la propiedad sync.data.scheduler.runAtStartup este en true al ejecutarse por primera vez(por el tema de la sincronización), luego este valor deberia de quedar en false.|
|F|M|F|1367262154356|          |lfont|Se deberia de tener una forma correcta de levantar y bajar los servicios(en linux) tal como: jbossservice.sh start\|stop\|restart al igual que en liferay.|
|F|M|F|1367262164157|          |acampopiano|Si en el caso de querer levantar el servicio de liferay(en linux) no levantara, fijarse que en la carpeta sh no exista el archivo tomcat.pid, en este caso deberia de eliminarse con el comando rm.|