La finalidad de la migración del O3Server.cfg a base de datos es pasar toda la información que contiene (cubos publicados, rolesvistas, usuarios, etc.) a base de datos, y seguir trabajando desde allí.
Los pasos para la migración son:
...
- 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.). En caso de realizar la migración a una nueva base de datos, la misma debe estar creada de antemano.
- Usuario y contraseña (que se guardará encriptada) para la base de datos.
...
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.
| Code Block |
|---|
<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>
-->
|
...
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.
...
- Iniciar el O3 server y conectarse usando el AdmServer
- Luego desde el AdmServer, seleccionar en la toolBar la opción "Herramientas --> Migrador de configuración del Servidor". Para realizar la migración se debe 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ó:
- 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.
...
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.
| Note |
|---|
Como los usuarios admin y user están en RBAC, se deben crear manualmente en el AdmServer una vez que se migró a base de datos. |
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:
- Apagar la property (o3.config.dataBase = false) que se define en el archivo Gserver.properties ubicado en <O3_DIR>\jboss\server\default\ideasoft-o3
- 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.