Code source wiki de Guide de mise à jour

Modifié par Aurelie Bertrand le 2026/06/29 15:38
Afficher les derniers auteurs
1 {{ddtoc/}}
2
3 ----
4
5 = Introduction =
6
7 (% class="box warningmessage" %)
8 (((
9 **~ ⚠ UNE FOIS LA MISE À JOUR VERS LA VERSION 2026 R1 EFFECTUÉE, IL __N'EST PAS POSSIBLE __DE REVENIR À UNE VERSION ANTÉRIEURE.  ⚠**
10 )))
11
12 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.
13
14 Il vous concerne UNIQUEMENT si vous respectez les [[bonnes pratiques>>doc:||anchor="Bonnes_pratiques"]] décrites dans le paragraphe dédié.
15 Si ce n'est pas le cas, reprenez l'installation de zéro selon le guide d'installation [[Linux>>doc:Digdash.deployment.installation.Ubuntu24.WebHome]] ou [[Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome]].
16
17 (% class="box warningmessage" %)
18 (((
19 **Important : Migration des développements spécifiques (toutes versions)**
20 \\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.
21 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.
22 )))
23
24 Les archives d’installation de DigDash Enterprise sont nommées sous la forme:
25 **digdash_enterprise_2026R1_t10.zip** ou **digdash_enterprise_2026R1_numpatch_t10.zip **(par exemple**, **digdash_enterprise_2026R1_P01_t10.zip pour le patch P01)
26
27 Après extraction, le dossier s’appellera :
28 **digdash_enterprise_2026R1_t10** ou **digdash_enterprise_2026R1_numpatch_t10**.
29
30 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.**
31 Le numéro de version est visible en bas de la page d'accueil DigDash (ou dans le fichier version.txt de l'archive).
32
33 **Configuration supportée :**
34
35 (% class="box warningmessage" %)
36 (((
37 **⚠ **Depuis cette version 2026 R1, Tomcat 9 n'est plus supporté. Seul Tomcat 10 est supporté.
38 )))
39
40 * Serveur : **Tomcat 10 uniquement** (Windows et Linux: Ubuntu 24.04).
41 * Serveur : **Java 17, Java 21 et Java 25 **(Windows et Linux)
42
43 = Bonnes pratiques pour la version 2026 R1{{id name="Bonnes_pratiques"/}}{{id name="Bonnes_pratiques"/}} =
44
45 Pour un fonctionnement optimal de DigDash Enterprise, il est recommandé d'appliquer les préconisations suivantes :
46
47 * Utilisation du fichier **digdash.properties** pour stocker la configuration des environnements.
48 Pour plus d'informations sur le paramétrage du fichier, consultez la page [[Paramétrage du fichier digdash.properties>>doc:.DigDash\.properties.WebHome]].
49
50 * Utilisation d'un système de base de données externe pour les bases DDAudit, Comments et DDDataEntry.
51 Pour plus d'informations sur l'installation d'un système de base de données externe, consultez le paragraphe :
52 ** [[Installation de MariaDB>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||anchor="DB_windows"]] pour un environnement de production **Windows**.
53 ** [[Installation de MariaDB>>doc:Digdash.deployment.installation.Ubuntu24.WebHome||anchor="DB_ubuntu"]] pour un environnement de production** Ubuntu**.
54
55 * Utilisation d'un Tomcat séparé de l'installation Digdash (installation par le gestionnaire de package de l'OS).
56 Pour plus d'informations sur l'installation d'un Tomcat séparé, consultez le paragraphe :
57 ** [[Installation de Tomcat 10>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||anchor="Tomcat_windows"]] pour un environnement de production **Windows**.
58 ** [[Installation de Tomcat 10>>doc:Digdash.deployment.installation.Ubuntu24.WebHome||anchor="Tomcat_ubuntu"]] pour un environnement de production **Ubuntu 24.04**.
59
60 * Utilisation de OpenDJ à la place de adswrapper (adswrapper n'est plus livré).
61 Pour plus d'informations sur l'installation de OpenDJ, consultez le paragraphe :
62 ** [[Installation d'OpenDJ>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||anchor="OpenDJ"]] pour un environnement de production **Windows**.
63 ** [[Installation d'OpenDJ>>doc:Digdash.deployment.installation.Ubuntu24.WebHome||anchor="OpenDJ"]]  pour un environnement de production **Ubuntu**.
64
65 = Mise à jour de DigDash Enterprise vers la version 2026 R1{{id name="Premier_deploiement"/}} =
66
67 Ce paragraphe vous concerne si vous mettez à jour DigDash Enterprise depuis une version 2024 R2 ou ultérieure vers la version 2026 R1.
68 Pour une mise à jour depuis une version antérieure à la version 2024 R2, veuillez contacter DigDash à l’adresse [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__contact@digdash.com__>>path:mailto:contact@digdash.com]](%%).
69
70 (% class="box warningmessage" %)
71 (((
72 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>>doc:Digdash.deployment.Connectivity_Database.adding_jdbc_driver.WebHome||anchor="HDriversprE9configurE9snoninclus"]].
73 )))
74
75 == Procédure de mise à jour ==
76
77 === Étape 1 : Sauvegarde de la configuration ===
78
79 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.
80 Si vous aviez ajouté des fichiers à votre installation (modification de logos, images, css, adjonction de JSP, ...) il faudra les reporter dans la nouvelle installation.
81 Consultez la documentation [[Sauvegarde et restauration>>doc:Digdash.deployment.configuration.backup_restore.WebHome]].
82
83 === Étape 2 : Arrêt du serveur{{id name="Stop_server"/}} ===
84
85 Arrêtez le serveur DigDash :
86
87 * **Sous Windows :** cliquez-droit sur votre service, puis cliquez sur **Arrêter **depuis votre application **Services** de Windows.
88 * **Sous Linux : **utilisez la commande** **##{{code language="shell"}}sudo service tomcat10 stop{{/code}}##
89
90 === Étape 3 : Sauvegarde et suppression des anciennes applications ===
91
92 Sauvegardez puis effacez les fichiers et dossiers de **<install_dd>/webapps :**
93
94 (% border="0" style="width:563px" %)
95 |(% style="width:286px" %)(((
96 Dossiers :
97
98 * adminconsole
99 * ddenterpriseapi
100 * digdash_dashboard
101 * studio
102 )))|(% style="width:317px" %)(((
103 Fichiers :
104
105 * adminconsole.war
106 * ddenterpriseapi.war
107 * digdash_dashboard.war
108 * studio.war
109 )))
110
111 (% class="box warningmessage" %)
112 (((
113 ⚠ Ne pas effacer le dossier **ROOT**.
114 )))
115
116 === Étape 4 : Copie des nouvelles applications ===
117
118 Dézippez la nouvelle version du produit dans un emplacement temporaire.
119
120 Naviguez dans ce dossier temporaire jusque dans le dossier **webapps.**
121 Copiez les fichiers suivants dans le même dossier de votre installation :
122
123 * adminconsole.war
124 * ddenterpriseapi.war
125 * digdash_dashboard.war
126 * studio.war
127
128 Le dossier **webapps **doit maintenant contenir 4 fichiers .war et le dossier **ROOT**.
129
130 === Étape 5 : Récupération des add-ons ===
131
132 Copiez le contenu du répertoire **add-ons** vers le même endroit dans votre installation.
133 Si vous aviez modifié certains fichiers (**importtools**, **backtuptools**, ...) sauvegardez-les avant la copie.
134
135 === Étape 6 : Modification de la variable JAVA_OPTS{{id name="JVM"/}} ===
136
137 Des paramètre doivent être ajoutés à la variable JAVA_OPTS.
138
139 ==== Sur Linux ====
140
141 1. Éditez le fichier suivant:
142
143 {{code language="shell"}}sudo vi /etc/default/tomcat10{{/code}}
144
145 (% start="2" %)
146 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:
147
148 {{code language="shell"}}
149 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"
150 {{/code}}
151
152 ==== Sur Windows ====
153
154 1. Allez dans le répertoire d’installation de Tomcat puis dans le répertoire bin et lancer **tomcat10w.exe**.
155 1. Allez dans l’onglet **Java**.
156 1. (((
157 Ajoutez le paramètre **-Dfile.encoding=UTF-8** dans Java Options comme suit:
158 [[image:Dfile.png||alt="Encodage"]]
159 )))
160 1. (((
161 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.
162 )))
163
164 === Étape 7 : Redémarrage du serveur{{id name="Start_server"/}} ===
165
166 Redémarrez le serveur DigDash :
167
168 * **Sous Windows :** cliquez-droit sur votre service, puis cliquez sur **Démarrer **depuis votre application **Services** de Windows.
169 * (((
170 **Sous Linux : **utilisez la commande## {{code language="shell"}}sudo service tomcat10 start{{/code}}##
171 )))
172
173 et laissez Tomcat redéployer les nouvelles applications.
174
175 Sous Linux, reportez-vous au [[Guide d'installation Linux>>doc:Digdash.deployment.installation.Ubuntu24.WebHome||target="_blank"]].
176 Sous Windows, reportez-vous [[Guide d'installation Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||target="_blank"]].
177
178 === Étape 8 : Restauration ===
179
180 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.
181
182 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).
183 De même si vous pointez vers un nouveau dossier LDAP pour restaurer les entrées LDAP (utilisateurs, rôles, groupes d'autorisations),
184
185 (% class="box warningmessage" %)
186 (((
187 **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.
188 )))
189
190 === Étape 9 : Nettoyage du cache du navigateur ===
191
192 Supprimez le cache du navigateur (raccourcis sur la plupart des navigateurs : Ctrl + Shift + Suppr).
193
194 === Étape 10 : Régénération des modèles de données ===
195
196 (% class="box infomessage" %)
197 (((
198 (% id="cke_bm_413S" style="display:none" %) (%%)💡 La régénération des modèles de données est recommandée dans le cas d'une montée de version majeure.
199 )))
200
201 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.
202
203 * Entrez l'URL* sous la forme suivante dans le navigateur pour appeler cet événement** **via fireevent.
204 __http:~/~/localhost:8080/ddenterpriseapi/fireevent?eventid=EVENT_REFRESHFLOW_FORCEALL__
205 \\* //Remplacez http:~/~/localhost:8080/ //par l'adresse de votre environnement DigDash et //ddenterpriseapi //par le nom de votre domaine.
206
207 === Étape 11 : Réinitialisation des groupes d'autorisations par défaut ===
208
209 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.
210
211 (% class="box warningmessage" %)
212 (((
213 ⚠ Si vous aviez modifié les groupes d'autorisations, ces modifications seront perdues.
214 )))
215
216 Pour cela :
217
218 1. Allez dans **Configuration **> **Gestion des utilisateurs** > **Groupes d'autorisations** : tous les groupes d'autorisations y sont listées.
219 1. Cliquez sur le lien **Réinitialiser les groupes d'autorisations par défaut**.
220 ➡ Un message de confirmation s'affiche.
221 1. Cliquez sur **OK**.
222
223 === Étape 12 : Réinitialisation des thèmes //digdash_2024// et //digdash_2019{{id name="thème"/}}// ===
224
225 Les thèmes //digdash_2019// et //digdash_2024// ont été modifiés. Ils doivent donc être réinitialisés.
226
227 Pour cela :
228
229 1. Depuis le Studio, ouvrez le** Gestionnaires de styles**.
230 1. Cliquez-droit sur le thème **digdash_2024**, respectivement **digdash_2019, **puis cliquez sur **Réinitialiser**.
231 1. Cliquez sur** OK**.
232
233 Dans le cas où vous utilisiez un thème //digdash_2019// ou //digdash_2024 //personnalisé:
234
235 1. Récupérez les modifications/ajouts effectués à l'intérieur de la feuille de styles et sauvegardez-les à part.
236 1. Réinitialisez le thème comme décrit dans le paragraphe précédent.
237 1. Créez un nouveau thème personnalisé à l'aide de l'Éditeur de thèmes. Consultez la page[[ Éditeur de thèmes>>doc:Digdash.user_guide.dashboard.theme_editor.WebHome]] pour une description détaillée.
238 1. Réappliquez-y les modifications/ajouts via l'interface.
239 1. Allez dans **Configuration **-> **Paramètres serveur** -> **Paramètres supplémentaires** -> **Divers** pour sélectionner le nouveau thème personnalisé comme thème serveur.
240
241 == Changements de comportement ==
242
243 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>>doc:Digdash.deployment.installation.behaviour_changes.WebHome]].
244
245 = Déploiement d'un patch sur une 2026 R1{{id name="Deploiement_patch"/}} =
246
247 Ce paragraphe concerne la mise à jour d'une version 2026 R1 vers une autre 2026 R1 plus récente.
248
249 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>>doc:||anchor="Bonnes_pratiques"]].
250
251 (% class="box warningmessage" %)
252 (((
253 ⚠ Si votre installation contient des développements spécifiques, qui se trouvent dans les dossiers des applications :
254 **<install_dd>/apache-tomcat/webapps/ddenterpriseapi** ou **<install_dd>/apache-tomcat/webapps/digdash_dashboard**
255 ils seront perdus lors de la mise à jour. Sauvegardez-les avant toute autre opération, afin de pouvoir les reporter après mise à jour.
256 )))
257
258 (% class="wikigeneratedid" %)
259 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.