Código fuente wiki de Guide de mise à jour

Última modificación por joshattalidigdashbiz el 2024/05/17 18:02
Mostrar los últimos autores
1
2
3 {{ddtoc/}}
4
5 ----
6
7 = Introducción =
8
9
10 Este guía describe el proceso y las precauciones a coger para actualizar su versión de DigDash Enterprise hacia la nueva versión 2023R2.
11 Presenta también las modificaciones de comportamiento establecidas por esta versión.
12
13 Este guía le concierne ÚNICAMENTE si está respetando las [[buenas prácticas>>path:#Bonnes_pratiques]] descritas en el párrafo dedicado.
14 Si no es su caso, intenta la instalación inicial con la ayuda de la guía de instalación [[Linux>>path:/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/install_guide_ubuntu/]] o [[Windows>>path:/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/install_guide_windows_new/]].
15
16 (% class="box warningmessage" %)
17 (((
18 ❗Si está usando una **base de datos H2** (no recomendado), empieza a trabajar en ello en la versión **2023 R1**. Las versiones anteriores basadas en H2 (DDAudit, Comentarios y DDEntry) no son compatibles con esta versión. Ver el documento [[Migración basada en los datos H2>>path:/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/upgrade_dde/H2_database/]] para tener el detalle de los pasos a seguir.
19 )))
20
21 (% class="box warningmessage" %)
22 (((
23 **Importante : Migración de los desarrollos espec**(% style="font-family:Liberation Serif,serif; line-height:100%" %)í(%%)**ficos (todas versiones)**
24
25 Este proceso no necesita la realización de la migraci(% style="font-family:Liberation Serif,serif; line-height:100%" %)ó(%%)n de los desarrollos específicos (modificación de los logos, añadidura de JSP, scripts de importación de usuarios...) que pueden ser descritas en sus procesos internos.
26 Si los desarrollos específicos son hechos, haga una copia asegurada de su instalación actual para recuperar y migrar todos estos desarrollos.
27 \\**Importante** : Después de la versión 2022R2, el valor del parámetro usuario **langChoice** se convierte en un código y no un index. Por ejemplo, 0 se ha convertido en "en", 1 se ha convertido en "fr". Hay que tener en cuenta este cambio :
28
29 * en la adaptación de sus scripts de importaci(% style="font-family:Liberation Serif,serif; line-height:100%" %)ó(%%)n de usuarios,
30 * en las fórmulas de las medidas, usa ${user.langChoice} para establecer el valor de una medida.
31 * en las fórmulas de filtrado de los que usen ${user.langChoice}.
32 )))
33
34 Los archivos de instalación de DigDash Enterprise son nombrados bajo el modelo **digdash_enterprise_2023R2_64.zip** o **digdash_enterprise_2023R2_numpatch_64.zip**.
35 Después de la extracción, la carpeta aparece en **digdash_enterprise_2023R2_64** o en **digdash_enterprise_2023R2_numpatch_64**.
36
37 Para volver el proceso explícito, la carpeta de instalación de las versiones mas antiguas se nombrará **install_dd_OLD** y la carpeta de instalación de las versiones mas recientes **install_dd_NEW**.
38 El número de versión se puede ver en el archivo version.txt del registro o en la página « **Configuración  / Estatus del servidor** » (« Versión DigDash Enterprise » bajo de la sección « **Estatus general** »).
39
40 **Configuración atendida :**
41
42 * Servidor : **Tomcat 9** (Windows y Linux)
43 * Servidor : **Java 11** (Windows y Linux)
44
45 Bajo Linux necesitará a mínimo instalar Java siguiendo las recomendaciones de la [[Guía de instalación>>path:/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/install_guide_ubuntu/]].
46
47 = Buenas prácticas para la versión 2023 R2{{id name="Bonnes_pratiques"/}}{{id name="Bonnes_pratiques"/}} =
48
49 Para que funcione DigDash Enterprise de manera optimal, es recomendado aplicar los pasos siguientes :
50
51 * Usar el archivo **digdash.properties **para guardar la configuración de los entornos.
52 Para más información sobre los parámetros de los archivos, consulta la [[página de los parámetros del archivo digdash.properties>>path:https://doc.digdash.com/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/upgrade_dde/DigDash.properties/]].
53
54 * Uso de un sistema de base de datos externo para las bases de datos DDAudit, Comentarios y DDEntry.
55 Para más información sobre la instalación de un sistema de base de datos externo, consulta los párrafos :
56 ** [[Instalación de MariaDB>>path:https://doc.digdash.com/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/install_guide_windows_new/#DB_windows]] para un entorno de producción Windows.
57 ** [[MariaDB (Recomendado)>>path:https://doc.digdash.com/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/install_guide_ubuntu/#DB_ubuntu]] para un entorno de producción Ubuntu.
58
59 * Uso de un Tomcat aparte de la instalación de DigDash (instalación para la gestión de los paquetes OS).
60 Para más información sobre la instalación de un Tomcat apartado, consulta los párrafos :
61 ** [[Instalación de Tomcat 9>>path:https://doc.digdash.com/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/install_guide_windows_new/#Tomcat_windows]] para un entorno de producción Windows.
62 ** [[Tomcat 9>>path:https://doc.digdash.com/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/install_guide_ubuntu/#Tomcat_ubuntu]] para un entorno de producción Ubuntu.
63
64 * Uso de OpenLDAP en vez de adswrapper.
65 Para más información sobre la instalación de OpenLDAP, consulta los párrafos :
66 ** [[Instalación de OpenLDAP>>path:https://doc.digdash.com/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/install_guide_windows_new/#OpenLDAP_windows]] para un entorno de producción Windows
67 ** [[Configuración de OpenLDAP>>path:https://doc.digdash.com/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/install_guide_ubuntu/#OpenLDAP_ubuntu]] para un entorno de producción Ubuntu
68
69 = Actualización de DigDash Enterprise hacia la versión 2023 R2{{id name="Premier_deploiement"/}} =
70
71
72 Este párrafo le concierne si actualiza DigDash Enterprise desde una versión 2021 R1 o ulterior hacia la versión 2023 R2.
73 Para actualizar una versión 2021 R1 o anterior, por favor contacta DigDash a la dirección [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__contact@digdash.com__>>path:mailto:contact@digdash.com]](%%).
74
75 (% class="box warningmessage" %)
76 (((
77 Los **controladores JDBC** son actualizados y son necesarios a algunas instalaciones. Por favor, verifica sus necesidades en el documento siguiente : [[Añadidura Controlador JDBC ~> Controladores pre configurados non incluidos>>url:https://doc.digdash.com/xwiki/wiki/dd2023r2/view/Digdash/deployment/Connectivity_Database/adding_jdbc_driver/#HDriversprE9configurE9snoninclus]].
78 )))
79
80 (% class="box warningmessage" %)
81 (((
82 El **módulo DDAudit** es modificado en versión 2023R1. Para saber más sobre las instrucciones relacionadas, consulta el párrafo [[Modificación del módulo DDAudit>>path:#DDAudit]].
83 )))
84
85 == Proceso de actualización ==
86
87 === Paso 1 : Configuración del respaldo ===
88
89 Haga un respaldo completo de su configuración : entradas LDAP (usuarios, roles, grupos de autorizaciones), modelos de datos, cuadros de mandos, etc.
90 Si ha adaptado los archivos para su instalación (modificación de los logos, imágenes, CSS, añadidura de JSP, ...) tendrá que transferirlos en la nueva instalación.
91 Consulta la documentación [[Respaldo y restauración>>path:/xwiki/wiki/dd2023r2/view/Digdash/deployment/configuration/backup_restore/]].
92
93 === Paso 2 : Interrupción del servidor ===
94
95 Apaga el servidor DigDash :
96
97 * **Bajo Windows** : haga clic en su servicio ("Tomcat 9" por defecto), y haga clic en **Apagar** desde su aplicación **Servicios** de Windows.
98 * **Bajo Linux** : usa el comando (% id="cke_bm_1864S" style="display:none" %)** **(%%)** **##{{code language="shell"}}service tomcat9 stop{{/code}}##
99
100 === Paso 3 : Respaldo y supresión de las antiguas aplicaciones ===
101
102 Guarda y luego suprime los archivos y carpetas de **<install_dd>/webapps :**
103
104 |(((
105 Carpetas :
106
107 * adminconsole
108 * ddenterpriseapi
109 * digdash_dashboard
110 * studio
111 )))|(((
112 Archivos :
113
114 * adminconsole.war
115 * ddenterpriseapi.war
116 * digdash_dashboard.war
117 * studio.war
118 )))
119
120 (% class="box warningmessage" %)
121 (((
122 **❗La carpeta ROOT** no ha sido tratada todavía.
123 )))
124
125 === Paso 4 : Pegar las nuevas aplicaciones ===
126
127 Extraer la nueva versión del producto en una carpeta temporaria.
128
129 Acceda a la carpeta temporaria únicamente en la **carpeta de las aplicaciones Web**.
130 Copiar los archivos a continuación en su carpeta de instalación :
131
132 * adminconsole.war
133 * ddenterpriseapi.war
134 * digdash_dashboard.war
135 * studio.war
136
137 La carpeta **webapps** ya debe contener 4 archivos .war y la carpeta **ROOT**.
138
139 === Paso 5 : Recuperación de los módulos complementarios ===
140
141 Copiar el contenido de los **módulos complementarios** de la carpeta hacia la misma dirección dentro de su instalación.
142 Si ha modificado algunos archivos (**importtools**, **backuptools**, ...), guárdalos y cópialos.
143
144 === Paso 6 : Reactivación del servidor ===
145
146 Reactiva el servidor DigDash :
147
148 * **Bajo Windows :** haga clic en su servicio (« Tomcat 9 » por defecto), y haga clic en **Iniciar** desde su aplicación **Servicios** de Windows.
149 * **Bajo Linux :** usa el comando (% id="cke_bm_2249S" style="display:none" %)## ##(%%)##{{code language="shell"}}service tomcat9 restart{{/code}}##
150
151 y deja Tomcat instalar sus nuevas aplicaciones.
152
153 Bajo Linux, ayúdese del [[Guía de instalación Linux>>path:/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/install_guide_ubuntu/]].
154 Bajo Windows, ayúdese del [[Guía de instalación Windows>>path:/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/install_guide_windows_new/]].
155
156 === Paso 7 : Reparación ===
157
158 Si ha configurado su nueva instalación para apuntar hacia su carpeta de datos precedente, la reparación no es necesaria.
159
160 Sino (nueva carpeta de datos), usa el respaldo del paso 1 para restaurar las entradas LDAP (usuarios, roles, grupos de autorización).
161
162 (% class="box warningmessage" %)
163 (((
164 **Importante** : Si ha hecho modificaciones en las carpetas **ddenterpriseapi **y **digdash_dashboard **sobre archivos de configuración (web.xml, ...), imágenes o archivos CSS, deberá transferirlos.
165 )))
166
167 === Paso 8 : Limpieza del caché del navegador ===
168
169 Suprimir el caché del navegador (atajo en la mayoridad de los navegadores : Ctrl + Shift + Suppr).
170
171 === Paso 9 : Regeneración de los modelos de datos ===
172
173 (% class="box infomessage" %)
174 (((
175 La regeneración de los modelos de datos es recomendada en el caso de una subida de versión importante.
176 )))
177
178 En la línea **Flujos** del Studio, haga clic en cada cartera de flujos y haga clic en **Sincronizar para todos los usuarios**.
179
180 En la casilla **Confirmar la sincronización de la cartera**, marca la casilla **Forzar la generación de los cubos de datos de los flujos seleccionados** y luego la casilla **Forzar la generación de todos los cubos dependientes**.
181
182 [[image:1710168521497-204.png||data-xwiki-image-style-alignment="center"]]
183
184 == Modificación del módulo DDAudit{{id name="DDAudit"/}} ==
185
186 El módulo DDAudit ha sido modificado en versión 2023 R1. Si ha desplegado DDAudit en la versión anterior, aplica las instrucciones siguientes :
187
188 * Si no ha modificado los modelos y los flujos de DDAudit, y si no ha creado nuevos modelos y flujos, es recomendado desinstalar el módulo DDAudit, suprimiendo el rol y sus datos, e instalar lo de nuevo con el archivo .zip de instalación de esta nueva versión, o pasando por el gestor DigDash Metadata Service desde el Studio.
189 * Si ha creado sus propios modelos y flujos para el DDAudit, o si ha modificado los modelos de datos, debe modificar las consultas SQL de los modelos de datos modificados o creados para reemplazar el campo **user** con **dd_user** en vez (los nombres de las dimensiones y medidas no cambian).
190
191 (% class="box warningmessage" %)
192 (((
193 ❗Si está usando H2 como base de datos para DDAudit (no recomendado), puede migrar su base de datos anterior (ver el documento [[Migración de base de datos H2>>path:/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/upgrade_dde/H2_database/]]) antes de poder realizar estas modificaciones.
194 )))
195
196 = Modificaciones de comportamiento en la 2023 R2 =
197
198 {{id name="Deploiement_patch"/}}
199
200 Las nuevas funcionalidades y soluciones de bugs en 2023 R2 son al origen de modificaciones comportamentales susceptibles de tener un impacto. Es recomendado consultar la lista de las modificaciones comportamentales a continuación.
201
202 (% class="box" %)
203 (((
204 💡 Los elementos con un asterisco son los para los cuales es posible, si necesario, restablecer el comportamiento anterior. Consulta por favor el párrafo [[Recuperación de los comportamientos anteriores>>https://doc.digdash.com/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/upgrade_dde/?language=fr#]] para más información.
205 )))
206
207 == Seguridad ==
208
209 **Visualización de los cubos**
210
211 El usuario tiene entonces la autorización **//de gestionar los servidores//** y de añadir el parámetro **//showCubes=true //**en la URL para enseñar los cubos en la página de Respaldo.
212
213 **Importación de archivos desde el Asistente de creacion de Cuadro de Mando**
214
215 El usuario debe ahora tener la autorización (ACL) **//Subir un documento//** para importar archivos en el Asistente de Creación de Cuadro de Mando.
216
217 == Fuente de datos ==
218
219 **Postgreqsl**
220
221 El elemento AUTO_COMMIT es desactivado por defecto para las exigencias sobre las fuentes de datos.
222
223 == Gestión de los usuarios ==
224
225 Para las páginas de cuadro de mandos y los Objetos de cuadros accesibles, el valor de los usuarios ahora es concatenado con los valores de los perfiles que les son atribuidos.
226
227 == Parámetros del servidor ==
228
229 La modificación de los parámetros de las bases de datos de Auditoria y de Comentarios no necesita más la explotación del servidor.
230
231 == Respaldo ==
232
233 Cuando se hace un respaldo, si elijamos la opción "Exportar los archivos dependientes (fuentes de datos del servidor Common Datasources, imagines, hojas de estilo...), las imágenes de referencia en los cuadros de mandos ahora son las mismas.
234
235 == Studio ==
236
237 La interfaz de edición de los gráficos ha sido adaptada para mejorar la experiencia del usuario.
238 Un conjunto de funcionalidades / propiedades han sido desplazadas. Consulta la página [[Cambios edición de gráficos>>path:/xwiki/wiki/dd2023r2/view/Digdash/user_guide/studio/Find_items/]] para obtener mas información.
239
240 == Fábricas de documentos ==
241
242 El mecanismo de numeración de las páginas cambia.
243 Las fábricas de documentos en las cuales la numeración de las páginas estaba activa hasta ahora, van a generar una zona de texto bajo de la página en la derecha cuyo contenido es //${builder.pageIndex}/${builder. pageCount}  // (número de la página/nombre de las páginas)//.//
244
245 == Editor de cuadros de mando ==
246
247 **Fondo**
248
249 Si un fondo es definido en la interfaz **Parámetros -> Propiedades -> Cuadro de mando**, ahora se aplica por defecto a todos los nuevos roles añadidos.
250
251 [[image:1710168342993-884.png]]
252
253 **Tema**
254
255 El archivo CSS por defecto "default.css" no está más cargado automáticamente.
256 Para los usuarios que utilizan "default.css", ningún CSS estará cargado. Para continuar a usarlo, hay que definirlo en el **Editor de cuadro de mando -> Propiedades -> Tema**.
257
258 == Gráficos ==
259
260 **Ordenación en las tablas**
261
262 La flecha de ordenación ahora es ubicada a la izquierda de la celda (para evitar una superposición con el texto).
263
264 **Paginación de las tablas**
265
266 Un nuevo método de paginación para los grandes cuadros permite evitar los tiempos de carga largos.
267 Por defecto, la paginación es activada con un límite de 100 líneas por página y el desafilamiento virtual es desactivado.
268 Los botones de paginación son desactivados si el número de líneas de la página inicial es inferior al número de líneas máximo definido en la interfaz usuario (100 por defecto).
269
270 == Exportar ==
271
272 **Nombre de archivo**
273
274 El nombre del archivo exportado ahora es el nombre del flujo sin guion. Por ejemplo, //"Mi flujo"// será exportado en el archivo //"Mi flujo"//, mientras que antes estaba exportado en el archivo //"Mi_flujo"//.
275
276 **Tabla pivot**
277
278 Durante la exportación Excel sin estilos de una tabla pivot, los encabezados ahora son fusionados.
279
280 **Exportar Excel**
281
282 La exportación Excel sin los estilos ahora es permitida solamente para las tablas.
283
284 **Tamaño de tipo de letra proporcionalmente al tamaño del gráfico**
285
286 La opción **Tamaño de fuente de letras proporcional al tamaño del gráfico** no es más disponible en los gráficos de tipos Tablas, Reportes HTML y Reportes Texto. Si esta opción ha sido activada en una versión anterior, no funcionará más.
287
288 == DDAudit ==
289
290 **Lista de los cubos** *
291
292 La lista de los cubos actualizados en la base de datos de auditoria no es más limpiada cada día. Ahora es conservado durante 6 meses (parámetro por defecto) en la base de datos.
293
294 **Memoria**
295
296 En el DDAudit, el campo Memoria ahora corresponde al tamaño real del cubo en memoria.
297
298 == Diversos ==
299
300 **Tamaño de un cubo en memoria**
301
302 El tamaño de un cubo en memoria ahora incluye el tamaño de los datos relacionados. Entonces, el tamaño evoluciona después de la carga del cubo, en función de la carga y del uso de los datos.
303
304 **Scripts y fechas**
305
306 El método getFullYear() ahora es disponible para obtener la fecha. Devuelve el año de la fecha ensenada según la hora local.
307 Antes faltaba usar getYear() + 1900. Este método sigue utilizable, pero no es recomendado.
308
309 == Recuperación de comportamientos anteriores ==
310
311 Puede ser interesante en algunos casos de restablecer el comportamiento anterior.
312 Por eso, falta editar el archivo system.xml ubicado en **<DD Install>/Enterprise Server/ddenterpriseapi/config/system.xml** y añadir una línea de propiedad que especifique el comportamiento.
313 Esta operación necesita reiniciar el servidor DigDash.
314
315 **Lista de los cubos**
316
317 Modifique el valor de la propiedad siguiente y remplázalo con //false// :
318 <Property key=" PROP_AUDIT_KEEP_MISSING_CUBES" value="false"/>
319
320 = Despliegue de un correctivo sur 2023 R2{{id name="Deploiement_patch"/}} =
321
322 Ce paragraphe concerne la mise à jour d'une version 2023 R2 vers une autre 2023 R2 plus récente.
323
324 Este párrafo trata de la actualización de una versión 2023 R2 hacia otra 2023 R2 más reciente.
325
326 On considère ici que votre configuration suit la recommandation d'utiliser le fichier **digdash.properties**. Si cela n'est pas fait, référez-vous au paragraphe [[Bonnes pratiques pour la version 2023 R2>>url:https://doc.digdash.com/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/upgrade_dde/?language=fr#Bonnes_pratiques]].
327
328 Consideramos aquí que su configuración sigue la recomendación del uso del archivo digdash.properties. Si no está hecho, vuelve al párrafo [[Buenas prácticas para la versión 2023 R2>>https://doc.digdash.com/xwiki/wiki/dd2023r2/view/Digdash/deployment/installation/upgrade_dde/?language=fr#Bonnes_pratiques]].
329
330 (% class="box warningmessage" %)
331 (((
332 Si votre installation contient les développements spécifiques, vous les retrouverez dans les dossiers des applications :
333 **<install_dd>/apache-tomcat/webapps/ddenterpriseapi** ou  **<install_dd>/apache-tomcat/webapps/digdash_dashboard**
334 ne seront pas perdus aujourd'hui. Sauvegardez-les avant toute autre opération, afin de pouvoir les reporters après mise à jour.
335
336 Si su instalación contiene desarrollos específicos, les pueden encontrar en las carpetas de las aplicaciones :
337 **<install_dd>/apache-tomcat/webapps/ddenterpriseapi** o  **<install_dd>/apache-tomcat/webapps/digdash_dashboard**
338 Estarán perdidos después de la actualización. Guárdelos antes de cualquier otra operación, para poder importarles de nuevo después.
339 )))
340
341 La procédure de déploiement d'un patch est désormais identique à la mise à jour de version. Vous pouvez donc suivre la procédure détaillée ci-dessus.
342
343 El proceso de despliegue de un correctivo ahora es idéntico a la actualización de la versión. Puede entonces seguir el proceso detallado encima.