Migración de O3 4.1.x o 4.2.x a 5.x

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

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

Consideraciones previas a la migración

Revisar el correcto funcionamiento de la instalación anterior
Revisar si hay espacio suficiente en el disco para la nueva instalación
Bajar y descompactar en el directorio raíz de O3 de la versión vieja este archivo
CUIDADO!

Verificar que se descompacto en la versión vieja NO EN LA NUEVA
Si se está migrando de una versión 4.3.XXX a una 5.x.xxx no en necesario la migración de cubos y perfiles
Comienzo de la migración

Bajar el jboss y todos los módulos de O3 que estén en ejecución
Ejecutar el migrador de perfiles
En plataformas Linux
```
profileMigrator.sh
```
En plataformas Windows
```
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
Resumen

#####################################################
>>>>> FOUND PROFILES: 15
>>>>> CORRECTLY MIGRATED PROFILES: 15
>>>>> There was no failures !!
#####################################################
Ejecutar el migrador de Cubos
En plataformas Linux
```
cubeMigrator.sh
```
En plataformas Windows
```
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
```
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
```
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
```
cubeMigrator.bat C:\Cubes\Sales.cube C:\NewCubes\Sales.cube
```
Renombrar la carpeta de instalación (ej: renombrar ...\O3 a ...\O3_old) y luego instalar en el mismo lugar (ej cont: es decir en ...\O3 )
Copiar la carpeta entera \jboss\server\default\ideasoft-o3\server a la nueva instalación en el mismo lugar
Copiar el archivo \jboss\server\default\ideasoft-o3\O3Server.cfg a la nueva instalación en el mismo lugar
Si los usuarios utilizados son los internos de O3 copiar la carpeta \jboss\server\default\data\hypersonic en la nueva instalación
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*
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
(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
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 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.
```
<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>
```
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.
```
<Connector port="8080" address="${jboss.bind.address}">
```
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
Revisar configuración del mail. Copiar el archivo jboss\server\default\deploy\mail-service.xml a la nueva instalación en el mismo lugar
Levanar el Jboss

Consideraciones finales

Cargar el admserver y loguarse con un usuario
Verificar la publicación de cubos, que esta presentes y disponibles, y que los perfiles se asociados se leyeron sin problemas
Verificar que los usuarios, roles, permisos son los correctos
Abrir el portal y loguarse, cargar cubos, tableros, escritorios, dashboards, etc. según corresponda
Levantar el browser y cargar algún cubo
Construir con el builder algún cubo para comprobar que el ambiente de construccion no se alteró

Migración de O3 4.1.x o 4.2.x a 5.x

Consideraciones previas a la migración

Comienzo de la migración

Consideraciones finales