Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 19 Next »

Como migrar de una versión 5.x.x a 6.x.x

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 servicios.
  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 la raíz de la instalación nueva.

Si se tiene en base de datos la información del admserver y los usuarios

  1. Configurar JBoss 7 con Diferentes Bases de Datos 

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 en la raíz de la nueva instalación.
  2. Configurar JBoss 7 con Diferentes Bases de Datos

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

  1. Realizar exportación desde admserver de o3v5 y la importación en el admserver de o3v6.

Los usuarios no serán exportados y deberán ser creados manualmente.

Solo en caso de tener escritorios, se debe editar cada uno de los archivos .desk que se encuentran en <o3>/server/istore/jdesktop/desktops/ y modificar el puerto 1099 por 4477.

<initParam>otp://localhost:4447/...</initParam>

Si se usa eportal

  1. Copiar de la instalación vieja el contenido de la carpeta <o3>/jboss/server/default/data/liferay en <o3>/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 en <o3>/liferay/data/hsql

Si se usa eportal con base de datos 

  1. Copiar de la instalación vieja los datos de conexión definidos en el archivo <o3>/jboss/server/default/deploy/liferay-xxxxxx-ds.xml (siendo xxxx la base de datos)
  2. Configurar Liferay con Diferentes Bases de Datos

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 en <o3>/jboss/standalone/deployments/o3-server.ear/o3web.war/themes

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 en <o3>/liferay/tomcat/webapps y renombrar la carpeta cómo geoserver (<o3>/liferay/tomcat/webapps/geoserver).
  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 (<o3>/jboss/standalone/deployments/o3-server.ear/o3web.war/WEB-INF/webapp.properties)

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 archivo de properties correspondiente a la configuración de ldap desde la carpeta <o3>\jboss\server\default\ideasoft-o3\config\rbac de la instalación anterior a la nueva instalación (<o3>\config\rbac).
  2. Crear en la nueva instalación el archivo <o3>\O3Server_custom.properties y configurarlo según se indica en la guía de configuración de LDAP (HowTo Seguridad de O3 en LDAP y Active Directory). Se puede considerar la configuración definida en la versión actual (<o3>\jboss\server\default\ideasoft-o3\GServer.properties).

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 cambio en la nueva versión.
    Por ejemplo para cambiar el juego de puertos de jboss a port-01 definimos la property:  Djboss.socket.binding.port-offset con el valor 100 en el archivo bat o sh según la instalación.

    jboss.bat (windows)
    set JAVA_OPTS=%JAVA_OPTS% -Djboss.socket.binding.port-offset=100


    jboss.sh (linux)
    JAVA_OPTS="$JAVA_OPTS -Djboss.socket.binding.port-offset=100"

    Para e caso de liferay, debemos editar el archivo <o3>/liferay/tomcat/conf/server.xml y modificar los valores para los puertos 8305, 8380, 8309 por 8405, 8480, 8409. Luego será necesario cambiar los valores de los puertos en los siguientes archivos de properties: 

    <o3>/O3Server.properties
    http.port=8180

    <o3>/O3Web.properties
    o3.http.upload.port=8180
    urlPrefixRest=http\://localhost\:8180
    urlPrefixTicket=http\://localhost\:8180

    <o3>/Portlets.properties
    o3.http.port=8180

    <o3>/liferay/tomcat/webapps/o3-parts-web/WEB-INF/classes/portlets-config/portlets-config.properties
    urlPrefixLogout=http\://localhost\:8180/o3-rest 
    urlPrefixRest=http\://localhost\:8180 
    urlPrefixTicket=http\://localhost\:8180 
    urlPrefixUploadFiles=http\://localhost\:8180

    <o3>/jboss/standalone/deployments/o3-parts-blaze-web.war/WEB-INF/flex/proxy-config.xml
    remplazar los 8080 por 8180

    <o3>/liferay/tomcat/webapps/o3-parts-web/WEB-INF/flex/proxy-config.xml
    remplazar los 8080 por 8180

    <o3>/config/client/custom-jboss-ejb-client.properties
    remote.connection.default.port = 4547

  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 6 editar el archivo <o3>/jboss/standalone/configuration/o3bi.xml y modificar la siguiente línea, cambiando el valor de port por el valor deseado.

     

    <socket-binding-group name="standard-sockets" default-interface="public">
 <socket-binding name="http" port="8080"/>
 ...
</socket-binding-group>


Uso de Drivers JDBC adicionales

  1. Revisar los drivers de conexión a bases de datos en /classes/jdbc 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 en el archivo jboss\server\default\deploy\mail-service.xml y configurar en la nueva instalación de acuerdo al siguiente wiki: HowTo configurar el Servicio de Mail de JBoss

Verificando la nueva instalación

  1. Iniciar el Servidor de O3 (JBoss)  y Liferay.
  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ó
  • No labels