Page Comparison

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

...

Procedimiento de migración

1. Bajar los servicios.
   1. Respaldar bases de datos (solo sí la configuración de o3 y eportal se encuentra en base de datos).
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. HowTo Configurar JBoss 7 con Diferentes Bases de Datos 
2. Definir usuario internal (usr: internal / pass: internal) en el admserver. El nuevo usuario deberá estar asociado al rol System y tener definido cómo atributo runAsEnabled de tipo Boolean.

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. HowTo Configurar JBoss 7 con Diferentes Bases de Datos
3. Definir usuario internal (usr: internal / pass: internal) en el admserver. El nuevo usuario deberá estar asociado al rol System y tener definido cómo atributo runAsEnabled de tipo Boolean.

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

...

Si se usa eportal

1. Copiar Renombrar <o3>/liferay/data/document_library como #document_library y copiar de la instalación vieja el contenido de la la carpeta <o3>/liferay/data/document_library
2. Renombrar <o3>/liferay/data/jackrabbit como #jackrabbit y copiar de la instalación vieja la carpeta <o3>/jboss/server/default/data/liferay en <o3>/liferayliferay/data/jackrabbit
3. Renombrar <o3>/liferay/data/lucene como #lucene y copiar de la instalación vieja la carpeta <o3>/liferay/data/lucene

Si además se usa eportal con hypersonic

1. Renombrar el archivo <o3>/liferay/data/hsql/lportal.script como #lportal.script
2. Copiar de la instalación vieja el archivo <o3>/jboss/server/default/data/hypersonic/lportal.script en <o3>/liferay/data/hsql
3. En la nueva instalación versión 6, editar el archivo <o3>/liferay/tomcat/webapps/eportal/WEB-INF/classes/portal-ext.properties
   1. Cambiar el valor (6) de la property: permissions.user.check.algorithm por 2 (permissions.user.check.algorithm=2).
   2. Descomentar la property: #image.hook.impl=com.liferay.portal.image.DatabaseHook quitando el numeral (image.hook.impl=com.liferay.portal.image.DatabaseHook).

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. En la nueva instalación versión 6, editar el archivo <o3>/liferay/tomcat/webapps/eportal/WEB-INF/classes/portal-ext.properties
   1. Cambiar el valor (6) de la property: permissions.user.check.algorithm por 2 (permissions.user.check.algorithm=2).
   2. Descomentar la property: #image.hook.impl=com.liferay.portal.image.DatabaseHook quitando el numeral (image.hook.impl=com.liferay.portal.image.DatabaseHook).
3. HowTo Configurar Liferay con Diferentes Bases de Datos

Otras consideraciones

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

...

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.

   Code Block
   xml xml
   <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.:

    

   HowTo Cambiar Juego de Puertos en Servidor de puertos del Servidor O3 (JBoss y Liferay)

   Para el caso de liferay, debemos editar el archivo <o3>/liferay/tomcat/conf/server.xml y modificar los valores para los puertos 8305, 8380, 8309.

    

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

   Code Block
   <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.

    

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

   
   

...

Verificando la nueva instalación

1. Setear la property sync.data.scheduler.runAtStartup definida en <o3>/O3Server.properties con el valor true.
2. Iniciar el Servidor de O3 (JBoss)  y Liferay.
3. Ingresar al O3 Server Administrator y loguarse con el usuario administrador.
4. Verificar la publicación de cubos.
   Esto implica que están presentes y disponibles, y que los perfiles asociados se leyeron sin problemas.
5. Verificar que los usuarios, roles, permisos son los correctos.
6. Abrir el portal y loguarseloguearse, cargar cubos, tableros, escritorios, dashboards, etc. según corresponda.
7. Levantar el browser y cargar algún cubo.
8. Construir con el builder algún cubo para comprobar que el ambiente de construccion no se alteróde construcción no se alteró
9. Setear la property sync.data.scheduler.runAtStartup definida en <o3>/O3Server.properties con el valor false.