Migración de Versiones de O3

Migrando una versión 4.1.x o 4.2.X a una 4.3.x o 5.x

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

Comienzo de la migración

Bajar el jboss y todos los módulos de O3 que estén en ejecución
Ejecutar el script
```
profileMigrator.sh
```
o
```
profileMigrator.bat
```
según sistema operativo, de forma de convertir los profiles viejos al formato nuevo. Solo hay que ejecutarlo, no se le debe de pasar ningún parámetro.
Ejecutar el script
```
cubeMigrator.sh
```
o
```
cubeMigrator.bat
```
pasándole como parámetro:
- el directorio donde tenemos nuestros cubos
- el directorio donde tenemos nuestros cubos y el directorio donde dejará los nuevos cubos
- el path y nombre de un cubo
- el path y nombre de un cubo y el lugar donde deberá dejar el nuevo cubo
- En todos los casos a los cubos viejos les agrega una terminación .old (ej: demo.cube.old)
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ó