Page Comparison

...

La versión 5 de O3 incluye un Wizard de Configuración y Migración que facilita la tarea de pasaje de versiones 4.3

...

a la versión 5.
Este Wizard consta básicamente de 3 pasos independientes que podrán configurarse de acuerdo a las necesidades o caracteríasticas de la instalación.

• Paso 1: Configuración de la Base de Datos
• Paso 2: Migración de los datos de la versión anterior
• Paso 3: Habilitación de la Base de Datos de Datamarts

Consideraciones previas a la migración

• Revisar La migración asume el correcto funcionamiento de la instalación anterior
• Revisar si hay espacio suficiente en el disco para la nueva instalación, así como para los datamarts que ella contendrá una vez migrados

Comienzo de la migración

La migración requiere la ejecución de los siguientes pasos previos:

1. Bajar el Servidor (jboss) y todos los módulos de O3 que estén en ejecución.
   Es importante que no se vuelva a levantar niguno de los 2 jboss hasta que se indique

...

2. Renombrar la carpeta de instalación (ej: renombrar ...\O3 a ...\O3_old) y luego instalar en el mismo lugar (ej: es decir en

...

1. <ruta a O3>\O3 )
2. Copiar la carpeta entera <ruta a O3>jboss\

...

1. server\default\ideasoft-o3\server a la nueva instalación en el mismo lugar
2. Instalar las licencias y activarlas (ver guia de activación de licencias)

...

Si tengo licencia enterprise y quiero cambiar el O3Server.cfg por Base de datos

...

2. Iniciar el O3 Server Administrator de la versión recién instalada.
3. Desde el menú Herramientas seleccionar la opción Wizard de Configuración y Migración...
   Esta operación desplegará el Wizard para ejecutar los 3 pasos mencionados anteriormente

Paso 1. Configuración de la Base de Datos

Este paso permite configurar la base de datos del O3 Server.
En esta base de datos se almacenan los usuarios, los roles y los esquemas de seguridad, así como la referencia a los datamarts publicados en el servidor.

La elección de la base de datos dependerá de cada instalación.

O3 distribuye por defecto una instancia de la base de datos Hypersonic que puede ser utilizada con tal propósito.

Si fuera necesario este paso permite indicar una base de datos diferente donde realizar la migración.

A continuación se detallan los pasos necesarios para configurar una base de datos diferente a la distribuida con O3. A los efectos de ejemplificar se detallan los parámetros para una base de datos PostgreSQL.

1. En el manejador de base de datos de nuestra preferencia

...

1. crear una base de datos vacía y un usuario con permisos suficientes para crear tablas en ella.

...

1. Seleccionar la opción de Usar una base de datos distinta a la incluida en O3

...

1. Ingresar los datos

...

1. específicos para la base de datos escogida.

   Parámetro	Descripción
   Motor	Identificador del Motor de Base de datos a utilizar. Debe seleccionarse un manejador de la lista desplegable. La selección de este campo carga el resto con valores por defecto que deberán modificarse
   Manejador	Nombre del Driver JDBC que se utiliza para conectarse a la base de datos.
   URL	URL de conexión a la base de datos. Típicamente identifica la IP o nombre del servidor, puerto y parámetros adicionales. Cada driver JDBC tendrá una URL propia que podrá consultarse en la documentación del driver
   Usuario	Usuario de la base de datos con el que se conectará el Servidor de O3
   Contraseña	Contraseña del usuario indicado en el campo anterior

   
   

   Note
   title Atención
   Como paso previo se debe de

...

1. instalar el driver JDBC adecuado en la carpeta <o3>/classes/jdbc/ y en <o3>/jboss/server/default/lib para poder acceder a la base de datos.

   
   Image Modified
   

...

1. Verificar la conexión con el botón Testear Conexión
2. Presionar el botón Siguiente
3. Confirmar el diálogo que pregunta si se deben crear las tablas necesarias

...

Paso 2

...

Image Removed

• Seleccionamos migrar desde una 4.X y le damos la ubicación de la vieja instalación de O3
• Y nos contesta diciéndonos que versión encontró y que tipo de base de datos tenía.
• Revisamos que estén chequeados los 2 chekbox y apretmos siguiente
• Paso 3 del Wizard Configuración y Migración.

Si no tengo licencia enterprise o la tengo pero no quiero pasarme a Base de datos

• Copiar el archivo \jboss\server\default\ideasoft-o3\O3Server.cfg a la nueva instalación en el mismo lugar

...

. Migración de los datos de la versión anterior

Este paso permite indicar dónde se encuentra instalada la versión anterior (4.3) de O3 de la que se tomará la configuración, así como los datamarts que contenga.

1. Seleccionar la opción Migración desde versión 4.x.
2. Indicar la ruta a la instalación anterior de O3.
   Esta ruta deberá apuntar a la carpeta de instalación.
3. Una vez indicada la ruta se despliega información acerca de la instalación, típicamente datos sobre la base de datos que la versión anterior utilizaba.
   

   Note
   title Atención
   Si no se despliega información acerca de la instalación anterior es posible que se haya ingresado una ruta incorrecta que no apunte a la raiz de instalación o que se trate de una versión incorrecta de O3 de la cual no se pueda migrar.

   
   Image Added
