Guide de mise à jour

1

Ce document explique les différentes étapes à suivre pour mettre à jour votre déploiement DigDash Enterprise vers une nouvelle version.

2

3

(% class="box errormessage" %)

4

(((

5

**Attention : Avant toute migration, faire une sauvegarde intégrale de l’application depuis la page d’accueil => Configuration => Gestion des sauvegardes.**

6

)))

7

8

(% class="box warningmessage" %)

9

(((

10

**Important : Incompatibilité Tomcat 7 / adswrapper ( version 2018 R2 et supérieure)**

11

A partir de la version 2018R2, adswrapper.war (annuaire LDAP) est incompatible avec Tomcat 7. Vous devez soit mettre à jour votre Tomcat, soit conserver votre fichier adswrapper.war lors de la procédure.

12

)))

13

14

(% class="box warningmessage" %)

15

(((

16

**Important : Migration des développements spécifiques (toutes versions)**

17

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.

18

Si des développements spécifiques ont été faits, procédez à une copie de sauvegarde de l’ancienne application afin de pouvoir récupérer et migrer tous ces développements.

19

)))

20

21

(% class="box warningmessage" %)

22

(((

23

**Important : Changement technologique dans l’application de tableau de bord (2017 R2 et supérieure)**

24

Dans les versions 2017 R2 (2017B0929) et supérieures, un changement de technologie dans le tableau de bord entraîne des incompatibilités des styles CSS.

25

Si vous venez d’une version antérieure à 2017 R2 et si vous avez customisé les styles du tableau de bord, veuillez vous référer à la documentation** [[Styles CSS>>doc:Digdash.customization.customization_DDE.customization_css.WebHome||anchor="css_migration"]].**

26

)))

27

28

Les dossiers d’installation de DigDash Enterprise sont nommées sous le modèle **digdash_enterprise_numversion_64.zip** ou **install_dd_numversion_64.zip**.

29

30

Après dézippage, le dossier s’appellera **digdash_enterprise_numversion** ou **install_dd_numversion**.

31

32

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.**

33

34

Le numéro de version est visible depuis la page « **Configuration **/ **État du serveur** »

35

36

(« Version DigDash Enterprise » en haut à gauche dans la rubrique « **État général** »).

__**Prérequis :**__

* Serveur : Java 8 minimum (Tomcat 8 minimum si vous utilisez adswrapper.war)

42

* Desktop Studio : Java 7 minimum

43

44

(% id="cke_bm_180S" style="display:none" %)

45

46

Consultez le chapitre adapté à votre version actuelle

* Version actuelle : 2016 ou inférieure => Contactez 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" %)__contact@digdash.com__>>path:mailto:contact@digdash.com]](%%).

51

52

= Mise à jour vers une version 2020 R1 =

53

54

Ce paragraphe concerne la mise à jour de toutes les versions à partir de 2017 R1 vers une version 2020 R1.

(% class="box" %)

