Guía de actualización
- Introducción
- Buenas prácticas para la versión 2023 R2
- Actualización de DigDash Enterprise hacia la versión 2023 R2
- Proceso de actualización
- Paso 1 : Configuración del respaldo
- Paso 2 : Interrupción del servidor
- Paso 3 : Respaldo y supresión de las antiguas aplicaciones
- Paso 4 : Pegar las nuevas aplicaciones
- Paso 5 : Recuperación de los módulos complementarios
- Paso 6 : Reactivación del servidor
- Paso 7 : Reparación
- Paso 8 : Limpieza del caché del navegador
- Paso 9 : Regeneración de los modelos de datos
- Modificación del módulo DDAudit
- Proceso de actualización
- Modificaciones de comportamiento en la 2023 R2
- Despliegue de un correctivo sur 2023 R2
Introducción
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.
Presenta también las modificaciones de comportamiento establecidas por esta versión.
Este guía le concierne ÚNICAMENTE si está respetando las buenas prácticas descritas en el párrafo dedicado.
Si no es su caso, intenta la instalación inicial con la ayuda de la guía de instalación Linux o Windows.
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.
Después de la extracción, la carpeta aparece en digdash_enterprise_2023R2_64 o en digdash_enterprise_2023R2_numpatch_64.
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.
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 »).
Configuración atendida :
- Servidor : Tomcat 9 (Windows y Linux)
- Servidor : Java 11 (Windows y Linux)
Bajo Linux necesitará a mínimo instalar Java siguiendo las recomendaciones de la Guía de instalación.
Buenas prácticas para la versión 2023 R2
Para que funcione DigDash Enterprise de manera optimal, es recomendado aplicar los pasos siguientes :
- Usar el archivo digdash.properties para guardar la configuración de los entornos.
Para más información sobre los parámetros de los archivos, consulta la página de los parámetros del archivo digdash.properties.
- Uso de un sistema de base de datos externo para las bases de datos DDAudit, Comentarios y DDEntry.
Para más información sobre la instalación de un sistema de base de datos externo, consulta los párrafos :- Instalación de MariaDB para un entorno de producción Windows.
- MariaDB (Recomendado) para un entorno de producción Ubuntu.
- Uso de un Tomcat aparte de la instalación de DigDash (instalación para la gestión de los paquetes OS).
Para más información sobre la instalación de un Tomcat apartado, consulta los párrafos :- Instalación de Tomcat 9 para un entorno de producción Windows.
- Tomcat 9 para un entorno de producción Ubuntu.
- Uso de OpenLDAP en vez de adswrapper.
Para más información sobre la instalación de OpenLDAP, consulta los párrafos :- Instalación de OpenLDAP para un entorno de producción Windows
- Configuración de OpenLDAP para un entorno de producción Ubuntu
Actualización de DigDash Enterprise hacia la versión 2023 R2
Este párrafo le concierne si actualiza DigDash Enterprise desde una versión 2021 R1 o ulterior hacia la versión 2023 R2.
Para actualizar una versión 2021 R1 o anterior, por favor contacta DigDash a la dirección contact@digdash.com.
Proceso de actualización
Paso 1 : Configuración del respaldo
Haga un respaldo completo de su configuración : entradas LDAP (usuarios, roles, grupos de autorizaciones), modelos de datos, cuadros de mandos, etc.
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.
Consulta la documentación Respaldo y restauración.
Paso 2 : Interrupción del servidor
Apaga el servidor DigDash :
- Bajo Windows : haga clic en su servicio ("Tomcat 9" por defecto), y haga clic en Apagar desde su aplicación Servicios de Windows.
- Bajo Linux : usa el comando service tomcat9 stop
Paso 3 : Respaldo y supresión de las antiguas aplicaciones
Guarda y luego suprime los archivos y carpetas de <install_dd>/webapps :
Carpetas :
| Archivos :
|
Paso 4 : Pegar las nuevas aplicaciones
Extraer la nueva versión del producto en una carpeta temporaria.
Acceda a la carpeta temporaria únicamente en la carpeta de las aplicaciones Web.
Copiar los archivos a continuación en su carpeta de instalación :
- adminconsole.war
- ddenterpriseapi.war
- digdash_dashboard.war
- studio.war
La carpeta webapps ya debe contener 4 archivos .war y la carpeta ROOT.
Paso 5 : Recuperación de los módulos complementarios
Copiar el contenido de los módulos complementarios de la carpeta hacia la misma dirección dentro de su instalación.
Si ha modificado algunos archivos (importtools, backuptools, ...), guárdalos y cópialos.
Paso 6 : Reactivación del servidor
Reactiva el servidor DigDash :
- Bajo Windows : haga clic en su servicio (« Tomcat 9 » por defecto), y haga clic en Iniciar desde su aplicación Servicios de Windows.
- Bajo Linux : usa el comando service tomcat9 restart
y deja Tomcat instalar sus nuevas aplicaciones.
Bajo Linux, ayúdese del Guía de instalación Linux.
Bajo Windows, ayúdese del Guía de instalación Windows.
Paso 7 : Reparación
Si ha configurado su nueva instalación para apuntar hacia su carpeta de datos precedente, la reparación no es necesaria.
Sino (nueva carpeta de datos), usa el respaldo del paso 1 para restaurar las entradas LDAP (usuarios, roles, grupos de autorización).
Paso 8 : Limpieza del caché del navegador
Suprimir el caché del navegador (atajo en la mayoridad de los navegadores : Ctrl + Shift + Suppr).
Paso 9 : Regeneración de los modelos de datos
En la línea Flujos del Studio, haga clic en cada cartera de flujos y haga clic en Sincronizar para todos los usuarios.
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.
Modificación del módulo DDAudit
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 :
- 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.
- 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).
Modificaciones de comportamiento en la 2023 R2
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.
💡 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 para más información.
Seguridad
Visualización de los cubos
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.
Importación de archivos desde el Asistente de creacion de Cuadro de Mando
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.
Fuente de datos
Postgreqsl
El elemento AUTO_COMMIT es desactivado por defecto para las exigencias sobre las fuentes de datos.
Gestión de los usuarios
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.
Parámetros del servidor
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.
Respaldo
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.
Studio
La interfaz de edición de los gráficos ha sido adaptada para mejorar la experiencia del usuario.
Un conjunto de funcionalidades / propiedades han sido desplazadas. Consulta la página Cambios edición de gráficos para obtener mas información.
Fábricas de documentos
El mecanismo de numeración de las páginas cambia.
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).
Editor de cuadros de mando
Fondo
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.
Tema
El archivo CSS por defecto "default.css" no está más cargado automáticamente.
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.
Gráficos
Ordenación en las tablas
La flecha de ordenación ahora es ubicada a la izquierda de la celda (para evitar una superposición con el texto).
Paginación de las tablas
Un nuevo método de paginación para los grandes cuadros permite evitar los tiempos de carga largos.
Por defecto, la paginación es activada con un límite de 100 líneas por página y el desafilamiento virtual es desactivado.
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).
Exportar
Nombre de archivo
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".
Tabla pivot
Durante la exportación Excel sin estilos de una tabla pivot, los encabezados ahora son fusionados.
Exportar Excel
La exportación Excel sin los estilos ahora es permitida solamente para las tablas.
Tamaño de tipo de letra proporcionalmente al tamaño del gráfico
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.
DDAudit
Lista de los cubos *
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.
Memoria
En el DDAudit, el campo Memoria ahora corresponde al tamaño real del cubo en memoria.
Diversos
Tamaño de un cubo en memoria
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.
Scripts y fechas
El método getFullYear() ahora es disponible para obtener la fecha. Devuelve el año de la fecha ensenada según la hora local.
Antes faltaba usar getYear() + 1900. Este método sigue utilizable, pero no es recomendado.
Recuperación de comportamientos anteriores
Puede ser interesante en algunos casos de restablecer el comportamiento anterior.
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.
Esta operación necesita reiniciar el servidor DigDash.
Lista de los cubos
Modifique el valor de la propiedad siguiente y remplázalo con false :
<Property key=" PROP_AUDIT_KEEP_MISSING_CUBES" value="false"/>
Despliegue de un correctivo sur 2023 R2
Ce paragraphe concerne la mise à jour d'une version 2023 R2 vers une autre 2023 R2 plus récente.
Este párrafo trata de la actualización de una versión 2023 R2 hacia otra 2023 R2 más reciente.
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.
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.
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.
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.