4. Verificar que se encuentran activos los checkbox que permiten copiar los recursos de la instalación anterior y la configuración de usuarios y roles
5. Presionar el botón Siguiente para que se realice la migración de los datos

Paso 3. Habilitación de la Base de Datos de Datamarts

Este paso permite habilitar o no el uso de la base de datos como repositorio para la configuración de los datamarts publicados en el Servidor de O3.

1. Seleccionar la opción de Habilitar o no el uso de la base de datos
   Image Added
2. Presionar el botón Finalizar para confirmar la selección y finalizar la migración
   

Otras consideraciones

Las siguientes consideraciones podrán aplicarse o no dependiendo de cada instalación.

Nombre de la máquina para accesos WEB

1. Revisar el archivo de la instalación anterior
   /jboss/server/default/deploy/gserver/ ******-ds.xml*Si los usuarios se obtienen de un LDAP entonces copiar /0o3.ear/o3portal.war/WEB-INF/wabapp.properties
2. En particular verificar el valor de la property
   gclient.server.host
3. Si tuviera un valor diferente a localhost, dicho valor deberá ser asignado también en la nueva instalación

Uso de LDAP

O3 puede ser integrado con un servidor LDAP donde almacenar la configuración de usuarios y roles.

Si la versión anterior hubiera sido personalizada para conectarse con un servidor de estas características se deben ejecutar los siguientes pasos:

1. Copiar el xml correspondiente de la carpeta jboss\server\default\ideasoft-o3\config\rbac y modificar de la instalación anterior a la nueva instalación
2. Modificar el archivo jboss\server\default\ideasoft-o3\GServer.properties según se indica en la guía de configuración de LDAP
3. (Sólo en versiones 4.X, las licencias de las versiones 5.X no son compatibles con las de versiones anteriores) Copiar la carpeta /license, verificar que en /jboss/server/default/ideasoft-o3/license no exista alguna licencia, si la hay revisarla y pasarla a la carpeta <O3>/license de la nueva instalación
4. Revisar el archivo /jboss/server/default/deploy/gserver/0o3.ear/o3portal.war/WEB-INF/wabapp.properties en la instalación vieja, ver si la property gclient.server.host = localhost o tiene otro valor, si así fuera en la nueva instalación cambiarlo al valor de la vieja
Revisar en la instalación vieja si

Uso de puertos personalizados en JBoss

1. Revisar en la instalación anterior si hay cambio de puertos.
   Para ello vamos a se debe verificar el archivo /jboss/server/default/conf y miramos en el archivo /jboss-service.xml si está
2. Si tuviera descomentado el siguiente código .
   Si estuviera descomentado, significa que se modificaron los puertos por defecto. Debemos entonces descomentarlo también en el archivo nuevo (el de la nueva instalación) y copiar el archivo .xml al que se hace referencia en <attribute name="StoreURL"...>  Revisar la guía de modificación de puertos de JBoss para obtener más detalles sobre este punto. codehan modificados.

   Code Block
   xml xml
   <mbean code="org.jboss.services.binding.ServiceBindingManager" name="jboss.system:service=ServiceBindingManager"> <attribute name="ServerName">ports-01</attribute> <attribute name="StoreURL">${jboss.server.home.url}/port-bindings.xml</attribute> <attribute name="StoreFactoryClassName">org.jboss.services.binding.XMLServicesStoreFactory</attribute> </mbean>

3. En tal caso deberá replicarse el mismo cambio en la nueva versión, así como copiar el archivo .xml al que se hace referencia en <attribute name="StoreURL"...>
   Revisar la guía de modificación de puertos de JBoss para obtener más detalles sobre este punto.
4. Revisar si se cambió el puerto del tomcat, abriendo
   Revisar el archivo jboss/server/default/deploy/jbossweb-tomcat55.sar/server.xml y buscando el código.
   El puerto por defecto es el 8080. Si hubiera otro definido se debe modificar también en la nueva instalación.
   Buscar el código

   Code Block
   <Connector port="8080" address="${jboss.bind.address}">

   El puerto por defecto es el 8080. Si hubiera otro definido se debe modificar también en la nueva instalación.

Uso de Drivers JDBC adicionales

1. Revisar los drivers de conexión a bases de datos en /classes/jdbc y en /jboss/server/default/lib y pasar a la nueva instalación los que sean necesarios

Configuración del Mailer

1. Revisar configuración del mail. Copiar el archivo jboss\server\default\deploy\mail-service.xml a la nueva instalación en el mismo lugar
2. Levanar el Jboss

Consideraciones finales

...

Verificando la nueva instalación

1. Iniciar el Servidor de O3 (JBoss) 
2. Ingresar al O3 Server Administrator y loguarse con un el usuario administrador.
3. Verificar la publicación de cubos,
   Esto implica que esta están presentes y disponibles, y que los perfiles se asociados se leyeron sin problemas
4. Verificar que los usuarios, roles, permisos son los correctos
5. Abrir el portal y loguarse, cargar cubos, tableros, escritorios, dashboards, etc. según corresponda
6. Levantar el browser y cargar algún cubo
7. Construir con el builder algún cubo para comprobar que el ambiente de construccion no se alteró