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
- 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 script
o
profileMigrator.sh
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.profileMigrator.bat
- Ejecutar el script
o
cubeMigrator.sh
pasándole como parámetro:cubeMigrator.bat
- 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ó