Respaldos y restauración
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 :
- Usuarios, roles y grupos de autorizacion
- Cuadros de mandos,
- Cartera de flujos de informaciones y modelo de datos
- Imagenes, diccionarios de datos (traduccionnes, formatos, connexiones, paletas de colores, etc.)
- 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 :
- 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. - 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
- Ir a la pagina de inicio de la installacion de DigDash Enterprise :
- inicie el navegador internet,
- luego tecle la URL : http://NombreDelServidor:PuertoDelServidor (por ejemplo y por defecto : http://localhost:8080).
- la pagina de inicio de DigDash Enterprise se abre.
- Haga clic en el boton Configuracion y luego en Gestion de los respaldos. Haga clic en Respaldo para guardar su configuracion actual.
- En la caja de conexion, ingrese su nombre de usuario y su contraseña.
- Marque las casillas de los elementos que quiere guardar en cada una de las secciones.
- Haga clic en Exportar y despues en Descargar el archivo de copia de seguridad (archivo .zip)
Restaurar datos desde una copia de seguridad
- Ir a la pagina de inicio de la installacion de DigDash Enterprise :
- inicie el navegador internet,
- luego tecle la URL : http://NombreDelServidor:PuertoDelServidor (por ejemplo y por defecto : http://localhost:8080).
- la pagina de inicio de DigDash Enterprise se abre.
- Haga clic en el boton Configuracion y luego en Gestion de los respaldos. Haga clic en Restauracion para restaurar una configuracion.
- Haga clic en el boton Selecionnar archivo para selecionnar el archivo zip que corresponde a su backup y luego haga clic en Subir.
- 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 :
- Haga una copia de seguridad completa del entorno de desarollo
- Restaure la copia de seguridad en el entorno de produccion
- 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.
- Restaure la copia de seguridad en el entorno de prodccion
- 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 :
- -url server_url : URL del servidor (per defecto http://localhost:8080)
- -domain dd_domain : nombre de dominio de la aplicacion (per defecto ddenterpriseapi)
- -login user_login : nombre de usuario del administrador
- -pass user_pass : contraseña del administrador
- -export ou -backup : guarda la configuracion en un archivo zip
- -import ou -restore : restaura la configuracion desde un archivo zip
- -file zipfile : ruta del archivo zip a restaurar
- -ldap : guardar o restaurar el directorio LDAP
- -noldap : no guardar o no restaurar el directorio LDAP
- -help : enseña la ayuda
- -debug : enseña los mensajes de error
Exemples d'utilisation :
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 :
- la URL de su servidor : por defecto, http://localhost:8080
- el dominio de la aplicacion : por defecto, ddenterpriseapi
- el nombre de usuario : por defecto, admin
- la contraseña del usuario : por defecto, admin
- 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.
Elemento | Comentario |
Usuarios Datos en relacion a cada usuario | |
LDAP | Datos del usuario almacenados en el LDAP:
|
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:
|
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 :
|
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 :
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.
Archivos:
|
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:
|
dmvoc.properties | Diccionarios de los valores hablados para los mensajes de los modelos de datos. Alcance: Exportacion video de los flujos (opcional) Archivos:
|
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:
|
dashboard<domain>.properties (Obsoleto) | Diccionario de los elementos del cuadro de mandos (nombre de las paginas, etc.) |
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:
|
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:
|
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. |