Page Comparison

La finalidad de la migración del O3Server.cfg a base de datos es pasar toda la información que contiene (cubos publicados, roles, usuariosvistas, etc.) a base de datos, y seguir trabajando desde allí.
Los pasos para la migración son:

...

1. Motor, las opciones posibles son SQL Server Microsoft, SQL Server Opta, Oracle, MySQL, PostgreSQL, HsqlDb, Derby, other.
2. Manejador (driver) a utilizar (debe tenerse el driver correspondiente en el servidor <InstalaciónO3>\jboss\server\default\lib)
3. Url completa a la base de datos (servidor, puerto de la base de datos, nombre de la misma, etc.). En caso de realizar la migración a una nueva base de datos, la misma debe estar creada de antemano.
4. Usuario y contraseña (que se guardará encriptada) para la base de datos.

Además:

Configuración inicial (original):

<connection-url>jdbc:hsqldb:hsql://localhost:1701</connection-url>
...
<driver-class>org.hsqldb.jdbcDriver</driver-class>
...
<user-name>sa</user-name>
<password></password>
...
<metadata>
         <type-mapping>Hypersonic SQL</type-mapping>
</metadata>

Ejemplo para conexión a SQL Server:

En este caso la configuración del archivo corresponde a indicar la URL, el driver, usuario, contraseña y comentar el tag indicado.

<connection-url>jdbc:sqlserver://Server:1433;DatabaseName=PruebaO3ServerCfg;SelectMethod=cursor</connection-url>
...
<driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class>
...
<user-name>sa</user-name>
<password></password>
...
<!--Finalmente se comenta el tag:-->
<!-- corresponding type-mapping in the standardjbosscmp-jdbc.xml (optional)
<metadata>
         <type-mapping>Hypersonic SQL</type-mapping>
</metadata>
-->

Luego se tiene 3 opciones:

1- Verificar la conexión a la base con el botón "Verificar Conexion". Si la conexión es satisfactoria se mostrará un mensaje como el siguiente:

2- En caso de que se quiera crear las tablas, se debe de presionar el botón con la etiqueta "Generar Tablas". Se mostrará el siguiente mensaje:

3- Si las tablas ya existen y lo que se quiere es actualizar la estructura de las mismas, se debe de presionar el botón con la etiqueta "Actualizar Tablas".
Se crearán/actualizarán las tablas de RBAC, E2, jwf, y las necesarias para cubos, vistas, cubos-roles, cubos-perfiles, modelos, etc.

...

Luego de una actualización exitosa de la base de datos, se debe de proceder a migrar los datos de los cubos y vistas del O3Server.cfg (cubos, vistas, etc.) a la base de datos.
Para migrar los datos debe de estar levantado se debe:

1. Iniciar el O3 server y conectarse usando el AdmServer

...

2. Luego desde el AdmServer,

...

1. seleccionar en la toolBar la opción "Herramientas --> Migrador de configuración del Servidor".

...

1. Para realizar la migración se debe

...

1. presionar el botón con la etiqueta "Migrar" y a continuación se mostrará en el área de "Mensajes de la migración" la información de qué se migró:
   Image Added
2. La última linea del mensaje está avisando que ya están disponibles los cubos como para comenzar a trabajar desde base de datos.

3- Configuración del O3 Server para levantar con Base de Datos.

Luego de haber seguido los pasos anteriores se debe de bajar el servidor y editar el archivo GServer.properties para modificar la property "o3.config.dataBase" de <InstalaciónO3>\jboss\server\default\ideasoft-o3\GServer.properties, con el valor "true".

Al levantar el servidor nuevamente este tomará la información que se guardó en la base de datos y toda nueva información sera guardada en este lugar.

Volver a trabajar con O3Server.cfg

Como ya se mencionó a partir de O3 5.0 se almancena la configuración del servidor en base de datos, a diferencia de versiones anteriores donde la configuración era almacenada en el archivo O3Server.cfg

Para facilitar la migración desde versiones anteriores se ofrece este mecanismo que tiene por resultado eliminar el uso del O3Server.cfg y pasar a adminsitrar en base de datos la información de cubos publicados y perfiles de acceso.

De todas formas se aclara que si se necesita volver a la situación inicial, trabajando con O3Server.cfg, el procedimiento sería:

1. Apagar la property (o3.config.dataBase = false) que se define en el archivo Gserver.properties ubicado en <O3_DIR>\jboss\server\default\ideasoft-o3
2. Reiniciar el O3Server (Jboss).

Los cambios hechos desde la migración (publicación de nuevos cubos, creación de nuevas vistas, etc.), no se verán reflejados en el O3Server.cfg.