Como migrar de una versión 5.x a otra 5.x.x
El proceso se mantiene vigente para las versiones actuales, desde la versión 5 en adelante.
Por el momento no hay un wizard de migración entre este tipo de versiones, por lo cual el procedimiento es manual.
Procedimiento de migración
- Bajar los 2 jboss
- Renombrar la carpeta IdeaSoft/O3 a IdeaSoft/O3v5.0.x
- Copiar de la instalación vieja el directorio <o3>/jboss/server/default/ideasoft-o3/server en el mismo lugar en la instalación nueva
Si se tiene en base de datos la información del admserver y los usuarios
- Copiar el datasource que está en <o3>/jboss/server/default/deploy/gserver/gserver-???-ds.xml
Si se tiene los usuarios en base de datos pero los datos del admserver en archivo
- Copiar de la instalación vieja el archivo <o3>/jboss/server/default/ideasoft-o3/O3Server.cfg
- Copiar el datasource que está en <o3>/jboss/server/default/deploy/gserver/gserver-???-ds.xml
Si no se tiene usuarios en base de datos y datos del admserver en archivo, default de O3 cuando instalamos
- Copiar de la instalación vieja el archivo <o3>/jboss/server/default/ideasoft-o3/O3Server.cfg
- Copiar de la instalación vieja el archivo <o3>/jboss/server/default/data/hypersonic/default.script
Si se usa eportal
- Copiar de la instalación vieja el contenido de la carpeta <o3>/jboss/server/default/data/liferay
Otras consideraciones
Las siguientes consideraciones podrán aplicarse o no dependiendo de cada instalación.
Si se usa portal
- Verificar que se este usando el tema adecuado, si no copiarlo de la instalación vieja en <o3>/jboss/server/default/deploy/gserver/0o3.ear/o3portal.war/themes/mi_tema
Si se usa eportal con hypersonic
- Copiar de la instalación vieja el archivo <o3>/jboss/server/default/data/hypersonic/lportal.script
Nombre de la máquina para accesos WEB
- Revisar el archivo de la instalación anterior
/jboss/server/default/deploy/gserver/0o3.ear/o3portal.war/WEB-INF/wabapp.properties - En particular verificar el valor de la property
gclient.server.host - Si tuviera un valor diferente a localhost, dicho valor deberá ser asignado también en la nueva instalación
Uso de LDAP
O3 puede ser integrado con un servidor LDAP donde almacenar la configuración de usuarios y roles.
Si la versión anterior hubiera sido personalizada para conectarse con un servidor de estas características se deben ejecutar los siguientes pasos:
- Copiar el xml correspondiente de la carpeta jboss\server\default\ideasoft-o3\config\rbac de la instalación anterior a la nueva instalación
- Modificar el archivo jboss\server\default\ideasoft-o3\GServer.properties según se indica en la guía de configuración de LDAP
Uso de puertos personalizados en JBoss
- Revisar en la instalación anterior si hay cambio de puertos.
Para ello se debe verificar el archivo /jboss/server/default/conf/jboss-service.xml - Si dijera otro valor diferente a ports-default significa que los puertos han sido modificados.
<mbean code="org.jboss.services.binding.ServiceBindingManager" name="jboss.system:service=ServiceBindingManager"> <attribute name="ServerName">ports-default</attribute> <attribute name="StoreURL">${jboss.server.home.url}/port-bindings.xml</attribute> <attribute name="StoreFactoryClassName">org.jboss.services.binding.XMLServicesStoreFactory</attribute> </mbean>
- En tal caso deberá replicarse el mismo cambio en la nueva versión.
Revisar la guía de modificación de puertos de JBoss para obtener más detalles sobre este punto. - Revisar si se cambió el puerto del tomcat en la instalación vieja.
Revisar el archivo jboss/server/default/deploy/jbossweb-tomcat55.sar/server.xml
Buscar el códigoEl 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}">
En la versión 5 este archivo cambio el path siende el nuevo path el siguiente
<o3>/jboss/server/default/deploy/jboss-web.deployer/server.xml
Uso de Drivers JDBC adicionales
- 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
Configuración del Mailer
- Revisar configuración del mail. Copiar el archivo jboss\server\default\deploy\mail-service.xml a la nueva instalación en el mismo lugar.
Información más detallada de este punto puede encontrarse en HowTo configurar el mailer de JBoss
Verificando la nueva instalación
- Iniciar el Servidor de O3 (JBoss)
- Ingresar al O3 Server Administrator y loguarse con el usuario administrador.
- Verificar la publicación de cubos
Esto implica que están presentes y disponibles, y que los perfiles 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ó