(((

(% style="color:#e74c3c" %)__**Nouveauté 2020 R1**__(%%) :

59

\\**Web Studio **: La précédente version du Studio, maintenant appelée **Desktop Studio**, nécessitait d’installer Java sur le poste client. La nouvelle version s’exécute dans votre navigateur internet, comme le fait l’éditeur de tableau de bord. Java n’est donc plus obligatoire sur le poste client.

60

\\Cette nouveauté s’accompagne d’un nouveau fichier war (studio.war) à prendre en compte lors du déploiement (cf. [[(% 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" %)__Étape 6__>>path:#y2dhwluwi999]](%%)) .

61

)))

62

63

__**Étape 1**__** :**

64

65

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.

66

67

Voir documentation [[Sauvegarde et restauration>>doc:Digdash.deployment.configuration.backup_restore.WebHome]].

__**Étape 2 :**__

Arrêtez les serveurs DigDash (TOMCAT, LDAP ) à l'aide de : **<install_dd_OLD>/stop_tomcat.bat **ou **<install_dd_OLD>/stop_servers.bat**

__**Étape 3 :**__

Sauvegardez puis effacez les fichiers et dossiers de **<install_dd_OLD>/apache-tomcat/webapps/**

78

79

(Attention : Ne pas effacer le dossier ROOT) :

80

81

* adminconsole (dossier)

82

* adminconsole.war (fichier)

83

* ddenterpriseapi (dossier)

84

* ddenterpriseapi.war (fichier)

85

* digdash_dashboard (dossier)

86

* digdash_dashboard.war (fichier)

87

88

__**Étape 4**__** :**

89

90

Si vous souhaitez mettre à jour adswrapper, utilisez une version de Tomcat au moins égale à la version 8 (fournie par DigDash à partir de la version 2018 R2) et supprimez les fichiers suivants :

91

92

* adswrapper.war (fichier)

93

* adswrapper (dossier)

94

* ldapdigdash (sauvegardez le dossier avant de le supprimer).

95

96

Attention à bien valider que votre sauvegarde de l’étape 1 contient les entrées LDAP.

97

98

99

__**Étape 5**__** :**

100

101

Dézippez **digdash_enterprise_numversion_64.zip** et naviguez dans **<install_dd_NEW>/apache- tomcat/webapps/**

102

103

104

__**Étape 6**__** :**

105

106

Copiez les 5 fichiers suivants depuis **<install_dd_NEW>/apache-tomcat/webapps** vers **<install_dd_OLD >/apache-tomcat/webapps/** :

107

108

* **adminconsole.war** (Desktop Studio, nécessite Java 7 sur le poste client)

109

* **studio.war** (Web Studio)

110

* **ddenterpriseapi.war**

111

* **digdash_dashboard.war**

112

* **adswrapper.war** (seulement si vous l’avez supprimé à l’étape 4).

113

114

Le dossier **webapps** doit maintenant contenir 5 fichiers .war et le dossier** ROOT.**

115

116

117

__**Étape 7**__** :**

118

119

__Supprimez les dossiers :__

120

121

* <install_dd_OLD>/documentation

122

* <install_dd_OLD>/apache- tomcat/webapps/ROOT/documentation

123

* <install_dd_OLD>/add-ons

124

125

__Extraire et copier la documentation et les add-ons :__

126

127

* Copiez le répertoire **<install_dd_NEW>/documentation** vers **<install_dd_OLD>**

128

129

* Copiez le répertoire **<install_dd_NEW>/apache-tomcat/webapps/ROOT/documentation** vers **<install_dd_OLD>/apache-tomcat/webapps/ROOT**

130

131

* Copiez le répertoire** <install_dd_NEW>/add-ons** vers** <install_dd_OLD>**

132

133

Vous pouvez renommer le dossier **<install_dd_OLD>** en **<install_dd_AAAAMMJJ>** où AAAAMMJJ correspondant à la date du jour.

134

135

136

__**Étape 8**__** :**

137

138

Démarrez simplement TOMCAT à l'aide de **<install_dd_AAAAMMJJ>/start_tomcat.bat** et laissez TOMCAT redéployer les nouvelles applications.

139

140

141

__**Étape 9**__** :**

142

143

Supprimez le cache du navigateur.

144

145

146

__**Étape 10**__** :**

147

148

Utilisez la sauvegarde de l’étape 1 pour restaurer les entrées LDAP (utilisateurs, rôles, groupes d'autorisations) si vous avez mis à jours adswrapper à l’étape 4. Voir documentation [[Guide de configuration>>doc:Digdash.deployment.configuration.configuration_guide.II_configuration.WebHome]], chapitre « **Sauvegarder les données** ».

149

150

__**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.

151

152

//__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.//

153

154

= Mise à jour vers une version patchée =

155

156

Ce paragraphe concerne la mise à jour de versions 2017, 2018, 2019 ou 2020 vers une version patchée :

157

158

• 2020 R1 vers 2020 R1 patchée

159

160

• 2019 R2 vers 2019 R2 patchée

161

162

• 2019 R1 vers 2019 R1 patchée

163

164

• 2018 R2 vers 2018 R2 patchée

165

166

• 2018 R1 vers 2018 R1 patchée

167

168

• 2017 R2 (2017B0929) vers 2017 R2 patchée

169

170

• 2017 R1 (2017B0329) vers 2017 R1 patchée

171

172

173

__**Étape 1**__** :**

174

175

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. Voir documentation [[Guide de configuration>>doc:Digdash.deployment.configuration.configuration_guide.II_configuration.WebHome]], chapitre « Sauvegarder les données ».

176

177

178

__**Étape 2**__** :**

179

180

Arrêtez les serveurs DigDash (TOMCAT, LDAP) à l'aide de : **<install_dd_OLD>/stop_tomcat.bat **ou **<install_dd_OLD>/stop_servers.bat**

181

182

183

__**Étape 3**__** :**

184

185

Sauvegardez puis effacez les fichiers et dossiers de **<install_dd_OLD>/apache-tomcat/webapps/**

186

187

(Attention : Ne pas effacer le dossier ROOT) :

188

189

|(((

190

* adminconsole (dossier)

191

* adminconsole.war (fichier)

192

* studio (dossier) (si présent)

193

* studio.war (fichier) (si présent)

194

)))|(((

195

* ddenterpriseapi (dossier)

196

* ddenterpriseapi.war (fichier)

197

* digdash_dashboard (dossier)

198

* digdash_dashboard.war (fichier)

199

)))

200

201

Ne pas effacer les fichiers et dossiers suivants s'ils sont présents sur votre serveur :

202

203

* adswrapper (dossier)

204

* adswrapper.war (fichier)

205

* ldapdigdash (dossier)

206

207

__**Étape 4**__** :**

208

209

Dézippez** install_dd_NEW** et naviguez dans **<install_dd_NEW>/apache-tomcat/webapps/**

210

211

212

__**Étape 5**__** :**

213

214

Copiez les 3 fichiers suivants depuis <**install_dd_NEW>/apache-tomcat/webapps** vers **<install_dd_OLD >/apache-tomcat/webapps/** :

215

216

* adminconsole.war

217

* ddenterpriseapi.war

218

* digdash_dashboard.war

219

220

Le dossier **webapps **doit maintenant contenir 4 fichiers .war, un dossier **adswrapper** et le dossier **ROOT**.

221

222

Depuis la version **2020 R1**, copiez aussi le fichier **studio.war**.

223

224

225

__**Étape 6**__** :**

226

227

Extraire et copier la documentation et les add-ons :

228

229

* Copiez le contenu du repertoire **<instal_dd_NEW>/documentation** vers **<install_dd_OLD>/documentation**

230

231

* Copiez le contenu du répertoire **<install_dd_NEW>/apache- tomcat/webapps/ROOT/documentation** vers **<install_dd_OLD>/apache- tomcat/webapps/ROOT/documentation**

232

233

* Copiez le contenu du répertoire **<install_dd_NEW>/add-ons** vers **<install_dd_OLD>/add-ons**

234

235

Vous pouvez renommer le dossier **<install_dd_OLD>** en **<install_dd_AAAAMMJJ> **où AAAAMMJJ correspondant à la date du jour.

236

237

238

__**Étape 7**__** :**

239

240