Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Excerpt

Guía de Migración desde v5.x ó v6.x a v7.x.

Es un procedimiento manual que se aplica sin importar si partimos desde una versión 5.x ó 6.x. En caso de tener consideraciones especiales por la versión que estamos intentando migrar, la guía lo indicará.

...

    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: jboss/standalone/deployments/O3Server-ds.xml.

        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. Personalización de la instalación:
    1. Copiar el archivo /opt/ideasoft/VersionAnterior/O3Server_custom.properties desde la versión anterior a la nueva versión. Tener en cuenta que en versión 5.x existían otras propiedades que no se mantienen en versiones posteriores, por lo que es MUY IMPORTANTE revisar la lista de propiedades existentes en caso de partir de una versión 5.x. En versión 5.x el nombre del archivo es GServer_custom.properties y se puede encontrar en ... (question)
    2. Ajustar los parámetros de memoria y otros, de JBoss, Liferay, O3Designer, O3Builder.

  2. Se solicita seguir los siguientes instructivos en caso de querer cambiar nombre o ip, puertos, configurar apache o https en la nueva versión, modificar url de eportal, instalar servicios en Linux:
      1. HowTo - cambiar nombre (o ip) después de un instalación
      2. HowTo Cambiar puertos del Servidor O3 (JBoss y Liferay)
      3. HowTo Configurar O3 Bajo Apache o IIS
      4. HowTo o3v6 Https (SSL)
      5. HowTo modificar url de eportal luego de cambiar ip o nombre del servidor

      6. Cómo se instalan Servicios de O3 BI 7 en Linux


  3. Verificar que los servicios de la versión anterior están bajos

  4. Copiar la carpeta opt/ideasoft/VersionAnterior/server, pero sin copiar la carpeta opt/ideasoft/VersionAnterior/server/istore/rules ya que debe quedar vacía en la nueva versión.

  5. Si se tienen reportes publicados, revisar directorios de drivers y copiarlos. Ver O3 Report - Ubicación de drivers

  6. Levantar la base exist de de la versión nueva, ejecutando el bat o sh correspondiente dependiendo del servidor (por defecto levanta en el puerto 8088):
    1. <o3v7/>/sh/exist-db-start.sh
    2. <o3v7/>/bat/exist-db-start.bat

  7. Para considerar las modificaciones que se solicitan en el punto número 8, es necesario acceder a la base exist levantada en el puerto 8088. 
    A continuación se especifican los pasos para poder acceder:
    1. Acceder a <NuevaVersion>/exist-db/bin en la nueva instalación.
    2. Ejecutar el client.bat o client.sh dependiendo del servidor.
    3. Este último paso nos abre un cliente exist que tiene la siguiente apariencia:
    4. Se debe modificar la url de la siguiente forma: xmldb:exist://localhost:8088/exist/xmlrpc y seleccionar "Connect".
    5. Una vez conectados, se observa el acceso a la base de la siguiente forma:


  8. Respecto a la migración de cubos, los mismos guardarán su definición en la base exist con un identificador numérico.
    Es sugerencia para los cubos más importantes seguir los siguientes pasos, de forma tal que se identifiquen con un nombre más nemotecnico y no numérico como se realiza de forma automática.
    1. Desde el cliente exist abierto en el punto anterior, se solicita abrir el archivo o3bi/domains/default/current/runtime/Administrator/initialMigrationMapping.xml.
      Se debe agregar un nodo <mapping> por cada cubo del cliente que se le quiera dar identificación manual.
      A continuación se ejemplifica el nodo a agregar, el mismo en key y oldValue debe conter el identificador anterior. Por ejemplo, en caso de versión 6.x es dato de su dublin core con la siguiente forma: <ns3:identifier>cube::o3bi/Wines::Wines</ns3:identifier>. 
      En newValue es donde vamos a dar nuestro nombre identificatorio. La identificación newValue contiene varios componentes separados por ":", se debe asignar el nombre como último elemento, teniendo en cuenta que no puede contener mas de 20 caracteres, ni  espacios ni ningún otro carácter especial. En el ejemplo a continuación el nombre asignado es "Wines".
      Ejemplo de un <mapping>:
           <mapping>
              <key>cube::o3bi/Wines::Wines</key>
              <oldValue>cube::o3bi/Wines::Wines</oldValue>
              <newValue>urn:o3bi:default:r:cube:n:o3bi:Wines</newValue>
          </mapping>

...