Code source wiki de Guide de mise à jour
Modifié par mperroud le 2021/11/22 13:40
Afficher les derniers auteurs
author | version | line-number | content |
---|---|---|---|
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]](%%). |