Page Comparison

La migración de versiones 4.1 o 4.2 a la 5 debe realizarse en 2 etapaspasos.

Etapa Paso 1: Conversión de cubos y perfiles de acceso al nuevo formato
Etapa Paso 2: Migración a la nueva versión

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.
2. Bajar y descompactar en el directorio raíz de O3 de la versión vieja

...

1. el siguiente
   Migrador

   Note
   title

...

1. Advertencia

   Verificar que este migrador se

...

1. extraiga en la versión vieja

...

1. (4.1.x o 4.3

...

1. .x)

Paso 1: Conversión de cubos y perfiles

Comienzo de la migración

...

de acceso al nuevo formato

Este paso permite convertir tanto cubos como perfiles de acceso al nuevo formato utilizado en versiones más nuevas de O3.

La ejecución de este paso realiza respaldos de los archivos que modifica para que sea posible recuperar la instalación anterior en caso que sea necesario.

1. Ejecutar el migrador de perfiles
   En plataformas Linux

   Code Block
   profileMigrator.sh

   
   En plataformas Windows

   Code Block
   profileMigrator.bat

   Este migrador no requiere parámetros adicionales.
   Su ejecución deja los perfiles migrados en la propia instalación de O3 para luego ser tomados por los pasos siguientes.
   Al finalizar el migrador se muestra un resumen de los perfiles migrados

   Tip
   title Resumen
   ##################################################### >>>>> FOUND PROFILES: 15 >>>>> CORRECTLY MIGRATED PROFILES: 15 >>>>> There was no failures !! #####################################################

   
   
2. Ejecutar el migrador de Cubos
   En plataformas Linux

   Code Block
   cubeMigrator.sh

   
   En plataformas Windows

   Code Block
   cubeMigrator.bat

   Este migrador tiene 3 modos de operación dependiendo de los parámetros suministrados
   • Migración de todos los cubos de una carpeta
     En este caso se debe indicar como parámetro el directorio donde se encuentran los cubos

     Code Block
     cubeMigrator.bat C:\Cubes

     Esto migra los cubos dejando los originales con extensión .cube.old
     
   • Migración de un cubo en particular
     En este caso se debe indicar como parámetro la ruta completa al cubo que se desea migrar

     Code Block
     cubeMigrator.bat C:\Cubes\Sales.cube

     Esto migra el cubo indicado dejando el original con extensión .cube.old
     
   • Migración de un cubo en particular indicando la ruta donde quedará migrado
     En este caso se debe indicar como parámetros la ruta al cubo original y al cubo migrado

     Code Block
     cubeMigrator.bat C:\Cubes\Sales.cube C:\NewCubes\Sales.cube

     
     

Paso 2: Migración a la nueva versión

1. Renombrar la carpeta de instalación (ej: renombrar ...\O3 a ...\O3_old) y luego instalar en el mismo lugar (ej cont: es decir en ...<ruta a O3>\O3 )
2. Instalar las licencias y activarlas (ver Guía de instalación de Licencias)
3. Copiar la carpeta entera
   <O3>\jboss\server\default\ideasoft-o3\server a
   sobre la nueva instalación en el mismo lugar
4. Copiar el archivo \jboss\server\default\ideasoft-o3\O3Server.cfg a la nueva instalación en el mismo lugar
5. Si los usuarios utilizados son los internos de O3 copiar la carpeta \jboss\server\default\data\hypersonic en la nueva instalación
6. Si los usuarios están en una base de datos externa entonces copiar los archivos de data source de /jboss/server/default/deploy/gserver/ ******-ds.xml*
7. Si los usuarios se obtienen de un LDAP entonces copiar el xml correspondiente de la carpeta jboss\server\default\ideasoft-o3\config\rbac y modificar jboss\server\default\ideasoft-o3\GServer.properties según se indica en la guía de configuración de LDAP
8. (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
9. 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
10. Revisar en la instalación vieja si hay cambio de puertos. Para ello vamos a /jboss/server/default/conf y miramos en el archivo jboss-service.xml si está 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.

    Code Block
    <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>

11. Revisar si se cambió el puerto del tomcat, abriendo 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.

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

12. 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
13. Revisar configuración del mail. Copiar el archivo jboss\server\default\deploy\mail-service.xml a la nueva instalación en el mismo lugar
14. Levanar el Jboss

Consideraciones finales

1. Cargar el admserver y loguarse con un usuario
2. Verificar la publicación de cubos, que esta presentes y disponibles, y que los perfiles se asociados se leyeron sin problemas
3. Verificar que los usuarios, roles, permisos son los correctos
4. Abrir el portal y loguarse, cargar cubos, tableros, escritorios, dashboards, etc. según corresponda
5. Levantar el browser y cargar algún cubo
6. Construir con el builder algún cubo para comprobar que el ambiente de construccion no se alteróIniciar el O3 Server Administrator de la versión recién instalada.
7. Desde el menú Herramientas seleccionar la opción Wizard de Configuración y Migración...
8. Ejecutar los pasos Paso 1, Paso 2, Paso 3 y Otras Consideraciones del siguiente instructivo