Respaldos y restauración

Última modificación por Aurelie Bertrand el 2023/05/11 10:24


Respaldo y restauracion manual

Si usted quiere instalar una nueva version de DigDash Enterprise o hace una migracion hacia un nuevo entorno (pasar de un entorno de test a un entorno de produccion, operar un mantenimiento en el servidor, etc.) puede hacer una copia de seguridad de la installacion de DigDash Enterprise y luego restaurar los datos de su entorno actual : 

  1. Usuarios, roles y grupos de autorizacion
  2. Cuadros de mandos,
  3. Cartera de flujos de informaciones y modelo de datos
  4. Imagenes, diccionarios de datos (traduccionnes, formatos, connexiones, paletas de colores, etc.)
  5. Fuentes de datos

Selecionne primero los elementos que quiere guardar. Esta operacion crea un archivo zip que debe luego restaurar en el nuevo entorno o en la nueva version. 

Cuidado, los archivos de la carpeta de instalacion no son guardados ni restaurados por la herramienta. Debe pues copiarlos de manera manual si habia hecho modificaciones en estos archivos : 

  1. Estilos del cuadro de mando : si modifico los estilos del cuadro de mando desde el archivo dashboard.css en la carpeta webapps/digdash_dashboard, este archivo debera ser copiado manualmente hacia el nuevo entorno.
    Nota : aconsejamos de modificar los estilos del cuadro de mando desde el editor CSS del cuadro de mando. Asi, se cree un archivo default.css en la carpeta de datos del usuario. Este archivo puede ser guardado y despues restaurado.
  2. Imagenes y iconos : si modifico los archivos ubicados en la carpeta webapps/digdash_dashboard/icons, debera copiarlos para poder reaplicarlos en su nueva version. 

Generar una copia de seguridad

  1. Ir a la pagina de inicio de la installacion de DigDash Enterprise :
  2. Haga clic en el boton Configuracion y luego en Gestion de los respaldos. Haga clic en Respaldo para guardar su configuracion actual.
  3. En la caja de conexion, ingrese su nombre de usuario y su contraseña. 
  4. Marque las casillas de los elementos que quiere guardar en cada una de las secciones.
  5. Haga clic en Exportar y despues en Descargar el archivo de copia de seguridad (archivo .zip)

Restaurar datos desde una copia de seguridad

  1. Ir a la pagina de inicio de la installacion de DigDash Enterprise :
  1. Haga clic en el boton Configuracion y luego en Gestion de los respaldos. Haga clic en Restauracion para restaurar una configuracion.
  2. Haga clic en el boton Selecionnar archivo para selecionnar el archivo zip que corresponde a su backup y luego haga clic en Subir.
  3. Se muestra la lista de conexiones de base de datos presentes en el archivo de respaldo para que pueda actualizarlas si es necesario.

Migracion de conexiones y de servidores de documentos

Para facilitar la migracion de estos elements, es posible de modificar sus identificadores para que estan identicos entre los servidores de desarollo y de produccion por ejemplo. 

Durante la primera migracion entre un servidor de desarollo y un servidor de produccion : 

  1. Haga una copia de seguridad completa del entorno de desarollo
  2. Restaure la copia de seguridad en el entorno de produccion
  3. Modifique las cadenas de conexion hacia las bases de datos y los servidores de documentos en el entorno de produccion para que sean las mismas que lo de desarollo (desde el gestor de conexiones y el gestor de servidor de documentos en el Web Studio).

Durante las siguientes migraciones hacia el entorno de produccion : 

  • Haga una copia de seguridad selectiva de los datos : modelos de datos, cartera, cuadros de mandos modificados o nuevos,...

No guarde el archivo conteniendo las connexiones (dbcnxrepository.xml) y tampoco el archvio conteniendo los servidores de documentos (serverurlrepository.xml) aun si llevan modificaciones. 

  1. Restaure la copia de seguridad en el entorno de prodccion
  2. Si las connexiones a las bases de datos, o si los servidores de documentos llevan modificaciones en el entorno de desarollo, reproduzca estas modificaiones manualmente en el entorno de produccion. 

