Code source wiki de Guide de mise à jour

Modifié par Aurelie Bertrand le 2024/07/02 14:57
Afficher les derniers auteurs
1 {{ddtoc/}}
2
3 ----
4
5 = Introduction =
6
7 Ce guide décrit la procédure et les précautions à prendre pour mettre à jour votre version DigDash Enterprise vers la nouvelle version 2023R2.
8 Il présente également les modifications de comportement introduits dans cette version.
9
10 Ce guide vous concerne UNIQUEMENT si vous respectez les [[bonnes pratiques>>doc:||anchor="Bonnes_pratiques"]] décrites dans le paragraphe dédié.
11 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]].
12
13 (% class="box warningmessage" %)
14 (((
15 ❗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 DDEntry) 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.
16 )))
17
18 (% class="box warningmessage" %)
19 (((
20 **Important : Migration des développements spécifiques (toutes versions)**
21 \\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.
22 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.
23
24 **Important **: Depuis la version 2022R2, la valeur du paramètre utilisateur **langChoice **est maintenant un code langue et non plus un index. Par exemple 0 est devenu "en", 1 est devenu "fr". Il faut prendre en compte ce changement :
25
26 * dans l'adaptation de vos scripts d'import des utilisateurs,
27 * dans les formules de mesures dérivées qui utiliseraient ${user.langChoice} pour déterminer la valeur d'une mesure.
28 * dans les formules de filtrages de données qui utiliseraient ${user.langChoice}.
29 )))
30
31 Les archives d’installation de DigDash Enterprise sont nommées sous le modèle **digdash_enterprise_2023R2_64.zip** ou **digdash_enterprise_2023R2_numpatch_64.zip.**
32 Après extraction, le dossier s’appellera **digdash_enterprise_2023R2_64** ou **digdash_enterprise_2023R2_numpatch_64**.
33
34 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.**
35 Le numéro de version est visible dans le fichier version.txt de l'archive ou depuis la page « **Configuration **/ **État du serveur** » (« Version DigDash Enterprise » en haut à gauche dans la rubrique « **État général** »).
36
37 **Configuration supportée :**
38
39 * Serveur : **Tomcat 9** (Windows et Linux)
40 * Serveur : **Java 11** (Windows et Linux)
41
42 Sous Linux vous devrez au minimum installer Java en suivant les recommandations du [[Guide d'installation>>doc:Digdash.deployment.installation.install_guide_ubuntu.WebHome||target="_blank"]].
43
44 = Bonnes pratiques pour la version 2023 R2{{id name="Bonnes_pratiques"/}}{{id name="Bonnes_pratiques"/}} =
45
46 Pour un fonctionnement optimal de DigDash Enterprise, il est recommandé d'appliquer les préconisations suivantes :
47
48 * Utilisation du fichier **digdash.properties** pour stocker la configuration des environnements.
49 Pour plus d'informations sur le paramétrage du fichier, consultez la page [[Paramétrage du fichier digdash.properties>>doc:.DigDash\.properties.WebHome]].
50
51 * Utilisation d'un système de base de données externe pour les bases DDAudit, Comments et DDEntry.
52 Pour plus d'informations sur l'installation d'un système de base de données externe, consultez le paragraphe :
53 ** [[Installation de MariaDB>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||anchor="DB_windows"]] pour un environnement de production Windows.
54 ** [[MariaDB (Préconisé)>>doc:Digdash.deployment.installation.install_guide_ubuntu.WebHome||anchor="DB_ubuntu"]] pour un environnement de production Ubuntu.
55
56 * Utilisation d'un Tomcat séparé de l'installation DigDash (installation par le gestionnaire de package de l'OS).
57 Pour plus d'informations sur l'installation d'un Tomcat séparé, consultez le paragraphe :
58 ** [[Installation de Tomcat 9>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||anchor="Tomcat_windows"]] pour un environnement de production Windows.
59 ** [[Tomcat 9>>doc:Digdash.deployment.installation.install_guide_ubuntu.WebHome||anchor="Tomcat_ubuntu"]] pour un environnement de production Ubuntu.
60
61 * Utilisation d'OpenDJ à la place de adswrapper.
62 Pour plus d'informations sur l'installation de OpenDJ, consultez le paragraphe :
63 ** [[Installation d'OpenDJ>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||anchor="OpenDJ"]] pour un environnement de production Windows.
64 ** [[Installation d'OpenDJ>>doc:Digdash.deployment.installation.install_guide_ubuntu.WebHome||anchor="OpenDJ"]] pour un environnement de production Ubuntu.
65
66 = Mise à jour de DigDash Enterprise vers la version 2023 R2{{id name="Premier_deploiement"/}} =
67
68 Ce paragraphe vous concerne si vous mettez à jour DigDash Enterprise depuis une version 2021 R1 ou ultérieure vers la version 2023 R2.
69 Pour une mise à jour depuis une version 2021 R1 ou antérieure, 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" %)__contact@digdash.com__>>path:mailto:contact@digdash.com]](%%).
70
71 (% class="box warningmessage" %)
72 (((
73 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"]].
74 )))
75
76 (% class="box warningmessage" %)
77 (((
78 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"]].
79 )))
80
81 == Procédure de mise à jour ==
82
83 === Étape 1 : Sauvegarde de la configuration ===
84
85 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.
86 Si vous aviez ajouté des fichiers à votre installation (modification de logos, imags, css, adjonction de JSP, ...) il faudra les reporter dans la nouvelle installation.
87 Consultez la documentation [[Sauvegarde et restauration>>doc:Digdash.deployment.configuration.backup_restore.WebHome]].
88
89 === Étape 2 : Arrêt du serveur ===
90
91 Arrêtez le serveur DigDash :
92
93 * **Sous Windows :** cliquez-droit sur votre service ("Tomcat 9" par défaut), puis cliquez sur **Arrêter **depuis votre application **Services** de Windows.
94 * **Sous Linux : **utilisez la commande** **##{{code language="shell"}}service tomcat9 stop{{/code}}##
95
96 === Étape 3 : Sauvegarde et suppression des anciennes applications ===
97
98 Sauvegardez puis effacez les fichiers et dossiers de **<install_dd>/webapps :**
99
100 (% border="0" style="width:450px" %)
101 |(% style="width:274px" %)(((
102 Dossiers :
103
104 * adminconsole
105 * ddenterpriseapi
106 * digdash_dashboard
107 * studio
108 )))|(% style="width:174px" %)(((
109 Fichiers :
110
111 * adminconsole.war
112 * ddenterpriseapi.war
113 * digdash_dashboard.war
114 * studio.war
115 )))
116
117 (% class="box warningmessage" %)
118 (((
119 ❗Ne pas effacer le dossier **ROOT**.
120 )))
121
122 === Étape 4 : Copie des nouvelles applications ===
123
124 Dézippez la nouvelle version du produit dans un emplacement temporaire.
125
126 Naviguez dans ce dossier temporaire jusque dans le dossier **webapps.**
127 Copiez les fichiers suivants dans le même dossier de votre installation :
128
129 * adminconsole.war
130 * ddenterpriseapi.war
131 * digdash_dashboard.war
132 * studio.war
133
134 Le dossier **webapps **doit maintenant contenir 4 fichiers .war et le dossier **ROOT**.
135
136 === Étape 5 : Récupération des add-ons ===
137
138 Copiez le contenu du répertoire **add-ons** vers le même endroit dans votre installation.
139 Si vous aviez modifié certains fichiers (**importtools**, **backtuptools**, ...) sauvegardez-les avant la copie.
140
141 === Étape 6 : Redémarrage du serveur ===
142
143 Redémarrez le serveur DigDash :
144
145 * **Sous Windows :** cliquez-droit sur votre service ("Tomcat 9" par défaut), puis cliquez sur **Démarrer **depuis votre application **Services** de Windows.
146 * **Sous Linux : **utilisez la commande** **##{{code language="shell"}}service tomcat9 restart{{/code}}##
147
148 et laissez Tomcat redéployer les nouvelles applications.
149
150 Sous Linux, reportez-vous au [[Guide d'installation Linux>>doc:Digdash.deployment.installation.install_guide_ubuntu.WebHome||target="_blank"]].
151 Sous Windows, reportez-vous [[Guide d'installation Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||target="_blank"]].
152
153 === Étape 7 : Restauration ===
154
155 Si vous avez configuré votre nouvelle installation pour pointer sur votre ancien dossier des données la restauration n'est pas nécessaire.
156
157 Sinon (nouveau dossier des données) utilisez la sauvegarde de l’étape 1 pour restaurer les entrées LDAP (utilisateurs, rôles, groupes d'autorisations).
158
159 (% class="box warningmessage" %)
160 (((
161 **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.
162 )))
163
164 === Étape 8 : Nettoyage du cache du navigateur ===
165
166 Supprimez le cache du navigateur (raccourcis sur la plupart des navigateurs : Ctrl + Shift + Suppr).
167
168 === Étape 9 : Régénération des modèles de données ===
169
170 (% class="box infomessage" %)
171 (((
172 (% 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.
173 )))
174
175 Dans l'onglet **Flux** du Studio, cliquez-droit sur chaque portefeuille de flux puis cliquez sur **Synchroniser pour tous les utilisateurs**.
176
177 Dans la boite **Confirmer la synchronisation du portefeuille de rôle**, cochez la case **Forcer la génération des cubes des données** des flux sélectionnés puis, la case** Forcer la génération de tous les cubes dépendants**.
178
179 [[image:Confirmer_synchro_portefeuille.png||queryString="width=397&height=260" alt="Confirmer_synchronisation" data-xwiki-image-style-alignment="center" height="260" width="397"]]
180
181 == Modification du module DDAudit{{id name="DDAudit"/}} ==
182
183 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 :
184
185 * 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.
186
187 * 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).
188
189 (% class="box warningmessage" %)
190 (((
191 ❗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.
192 )))
193
194 = (% style="color:inherit; font-family:inherit; font-size:29px" %)Modifications de comportement dans la 2023 R2(%%) =
195
196 (% class="wikigeneratedid" id="HModificationsdecomportementdansla2023R1" %)
197 {{id name="Deploiement_patch"/}}De nouvelles fonctionnalités ou la résolution de bugs dans la 2023 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 ci-dessous.
198
199 (% class="box" %)
200 (((
201 💡 Les éléments marqués d'une astérisque** *** sont ceux pour lesquels il est possible, si nécessaire, de rétablir le comportement antérieur. Veuillez consulter le paragraphe [[Rétablissement des comportements antérieurs>>doc:||anchor="Rétablissement"]] pour plus d'informations.
202 )))
203
204 == Sécurité ==
205
206 **Affichage des cubes**
207
208 L'utilisateur doit désormais avoir l'autorisation **//Gérer les serveurs//** et ajouter le paramètre **//showCubes=true//** dans l'url pour afficher les cubes dans la page de Sauvegarde.
209
210 **Import de fichiers dans l'Assistant de Création de Tableau de Bord**
211
212 L'utilisateur doit désormais avoir l'autorisation (ACL) //**Soumettre un document**// pour importer des fichiers dans l'Assistant de Création de Tableau de Bord.
213
214 == Sources de données ==
215
216 **Postgreqsl**
217
218 La propriété AUTO_COMMIT est désormais désactivée par défaut pour les requêtes sur des sources de données.
219
220 == Gestion des utilisateurs ==
221
222 (% class="wikigeneratedid" %)
223 Pour les Pages de tableaux de bord accessibles et les Objets de tableaux de bord accessibles, la valeur de l'utilisateur est désormais concaténée aux valeurs des profils qui lui sont attribués.
224
225 == Paramètres serveur ==
226
227 **Bases de données**
228
229 La modification de paramètres pour les bases de données Audit et Commentaires ne nécessite plus de redémarrage serveur.
230
231 **Variables serveur**
232
233 Le fichier **serversettings.xml** doit désormais être modifié comme suit afin d'afficher l'onglet **Variables serveur** dans les Paramètres serveur :
234
235 {{code language="shell"}}
236 # Remplacer la ligne:
237 <group category="$uisrv.Advanced" id="serverParams" name="$uisrv.ServerParams">
238
239 # Par :
240 <group id="serverParams" name="$uisrv.ServerParams" category="$uisrv.Advanced" catMenuName="$uisrv.Servers" menu="0" submenu="5">
241 {{/code}}
242
243 == Sauvegarde ==
244
245 (% class="wikigeneratedid" %)
246 Lors de la réalisation d'une sauvegarde, lorsque l'on sélectionne l'option **Exporter les fichiers dépendants (sources de données du serveur Common Datasources, icônes, feuilles de styles...)**, les images référencées dans les tableaux de bord sont désormais incluses.
247
248 == Modèles de données ==
249
250 Il n'est plus possible de réaliser une jointure à partir d'un modèle en union associative ni de réaliser une union associative sur une clé à partir d'un modèle en union associative sur une autre clé.
251
252 == Studio ==
253
254 L'interface d'édition des graphiques a été refondue afin d'améliorer l'expérience utilisateur.
255 Un ensemble de fonctionnalités / propriétés a été déplacé. Consultez la page [[Changements édition des graphiques>>doc:Digdash.user_guide.studio.Find_items.WebHome]] pour obtenir de l'aide.
256
257 == Fabriques de documents ==
258
259 Le mécanisme de numérotation des pages a changé.
260 Les fabriques de documents pour lesquelles la numérotation des pages était activée jusqu'à présent vont se voir générer une zone de texte en pied de page dans le coin inférieur droit, dont le contenu est //${builder.pageIndex}/${builder.pageCount}  //(numéro de page/nombre de pages)//.//
261
262 == Éditeur de tableau de bord ==
263
264 **Arrière-plan**
265
266 Si un arrière-plan est défini dans l'interface **Paramètres -> Propriétés -> Tableau de bord**, il s'applique désormais par défaut à tous les nouveaux rôles ajoutés.
267 [[image:Tableau_bord_arriere_plan.png||queryString="width=411&height=341" alt="Arriere-plan" height="341" width="411"]]
268
269 **Thème**
270
271 Le fichier CSS par défaut "default.css" n'est plus chargé automatiquement.
272 Pour les utilisateurs qui utilisent default.css, aucun CSS ne sera chargé. Pour continuer à l'utiliser, il faut le définir dans **l'Éditeur de tableaux de bord -> Propriétés > Thème**.
273
274 == Graphiques ==
275
276 **Tri dans les tableaux**
277
278 La flèche de tri est désormais placée à gauche de la cellule (afin d'éviter tout chevauchement avec le texte).
279
280 **Pagination des tableaux**
281
282 Une nouvelle méthode de pagination pour les très grands tableaux permet d'éviter des chargements trop longs.
283 Par défaut, la pagination est activée avec 100 lignes par page et le défilement virtuel est désactivé
284 Les boutons de pagination sont désactivés si le nombre de lignes de la page courante est inférieur au nombre total de lignes de la page défini dans l'interface utilisateur (100 par défaut).
285
286 == Export ==
287
288 **Nom de fichier**
289
290 Le nom du fichier exporté est désormais le nom du flux sans tiret. Par exemple, "//Mon flux"// est exporté dans le fichier "//Mon flux"//. Auparavant, "//Mon flux"// était exporté dans le fichier "//Mon_flux"//.
291
292 **Tableau croisé**
293
294 Lors de l'export Excel sans styles d'un tableau croisé, les cellules d'en-tête sont maintenant fusionnées.
295
296 **Export Excel**
297
298 L'export Excel sans les styles est désormais autorisé seulement pour les tableaux.
299
300 **Taille de police proportionnelle à la taille du graphique**
301
302 L'option **Taille de police proportionnelle à la taille du graphique** n'est plus disponible sur les graphiques de type Tableaux, Rapport HTML et rapport Texte. Si cette option a été activée dans une version antérieure, cela ne fonctionnera plus.
303
304 == DDAudit ==
305
306 **Liste des cubes***
307
308 La liste des cubes rafraîchis dans la base de données d'audit n'est plus nettoyée tous les jours. Elle est désormais conservée 6 mois (paramètre par défaut) dans la base de données.
309
310 **Mémoire**
311
312 Dans DDAudit, le champ //Mémoire// correspond désormais à la taille réelle du cube en mémoire.
313
314 == Divers ==
315
316 **Taille en mémoire d'un cube**
317
318 La taille en mémoire d'un cube inclut désormais la taille des données rattachées. Ainsi, la taille évolue après le chargement du cube, en fonction du chargement et de l'utilisation des données.
319
320 **Scripts et date**
321
322 La méthode getFullYear() est désormais disponible pour obtenir la date. Elle renvoie l'année de la date renseignée d'après l'heure locale.
323 Il fallait auparavant utiliser getYear() + 1900. Cette méthode peut continuer à être utilisée mais n'est pas recommandée.
324
325 == Rétablissement des comportements antérieurs{{id name="Rétablissement"/}} ==
326
327 Il peut être intéressant dans certains cas de rétablir le comportement antérieur. 
328 Pour cela, il faut éditer le fichier system.xml situé dans **<DD Install>/Enterprise Server/ddenterpriseapi/config/system.xml **et ajouter une ligne de propriété spécifiant le comportement.
329 Cette opération nécessite un redémarrage du serveur DigDash.
330
331 **Liste des cubes**
332
333 Modifiez la valeur de la propriété suivante à //false// :
334 <Property key=" PROP_AUDIT_KEEP_MISSING_CUBES" value="false"/>
335
336 = Déploiement d'un patch sur une 2023 R2{{id name="Deploiement_patch"/}} =
337
338 Ce paragraphe concerne la mise à jour d'une version 2023 R2 vers une autre 2023 R2 plus récente.
339
340 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>>doc:||anchor="Bonnes_pratiques"]].
341
342 (% class="box warningmessage" %)
343 (((
344 Si votre installation contient des développements spécifiques, qui se trouvent dans les dossiers des applications :
345 **<install_dd>/apache-tomcat/webapps/ddenterpriseapi** ou **<install_dd>/apache-tomcat/webapps/digdash_dashboard**
346 ils seront perdus lors de la mise à jour. Sauvegardez-les avant toute autre opération, afin de pouvoir les reporter après mise à jour.
347 )))
348
349 (% class="wikigeneratedid" %)
350 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.