Guide de mise à jour

Modifié par Aurelie Bertrand le 2026/06/29 15:38

Introduction

 ⚠ UNE FOIS LA MISE À JOUR VERS LA VERSION 2026 R1 EFFECTUÉE, IL N'EST PAS POSSIBLE DE REVENIR À UNE VERSION ANTÉRIEURE.  ⚠

Ce guide décrit la procédure et les précautions à prendre pour mettre à jour votre version DigDash Enterprise vers la nouvelle version 2026 R1.

Il vous concerne UNIQUEMENT si vous respectez les bonnes pratiques décrites dans le paragraphe dédié.
Si ce n'est pas le cas, reprenez l'installation de zéro selon le guide d'installation Linux ou Windows.

Important : Migration des développements spécifiques (toutes versions)

Cette procédure ne prend pas en compte la migration de développements spécifiques (modification de logos, adjonction de JSP, scripts d'import utilisateurs...) qui peut être décrite dans vos procédures internes.
Si des développements spécifiques ont été faits, procédez à une copie de sauvegarde de votre installation actuelle afin de pouvoir récupérer et migrer tous ces développements.

Les archives d’installation de DigDash Enterprise sont nommées sous la forme:
digdash_enterprise_2026R1_t10.zip ou digdash_enterprise_2026R1_numpatch_t10.zip (par exemple, digdash_enterprise_2026R1_P01_t10.zip pour le patch P01)

Après extraction, le dossier s’appellera :
digdash_enterprise_2026R1_t10 ou digdash_enterprise_2026R1_numpatch_t10.

Pour expliciter la procédure, le dossier d’installation de la plus ancienne des versions sera nommé install_dd_OLD et le dossier d’installation de la plus récente des versions install_dd_NEW.
Le numéro de version est visible en bas de la page d'accueil DigDash (ou dans le fichier version.txt de l'archive).

Configuration supportée :

⚠ Depuis cette version 2026 R1, Tomcat 9 n'est plus supporté. Seul Tomcat 10 est supporté.

  • Serveur : Tomcat 10 uniquement (Windows et Linux: Ubuntu 24.04).
  • Serveur : Java 17, Java 21 et Java 25 (Windows et Linux)

Bonnes pratiques pour la version 2026 R1

