Migración de O3 4.3.x a 5.0.x

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 configuración de Datamarts en Base de Datos

Consideraciones previas a la migración

• 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 <ruta a O3>\O3 )
3. Instalar las licencias y activarlas (ver Guía de instalación de Licencias)
4. Iniciar el O3 Server Administrator de la versión recién instalada.
5. 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 crear una base de datos vacía y un usuario con permisos suficientes para crear tablas en ella.
2. Seleccionar la opción de Usar una base de datos distinta a la incluida en O3
3. Ingresar los datos 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

   
   

   Atención

   Como paso previo se debe de 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.

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

Paso 2. 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.
   

   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.

   
   
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 Configuración de Datamarts en Base de Datos

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
   
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/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 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

Uso de puertos personalizados en JBoss

1. Revisar en la instalación anterior si hay cambio de puertos.
   Para ello se debe verificar el archivo /jboss/server/default/conf/jboss-service.xml
2. Si dijera otro valor diferente a ports-default significa que los puertos han sido modificados.

   <mbean code="org.jboss.services.binding.ServiceBindingManager"
              name="jboss.system:service=ServiceBindingManager">
              <attribute name="ServerName">ports-default</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.
   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 en la instalación vieja.
   Revisar el archivo jboss/server/default/deploy/jbossweb-tomcat55.sar/server.xml
   Buscar el código

   <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.
   En la versión 5 este archivo cambio el path siende el nuevo path el siguiente
   <o3>/jboss/server/default/deploy/jboss-web.deployer/server.xml

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.
   Información más detallada de este punto puede encontrarse en HowTo configurar el mailer de JBoss

Verificando la nueva instalación

1. Iniciar el Servidor de O3 (JBoss) 
2. Ingresar al O3 Server Administrator y loguarse con el usuario administrador.
3. Verificar la publicación de cubos
   Esto implica que están presentes y disponibles, y que los perfiles 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ó