...
Guia de migración de una versión 4.
...
3.x
...
a 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ónBajar 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
Comienzo de la migración
- Bajar el jboss y todos los módulos de O3 que estén en ejecución
...
| Code Block |
|---|
profileMigrator.sh
|
...
| Code Block |
|---|
profileMigrator.bat
|
...
| Code Block |
|---|
cubeMigrator.sh
|
...
| Code Block |
|---|
cubeMigrator.bat
|
...
- Es importante que no se vuelva a levantar niguno de los 2 jboss hasta que se indique.
- Renombrar la carpeta de instalación (ej: renombrar ...\O3 a ...\O3_old) y luego instalar en el mismo lugar (ej
...
- : es decir en
...
- path_al_o3\O3 )
- Copiar la carpeta entera \jboss\server\default\ideasoft-o3\server a la nueva instalación en el mismo lugar
- Instalar las licencias y activarlas (ver guia de activación de licencias)
Si tengo licencia enterprise y quiero cambiar el O3Server.cfg por Base de datos
- En el manejador de base de datos de nuestra preferencia creamos un base de datos vacía y un usuario con permisos suficientes para crear tablas en ella.
- Levantar el admserver e ir a Herramientas->Wizard de Configuración y Migración.
- Optamos por usar base distinta a la incluida en O3
- Completamos los datos, en la imagen un ej para una base en Postgres de nombre O3 y con un usuario de nombre postgres. En el combo hay posibilidad para los manejadores más comunes.
Note title Atención se debe de colacar el driver adecuado en <o3>/classes/jdbc/ y en <o3>/jboss/server/default/lib para poder acceder a la base de datos.
Si no tengo licencia enterprise o la tengo pero no quiero pasarme a Base de datos
- Copiar el archivo \jboss\server\default\ideasoft-o3\O3Server.cfg a la nueva instalación en el mismo lugar
...
- 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.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> - 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}"> - 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
...