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

Como migrar de una versión 6.x a otra 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

Bajar los servicios.
Renombrar la carpeta IdeaSoft/O3 a IdeaSoft/O3v6.x.x
Copiar de la instalación vieja el directorio <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/standalone/deployments/O3Server-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>/O3Server.cfg
Copiar el datasource que está en <o3>/jboss/standalone/deployments/O3Server-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>/O3Server.cfg
Copiar de la instalación vieja el archivo <o3>/jboss/standalone/data/derby
Copiar de la instalación vieja el archivo <o3>/jboss/standalone/data/exist

Si se usa eportal

Copiar de la instalación vieja el contenido de la carpeta <o3>/liferay/document_library
Copiar de la instalación vieja el contenido de la carpeta <o3>/liferay/jackrabbit
Copiar de la instalación vieja el contenido de la carpeta <o3>/liferay/lucene
Copiar de la instalación vieja el contenido de la carpeta <o3>/liferay/data/image

Si además se usa eportal con hypersonic (default de O3 cuando instalamos)

Copiar de la instalación vieja el archivo <o3>/liferay/data/hsql/lportal.script

Si se usa eportal con base de datos

Copiar de la instalación vieja el archivo <o3>/liferay/tomcat/webapps/eportal/WEB-INF/classes/portal-ext.properties

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

Si se usa Sistema de Información Geográfico (SIG- Geoserver)

Copiar de la instalación vieja la carpeta <o3>/liferay/tomcat/webapps/geoserver
Así mismo copiar los archivos *Mapping.xml y *.plugins, asociados.

Nombre de la máquina para accesos WEB

Revisar el archivo de la instalación anterior
<o3>/jboss/standalone/deployments/o3-server.ear/o3web.war/WEB-INF/webapp.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 <o3>/config/rbac de la instalación anterior a la nueva instalación.
Modificar el archivo <o3>/O3Server.properties según se indica en la guía de configuración de LDAP (HowTo Seguridad de O3 en LDAP y Active Directory)

Uso de puertos personalizados en JBoss

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

Revisar los drivers de conexión a bases de datos en /classes/jdbc y pasar a la nueva instalación los que sean necesarios.
Para el uso de drivers adicionales en O3 Report, ir a la siguiente documentación

Configuración del Mailer

Revisar configuración del mail en el archivo <O3>/O3Server_custom.properties 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

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