Procedimiento de respaldo de Bases de Datos

Sobre las Bases de Datos

O3 BP&A utiliza por defecto tres bases de datos:

• BD XML / Exist:
  
  • Contiene la definición de Artefactos, esto es, los datos generados en Metadata (tableros, planes y demás artefactos), Organización , Dashboards y configuración de Alertas.
  • Esta base no debe ser sustituída.
  • En versiones anteriores a la 4.0 se encuentra en: <o3bpa-install>/jboss/standalone/data/exist/data.
    En caso de contar con versión 4.0 o posterior a la misma, se encuentra fuera del jboss, de forma independiente en: <o3bpa-install>/exist-db.

• BD Metrics:
  
  • Base de datos Derby que contiene los datos históricos de los indicadores (tanto los regulares como los pertenecientes a iniciativas) y objetivos referidos a su valor y meta, tanto los cargados manualmente como los obtenidos de consulta vista O3 o consulta SQL.
  • Es altamente recomendado sustituír esta base de datos por alguna de mayor porte, principalmente para instalaciones que estén en producción.
  • <o3bpa-install>/jboss/standalone/data/derby/metrics. 
    
    
• BD RBAC:
  

  • Base de datos Derby que contiene la información referida a usuarios y roles.

  • Es una base de datos que puede ser sustituída, pero que no es necesario en caso que la cantidad de usuarios del sistema no aumente sustancialmente.
    Si ya se cuenta con una base de datos de administración de usuarios, O3BP&A ofrece mecanismos de configuración para utilizar una BD externa. En ocasiones el cliente quiere vincular la administración de usuarios con el LDAP utilizado, esto también es posible. 
    En caso de trabajar con O3 BI, sugerimos solicitar compartir el mecanismo de autenticación, unificarlos y administrar a los usuarios únicamente desde O3 BI.
  • <o3bpa-install>/jboss/standalone/data/derby/rbac

Respaldo de Bases de Datos

Para realizar un respaldo de las bases de datos por defecto, seguir los siguientes pasos:

1. Bajar el servicio de jboss. 
   En v4.0 o posterior se debe bajar exist (metadata) también, dado que se encuentran de forma independiente.

2. Dentro del directorio de instalación de O3 BP&A, respaldar las siguientes carpetas:

   BD	Carpeta	Ubicación
   BD XML / Exist	data	<o3bpa-install>/exist-db/data
   BD Metrics	metrics	Respaldar la base de datos de métricas según el método ofrecido por el manejador que se esté utilizando. Si no se sustituyó por otra base de datos, respaldar <o3bpa-install>/jboss\standalone\data\hsqldb\metrics. (Recordar que el respaldo de métricas es conveniente en caso que se ingresen datos manuales en el producto, de lo contrario alcanza con los respaldos de exist)
   BD RBAC	rbac	Respaldar la base de datos de rbac según el método ofrecido por el manejador que se esté utilizando. Si no se sustituyó por otra base de datos, respaldar<o3bpa-install>/jboss/standalone/data/derby/rbac

3. Iniciar el jboss. 
   En versión 4.0 o posterior iniciar primero exist y luego el jboss.

Respaldo de BD Exist

Una forma alternativa de realizar el backup de la base de datos Exist de O3BPA es la siguiente:

En versiones anteriores a la 4.0:

1. Iniciar el servidor de O3BPA.
2. Ejecutar la aplicación eXist Client Shell (buscarla a partir de la barra de búsqueda de Windows, en caso contrario instalarlahttp://localhost:8180/exist/download.xml  o  http://www.exist-db.org/exist/download.xml )
3. Observar que se abre una nueva ventana correspondiente a la consola de Windows y se ejecuta el cliente.
4. Se despliega una pantalla donde se debe corroborar que el puerto sea el correcto y seleccionar Aceptar.
5. Observar que se abre una nueva ventana correspondiente a eXist Admin Client. Dentro de la barra de menú, hacer click sobre el botón Create Backup.
6. Definir:
   
   1. Collection: lista desplegable, las opciones indican lo que será respaldado (Ej. La opción: db/o3bpa/domains, respalda todos los dominios que existan)
   2. Target: campo que indica el lugar del disco donde el archivo de respaldo será guardado con extensión zip.
   3. Dejar la password en blanco
7. Aceptar y verificar que el backup se ejecuta.

En versiones 4.0 o posterior:

1. Asegurarnos de que exist se encuentre levantado.
2. Ejecutar el comando exist-db-client en carpeta bat o sh dependiendo del sistema operativo. Esto permite abrir el cliente exist.
3. Configurar el acceso estableciendo si es localhost o ip del sevidor y modificando el puerto a 8188.
   (Conectar sin contraseña).
4. Definir:
   1. Collection: lista desplegable, las opciones indican lo que será respaldado (Ej. La opción: db/o3bpa/domains, respalda todos los dominios que existan)
   2. Target: campo que indica el lugar del disco donde el archivo de respaldo será guardado con extensión zip.
   3. Dejar la password en blanco
   4. Aceptar y verificar que el backup se ejecuta.