Code source wiki de Guide de mise à jour

Modifié par mperroud le 2021/11/22 13:40
Masquer les derniers auteurs
mperroud 4.1 1 {{ddtoc/}}
2
3 ----
4
5 (% class="box errormessage" %)
6 (((
7 **Attention : Avant toute migration, faire une sauvegarde intégrale de l’application depuis la page d’accueil => Configuration => Gestion des sauvegardes.**
8 )))
9
10 (% class="box warningmessage" %)
11 (((
12 **Important : Migration des développements spécifiques (toutes versions)**
13 \\Cette procédure ne prend pas en compte la migration de développements spécifiques (modification de logos, adjonction de JSP,...) qui peut être décrite dans vos procédures internes.
14 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.
15 )))
16
17 (% class="box successmessage" %)
18 (((
19 **Nouveauté importante de cette version **: 
20 \\Le **Desktop Studio** était obsolète en 2021 R1 et a été **supprimé **définitivement depuis cette version 2021 R2.
21 Le Studio Web est donc devenu l'unique moyen de construire vos sources de données et vos graphiques.
22 Vous n'aurez plus à gérer les complications liées à l'installation et la mise à jour de Java sur les postes clients.
23
24 Attention : l'usage de l'ancien Desktop Studio dans un environnement 2021 R2 ou supérieur n'est pas supporté.
25 )))
26
27 Les archives d’installation de DigDash Enterprise sont nommées sous le modèle **digdash_enterprise_2021R2_64.zip** ou **digdash_enterprise_2021R2_numpatch_64.zip.**
28 Après extraction, le dossier s’appellera **digdash_enterprise_2021R2_64** ou **digdash_enterprise_2021R2_numpatch_64**.
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 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** »).
32
33 **Prérequis minimum :**
34
35 * Serveur : Tomcat 8
36 * Serveur : Java 8
37 * Web Studio : aucun prérequis (accessible dans le navigateur web comme le tableau de bord)
38
39 **Recommendations :**
40
41 * Serveur : **Tomcat 9** (Windows et Linux)
42 * Serveur : **Java 11** (Windows)
43 * Web Studio : aucun prérequis (accessible dans le navigateur web comme le tableau de bord)
44
45 Sous linux vous devrez au minimum installer Java en suivant les recommendations du [[Guide d'installation>>doc:Digdash.deployment.installation.install_guide_linux.WebHome||target="_blank"]].
46
47 = Premier déploiement de la 2021 R2 =
48
49 Ce paragraphe vous concerne si vous déployez pour la 1ère fois la version 2021 R2.
50 Dans le cas du déploiement d'un patch pour la 2021 R2, voir le chapitre [[Déploiement d'un patch sur une 2021 R2>>doc:||anchor="HDE9ploiementd27unpatchsurune2021R1"]].
51
52 (% class="box successmessage" %)
53 (((
54 Depuis la version précédente (2021 R1) le processus d'installation, de configuration et de maintenance (installation d'un patch ou intervention du support) a été simplifié.
55 Si vous n'avez pas déjà suivi cette procédure de configuration en 2021 R1 il est intéressant et vivement recommandé de reprendre de zéro l'installation.
56 Le nouveau système de configuration vous fera gagner du temps par la suite.
57 )))
58
59 Le principe général est de n'avoir à modifier qu'un seul fichier : **digdash.properties**, qui sera préservé automatiquement lors d'une prochaine mise à jour.
60 Ce fichier est fourni dans l'archive d'installation et comporte déjà tous les paramètres succeptibles d'être personnalisés lors de l'installation.
61
62 On distinguera deux cas principaux : utilisation du serveur Tomcat fourni (windows ou linux) ou utilisation de votre propre Tomcat.
63
64 == Utilisation du Tomcat fourni ==
65
66 === Étape 1 : Sauvegarde ===
67
68 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.
69 Si vous aviez ajouté des fichiers à votre installation (modification de logos, imags, css, adjonction de JSP, ...) il faudra les reporter dans la nouvelle installation.
70
71 Voir documentation [[Sauvegarde et restauration>>doc:Digdash.deployment.configuration.backup_restore.WebHome]].
72
73 === Étape 2 : Arrêt du serveur ===
74
75 Arrêtez le serveur DigDash à l'aide de : **<install_dd_OLD>/stop_tomcat.bat**.
76 Ou sous Linux **<install_dd_OLD>/apache-tomcat/bin/shutdown.sh.**
77 Ou arrêtez le service correspondant.
78
79 === Étape 3 : Extraction ===
80
81 * Dézippez **digdash_enterprise_2021R2_numpatch_64.zip** à l'emplacement de votre choix grâce à un outils comme [[7Zip>>https://www.7-zip.org||rel="noopener noreferrer" target="_blank"]].
82 * Renommez le dossier contenant l'installation. L'idéal est un nom sans version, pour ne pas induire en erreur sur le contenu de l'installation lors des mises à jour à venir.
83 * Vérifiez que votre dossier d'installation contient le fichier **version.txt**. C'est lui qui indiquera de manière certaine la version du produit (sans avoir à démarrer le serveur).
84
85 === Étape 4 : Paramétrage ===
86
87 (% class="box infomessage" %)
88 (((
89 Si vous êtes sous Linux, copiez le fichier **<install_dd_NEW>/digdash.properties** dans le dossier **/etc/digdash.**
90 Il sera trouvé automatiquement par le serveur.
91 Veillez à ce que dossiers et fichiers aient les mêmes droits que l'utilisateur exécutant le service Tomcat.
92 )))
93
94 Editez le fichier **<install_dd_NEW>/digdash.properties**.
95
96 (% class="box infomessage" %)
97 (((
98 Les lignes commençant par un seul caractère **#** sont celles à modifier.
99 En supprimant le caractère **#** en début de ligne vous activez le paramètre.
100 )))
101
102 ==== Emplacement des données ====
103
104 (% class="box successmessage" %)
105 (((
106 Lors de la configuration portez une attention particulière aux paramètres **digdash.appdata** ou **<application>.AppDataPath**.
107 L'idéal est d'utiliser le paramètre global **digdash.appdata** : toutes les applications utiliserons alors le même dossier racine.
108 )))
109
110 Pour spécifier un emplacement commun à toutes les applications DigDash (ldap, serveur, studio, ...) il faut modifier le paramètre **digdash.appdata** :
111
112 (% class="box" %)
113 (((
114 #digdash.appdata=C:/appdata
115 )))
116
117 devient :
118
119 (% class="box" %)
120 (((
121 digdash.appdata=C:/appdata
122 )))
123
124 (% class="box warningmessage" %)
125 (((
126 Attention à n'utiliser que des slash "/", ou deux anti-slash "~\~\".
127 )))
128
129 Attention au dossier des données de l'annuaire LDAP. Il s'agit du dossier **ldapdigdash** (si vous ne l'aviez pas modifié).
130
131 * Si vous utilisez le paramètre global **digdash.appdata** alors il faudra déplacer votre ancien dossier **ldapdigdash **dans le dossier spécifié dans ce paramètre.
132 * Si vous voulez continuer à placer le dossier **ldapdigdash **dans un autre emplacement, utilisez le paramètre **adswrapper.ads.instance.name**.
133
134 (% class="box warningmessage" %)
135 (((
136 Toutes les applications dans le même dossier (même LDAP) :
137
138 * digdash.appdata=C:/data
139 )))
140
141 (% class="box warningmessage" %)
142 (((
143 Pour un dossier LDAP séparé :
144
145 * (((
146 adswrapper.ads.instance.name=D:/data/ldapdigdash
147 )))
148 )))
149
150 ==== Les autres paramètres ====
151
152 Tous les autres paramètres présents dans ce fichier sont préfixés du nom de l'application concernée :
153
154 (% class="box infomessage" %)
155 (((
156 <nom de l'application>.<nom du paramètre>=<valeur>
157 )))
158
159 Vous devez ainsi reporter tous les paramètres que vous aviez modifiés dans les fichiers **web.xml** de votre ancienne installation.
160
161 Par exemple, pour modifier la méthode d'authentification (**authMethod**) au Tableau de bord (**digdash_dashboard**.war) il faut modifier le paramètre **digdash_dashboard.authMethod**.
162
163 (% class="box" %)
164 (((
165 #digdash_dashboard.authMethod=default/NTUser/NTUserOrLDAP/NTUserOrLDAP,loginForm/Custom
166 )))
167
168 devient :
169
170 (% class="box" %)
171 (((
172 digdash_dashboard.authMethod=default/NTUser/NTUserOrLDAP/NTUserOrLDAP,loginForm/Custom
173 )))
174
175 === Etape 5 : Démarrage ===
176
177 Une fois que vous avez reporté tous les paramètres de votre ancienne installation dans le fichier **digdash.properties**, démarrez TOMCAT à l'aide de **<install_dd_NEW>/start_tomcat.bat** et laissez Tomcat redéployer les nouvelles applications.
178 Ou sous Linux **<install_dd_OLD>/apache-tomcat/bin/startup.sh.**
179
180 Pour une installation en tant que service sous Windows, utilisez le script **<install_dd_NEW>/configure/servers_install_service.bat** (attention au nom du service si vous l'aviez modifié lors de la précédente installation, référez vous au** **[[Guide d'installation Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||target="_blank"]] pour plus de détails).
181
182 Sous linux reportez vous au [[Guide d'installation Linux>>doc:Digdash.deployment.installation.install_guide_linux.WebHome||target="_blank"]].
183 Plus d'informations sur l'installation en tant que service dans le [[Guide d'installation Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||target="_blank"]].
184
185 === Étape 6 : Restauration ===
186
187 Si vous avez configuré votre nouvelle installation pour pointer sur votre ancien dossier des données (voir [[Etape 5>>doc:||anchor="HC9tape5A0:DossierdesdonnE9es"]]) la restauration n'est pas nécessaire.
188
189 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).
190
191 __**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.
192
193 //__Note__ : Si vous venez d’une version 2017 R1 et si vous avez customisé les styles du tableau de bord, veuillez vous référer à la documentation [[Personnalisation>>doc:Digdash.customization.customization_DDE.WebHome]] pour mettre à jour vos styles CSS.//
194
195 === Étape 7 : Nettoyage du cache du navigateur ===
196
197 Supprimez le cache du navigateur (raccourcis sur la pluspart des navigateurs : Ctrl + Shift + Suppr)
198
199 == Utilisation de votre Tomcat ==
200
201 Si vous utilisez votre propre serveur Tomcat (Windows ou linux), la procédure à suivre est la même que pour le[[ déploiement d'un patch>>doc:||anchor="HDE9ploiementd27unpatchsurune2021R1"]],
202 vous pouvez donc suivre la procédure du [[chapitre suivant>>doc:||anchor="HDE9ploiementd27unpatchsurune2021R1"]].
203
204 Seule l'**étape 6 : Récupération des add-ons** sera à adapter.
205 Vous n'aurez qu'à copier le dossier add-ons où cela vous convient (vous l'avez peut être déjà sur votre machine, mais il peut contenir des mises à jour).
206
207 = Mise à jour 2021 R1 ou 2021 R2 (fichier digdash.properties déjà configuré) =
208
209 Ce paragraphe concerne la mise à jour d'une version 2021 R1 ou 2021 R2 vers une 2021 R2 plus récente.
210 Prérequis : votré déploiement est déjà configuré à l'aide du fichier **digdash.properties**. Si ce n'est pas le cas veuillez utilisez [[chapitre précédent>>doc:||anchor="HPremierdE9ploiementdela2021R2"]].
211
212 (% class="box infomessage" %)
213 (((
214 La procédure qui suit part du principe que votre configuration suit la recommandation d'utiliser le fichier **digdash.properties**. Si cela n'est pas fait, référez vous au [[premier chapitre>>doc:||anchor="HPremierdE9ploiementdela2021R1"]].
215 )))
216
217 (% class="box warningmessage" %)
218 (((
219 Si votre installation contient des développements spécifiques, qui se trouvent dans les dossiers des applications :
220 **<install_dd>/apache-tomcat/webapps/ddenterpriseapi** ou **<install_dd>/apache-tomcat/webapps/digdash_dashboard**
221 ils seront perdus lors de la mise à jour. Sauvegardez les avant toute autre opération, afin de pouvoir les reporter après mise à jour.
222 )))
223
224 == Étape 1 : Sauvegarde ==
225
226 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.
227
228 N'oubliez pas les éventuels développements spécifiques pouvant se trouver dans les applications (voir l'encadré jaune précédent).
229
230 Voir documentation [[Sauvegarde et restauration>>doc:Digdash.deployment.configuration.backup_restore.WebHome]].
231
232 == Étape 2 : Arrêt du serveur ==
233
234 Arrêtez le serveur DigDash à l'aide de : **<install_dd>/stop_tomcat.bat**
235 Ou arrêtez le service correspondant.
236
237 == Étape 3 : Suppression des anciennes applications ==
238
239 Sauvegardez puis effacez les fichiers et dossiers de **<install_dd>/apache-tomcat/webapps :**
240
241 (% border="0" %)
242 |(((
243 Dossiers :
244
245 * adminconsole
246 * ddenterpriseapi
247 * digdash_dashboard
248 * studio
249 * adswrapper
250 )))|(((
251 Fichiers :
252
253 * adminconsole.war
254 * ddenterpriseapi.war
255 * digdash_dashboard.war
256 * studio.war
257 * adswrapper.war
258 )))
259
260 (% class="box warningmessage" %)
261 (((
262 Ne pas effacer le dossier **ROOT**.
263 )))
264
265 (% class="box warningmessage" %)
266 (((
267 Ne pas effacer le dossier **ldapdigdash**.
268 )))
269
270 == Étape 4 : Copie des nouvelles applications ==
271
272 Dézippez la nouvelle version du produit dans un emplacement temporaire.
273
274 Naviguez dans ce dossier temporaire jusque dans le dossier **apache-tomcat/webapps.**
275 Copiez les 5 fichiers suivants dans le même dossier de votre installation :
276
277 * adminconsole.war
278 * ddenterpriseapi.war
279 * digdash_dashboard.war
280 * studio.war
281 * adswrapper.war
282
283 Le dossier **webapps **doit maintenant contenir 5 fichiers .war et le dossier **ROOT**.
284
285 == Étape 5 : Fichier version.txt ==
286
287 Copiez le fichier **version.txt** dans votre dossier d'installation. Il remplacera celui de la précédente installation.
288
289 (% class="box infomessage" %)
290 (((
291 Ce fichier permet de connaître la version du produit sans démarrer le serveur ou si la page "Etat du serveur" n'est pas disponible.
292 )))
293
294 == Étape 6 : Récuparation des add-ons ==
295
296 Copiez le contenu du répertoire **add-ons** vers le même endroit dans votre installation.
297 Si vous aviez modifiés certains fichiers (**importtools**, **backtuptools**, ...) sauvegardés les avant la copie.
298
299 == Étape 7 : Démarrage ==
300
301 Démarrez Tomcat à l'aide de **start_tomcat.bat /startup.sh** et laissez Tomcat redéployer les nouvelles applications.
302
303 Si vous êtes en mode service relancez le manuellement.
304
305 == Étape 8 : Nettoyage du cache du navigateur ==
306
307 Supprimez le cache du navigateur (raccourcis sur la pluspart des navigateurs : Ctrl + Shift + Suppr)
308
309 = Version 2018 R2 ou inférieure vers 2021 R2 =
310
311 (% class="wikigeneratedid" %)
312 Contactez DigDash à l’adresse [[(% class="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]](%%).