Page Comparison

...

1. Que el equipo donde se instalara cumple los requisitos de hardware y software recomendados.
2. Que se dispone de un usuario con privilegios de administrador en dicho equipo.
3. Que se disponga de las licencias necesarias (nuevas si se trata de un cambio de 5.x a 6.x o 7.x) o las vigentes para el nuevo equipo.
4. Que se disponga del instalador de la nueva versión en el equipo.
5. Que se evalúe la necesidad de  disponer de replicas de Bases de Datos para la nueva instalación de:
   
   
   1. RBAC: esta BD es la que tiene definición de usuarios, roles, asociaciones entre éstos y permisos sobre artefactos como reportes, etc. Tener en cuenta que puede tener roles solamente, por ejemplo cuando los usuarios se toman de un LDAP
      • En O3 BI v5.x se encuentra en \jboss\server\default\deploy\gserver\gserver-*-ds.xml, donde * es el nombre del motor utilizado, por ejemplo gserver-hsql-ds.xml (por default en O3, hypersonic), gserver-oracle-ds.xml, etc.
      • En O3 BI v6.x se encuentra en la misma ubicación que en O3BI v7
      • (En O3 BI v7 se encuentra en jboss/standalone/deployments/O3Server-ds.xml, datasource donde se encuentran definidos los parámetros de conexión a la base de RBAC)
        
        
   2. Liferay: esta BD es la que tiene las definiciones de portales  (ver <O3DIR>/liferay/tomcat/webapps/eportal/WEB-INF/classes).
      1.  Si en la version anterior, Liferay estaba usando HSQL, se debe copiar la carpeta <O3DIR>/liferay/data/
         
          Si se viene de una versión de O3 anterior a 7.1.0, ver previamente y aplicar para continuar con el procedimiento de migración, el siguiente wiki : /wiki/spaces/ISPRDO3/pages/126752778

...

1. 1. Verificar si es necesario copiar de la versión anterior drivers que se utilicen y que no sean distribuidos por O3. Esto lo realiza comparando los contenidos de la siguiente carpeta en versión anterior y nueva:
      
      1.  <O3BI_VersionAnterior>/classes/jdbc.
         
      2. <O3BI_VersionAnterior>/liferay/tomcat/lib/ext
   2. Configurar archivos properties y datasource de la nueva versión para que haga referencia a las BD de la versión anterior.
      Analizar lo que ya este configurado en los siguientes archivos de la versión anterior y modificarlos en la nueva:
      

      1. RBAC: en O3 BI v7 se ubica en jboss/standalone/deployments/O3Server-ds.xml, en versiones anteriores en:
         

         • En O3 BI v5.x se encuentra en \jboss\server\default\deploy\gserver\gserver-*-ds.xml, donde * es el nombre del motor utilizado, por ejemplo gserver-hsql-ds.xml (por default en O3, hypersonic), gserver-oracle-ds.xml, etc.
         • En O3 BI v6.x se encuentra en la misma ubicación que en O3BI v7

         
         

         Note
         en caso de venir de bases de datos (embebida de O3) Derby o Hipersonic (Indicar procedimiento) - Utilizar alguna herramienta que haga el pasaje (Ej.: TALEND)

         
         

         Note
         Procedimiento para creación de tablas RBAC y sentencias SQL para insertar datos (para inicializar con algunos usuarios) Creación tablas para RBAC en Base de Datos

         
         

      2. o3server.cfg. Si aún se está utilizando este archivo no se requiere la ejecución de ningún paso previo. El migrador lo consulta y exporta la información que contiene hacia eXist.

      3. Liferay: Para configurar la DB de liferay se debe modificar el archivo portal-ext.properties, adecuando las properties " jdbc.default.* "

         1. Si estamos migrando desde / hacia una version mayor o igual a 7.1.0 el archivo se encuentra  en <O3DIR>/liferay/

         2. SI estamos migrando desde / hasta  una version 7, pero anterior a 7.0.9: el archivo se encuentra en  <O3DIR>/liferay/tomcat/webapps/eportal/WEB-INF/classes.

...

1. Si la migración corresponde a un escenario de cambio de equipo:
   1. se debe copiar  la instalación anterior en el nuevo equipo. Recordar eliminar logs para facilitar la copia
   2. se deben copiar los cubos  manteniendo la misma estructura que en la versión anterior. 
      
      
2. Configurar lo siguiente: La  
   La carpeta <NuevaVersion><NuevaVersión>/migration contiene los archivos que llevan a cabo la migración.
   Según corresponda para el sistema operativo se utilizará o3bi-migration.sh para Linux y o3bi-migration.bat para Windows.
   Realizar las siguientes modificaciones sobre al archivo a ejecutar, con cualquier editor de texto:

   1. VERSION_MIGRACION="<número de la nueva versión donde se va a migrar>"

   2. RUTA_ORIGEN ="<ruta desde la que se quiere migrar>"

      Ejemplo:VERSION_MIGRACION="7.1.0-01" RUTA_ORIGEN ="/opt/ideasoft/VersionAnterior"  

3. Comprobar que se tiene el driver jdbc de la base de RBAC en <NuevaVersión>/migration/o3bi-migration/jdbc.

4. Abrir una consola y ejecutar el siguiente comando: 

   En Linux: <NuevaVersion><NuevaVersión>/migration/o3bi-migration.sh >> migration.log

   En Windows: <NuevaVersion><NuevaVersión>/migration/o3bi-migration.bat >> migration.log

   Como resultado del mismo se genera en <NuevaVersion>en <NuevaVersión>/migration/migration.log un archivo donde se especifica lo realizado por el migrador. Se debe inspeccionar para comprobar si existen errores.

...