Pour un fonctionnement optimal de DigDash Enterprise, il est recommandé d'appliquer les préconisations suivantes :

  • Utilisation du fichier digdash.properties pour stocker la configuration des environnements.
    Pour plus d'informations sur le paramétrage du fichier, consultez la page Paramétrage du fichier digdash.properties.
     
  • Utilisation d'un système de base de données externe pour les bases DDAudit, Comments et DDDataEntry.
    Pour plus d'informations sur l'installation d'un système de base de données externe, consultez le paragraphe :
  • Utilisation d'un Tomcat séparé de l'installation Digdash (installation par le gestionnaire de package de l'OS).
    Pour plus d'informations sur l'installation d'un Tomcat séparé, consultez le paragraphe :
  • Utilisation de OpenDJ à la place de adswrapper (adswrapper n'est plus livré).
    Pour plus d'informations sur l'installation de OpenDJ, consultez le paragraphe :

Mise à jour de DigDash Enterprise vers la version 2026 R1

Ce paragraphe vous concerne si vous mettez à jour DigDash Enterprise depuis une version 2024 R2 ou ultérieure vers la version 2026 R1.
Pour une mise à jour depuis une version antérieure à la version 2024 R2, veuillez contacter DigDash à l’adresse contact@digdash.com.

Les drivers JDBC ont été mis à jour et nécessitent pour certains d'être réinstallés. Merci de vérifier selon vos besoins dans le document suivant : Ajout Pilote JDBC > Drivers préconfigurés non inclus.

Procédure de mise à jour

Étape 1 : Sauvegarde de la configuration

Effectuez une sauvegarde complète de votre configuration : entrées LDAP (utilisateurs, rôles, groupes d'autorisations), modèles de données, tableaux de bord, etc.
Si vous aviez ajouté des fichiers à votre installation (modification de logos, images, css, adjonction de JSP, ...) il faudra les reporter dans la nouvelle installation.
Consultez la documentation Sauvegarde et restauration.

Étape 2 : Arrêt du serveur

Arrêtez le serveur DigDash :

  • Sous Windows : cliquez-droit sur votre service, puis cliquez sur Arrêter depuis votre application Services de Windows.
  • Sous Linux : utilisez la commande sudo service tomcat10 stop

Étape 3 : Sauvegarde et suppression des anciennes applications

Sauvegardez puis effacez les fichiers et dossiers de <install_dd>/webapps :

Dossiers :

  • adminconsole
  • ddenterpriseapi
  • digdash_dashboard
  • studio

Fichiers :

  • adminconsole.war
  • ddenterpriseapi.war
  • digdash_dashboard.war
  • studio.war

⚠ Ne pas effacer le dossier ROOT.

Étape 4 : Copie des nouvelles applications

Dézippez la nouvelle version du produit dans un emplacement temporaire.

Naviguez dans ce dossier temporaire jusque dans le dossier webapps.
Copiez les fichiers suivants dans le même dossier de votre installation :

  • adminconsole.war
  • ddenterpriseapi.war
  • digdash_dashboard.war
  • studio.war

Le dossier webapps doit maintenant contenir 4 fichiers .war et le dossier ROOT.

Étape 5 : Récupération des add-ons

Copiez le contenu du répertoire add-ons vers le même endroit dans votre installation.
Si vous aviez modifié certains fichiers (importtools, backtuptools, ...) sauvegardez-les avant la copie.

Étape 6 : Modification de la variable JAVA_OPTS

Des paramètre doivent être ajoutés à la variable JAVA_OPTS.

Sur Linux

  1. Éditez le fichier suivant:

        sudo vi /etc/default/tomcat10 

  1. Ajoutez les paramètres -Dfile.encoding=UTF-8 et --add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED --add-opens=java.base/sun.security.ssl=ALL-UNNAMED --add-opens=java.base/sun.security.util=ALL-UNNAMED à la variable JAVA_OPTS afin d'obtenir le résultat suivant:
JAVA_OPTS="-Djava.awt.headless=true -Xms6G -Xmx6G -Djava.security.egd=file:/dev/urandom -Dfile.encoding=UTF-8 -DPROP_MAX_CONCURRENT_TOTAL=5000 -DPROP_MAX_CONCURRENT_CON_PER_HOST=5000 --add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED --add-opens=java.base/sun.security.ssl=ALL-UNNAMED --add-opens=java.base/sun.security.util=ALL-UNNAMED"

Sur Windows

  1. Allez dans le répertoire d’installation de Tomcat puis dans le répertoire bin et lancer tomcat10w.exe.
  2. Allez dans l’onglet Java.

  3. Ajoutez le paramètre -Dfile.encoding=UTF-8 dans Java Options comme suit:
    Encodage

  4. Ajoutez les paramètres --add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED --add-opens=java.base/sun.security.ssl=ALL-UNNAMED --add-opens=java.base/sun.security.util=ALL-UNNAMED dans Java 9 Options.

Étape 7 : Redémarrage du serveur

Redémarrez le serveur DigDash :

  • Sous Windows : cliquez-droit sur votre service, puis cliquez sur Démarrer depuis votre application Services de Windows.

  • Sous Linux : utilisez la commande sudo service tomcat10 start

et laissez Tomcat redéployer les nouvelles applications.

Sous Linux, reportez-vous au Guide d'installation Linux.
Sous Windows, reportez-vous Guide d'installation Windows.

Étape 8 : Restauration

Si vous avez configuré votre nouvelle installation pour pointer sur votre ancien dossier des données ET votre ancien LDAP, la restauration n'est pas nécessaire.

Si vous pointez vers un nouveau dossier des données, utilisez la sauvegarde de l’étape 2 pour restaurer les fichiers de données (modèles, portefeuilles, tableaux de bord, etc).
De même si vous pointez vers un nouveau dossier LDAP pour restaurer les entrées LDAP (utilisateurs, rôles, groupes d'autorisations),

Important : si vous aviez fait des modifications dans les dossiers ddenterpriseapi et digdash_dashboard sur des fichiers de configuration (web.xml, ...), des images ou des fichiers css, vous devrez les reporter.

Étape 9 : Nettoyage du cache du navigateur

Supprimez le cache du navigateur (raccourcis sur la plupart des navigateurs : Ctrl + Shift + Suppr).

Étape 10 : Régénération des modèles de données

💡 La régénération des modèles de données est recommandée dans le cas d'une montée de version majeure.

L'évènement EVENT_REFRESHFLOW_FORCEALL permet de rafraîchir tous les flux du système (sauf les flux désactivés) et de forcer la régénération de tous les cubes.

  • Entrez l'URL* sous la forme suivante dans le navigateur pour appeler cet événement via fireevent.
    http://localhost:8080/ddenterpriseapi/fireevent?eventid=EVENT_REFRESHFLOW_FORCEALL

    * Remplacez http://localhost:8080/ par l'adresse de votre environnement DigDash et ddenterpriseapi par le nom de votre domaine.

Étape 11 : Réinitialisation des groupes d'autorisations par défaut

De nouvelles autorisations ont été ajoutées. Il est nécessaire de rénitialiser les groupes d'autorisations fournis par DigDash pour leur bonne prise en compte.

⚠ Si vous aviez modifié les groupes d'autorisations, ces modifications seront perdues.

Pour cela :

  1. Allez dans Configuration > Gestion des utilisateurs > Groupes d'autorisations : tous les groupes d'autorisations y sont listées.
  2. Cliquez sur le lien Réinitialiser les groupes d'autorisations par défaut.
    ➡ Un message de confirmation s'affiche.
  3. Cliquez sur OK.

Étape 12 : Réinitialisation des thèmes digdash_2024 et digdash_2019

Les thèmes digdash_2019 et digdash_2024 ont été modifiés. Ils doivent donc être réinitialisés.

Pour cela : 

  1. Depuis le Studio, ouvrez le Gestionnaires de styles.
  2. Cliquez-droit sur le thème digdash_2024, respectivement digdash_2019, puis cliquez sur Réinitialiser.
  3. Cliquez sur OK.

Dans le cas où vous utilisiez un thème digdash_2019 ou digdash_2024 personnalisé:

  1. Récupérez les modifications/ajouts effectués à l'intérieur de la feuille de styles et sauvegardez-les à part.
  2. Réinitialisez le thème comme décrit dans le paragraphe précédent.
  3. Créez un nouveau thème personnalisé à l'aide de l'Éditeur de thèmes. Consultez la page Éditeur de thèmes pour une description détaillée.
  4. Réappliquez-y les modifications/ajouts via l'interface.
  5. Allez dans Configuration -> Paramètres serveur -> Paramètres supplémentaires -> Divers pour sélectionner le nouveau thème personnalisé comme thème serveur.

Changements de comportement

De nouvelles fonctionnalités ou la résolution de bugs dans la 2026 R1 sont à l'origine de modifications de comportement susceptibles d'avoir un impact. Il est donc recommandé de consulter la liste des modifications de comportement disponibles sur la page dédiée : Changements de comportement.

Déploiement d'un patch sur une 2026 R1

Ce paragraphe concerne la mise à jour d'une version 2026 R1 vers une autre 2026 R1 plus récente.

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 2026 R1.

⚠ Si votre installation contient des développements spécifiques, qui se trouvent dans les dossiers des applications :
<install_dd>/apache-tomcat/webapps/ddenterpriseapi ou <install_dd>/apache-tomcat/webapps/digdash_dashboard
ils seront perdus lors de la mise à jour. Sauvegardez-les avant toute autre opération, afin de pouvoir les reporter après mise à jour.

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.