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á. |
...
- 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:
- <O3BI_VersionAnterior>/classes/jdbc.
- <O3BI_VersionAnterior>/liferay/tomcat/lib/ext
- <O3BI_VersionAnterior>/classes/jdbc.
- 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: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
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.
Liferay: Para configurar la DB de liferay se debe modificar el archivo portal-ext.properties, adecuando las properties " jdbc.default.* "
Si estamos migrando desde / hacia una version mayor o igual a 7.1.0 el archivo se encuentra en <O3DIR>/liferay/
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.
- 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:
...
- Personalización de la instalación:
- 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 ...
- Ajustar los parámetros de memoria y otros, de JBoss, Liferay, O3Designer, O3Builder.
- 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:
- Verificar que los servicios de la versión anterior están bajos
- 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.
- Si se tienen reportes publicados, revisar directorios de drivers y copiarlos. Ver O3 Report - Ubicación de drivers
- 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):
- <o3v7/>/sh/exist-db-start.sh
- <o3v7/>/bat/exist-db-start.bat
- 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:- Acceder a <NuevaVersion>/exist-db/bin en la nueva instalación.
- Ejecutar el client.bat o client.sh dependiendo del servidor.
- Este último paso nos abre un cliente exist que tiene la siguiente apariencia:
- Se debe modificar la url de la siguiente forma: xmldb:exist://localhost:8088/exist/xmlrpc y seleccionar "Connect".
- Una vez conectados, se observa el acceso a la base de la siguiente forma:
- 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.- 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>
- Desde el cliente exist abierto en el punto anterior, se solicita abrir el archivo o3bi/domains/default/current/runtime/Administrator/initialMigrationMapping.xml.
...