Para las nuevas connexiones o los nuevos servidores de documentos, ingrese el identificador usado en el entorno de desarollo. 

  • Para ingresar el identificador de conexion a una base de datos : 
    • abre el Web Studio
    • abre el Gestor de conexiones 
    • modifique la connexion deseada y haga clic en Modificar para modificar el identificador
  • Para ingresar el identificador de un servidor de documentos : 
    • abre el Web Studio
    • abre el Gestor de Servidor de documentos
    • modifique el servidor de documentos deseado y haga clic en Modificar para modificar el identificar del servidor de documento

Automatización

Se puede automatizar la generacion de copia de seguridad de su entorno. Para hacerlo, un herramienta de creacion de copia de seguridad es proveido en la installacion DigDash : backuptools.jar, que debe ser lanzado en el servidor. 

Este archivo jar se encuentra en el directorio apache_tomcat/ddenterpriseapi/WEB-INF/lib y debe ser lanzado desde esta misma ubicacion (porque se hace referencia a otros archivos jar ubicados en la misma carpeta). 

Las opciones disponibles son las siguientes : 

  1. -url server_url : URL del servidor (per defecto http://localhost:8080)
  2. -domain dd_domain : nombre de dominio de la aplicacion (per defecto ddenterpriseapi)
  3. -login user_login : nombre de usuario del administrador
  4. -pass user_pass : contraseña del administrador
  5. -export ou -backup : guarda la configuracion en un archivo zip
  6. -import ou -restore : restaura la configuracion desde un archivo zip
  7. -file zipfile : ruta del archivo zip a restaurar
  8. -ldap : guardar o restaurar el directorio LDAP
  9. -noldap : no guardar o no restaurar el directorio LDAP
  10. -help : enseña la ayuda
  11. -debug : enseña los mensajes de error

Exemples d'utilisation :

java -jar backuptools.jar -login admin -pass admin -export -noldap
java -jar backuptools.jar -url http://localhost:8080 -domain ddenterpriseapi -login admin -pass admin -export -ldap -file C:\\backup.zip
java -jar backuptools.jar -url http://localhost:8080 -domain ddenterpriseapi -login admin -pass admin -import -ldap -file C:\\backup.zip

Si hace una copia de seguridad de su entorno, un archivo backup se crea. Este archivo lleva el nombre fechaDelDia_backup.zip (por ejemplo 20210615_backup.zip si el backup ha sido generado el 15 de junio de 2021) y se puede encontrar este archivo en la carpeta conteniendo los datos de la herramient (por defecto : <DD Install>/Application Data/Enterprise Server/<domain>/config)

Tambien, un archivo esta proveido : backup_export.bat (archivo interactivo con prompts) que permite guardar sur entorno. 

Este archivo se encuentra en el directorio de instalacion. A la ejecucion del archivo, debe indicar : 

  1. la URL de su servidor : por defecto, http://localhost:8080
  2. el dominio de la aplicacion : por defecto, ddenterpriseapi
  3. el nombre de usuario : por defecto, admin
  4. la contraseña del usuario : por defecto, admin
  5. si quiere o no quiere guardar el directorio LDAP : ingrese Y para guardar y N para no guardar

Un archivo backup se crea. Este archivo lleva el nombre fechaDelDia_backup.zip (por ejemplo 20210615_backup.zip si el backup ha sido generado el 15 de junio de 2021) y se puede encontrar este archivo en la carpeta conteniendo los datos de la herramient (por defecto : <DD Install>/Application Data/Enterprise Server/<domain>/config)

Por ejemplo, con Windows 7 :

C:\Users\<user>\AppData\Roaming\Enterprise Server\ddenterpriseapi\config

Para restaurar un backup automaticamente, puede usar tambien el archivo backup_import.bat. Debe ingresar los mismos parametros que para backup_export. Ingrese tambien el nombre del archivo de la copia de seguridad (por defecto, deberia encontrarse en la carpeta donde hay backup_import.bat). 

Anexo: Lista de elementos de una copia de seguridad

A continuacion, presentamos los elementos que son posibles de ser guardado y restaurado con la descripcion de cada uno. 

Cuando el elemento corresponde a un archivo, este archivo esta ubicado en el directorio de los datos del dominio DigDash. Por ejemplo : <AppData>/Enterprise Server/ddenterpriseapi. La ubicacion de los archivos mencionados a continuacion esta relativa a este directorio. 

ElementoComentario

Usuarios

Datos en relacion a cada usuario

LDAP

Datos del usuario almacenados en el LDAP: 

  • Attributos del usuario (nombre, identificador, contraseña, variables, etc.)
  • Roles del usuario
  • Autorizaciones y grupos de autorizaciones del usuario
Carteras

Cartera de informaciones y de flujos del usuario

Archivo: /server/<usuario>/config/wallet.iwt

Cuadros de mandos

Cuadros de mandos del usuario

Archivo: /server/<usuario>/config/dashboard.xml

Modelos de datos

Modelos de datos del usuario

Archivo: /server/<usuario>/config/tabledatamodelrepository.xml

Contraseñas

Contraseñas del usuario

Archivo: /server/<usuario>/config/passwordrepository.xml

Roles

Datos en relacion a cada rol

LDAP

Datos de los roles almacenados en el LDAP:

  • Atributos del rol (nombre, identificador)
  • Usuarios del rol
Carteras

Cartera de informaciones y de flujos del rol

Archivo: /config/wallet_<Id_Role>.xml

Cuadros de mandos

Cuadros de mandos del rol

Archivo: /config/dashboard_<Id_Role>.xml

Modelos de datos

Modelos de datos del rol

Archivo: /config/tabledatamodelrepository_<Id_Role>.xml

Contraseña

Contraseñas del rol

Archivo: /config/passwordrepository_<Id_Role>.xml

Grupos de autorizaciones

Definicion de los grupos de autorizaciones proveedos por DigDash o agregado por el usuario. Los grupos de autorizacion solo son almacenados dentro del LDAP.

<Nombre del grupo de autorizacion>Definicion del grupo de autorizacion :
  • Lista de las autorizaciones contenidas en el grupo

Archivos comunes del servidor

Lista de los archivos comunes a todos los usuarios y los roles. 

Archivos comunes del servidor / Archivos del sistema
serversettings.xml

Parametros del servidor DigDash Enterprise : 

  • Proxy HTTP
  • Connexion LDAP
  • Parametros del planificador
  • Parametros de rendimiento
  • Y todos los parametros de la pagina de configuracion del servidor

Archivo: /config/serversettings.xml

Recomendaciones: No transfiera este archivo entre varias configuraciones diferentes

system.xml

Datos del sistema y algunos parametros escondidos comentados en la siguiente documentacion : Parametros avanzados

Archivo: /config/system.xml

Recomendaciones: No transfiera este archivo entre varias configuraciones diferentes

userssettings.xml

Parametros usuarios, incluso los parametros que se ha podido crear de manera personalizada en su installacion.

Paramètres utilisateurs incluant les paramètres que vous avez créé.

Archivo: /config/userssettings.xml

Archivos comunes del servidor / Diccionarios

Configuraciones communes a todos los usuarios y roles. Estos archivos pueden ser presentes o no segin los parametros usado por los flujos o modelos de datos. 

colortablerepository.xml

Diccionario de las paletas de colores

Alcance: Configuracion de los flujos

Archivo: /config/colortablerepository.xml

cssrepository.xml

Diccionario des styles CSS

Alcance: Configuracion de los flujos

Archivo: /config/cssrepository.xml

clustersettings.xml

Configuracion del modo cluster (avanzado)

Alcance: Configuracion del sistema

Archivo: /config/clustersettings.xml

DDComments.h2.db

Base de datos de los comentarios de los flujos y modelos de datos del cuadro de mandos. 

Alcance: Visualizacion de los cuadros de mandos y de los flujos

Archivo: /config/DDComments.h2.db

dbcnxrepository.xml

Diccionario des connexions bases de données (avancé)

Alcance: Configuracion de los modelos de datos (connexiones a las fuentes de datos)

Archivo: /config/dbcnxrepository.xml

favoritedevicesrepository.xml

Diccionario de la los disositivos de salidas de sincronizacion de los flujos (servidores de documentos, e-mail, etc.)

Alcance: Exportacion de los flujos

Archivo: /config/favoritedevicesrepository.xml

flowsnapshotrepository.xml

Diccionario de las vistas usuarios usadas en Self-Service BI

Alcance: Visualizacion de los flujos (con edicion en el cuadro de mandos)

Archivo: /config/flowsnapshotrepository.xml

formatrepository.xml

Diccionario des formats de nombres et de dates

Alcance: Configuracion de los modelos de datos y de los flujos

Archivo: /config/formatrepository.xml

jsfunctionrepository.xml

Diccionario de las funcionnes javascrpt usadas en las medidas calculadas, filtros, transformadores de fuentes, etc.

Alcance: Configuracion de los modelos de datos y de los flujos

Archivo: /config/jsfunctionrepository.xml

hierarchyrepository.xml

Diccionario de las jerarquias compartidas usadas por las dimensiones de los modelos de datos.

Alcance: Configuracion de los modelos de datos

Archivo: /config/hierarchyrepository.xml

navigationsentencerepository.xml

Diccionario de las frases creadas para la navigacion video y para el texto de los flujos de tipo Texto

Alcance: Configiracion de los flujos

Archivo: /config/navigationsentencerepository.xml

passwordrepository.xml

Diccionario de las contraseñas globales. (Obsoleto)

Archivo: /config/passwordrepository.xml

serverurlrepository.xml

Diccionario de los servidores de documentos usados en DigDash Enterprise

Alcance: Configuracion de los modelos de datos

Archivo: /config/serverurlrepository.xml

vectoriconrepository.xml

Diccionario de los iconos vectoriales usados por los graficos de tipo "Infografia"

Alcance: Configuracion de los flujos

Archivo: /config/vectoriconrepository.xml

vizmodelrepository.xml

Diccionario de los modelos de presentacion compartidos vinculados con flujos.

Alcance: Configuracion de los flujos

Archivo: /config/vizmodelrepository.xml

Archivos comunes del servidor / Archivos de traducciones

Los diccionnarios de traducciones agrupan los mensajes en varios idiomas. 

Cada uno de los archivos de traduccion siguientes puede acompañarse de un archivo relativo al idioma elegido. Por ejemplo, los archivos dm.properties, dm_fr.properties, dm_es.properties son las traducciones de los mensajes correspondientes al idioma ingles (predeterminado), français, espagnol.

dashboard.properties

Diccionario de las traducciones usadas en los elementos relativos al cuadro de mandos.

  • Nombre de las paginas
  • Nombre de los portlets

Archivos: 

  • /config/dashboard.properties
  • /config/dashboard_<lang>.properties
dm.properties

Diccionarios de las traducciones usadas en los modelos de datos y los flujos.

Alcance: Visualizacion de flujos y de elementos en los cuadros de mandos.

Archivos:

  • /config/dm.properties 
  • /config/dm_<lang>.properties 
dmvoc.properties

Diccionarios de los valores hablados para los mensajes de los modelos de datos.

Alcance: Exportacion video de los flujos (opcional)

Archivos:

  • /config/dmvoc.properties 
  • /config/dmvoc_<lang>.properties 
dmtag.properties

Diccionarios de los sinonimos creados en los modelos de datos. Estos diccionnarios son utilisados por la funcion de busqueda del cuadro de mando : consulta en lenguaje natural.

Alcance: Busqueda textual en el cuadro de mandos

Archivos:

  • /config/dmtag.properties 
  • /config/dmtag_<lang>.properties 

dashboard<domain>.properties

(Obsoleto)

Diccionario de los elementos del cuadro de mandos (nombre de las paginas, etc.)

Estos archivos son obsoletos y no deben ser guardados / restaurados

Archivos comunes del servidor / Otros archivos

Otros archivos vinculados a la configuracion de los cuadros de mandos.

Imagenes

(*.png, *.jpg, *.gif...)

Lista de las imagenes agregadas desde el editor de cuadro de mandos.

Directorios:

  • /config/web/public/ 
  • /config/web/public/<Id_Role>/ 
  • /config/web/public/<utilisateur>/

Estilos

default.css

*.css

Archivos conteniendo los estilos personalizados del cuadro de mandos. Las hojas de estilos CSS se pueden editar desde la interfaz de edicion de los cuadros de mandos. 

Archivos:

  • /config/web/public/default.css
  • /config/web/public/*.css
js-const.js

Constantes del servidor (propriedades que aparecen en la parte Configuracion > Parametros servidor > Additional parametros > Constantes y en la parte Configuracion > Parametros servidor > Exportar configuracion

Archivo: /config/web/session/js-const.js

js-default.js

Archivo de script personalizado del cuadro de mandos. Este archivo se puede editar directamente desde la interfaz de edicion de los cuadros de mandos.

Archivo: /config/web/session/js-default.js

Fichiers communs du serveur / Fuentes de datos

Fuentes de datos que estan contenidos en el servidor de documento Common datasources. Los archivos contenidos en este servidor pueden ser integrados a la copia de seguridad.