Page Comparison

Proceso de Migración de v5 a v6 de Proceso de Migración de v5 a v6 de O3

En este wiki se pretende mostrar como migrar un servidor con instalación de O3 versión 5.x.x a la versión más reciente hasta el momento 6.3.25, de la manera más sencilla posible, utilizando el conocimiento acumulado para este tipo de situaciones.

...

•  Instalar la versión de O3 en el servidor, utilizando el procedimiento estandard de instalación. Guía de Instalación de O3 BI v6
•  Instalar la Licencia(utilizar la licencia ya instalada en la carpeta <licences> de la instalación a sustituir. Guía de Instalación de Licencias de O3BI v6
  
•  Instalar los Servicios
  • En Windows How To O3 BI v6 como Servicio en Windows
  • En Linux How To O3 BI v6 como Servicio en Linux
•  Cambiar los puertos de la nueva instalación. HowTo Cambiar puertos del Servidor O3 (JBoss y Liferay)
  Asignarle un puerto nuevo al jboss y al liferay de manera de poder probar la nueva instalación sin complicaciones.
  Existe en la actualidad un proceso batch que cambia los puertos y asigna el desplazamiento al puerto de forma automática, pero esta en versión de prueba.
•  Levantar los servicios y probar que todo funciona correctamente. 
•  Bajar los Servicios.
  

Paso 2

•  Bajar los Servicios de la Instalación a Sustituir

...

•  Respaldar las bases de datos (solo sí la configuración de o3 y eportal se encuentra en base de datos).

...

•  Copiar de la instalación vieja el directorio <o3>/jboss/server/default/ideasoft-o3/server en la raíz de la instalación nueva.
  Renombrar siempre las carpetas que se van a sustituir para mantener un respaldo.

...

•  Configuración de la base de datos
  
  1. 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.
  2. 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.
  3. Si no se tiene usuarios en base de datos y datos del admserver en archivo (version 4.x de O3 o anteriores)
     1. Realizar exportación desde admserver de o3v5 y la importación en el admserver de o3v6.
        (Requiere seguir la siguiente secuencia: Levantar jboss v5 -> exportar en admserver v5 -> bajar v5 -> Levantar jboss v6 -> importar

...

• 1. 1. en admserver v6 -> bajar jboss v6.)
         Los usuarios no serán exportados y deberán ser creados manualmente.

Se adjunta un archivo de configuración para una instalación con Postgres como BD: O3Server-ds.xml

Si se utiliza Postgres en linux, fijarse los permisos del driver<opt/ideasoft/o3bi/classes/jdbc/drivers/postgresql-9.1-901.jdbc4.jar> esten asi: rw-r--r--

Si se utiliza LDAP(HowTo Seguridad de O3 en LDAP y Active Directory) para la validación de usuarios, hacer lo siguiente :

• Crear el archivo O3Server_custom.properties en la raiz de O3.
• Agregarle las siguientes propiedades: 
   
  

...

...

...

...

...

...

...

...

...

Si se usa eportal

1. Renombrar (puede no existir) <o3>/liferay/data/document_library como #document_library y copiar de la instalación vieja la carpeta <o3>/jboss/server/default/data/liferay/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/jackrabbit
3. Renombrar <o3>/liferay/data/lucene como #lucene y copiar de la instalación vieja la carpeta <o3>/jboss/server/default/data/liferay/lucene

Si además se usa eportal con hypersonic

...

.impl.jndi.JndiRAAssignmentRepository

rbac.loginService           = com.ideasoft.rbac.repository.impl.jndi.JndiLoginService

Se adjunta un archivo de configuración donde se utiliza LDAP y BD: O3Server_custom.properties

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 por alguna razon hubiera algún problema con el proceso de migración se recomienda leer el siguiente /wiki/spaces/CAP/pages/134426523 e ir chequeando paso a paso lo realizado hasta el momento.

...

 Paso 3

•  

  Si se usa eportal

...

1. Renombrar (puede no existir) <o3>/liferay/data/document_library como #document_library y copiar de la instalación vieja la carpeta <o3>/jboss/server/default/data/hypersonic/lportal.script en <o3>/liferay/data/hsql
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).

...

1. 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/jackrabbit
3. Renombrar <o3>/liferay/data/lucene como #lucene y copiar de la instalación vieja la carpeta <o3>/jboss/server/default/data/liferay/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 los datos de conexión definidos en el archivo <o3>/jboss/server/default/deploy/liferay-xxxxxx-ds.xml (siendo xxxx la base de datos).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).
4. HowTo Configurar Liferay con Diferentes Bases de Datos

Otras consideraciones

...

•  

  Si se usa

...

• eportal con base de datos 

1. Copiar de la instalación vieja en <o3>los datos de conexión definidos en el archivo <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 configurarlosegú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).liferay-xxxxxx-ds.xml (siendo xxxx la base de datos).
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).
4. HowTo 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 puertos personalizados en JBoss

...