Page Comparison

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

  Warning
  title 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

1. Bajar el jboss y todos los módulos de O3 que estén en ejecución
2. Ejecutar el script

   Code Block
   profileMigrator.sh

   o

   Code Block
   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.
3. Ejecutar el script

   Code Block
   cubeMigrator.sh

   o

   Code Block
   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)
4. 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 )
5. Copiar la carpeta entera \jboss\server\default\ideasoft-o3\server a la nueva instalación en el mismo lugar
6. Copiar el archivo \jboss\server\default\ideasoft-o3\O3Server.cfg a la nueva instalación en el mismo lugar
7. Si los usuarios utilizados son los internos de O3 copiar la carpeta \jboss\server\default\data\hypersonic en la nueva instalación
8. 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*
9. 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
10. (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
11. 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
12. 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>

13. 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}">

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

Consideraciones finales

...

Dependiendo de la versión de O3 que se desea migrar el proceso presenta algunas variantes.
Es importante verificar exactamente cuál es la versión que se desea migrar y seguir las instrucciones de acuerdo al siguiente cuadro.