Código fuente wiki de Sauvegarde et restauration

Última modificación por Aurelie Bertrand el 2024/03/25 13:11
Mostrar los últimos autores
1 {{ddtoc/}}
2
3 ----
4
5 = Respaldo y restauracion manual =
6
7 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 :
8
9 1. Usuarios, roles y grupos de autorizacion
10 1. Cuadros de mandos,
11 1. Cartera de flujos de informaciones y modelo de datos
12 1. Imagenes, diccionarios de datos (traduccionnes, formatos, connexiones, paletas de colores, etc.)
13 1. Fuentes de datos
14
15 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.
16
17 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 :
18
19 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.
20 **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.
21 1. Imagenes y iconos : si modifico los archivos ubicados en la carpeta ##webapps/digdash_dashboard/icons##, debera copiarlos para poder reaplicarlos en su nueva version.
22
23 (% style="font-size:26px" %)Generar una copia de seguridad
24
25 1. Ir a la pagina de inicio de la installacion de DigDash Enterprise :
26 1*. inicie el navegador internet,
27 1*. luego tecle la URL : [[http:~~/~~/NombreDelServidor:PuertoDelServidor>>url:localhost:8080]] (por ejemplo y por defecto : http:~/~/localhost:8080).
28 1*. la pagina de inicio de DigDash Enterprise se abre.
29 1. Haga clic en el boton **Configuracion** y luego en **Gestion de los respaldos**. Haga clic en **Respaldo** para guardar su configuracion actual.
30 1. En la caja de conexion, ingrese su nombre de usuario y su contraseña.
31 1. Marque las casillas de los elementos que quiere guardar en cada una de las secciones.
32 1. Haga clic en **Exportar** y despues en **Descargar el archivo de copia de seguridad** (archivo .zip)
33
34 == Restaurar datos desde una copia de seguridad ==
35
36 1. Ir a la pagina de inicio de la installacion de DigDash Enterprise :
37 1*. inicie el navegador internet,
38 1*. luego tecle la URL : [[http:~~/~~/NombreDelServidor:PuertoDelServidor>>url:localhost:8080]] (por ejemplo y por defecto : http:~/~/localhost:8080).
39 1*. la pagina de inicio de DigDash Enterprise se abre.
40
41 (% start="2" %)
42 1. Haga clic en el boton **Configuracion** y luego en **Gestion de los respaldos**. Haga clic en **Restauracion** para restaurar una configuracion.
43 1. Haga clic en el boton **Selecionnar archivo** para selecionnar el archivo zip que corresponde a su backup y luego haga clic en **Subir**.
44 1. Se muestra la lista de conexiones de base de datos presentes en el archivo de respaldo para que pueda actualizarlas si es necesario.
45
46 == Migracion de conexiones y de servidores de documentos ==
47
48 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.
49
50 Durante la primera migracion entre un servidor de desarollo y un servidor de produccion :
51
52 1. Haga una copia de seguridad completa del entorno de desarollo
53 1. Restaure la copia de seguridad en el entorno de produccion
54 1. 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).
55
56 Durante las siguientes migraciones hacia el entorno de produccion :
57
58 * Haga una copia de seguridad selectiva de los datos : modelos de datos, cartera, cuadros de mandos modificados o nuevos,...
59
60 No guarde el archivo conteniendo las connexiones (##dbcnxrepository.xml##) y tampoco el archvio conteniendo los servidores de documentos (##serverurlrepository.xml##) aun si llevan modificaciones.
61
62 1. Restaure la copia de seguridad en el entorno de prodccion
63 1. 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.
64
65 Para las nuevas connexiones o los nuevos servidores de documentos, ingrese el identificador usado en el entorno de desarollo.
66
67 * Para ingresar el identificador de conexion a una base de datos : 
68 ** abre el Web Studio
69 ** abre el Gestor de conexiones
70 ** modifique la connexion deseada y haga clic en Modificar para modificar el identificador
71 * Para ingresar el identificador de un servidor de documentos : 
72 ** abre el Web Studio
73 ** abre el Gestor de Servidor de documentos
74 ** modifique el servidor de documentos deseado y haga clic en Modificar para modificar el identificar del servidor de documento
75
76 = Automatización =
77
78 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.
79
80 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).
81
82 Las opciones disponibles son las siguientes :
83
84 1. -url server_url : URL del servidor (per defecto [[http://localhost:8080]])
85 1. -domain dd_domain : nombre de dominio de la aplicacion (per defecto ddenterpriseapi)
86 1. -login user_login : nombre de usuario del administrador
87 1. -pass user_pass : contraseña del administrador
88 1. -export ou -backup : guarda la configuracion en un archivo zip
89 1. -import ou -restore : restaura la configuracion desde un archivo zip
90 1. -file zipfile : ruta del archivo zip a restaurar
91 1. -ldap : guardar o restaurar el directorio LDAP
92 1. -noldap : no guardar o no restaurar el directorio LDAP
93 1. -help : enseña la ayuda
94 1. -debug : enseña los mensajes de error
95
96 __Exemples d'utilisation :__
97
98 {{code language="java" cssClass="notranslate"}}
99 java -jar backuptools.jar -login admin -pass admin -export -noldap
100 java -jar backuptools.jar -url http://localhost:8080 -domain ddenterpriseapi -login admin -pass admin -export -ldap -file C:\\backup.zip
101 java -jar backuptools.jar -url http://localhost:8080 -domain ddenterpriseapi -login admin -pass admin -import -ldap -file C:\\backup.zip
102 {{/code}}
103
104 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**##)
105
106 Tambien, un archivo esta proveido : backup_export.bat (archivo interactivo con prompts) que permite guardar sur entorno.
107
108 Este archivo se encuentra en el directorio de instalacion. A la ejecucion del archivo, debe indicar :
109
110 1. la URL de su servidor : por defecto, [[http:~~/~~/localhost:8080>>url:http://localhost:8080/]]
111 1. el dominio de la aplicacion : por defecto, ddenterpriseapi
112 1. el nombre de usuario : por defecto, admin
113 1. la contraseña del usuario : por defecto, admin
114 1. si quiere o no quiere guardar el directorio LDAP : ingrese **Y** para guardar y **N** para no guardar
115
116 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**##)
117
118 Por ejemplo, con Windows 7 :
119
120 (% class="box" %)
121 (((
122 C:\Users\<user>\AppData\Roaming\Enterprise Server\ddenterpriseapi\config
123 )))
124
125 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).
126
127 = Anexo: Lista de elementos de una copia de seguridad =
128
129 A continuacion, presentamos los elementos que son posibles de ser guardado y restaurado con la descripcion de cada uno.
130
131 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.
132
133 |**Elemento**|**Comentario**
134 |(% colspan="2" %)(((
135 __Usuarios__
136
137 Datos en relacion a cada usuario
138 )))
139 |LDAP|(((
140 Datos del usuario almacenados en el LDAP:
141
142 * Attributos del usuario (nombre, identificador, contraseña, variables, etc.)
143 * Roles del usuario
144 * Autorizaciones y grupos de autorizaciones del usuario
145 )))
146 |Carteras|(((
147 Cartera de informaciones y de flujos del usuario
148
149 Archivo: ##{{code language="text" cssClass="notranslate"}}/server/<usuario>/config/wallet.iwt{{/code}}##
150 )))
151 |Cuadros de mandos|(((
152 Cuadros de mandos del usuario
153
154 Archivo: {{code language="text" cssClass="notranslate"}}/server/<usuario>/config/dashboard.xml{{/code}}
155 )))
156 |Modelos de datos|(((
157 Modelos de datos del usuario
158
159 Archivo: {{code language="text" cssClass="notranslate"}}/server/<usuario>/config/tabledatamodelrepository.xml{{/code}}
160 )))
161 |Contraseñas|(((
162 Contraseñas del usuario
163
164 Archivo: {{code language="text" cssClass="notranslate"}}/server/<usuario>/config/passwordrepository.xml{{/code}}
165 )))
166 |(% colspan="2" %)(((
167 __Roles__
168
169 Datos en relacion a cada rol
170 )))
171 |LDAP|(((
172 Datos de los roles almacenados en el LDAP:
173
174 * Atributos del rol (nombre, identificador)
175 * Usuarios del rol
176 )))
177 |Carteras|(((
178 Cartera de informaciones y de flujos del rol
179
180 Archivo: {{code language="text" cssClass="notranslate"}}/config/wallet_<Id_Role>.xml{{/code}}
181 )))
182 |Cuadros de mandos|(((
183 Cuadros de mandos del rol
184
185 Archivo: {{code language="text" cssClass="notranslate"}}/config/dashboard_<Id_Role>.xml{{/code}}
186 )))
187 |Modelos de datos|(((
188 Modelos de datos del rol
189
190 Archivo: {{code language="text" cssClass="notranslate"}}/config/tabledatamodelrepository_<Id_Role>.xml{{/code}}
191 )))
192 |Contraseña|(((
193 Contraseñas del rol
194
195 Archivo: {{code language="text" cssClass="notranslate"}}/config/passwordrepository_<Id_Role>.xml{{/code}}
196 )))
197 |(% colspan="2" %)(((
198 __Grupos de autorizaciones__
199
200 Definicion de los grupos de autorizaciones proveedos por DigDash o agregado por el usuario. Los grupos de autorizacion solo son almacenados dentro del LDAP.
201 )))
202 |<Nombre del grupo de autorizacion>|Definicion del grupo de autorizacion :(((
203 * Lista de las autorizaciones contenidas en el grupo
204 )))
205 |(% colspan="2" %)(((
206 __Archivos comunes del servidor__
207
208 Lista de los archivos comunes a todos los usuarios y los roles.
209 )))
210 |(% colspan="2" %)__Archivos comunes del servidor / Archivos del sistema__
211 |serversettings.xml|(((
212 Parametros del servidor DigDash Enterprise :
213
214 * Proxy HTTP
215 * Connexion LDAP
216 * Parametros del planificador
217 * Parametros de rendimiento
218 * Y todos los parametros de la pagina de configuracion del servidor
219
220 Archivo: {{code language="text" cssClass="notranslate"}}/config/serversettings.xml{{/code}}
221
222 Recomendaciones: No transfiera este archivo entre varias configuraciones diferentes
223 )))
224 |system.xml|(((
225 Datos del sistema y algunos parametros escondidos comentados en la siguiente documentacion : [[Parametros avanzados>>doc:Digdash.deployment.configuration.advanced_system_guide.WebHome]]
226
227 Archivo: {{code language="text" cssClass="notranslate"}}/config/system.xml{{/code}}
228
229 Recomendaciones: No transfiera este archivo entre varias configuraciones diferentes
230 )))
231 |userssettings.xml|(((
232 Parametros usuarios, incluso los parametros que se ha podido crear de manera personalizada en su installacion.
233
234 Paramètres utilisateurs incluant les paramètres que vous avez créé.
235
236 Archivo: {{code language="text" cssClass="notranslate"}}/config/userssettings.xml{{/code}}
237 )))
238 |(% colspan="2" %)(((
239 __Archivos comunes del servidor / Diccionarios__
240
241 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.
242 )))
243 |colortablerepository.xml|(((
244 Diccionario de las paletas de colores
245
246 Alcance: Configuracion de los flujos
247
248 Archivo: {{code language="text" cssClass="notranslate"}}/config/colortablerepository.xml{{/code}}
249 )))
250 |cssrepository.xml|(((
251 Diccionario des styles CSS
252
253 Alcance: Configuracion de los flujos
254
255 Archivo: {{code language="text" cssClass="notranslate"}}/config/cssrepository.xml{{/code}}
256 )))
257 |clustersettings.xml|(((
258 Configuracion del modo //cluster// (avanzado)
259
260 Alcance: Configuracion del sistema
261
262 Archivo: {{code language="text" cssClass="notranslate"}}/config/clustersettings.xml{{/code}}
263 )))
264 |DDComments.h2.db|(((
265 Base de datos de los comentarios de los flujos y modelos de datos del cuadro de mandos.
266
267 Alcance: Visualizacion de los cuadros de mandos y de los flujos
268
269 Archivo: {{code language="text" cssClass="notranslate"}}/config/DDComments.h2.db{{/code}}
270 )))
271 |dbcnxrepository.xml|(((
272 Diccionario des connexions bases de données (avancé)
273
274 Alcance: Configuracion de los modelos de datos (connexiones a las fuentes de datos)
275
276 Archivo: {{code language="text" cssClass="notranslate"}}/config/dbcnxrepository.xml{{/code}}
277 )))
278 |favoritedevicesrepository.xml|(((
279 Diccionario de la los disositivos de salidas de sincronizacion de los flujos (servidores de documentos, e-mail, etc.)
280
281 Alcance: Exportacion de los flujos
282
283 Archivo: {{code language="text" cssClass="notranslate"}}/config/favoritedevicesrepository.xml{{/code}}
284 )))
285 |flowsnapshotrepository.xml|(((
286 Diccionario de las vistas usuarios usadas en //Self-Service BI//
287
288 Alcance: Visualizacion de los flujos (con edicion en el cuadro de mandos)
289
290 Archivo: {{code language="text" cssClass="notranslate"}}/config/flowsnapshotrepository.xml{{/code}}
291 )))
292 |formatrepository.xml|(((
293 Diccionario des formats de nombres et de dates
294
295 Alcance: Configuracion de los modelos de datos y de los flujos
296
297 Archivo: {{code language="text" cssClass="notranslate"}}/config/formatrepository.xml{{/code}}
298 )))
299 |jsfunctionrepository.xml|(((
300 Diccionario de las funcionnes javascrpt usadas en las medidas calculadas, filtros, transformadores de fuentes, etc.
301
302 Alcance: Configuracion de los modelos de datos y de los flujos
303
304 Archivo: {{code language="text" cssClass="notranslate"}}/config/jsfunctionrepository.xml{{/code}}
305 )))
306 |hierarchyrepository.xml|(((
307 Diccionario de las jerarquias compartidas usadas por las dimensiones de los modelos de datos.
308
309 Alcance: Configuracion de los modelos de datos
310
311 Archivo: {{code language="text" cssClass="notranslate"}}/config/hierarchyrepository.xml{{/code}}
312 )))
313 |navigationsentencerepository.xml|(((
314 Diccionario de las frases creadas para la navigacion video y para el texto de los flujos de tipo Texto
315
316 Alcance: Configiracion de los flujos
317
318 Archivo: {{code language="text" cssClass="notranslate"}}/config/navigationsentencerepository.xml{{/code}}
319 )))
320 |passwordrepository.xml|(((
321 Diccionario de las contraseñas globales. (//Obsoleto//)
322
323 Archivo: {{code language="text" cssClass="notranslate"}}/config/passwordrepository.xml{{/code}}
324 )))
325 |serverurlrepository.xml|(((
326 Diccionario de los servidores de documentos usados en DigDash Enterprise
327
328 Alcance: Configuracion de los modelos de datos
329
330 Archivo: {{code language="text" cssClass="notranslate"}}/config/serverurlrepository.xml{{/code}}
331 )))
332 |vectoriconrepository.xml|(((
333 Diccionario de los iconos vectoriales usados por los graficos de tipo "Infografia"
334
335 Alcance: Configuracion de los flujos
336
337 Archivo: {{code language="text" cssClass="notranslate"}}/config/vectoriconrepository.xml{{/code}}
338 )))
339 |vizmodelrepository.xml|(((
340 Diccionario de los modelos de presentacion compartidos vinculados con flujos.
341
342 Alcance: Configuracion de los flujos
343
344 Archivo: {{code language="text" cssClass="notranslate"}}/config/vizmodelrepository.xml{{/code}}
345 )))
346 |(% colspan="2" %)(((
347 __Archivos comunes del servidor / Archivos de traducciones__
348
349 Los diccionnarios de traducciones agrupan los mensajes en varios idiomas.
350
351 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.
352 )))
353 |dashboard.properties|(((
354 Diccionario de las traducciones usadas en los elementos relativos al cuadro de mandos.
355
356 * Nombre de las paginas
357 * Nombre de los //portlets//
358
359 Archivos:
360
361 * {{code language="text" cssClass="notranslate"}}/config/dashboard.properties{{/code}}
362 * {{code language="text" cssClass="notranslate"}}/config/dashboard_<lang>.properties{{/code}}
363 )))
364 |dm.properties|(((
365 Diccionarios de las traducciones usadas en los modelos de datos y los flujos.
366
367 Alcance: Visualizacion de flujos y de elementos en los cuadros de mandos.
368
369 Archivos:
370
371 * {{code language="text" cssClass="notranslate"}}/config/dm.properties {{/code}}
372 * {{code language="text" cssClass="notranslate"}}/config/dm_<lang>.properties {{/code}}
373 )))
374 |dmvoc.properties|(((
375 Diccionarios de los valores hablados para los mensajes de los modelos de datos.
376
377 Alcance: Exportacion video de los flujos (opcional)
378
379 Archivos:
380
381 * {{code language="text" cssClass="notranslate"}}/config/dmvoc.properties {{/code}}
382 * {{code language="text" cssClass="notranslate"}}/config/dmvoc_<lang>.properties {{/code}}
383 )))
384 |dmtag.properties|(((
385 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.
386
387 Alcance: Busqueda textual en el cuadro de mandos
388
389 Archivos:
390
391 * {{code language="text" cssClass="notranslate"}}/config/dmtag.properties {{/code}}
392 * {{code language="text" cssClass="notranslate"}}/config/dmtag_<lang>.properties {{/code}}
393 )))
394 |(((
395 dashboard<domain>.properties
396
397 //(Obsoleto)//
398 )))|(((
399 Diccionario de los elementos del cuadro de mandos (nombre de las paginas, etc.)
400
401 (% class="box errormessage" %)
402 (((
403 //Estos archivos son obsoletos y no deben ser guardados / restaurados//
404 )))
405 )))
406 |(% colspan="2" %)(((
407 __Archivos comunes del servidor / Otros archivos__
408
409 Otros archivos vinculados a la configuracion de los cuadros de mandos.
410 )))
411 |(((
412 Imagenes
413
414 (*.png, *.jpg, *.gif...)
415 )))|(((
416 Lista de las imagenes agregadas desde el editor de cuadro de mandos.
417
418 Directorios:
419
420 * {{code language="text" cssClass="notranslate"}}/config/web/public/ {{/code}}
421 * {{code language="text" cssClass="notranslate"}}/config/web/public/<Id_Role>/ {{/code}}
422 * {{code language="text" cssClass="notranslate"}}/config/web/public/<utilisateur>/{{/code}}
423 )))
424 |(((
425 Estilos
426
427 default.css
428
429 *.css
430 )))|(((
431 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.
432
433 Archivos:
434
435 * {{code language="text" cssClass="notranslate"}}/config/web/public/default.css{{/code}}
436 * {{code language="text" cssClass="notranslate"}}/config/web/public/*.css{{/code}}
437 )))
438 |js-const.js|(((
439 Constantes del servidor (propriedades que aparecen en la parte //Configuracion > Parametros servidor > Additional parametros > Constantes// y en la parte //Configuracion > Parametros servidor > Exportar configuracion//
440
441 Archivo: {{code language="text" cssClass="notranslate"}}/config/web/session/js-const.js{{/code}}
442 )))
443 |js-default.js|(((
444 Archivo de //script// personalizado del cuadro de mandos. Este archivo se puede editar directamente desde la interfaz de edicion de los cuadros de mandos.
445
446 Archivo: {{code language="text" cssClass="notranslate"}}/config/web/session/js-default.js{{/code}}
447 )))
448 |(% colspan="2" %)(((
449 __Fichiers communs du serveur / Fuentes de datos__
450
451 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.
452 )))