La finalidad de la migración del O3Server.cfg a base de datos es pasar toda la información que contiene (cubos publicados, roles, usuarios, etc.) a base de datos, y seguir trabajando desde allí.
Los pasos para la migración son:
- Creación o actualización de la base de datos.
- Migración de los datos.
- Configuración del O3Server para iniciarse con base de datos.
1- Actualización o creación de la Base de Datos.
No es necesario que el Servidor O3 esté levantado a no ser que se quiera usar la base Hypersonic que viene en el jboss, conectandose por host:puerto.
Iniciar el AdmServer y en la toolBar seleccionar "Herramientas -->Generador Esquemas Base de Datos". Esto muestra la siguiente ventana:
Se configura la conexión a la base de datos:
- Motor, las opciones posibles son SQL Server Microsoft, SQL Server Opta, Oracle, MySQL, PostgreSQL, HsqlDb, Derby, other.
- Manejador (driver) a utilizar (debe tenerse el driver correspondiente en el servidor <InstalaciónO3>\jboss\server\default\lib)
- Url completa a la base de datos (servidor, puerto de la base de datos, nombre de la misma, etc.)
- Usuario y contraseña (que se guardará encriptada) para la base de datos.
Luego se tiene 3 opciones:
- 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:
- 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:
- 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".
2- Migración de los datos.
Luego de una actualización exitosa de la base de datos, se debe de proceder a migrar los datos de los cubos y vistas a la base de datos.
Para migrar los datos debe de estar levantado el O3 server y conectarse usando el AdmServer. Luego desde el AdmServer, selecciona en la toolBar la opción "Herramientas --> Migrador de configuración del Servidor". Esto muestra la siguiete ventana:
Para realizar la migración se debe de apretar 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ó.
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" 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.