Code source wiki de Guide de mise à jour
Modifié par Aurelie Bertrand le 2025/02/07 10:27
Afficher les derniers auteurs
author | version | line-number | content |
---|---|---|---|
1 | {{ddtoc/}} | ||
2 | |||
3 | ---- | ||
4 | |||
5 | = Introduction = | ||
6 | |||
7 | (% class="box warningmessage" %) | ||
8 | ((( | ||
9 | ❗Une fois la mise à jour vers la version 2024 R2 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 2024 R2. | ||
13 | Il présente également les modifications de comportement introduites dans cette version. | ||
14 | |||
15 | Ce guide vous concerne UNIQUEMENT si vous respectez les [[bonnes pratiques>>doc:||anchor="Bonnes_pratiques"]] décrites dans le paragraphe dédié. | ||
16 | Si ce n'est pas le cas, reprenez l'installation de zéro selon le guide d'installation [[Linux>>doc:Digdash.deployment.installation.install_guide_ubuntu.WebHome]] ou [[Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome]]. | ||
17 | |||
18 | (% class="box warningmessage" %) | ||
19 | ((( | ||
20 | ❗Si vous utilisez **adswrapper** (non recommandé), une mise à jour a été effectuée dans la version 2024 R1. Elle permet notamment de corriger des problèmes de sécurité. | ||
21 | |||
22 | ❗Si vous utilisez une **base de données H2** (non recommandé), une mise à jour a été effectuée dans la version **2023 R1**. Les anciennes versions de base de données H2 (DDAudit, Comments et DDDataEntry) ne sont pas compatibles avec cette version. Veuillez consulter le document [[Migration base de données H2>>doc:.H2_database.WebHome]] pour le détail des procédures à suivre. | ||
23 | ))) | ||
24 | |||
25 | (% class="box warningmessage" %) | ||
26 | ((( | ||
27 | **Important : Migration des développements spécifiques (toutes versions)** | ||
28 | \\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. | ||
29 | 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. | ||
30 | ))) | ||
31 | |||
32 | Il existe des archives d’installation de DigDash Enterprise différentes pour Tomcat 9 et Tomcat 10. Elles sont nommées sous la forme: | ||
33 | |||
34 | * Pour Tomcat 9: **digdash_enterprise_2024R2_64.zip** ou **digdash_enterprise_2024R2_numpatch_64.zip**. | ||
35 | * Pour Tomcat 10: **digdash_enterprise_2024R2_t10_64.zip** ou **digdash_enterprise_2024R2_numpatch_t10_64.zip**. | ||
36 | |||
37 | Après extraction, le dossier s’appellera : | ||
38 | |||
39 | * Pour Tomcat 9: **digdash_enterprise_2024R2_64** ou **digdash_enterprise_2024R2_numpatch_64**. | ||
40 | * Pour Tomcat 10: **digdash_enterprise_2024R2_t10_64** ou **digdash_enterprise_2024R2_numpatch_t10_64**. | ||
41 | |||
42 | 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.** | ||
43 | Le numéro de version est visible en bas de la page d'accueil DigDash (ou dans le fichier version.txt de l'archive). | ||
44 | |||
45 | **Configuration supportée :** | ||
46 | |||
47 | * Serveur : **Tomcat 9** (Windows et Linux: Ubuntu 20.02 et 22.02) | ||
48 | **~ Tomcat 10** (Windows et Linux: Ubuntu 24.04). | ||
49 | * Serveur : **Java 17 uniquement **(Windows et Linux) | ||
50 | |||
51 | = Bonnes pratiques pour la version 2024 R2{{id name="Bonnes_pratiques"/}}{{id name="Bonnes_pratiques"/}} = | ||
52 | |||
53 | Pour un fonctionnement optimal de DigDash Enterprise, il est recommandé d'appliquer les préconisations suivantes : | ||
54 | |||
55 | * Utilisation du fichier **digdash.properties** pour stocker la configuration des environnements. | ||
56 | Pour plus d'informations sur le paramétrage du fichier, consultez la page [[Paramétrage du fichier digdash.properties>>doc:.DigDash\.properties.WebHome]]. | ||
57 | |||
58 | * Utilisation d'un système de base de données externe pour les bases DDAudit, Comments et DDDataEntry. | ||
59 | Pour plus d'informations sur l'installation d'un système de base de données externe, consultez le paragraphe : | ||
60 | ** [[Installation de MariaDB>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||anchor="DB_windows"]] pour un environnement de production **Windows**. | ||
61 | ** [[Installation de MariaDB>>doc:Digdash.deployment.installation.install_guide_ubuntu.Ubuntu22.WebHome||anchor="DB_ubuntu"]] pour un environnement de production** Ubuntu**. | ||
62 | |||
63 | * Utilisation d'un Tomcat séparé de l'installation Digdash (installation par le gestionnaire de package de l'OS). | ||
64 | Pour plus d'informations sur l'installation d'un Tomcat séparé, consultez le paragraphe : | ||
65 | ** [[Installation de Tomcat 9>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||anchor="Tomcat_windows"]] ou Tomcat 10 pour un environnement de production **Windows**. | ||
66 | ** [[Installation de Tomcat 9>>doc:Digdash.deployment.installation.install_guide_ubuntu.Ubuntu22.WebHome||anchor="Tomcat_ubuntu"]] pour un environnement de production **Ubuntu 20.02 ou 22.02**. | ||
67 | ** [[Installation de Tomcat 10>>doc:Digdash.deployment.installation.install_guide_ubuntu.Ubuntu24.WebHome||anchor="Tomcat_ubuntu"]] pour un environnement de production **Ubuntu 24.04**. | ||
68 | |||
69 | * Utilisation de OpenDJ à la place de adswrapper. | ||
70 | Pour plus d'informations sur l'installation de OpenDJ, consultez le paragraphe : | ||
71 | ** [[Installation d'OpenDJ>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||anchor="OpenDJ_Windows"]] pour un environnement de production **Windows**. | ||
72 | ** [[Installation d'OpenDJ>>doc:Digdash.deployment.installation.install_guide_ubuntu.Ubuntu22.WebHome||anchor="OpenDJ"]] pour un environnement de production Ubuntu. | ||
73 | |||
74 | = Mise à jour de DigDash Enterprise vers la version 2024 R2{{id name="Premier_deploiement"/}} = | ||
75 | |||
76 | Ce paragraphe vous concerne si vous mettez à jour DigDash Enterprise depuis une version 2023 R1 ou ultérieure vers la version 2024 R2. | ||
77 | Pour une mise à jour depuis une version antérieure à la version 2023 R1, 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" %)__contact@digdash.com__>>path:mailto:contact@digdash.com]](%%). | ||
78 | |||
79 | (% class="box warningmessage" %) | ||
80 | ((( | ||
81 | 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"]]. | ||
82 | ))) | ||
83 | |||
84 | (% class="box warningmessage" %) | ||
85 | ((( | ||
86 | Le **module DDAudit **a été modifié dans la version 2023R1. Pour en savoir plus sur les instructions relatives, veuillez consulter le paragraphe [[Modification du module DDAudit>>doc:||anchor="DDAudit"]]. | ||
87 | ))) | ||
88 | |||
89 | == Procédure de mise à jour == | ||
90 | |||
91 | === Étape 1 : Vérification de la version de Java utilisée === | ||
92 | |||
93 | L'utilisation de Java 17 est obligatoire pour DigDash 2024 R2. Pour vérifier la version actuellement utilisée par tomcat, vous pouvez : | ||
94 | |||
95 | * Ouvrir la page** [[Etat du serveur>>doc:Digdash.deployment.configuration.server_status.WebHome]]** : la version de Java utilisée est indiquée dans la section** Etat général** (ici Java 17). | ||
96 | [[image:Java_version_FR.png||alt="Version java"]] | ||
97 | |||
98 | * Vérifier la version en allant dans le répertoire de Java : | ||
99 | *1. Dans un terminal, entrez la commande suivante : | ||
100 | |||
101 | {{code language="shell"}} | ||
102 | cd /usr/lib/jvm | ||
103 | ll | ||
104 | {{/code}} | ||
105 | |||
106 | (% start="2" %) | ||
107 | 1. Regardez vers quelle version le lien symbolique default-java pointe actuellement. | ||
108 | Dans l’exemple ci-dessous, il pointe vers java 11. | ||
109 | [[image:Check_java_version_FR.png||alt="version Java"]] | ||
110 | |||
111 | Si la version utilisée n'est pas Java 17, consultez la page [[Changer de version de Java>>doc:.changeJava.WebHome]] pour savoir comment changer de version. | ||
112 | |||
113 | === Étape 2 : Sauvegarde de la configuration === | ||
114 | |||
115 | 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. | ||
116 | Si vous aviez ajouté des fichiers à votre installation (modification de logos, images, css, adjonction de JSP, ...) il faudra les reporter dans la nouvelle installation. | ||
117 | Consultez la documentation [[Sauvegarde et restauration>>doc:Digdash.deployment.configuration.backup_restore.WebHome]]. | ||
118 | |||
119 | === Étape 3 : Arrêt du serveur{{id name="Stop_server"/}} === | ||
120 | |||
121 | Arrêtez le serveur DigDash : | ||
122 | |||
123 | * **Sous Windows :** cliquez-droit sur votre service, puis cliquez sur **Arrêter **depuis votre application **Services** de Windows. | ||
124 | * **Sous Linux : **utilisez la commande** **##{{code language="shell"}}sudo service tomcat9 stop{{/code}} ou {{code language="shell"}}sudo service tomcat10 stop{{/code}} | ||
125 | (selon la version de tomcat installée)## | ||
126 | |||
127 | === Étape 4 : Sauvegarde et suppression des anciennes applications === | ||
128 | |||
129 | Sauvegardez puis effacez les fichiers et dossiers de **<install_dd>/webapps :** | ||
130 | |||
131 | (% border="0" style="width:563px" %) | ||
132 | |(% style="width:286px" %)((( | ||
133 | Dossiers : | ||
134 | |||
135 | * adminconsole | ||
136 | * ddenterpriseapi | ||
137 | * digdash_dashboard | ||
138 | * studio | ||
139 | * adswrapper (non recommandé) | ||
140 | )))|(% style="width:317px" %)((( | ||
141 | Fichiers : | ||
142 | |||
143 | * adminconsole.war | ||
144 | * ddenterpriseapi.war | ||
145 | * digdash_dashboard.war | ||
146 | * studio.war | ||
147 | * adswrapper.war (non recommandé) | ||
148 | ))) | ||
149 | |||
150 | (% class="box warningmessage" %) | ||
151 | ((( | ||
152 | ❗Ne pas effacer le dossier **ROOT**. | ||
153 | |||
154 | Ne pas effacer le dossier **ldapdigdash** si utilisé. Le répertoire ldapdigdash est lié à adswrapper (non recommandé). | ||
155 | ))) | ||
156 | |||
157 | === Étape 5 : Copie des nouvelles applications === | ||
158 | |||
159 | Dézippez la nouvelle version du produit dans un emplacement temporaire. | ||
160 | |||
161 | Naviguez dans ce dossier temporaire jusque dans le dossier **webapps.** | ||
162 | Copiez les fichiers suivants dans le même dossier de votre installation : | ||
163 | |||
164 | * adminconsole.war | ||
165 | * ddenterpriseapi.war | ||
166 | * digdash_dashboard.war | ||
167 | * studio.war | ||
168 | * adswrapper.war (non recommandé) | ||
169 | |||
170 | Le dossier **webapps **doit maintenant contenir 4 fichiers .war (5 si vous utilisez adswrapper) et le dossier **ROOT**. | ||
171 | |||
172 | === Étape 6 : Récupération des add-ons === | ||
173 | |||
174 | Copiez le contenu du répertoire **add-ons** vers le même endroit dans votre installation. | ||
175 | Si vous aviez modifié certains fichiers (**importtools**, **backtuptools**, ...) sauvegardez-les avant la copie. | ||
176 | |||
177 | === Étape 7 : Modification de la variable JAVA_OPTS === | ||
178 | |||
179 | Un paramètre doit être ajouté à la variable JAVA_OPTS. | ||
180 | |||
181 | ==== Sur Linux ==== | ||
182 | |||
183 | 1. Éditez le fichier suivant: | ||
184 | |||
185 | {{code language="shell"}}sudo vi /etc/default/tomcat9{{/code}} ou {{code language="shell"}}sudo vi /etc/default/tomcat10{{/code}} | ||
186 | |||
187 | selon votre version de tomcat. | ||
188 | |||
189 | (% start="2" %) | ||
190 | 1. Ajoutez le paramètre **~-~-add-opens=java.base/java.nio=ALL-UNNAMED** à la variable JAVA_OPTS afin d'obtenir le résultat suivant: | ||
191 | |||
192 | {{code language="shell"}} | ||
193 | JAVA_OPTS="-Djava.awt.headless=true -Xms6G -Xmx6G -Djava.security.egd=file:/dev/urandom -DPROP_MAX_CONCURRENT_TOTAL=5000 -DPROP_MAX_CONCURRENT_CON_PER_HOST=5000 --add-opens=java.base/java.nio=ALL-UNNAMED" | ||
194 | {{/code}} | ||
195 | |||
196 | ==== Sur Windows ==== | ||
197 | |||
198 | 1. Allez dans le répertoire d’installation de Tomcat puis dans le répertoire bin et lancer **tomcat9w.exe** ou **tomcat10w.exe** selon votre version de Tomcat. | ||
199 | 1. Allez dans l’onglet **Java**. | ||
200 | 1. Ajoutez le paramètre **~-~-add-opens=java.base/java.nio=ALL-UNNAMED** dans Java 9 options comme suit: | ||
201 | [[image:Java9_options_FR.png]] | ||
202 | |||
203 | === Étape 8 : Redémarrage du serveur{{id name="Start_server"/}} === | ||
204 | |||
205 | Redémarrez le serveur DigDash : | ||
206 | |||
207 | * **Sous Windows :** cliquez-droit sur votre service, puis cliquez sur **Démarrer **depuis votre application **Services** de Windows. | ||
208 | * ((( | ||
209 | **Sous Linux : **utilisez la commande** **##{{code language="shell"}}sudo service tomcat9 start{{/code}} ou {{code language="shell"}}sudo service tomcat10 start{{/code}} | ||
210 | (selon la version de tomcat installée)## | ||
211 | ))) | ||
212 | |||
213 | et laissez Tomcat redéployer les nouvelles applications. | ||
214 | |||
215 | Sous Linux, reportez-vous au [[Guide d'installation Linux>>doc:Digdash.deployment.installation.install_guide_ubuntu.WebHome||target="_blank"]]. | ||
216 | Sous Windows, reportez-vous [[Guide d'installation Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||target="_blank"]]. | ||
217 | |||
218 | === Étape 9 : Restauration === | ||
219 | |||
220 | 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. | ||
221 | |||
222 | 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). | ||
223 | De même si vous pointez vers un nouveau dossier LDAP pour restaurer les entrées LDAP (utilisateurs, rôles, groupes d'autorisations), | ||
224 | |||
225 | (% class="box warningmessage" %) | ||
226 | ((( | ||
227 | **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. | ||
228 | ))) | ||
229 | |||
230 | === Étape 10 : Nettoyage du cache du navigateur === | ||
231 | |||
232 | Supprimez le cache du navigateur (raccourcis sur la plupart des navigateurs : Ctrl + Shift + Suppr). | ||
233 | |||
234 | === Étape 11 : Régénération des modèles de données === | ||
235 | |||
236 | (% class="box infomessage" %) | ||
237 | ((( | ||
238 | (% 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. | ||
239 | ))) | ||
240 | |||
241 | 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. | ||
242 | |||
243 | * Entrez l'URL sous la forme suivante dans le navigateur pour appeler cet événement** **via fireevent. | ||
244 | __http:~/~/localhost:8080/ddenterpriseapi/fireevent?eventid=EVENT_REFRESHFLOW_FORCEALL__ | ||
245 | |||
246 | (% class="box infomessage" %) | ||
247 | ((( | ||
248 | ℹ Remplacez //http:~/~/localhost:8080/ //par l'adresse de votre environnement DigDash et //ddenterpriseapi //par le nom de votre domaine. | ||
249 | ))) | ||
250 | |||
251 | === Étape 12 : Modification du thème Dashboard{{id name="Dashboard_theme"/}} === | ||
252 | |||
253 | Plusieurs changements au niveau du thème Dashboard ont été réalisés: | ||
254 | |||
255 | * Un nouveau thème //digdash_2024// est désormais disponible. | ||
256 | * Le thème //digdash_2019// a été modifié suite à des modifications internes au Dashboard et doit être réinitialisé afin d'éviter tout problème d'affichage des graphiques et des tableaux de bord. | ||
257 | * Le thème //digdash// a été supprimé. | ||
258 | |||
259 | Suivez les instructions selon votre cas de figure. | ||
260 | |||
261 | ==== Changement vers le nouveau thème digdash_2024{{id name="2024"/}} ==== | ||
262 | |||
263 | Si vous souhaitez utiliser le nouveau thème //digdash_2024// comme thème serveur: | ||
264 | |||
265 | 1. Allez dans **Configuration **-> **Paramètres serveur** -> **Paramètres supplémentaires** -> **Divers.** | ||
266 | 1. Dans la liste déroulante **Thème**, sélectionnez** digdash_2024.** | ||
267 | |||
268 | ==== Utilisation du thème digdash_2019{{id name="2019"/}} ==== | ||
269 | |||
270 | Si vous utilisez le thème //digdash_2019// (sans personnalisation), il faut réinitialiser le thème. Pour cela: | ||
271 | |||
272 | 1. Depuis le Studio, ouvrez le** Gestionnaires de styles**. | ||
273 | 1. Cliquez-droit sur le thème digdash_2019 puis cliquez sur **Réinitialiser**. | ||
274 | [[image:Reset_theme_FR.png||alt="Réinitialiser le thème"]] | ||
275 | 1. Cliquez sur** OK**. | ||
276 | 1. Allez dans **Configuration **-> **Paramètres serveur** -> **Paramètres supplémentaires** -> **Divers **pour vérifier que le thème digdash_2019 est bien sélectionné comme thème serveur. | ||
277 | |||
278 | ==== Utilisation d'un thème digdash_2019 personnalisé{{id name="2019_custom"/}} ==== | ||
279 | |||
280 | Si vous utilisez un thème //digdash_2019// personnalisé: | ||
281 | |||
282 | 1. Récupérez les modifications/ajouts effectués à l'intérieur de la feuille de styles et sauvegardez-les à part. | ||
283 | 1. Réinitialisez le thème digdash_2019 comme décrit dans le paragraphe précédent. | ||
284 | 1. Créez un nouveau thème personnalisé en suivant la bonne pratique de variabilisation du thème. Consultez la page [[Personnalisation du thème du tableau de bord>>doc:Digdash.customization.customization_DDE.custom_style.WebHome]] pour une description détaillée. | ||
285 | 1. Réappliquez les modifications/ajouts dans la feuille de styles. | ||
286 | 1. Allez dans **Configuration **-> **Paramètres serveur** -> **Paramètres supplémentaires** -> **Divers** pour sélectionner le nouveau thème personnalisé comme thème serveur. | ||
287 | |||
288 | ==== Utilisation du thème digdash ==== | ||
289 | |||
290 | Le thème //digdash// a été supprimé. Si vous utilisiez le thème //digdash, //vous pouvez: | ||
291 | |||
292 | * sélectionner le thème //digdash_2024: //consultez le paragraphe [[Changement vers le nouveau thème digdash_2024>>doc:||anchor="2024"]]. | ||
293 | * sélectionner le thème //digdash_2019: //consultez le paragraphe [[Utilisation du thème digdash_2019>>doc:||anchor="2019"]]. | ||
294 | * créer un nouveau thème personnalisé : consultez la page [[Personnalisation du thème du tableau de bord>>doc:Digdash.customization.customization_DDE.custom_style.WebHome]]. | ||
295 | |||
296 | == Modification du module DDAudit{{id name="DDAudit"/}} == | ||
297 | |||
298 | Le module DDAudit a été modifié en version 2023 R1. Si vous avez déployé DDAudit dans une version précédente, suivez les instructions suivantes : | ||
299 | |||
300 | * Si vous n'avez pas modifié les modèles et les flux de DDAudit, et si vous n'avez pas créé de nouveaux modèles et flux, alors il est conseillé de désinstaller le module DDAudit, en supprimant le rôle et ses données puis de le réinstaller depuis le zip d'installation de cette nouvelle version, ou via le gestionnaire Digdash Metadata Service depuis le Studio. | ||
301 | |||
302 | * Si vous avez créé vos propres modèles et flux pour DDAudit, ou si vous avez modifié les modèles de données, vous devez modifier les requêtes SQL des modèles de données modifiés ou créés afin qu'ils n'utilisent plus le champ **user** mais **dd_user **(les noms des dimensions et mesures restent inchangés). | ||
303 | |||
304 | (% class="box warningmessage" %) | ||
305 | ((( | ||
306 | ❗Si vous utilisez H2 comme base de donnée pour DDAudit (non recommandé), il vous faudra migrer votre ancienne base de données (voir le document [[Migration base de données H2>>doc:.H2_database.WebHome]]) avant de pouvoir effectuer ces modifications. | ||
307 | ))) | ||
308 | |||
309 | == Changements de comportement == | ||
310 | |||
311 | De nouvelles fonctionnalités ou la résolution de bugs dans la 2024 R2 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]]. | ||
312 | |||
313 | = Déploiement d'un patch sur une 2024 R2{{id name="Deploiement_patch"/}} = | ||
314 | |||
315 | Ce paragraphe concerne la mise à jour d'une version 2024 R2 vers une autre 2024 R2 plus récente. | ||
316 | |||
317 | 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 2024 R2>>doc:||anchor="Bonnes_pratiques"]]. | ||
318 | |||
319 | (% class="box warningmessage" %) | ||
320 | ((( | ||
321 | Si votre installation contient des développements spécifiques, qui se trouvent dans les dossiers des applications : | ||
322 | **<install_dd>/apache-tomcat/webapps/ddenterpriseapi** ou **<install_dd>/apache-tomcat/webapps/digdash_dashboard** | ||
323 | ils seront perdus lors de la mise à jour. Sauvegardez-les avant toute autre opération, afin de pouvoir les reporter après mise à jour. | ||
324 | ))) | ||
325 | |||
326 | (% class="wikigeneratedid" %) | ||
327 | 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. |