Wiki source code of Guide de mise à jour

Last modified by jhurst on 2021/04/21 10:01
Show last authors
1 This document describes the different steps needed to upgrade your existing DigDash Enterprise deployment to a newer version.
2
3 Please read the chapter corresponding to your current version:
4
5 * [[(% class="wikiinternallink wikiinternallink wikiinternallink" %)__Upgrade to the 2019 R1 version__>>path:#r3970hngm770]]
6 * [[(% class="wikiinternallink wikiinternallink wikiinternallink" %)__Upgrade to a patched version__>>path:#tow7c5fzgsv6]]
7 * Current version: 2016 or inferior => Contact our support
8
9 (% style="color:#e74c3c" %)__**Important:**__** Before any migration, make a full backup of the application from the home page => Configuration => Backup Management.**
10
11 (% style="color:#e74c3c" %)__**Important: Tomcat 7 / adswrapper incompatibility (version 2018R2 and above)**__
12
13 In 2018 R2, the new version of adswrapper.war (LDAP directory) is incompatible with Tomcat 7. You must either upgrade your Tomcat or keep your adswrapper.war file during the procedure.
14
15 (% style="color:#e74c3c" %)__**Important: Migration of specific developments (all versions)**__
16
17 This procedure does not take into account the migration of specific developments (modification of logos, addition of JSP, ...) that can be described in your internal procedures. If specific developments have been made, you should backup the old application in order to recover and migrate all these developments.
18
19 (% style="color:#e74c3c" %)__**Important: Technological update in the dashboard application (2017 R2 and above)**__
20
21 In the 2017 R2 (2017B0929) and later versions, a change in the technology of the dashboard application leads to incompatibilities on some CSS styles. If you come from a version prior to 2017R2 and if you have customized dashboard styles, please refer to the documentation **customization_en.pdf.**
22
23
24 The installation folders for DigDash Enterprise are named under the template **install_dd_numversion_64.zip ou digdash_enterprise_numversion_64.zip**
25
26 After unzipping, the file will be called **install_dd_numversion** or **digdash_enterprise_numversion.**
27
28 To clarify the procedure, the installation folder for the older version will be named **install_dd_OLD** and the installation folder of the most recent version will be **install_dd_NEW.**
29
30 DigDash Enterprise version is visible in the "Configuration/server Status" page ("DigDash Enterprise Version" at the top left in the "Global Status" section).
31
32
33
34 (% start="1" style="list-style-type:upper-roman" %)
35 1. (((
36 == __**UPGRADE TO THE 2019 R1 VERSION**__ ==
37 )))
38
39 This section is about updating all versions from 2017R1 to 2019R1.
40
41 __**Step 1 :**__
42
43 Make a full backup of your configuration: LDAP entries (users, roles, permission groups), data models, dashboards, and so on.
44
45 See documentation **configuration_guide_fr.pdf**, chapter "**Save data**".
46
47 __**Step 2 :**__
48
49 Stop the DigDash servers (TOMCAT, LDAP) using:
50
51 **<install_dd_OLD>/stop_tomcat.bat **or **<install_dd_OLD>/stop_servers.bat**
52
53 __**Step 3 :**__
54
55 Save and delete the files and folders of **<install_dd_OLD>/apache-tomcat/webapps/**
56
57 (Caution: Do not delete the ROOT folder) :
58
59 * adminconsole (folder)
60 * adminconsole.war (file)
61 * ddenterpriseapi (folder)
62 * ddenterpriseapi.war (file)
63 * digdash_dashboard (folder)
64 * digdash_dashboard.war (file)
65
66 __**Step 4:**__
67
68 If you want to upgrade adswrapper, use a version of Tomcat at least equal to version 8 (provided by DigDash from version 2018 R2) and delete the following files:
69
70 * adswrapper.war (file)
71 * adswrapper (folder)
72 * ldapdigdash (save the file before deleting it).
73
74 Be sure to validate that your backup of step 1 contains the LDAP entries.
75
76
77 __**Step 5 :**__
78
79 Unzip **digdash_enterprise_numversion_64.zip** and navigate in **<install_dd_NEW>/apache- tomcat/webapps/**
80
81
82 __**Step 6 :**__
83
84 Copy the following 4 files from **<install_dd_NEW>/apache-tomcat/webapps** to **<install_dd_OLD >/apache-tomcat/webapps/** :
85
86 * adminconsole.war
87 * ddenterpriseapi.war
88 * digdash_dashboard.war
89 * adswrapper.war (only if you deleted it at step 4).
90
91 The **webapps** folder now needs to contain 4 files .war and the **ROOT** folder.
92
93
94 __**Step 7 :**__
95
96 __Delete the folders :__
97
98 * <install_dd_OLD>/documentation
99 * <install_dd_OLD>/apache- tomcat/webapps/ROOT/documentation
100 * <install_dd_OLD>/add-ons
101
102 __Extract and copy the documentation and the add-ons :__
103
104 * Copy the directory **<install_dd_NEW>/documentation** vers **<install_dd_OLD>**
105
106 * Copy the directory **<install_dd_NEW>/apache-tomcat/webapps/ROOT/documentation** vers **<install_dd_OLD>/apache-tomcat/webapps/ROOT**
107
108 * Copy the directory** <install_dd_NEW>/add-ons** vers** <install_dd_OLD>**
109
110 You can rename the folder **<install_dd_OLD>** in **<install_dd_AAAAMMJJ>** where AAAAMMJJ corresponds to a date.
111
112
113 __**Step 8 :**__
114
115 Just start TOMCAT with the help of **<install_dd_AAAAMMJJ>/start_tomcat.bat** and let TOMCAT redeploy the new applications.
116
117
118 __**Step 9 :**__
119
120 Clean the browser cache.
121
122
123 __**Step 10 :**__
124
125 Use the backup from step 1 to restore the LDAP entries (users, roles, permission groups) if you upgraded adswrapper in step 4. See documentation **configuration_guide_en.pdf**, chapter "Backing Up Data."
126
127 __**Important :**__ if you made changes in the ddenterpriseapi and digdash_dashboard folders on configuration files (web.xml, ...), images or css files, you will have to postpone them.
128
129 //__Note :__ If you update from a 2017R1 version and have customized the dashboard styles, please refer to the **customization_en.pdf** documentation to upgrade your CSS styles.//
130
131
132 (% start="2" style="list-style-type:upper-roman" %)
133 1. (((
134 == __**UPGRADE TO A PATCHED VERSION**__ ==
135 )))
136
137 This paragraph is about upgrading the 2017 or 2018 versions to a patched version:
138
139 • 2019 R1 to 2019 R1 patched
140
141 • 2018 R2 to 2018 R2 patched
142
143 • 2018 R1 to 2018 R1 patched
144
145 • 2017 R2 (2017B0929) to 2017 R2 patched
146
147 • 2017 R1 (2017B0329) to 2017 R1 patched
148
149
150 __**Step 1 :**__
151
152 Make a full backup of your configuration: LDAP entries (users, roles, permission groups), data models, dashboards, and so on. See documentation **configuration_guide_en.pdf**, chapter "Save data".
153
154
155 __**Step 2 :**__
156
157 Stop the DigDash servers (TOMCAT, LDAP) using: **<install_dd_OLD>/stop_tomcat.bat **ou **<install_dd_OLD>/stop_servers.bat**
158
159
160 __**Step 3 :**__
161
162 Back up and then delete the files and folders from **<install_dd_OLD>/apache-tomcat/webapps/**
163
164 (Caution: Do not delete the ROOT folder):
165
166 * adminconsole (folder)
167 * adminconsole.war (file)
168 * ddenterpriseapi (folder)
169 * ddenterpriseapi.war (file)
170 * digdash_dashboard (folder)
171 * digdash_dashboard.war (file)
172
173 Do not delete the following files and folders if they are present on your server:
174
175 * adswrapper (folder)
176 * adswrapper.war (file)
177 * ldapdigdash (folder)
178
179 __**Step 4 :**__
180
181 Unzip** install_dd_NEW** and navigate in **<install_dd_NEW>/apache-tomcat/webapps/**
182
183
184 __**Step 5 :**__
185
186 Copy the following 3 files from <**install_dd_NEW>/apache-tomcat/webapps** to **<install_dd_OLD >/apache-tomcat/webapps/** :
187
188 * adminconsole.war
189 * ddenterpriseapi.war
190 * digdash_dashboard.war
191
192 The **webapps **folders** **should now contain 4 .war files, an **adswrapper** folder, and the **ROOT **folder.
193
194
195 __**Step 6 :**__
196
197 Extract and copy the documentation and the add-ons:
198
199 * Copy the contents of the directory **<instal_dd_NEW>/documentation** to **<install_dd_OLD>/documentation**
200
201 * Copy the contents of the directory **<install_dd_NEW>/apache- tomcat/webapps/ROOT/documentation** to **<install_dd_OLD>/apache- tomcat/webapps/ROOT/documentation**
202
203 * Copy the contents of the directory **<install_dd_NEW>/add-ons** to **<install_dd_OLD>/add-ons**
204
205 You can rename the folder **<install_dd_OLD>** in **<install_dd_AAAAMMJJ> **where AAAAMMJJ corresponds to a date.
206
207
208 __**Step 7 **__**:**
209
210 Just start TOMCAT using **<install_dd_AAAAMMJJ>/start_tomcat.bat** and let TOMCAT redeploy the new applications.
211
212
213 __**Step 8 :**__
214
215 Clear your browser cache.
216
217