Migración de O3 5.x a 5.x.x

Owned by pminetti (Unlicensed)
Last updated: 01 Mar, 2013 by sgarrido (Unlicensed)Version comment
3 min read

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

  1. Bajar los 2 jboss
  2. Renombrar la carpeta IdeaSoft/O3 a IdeaSoft/O3v5.x.x
  3. 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

  1. Copiar el datasource que está en <o3>/jboss/server/default/deploy/gserver/gserver-???-ds.xml
  2. Copiar el archivo <o3>\jboss\server\default\ideasoft-o3\GServer_custom.properties

Si se tiene los usuarios en base de datos pero los datos del admserver en archivo

  1. Copiar de la instalación vieja el archivo <o3>/jboss/server/default/ideasoft-o3/O3Server.cfg
  2. Copiar el datasource que está en <o3>/jboss/server/default/deploy/gserver/gserver-???-ds.xml
  3. Copiar el archivo <o3>\jboss\server\default\ideasoft-o3\GServer_custom.properties

Si no se tiene usuarios en base de datos y datos del admserver en archivo, default de O3 cuando instalamos

  1. Copiar de la instalación vieja el archivo <o3>/jboss/server/default/ideasoft-o3/O3Server.cfg
  2. Copiar de la instalación vieja el archivo <o3>/jboss/server/default/data/hypersonic/default.script

Si se usa eportal

  1. Copiar de la instalación vieja el contenido de la carpeta <o3>/jboss/server/default/data/liferay

Si además se usa eportal con hypersonic

  1. Copiar de la instalación vieja el archivo <o3>/jboss/server/default/data/hypersonic/lportal.script

Si se usa eportal con base de datos 

  1. Copiar de la instalación vieja el archivo <o3>/jboss/server/default/deploy/liferay-xxxxxx-ds.xml (siendo xxxx la base de datos)
  2. En la instalación nueva cambiar de nombre el archivo liferay-hsqldb.ds.xml a #liferay-hsqldb.ds.xml

Otras consideraciones

Las siguientes consideraciones podrán aplicarse o no dependiendo de cada instalación.

Si se usa portal

  1. 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 Sistema de Información Geográfico (SIG- Geoserver)

  1. Copiar de la instalación vieja la carpeta <o3>/jboss/server/default/deploy/gserver/geoserver.war
  2. Así mismo copiar los archivos *Mapping.xml y *.plugins, asociados.

Nombre de la máquina para accesos WEB

  1. Revisar el archivo de la instalación anterior
    /jboss/server/default/deploy/gserver/0o3.ear/o3portal.war/WEB-INF/webapp.properties
  2. En particular verificar el valor de la property
    gclient.server.host
  3. 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:

  1. Copiar el xml correspondiente de la carpeta jboss\server\default\ideasoft-o3\config\rbac de la instalación anterior a la nueva instalación
  2. 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

  1. 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

  2. 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>
  3. 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.

  4. 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ódigo

    <Connector port="8080" address="${jboss.bind.address}">

    El puerto por defecto es el 8080. Si hubiera otro definido se debe modificar también en la nueva instalación.
    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

  1. 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
  2. Para el uso de drivers adicionales en O3 Report, ir a la siguiente documentación

Configuración del Mailer

  1. 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

  1. Iniciar el Servidor de O3 (JBoss) 
  2. Ingresar al O3 Server Administrator y loguarse con el usuario administrador.
  3. Verificar la publicación de cubos
    Esto implica que están presentes y disponibles, y que los perfiles asociados se leyeron sin problemas
  4. Verificar que los usuarios, roles, permisos son los correctos
  5. Abrir el portal y loguarse, cargar cubos, tableros, escritorios, dashboards, etc. según corresponda
  6. Levantar el browser y cargar algún cubo
  7. Construir con el builder algún cubo para comprobar que el ambiente de construccion no se alteró