Wiki source code of Upgrade Feedback (10.x)

Last modified by Vincent Massol on 2024/11/19 16:15

Hide last authors
Ecaterina Moraru (Valica) 2.1 1 {{toc start="2"/}}
2
3 == Requirements ==
4
5 > We regularly see users having problems to upgrade (cf forum, irc, mailing lists) and we’d need to list the common issues they have. Their problems may not be related to the UI but to bugs/limitations we currently have.
Ecaterina Moraru (Valica) 2.2 6
Ecaterina Moraru (Valica) 3.3 7 (% class="row" %)
8 (((
9 (% class="col-xs-12 col-sm-6" %)
10 (((
Ecaterina Moraru (Valica) 2.283 11 {{error}}
Ecaterina Moraru (Valica) 2.285 12 (%style="margin-top: 0;"%)
Ecaterina Moraru (Valica) 3.4 13 == **Top 5 Usability** issues we need to fix ==
Ecaterina Moraru (Valica) 2.283 14
Ecaterina Moraru (Valica) 2.282 15 Selection made by @evalica:
Ecaterina Moraru (Valica) 2.276 16
Ecaterina Moraru (Valica) 3.2 17 {{include reference="Proposal.Upgrade.SimplerUpgrade.Feedback.UsabilitySelectionEasyUpgrades11x.WebHome"/}}
Ecaterina Moraru (Valica) 2.280 18
Ecaterina Moraru (Valica) 2.278 19 {{/error}}
Ecaterina Moraru (Valica) 3.3 20 )))
Ecaterina Moraru (Valica) 2.276 21
Ecaterina Moraru (Valica) 3.3 22 (% class="col-xs-12 col-sm-6" %)
23 (((
Ecaterina Moraru (Valica) 3.6 24 {{box}}
Ecaterina Moraru (Valica) 3.8 25 (%style="margin-top: 0;"%)
Ecaterina Moraru (Valica) 3.10 26 == New features / improvements that need **design proposals** ==
Ecaterina Moraru (Valica) 2.276 27
Ecaterina Moraru (Valica) 3.9 28 * Invalid extensions step: step in DW that display the invalid extensions and ask the user to remove them.
Ecaterina Moraru (Valica) 3.5 29
Ecaterina Moraru (Valica) 3.9 30 * Environment validation step: step in the beginning of DW that validates the configuration found locally and suggest improvements in order for the instance to work properly.
Ecaterina Moraru (Valica) 3.6 31 {{/box}}
Ecaterina Moraru (Valica) 3.3 32 )))
33 )))
34
35
Ecaterina Moraru (Valica) 2.127 36 (% class="row" %)
37 (((
38 (% class="col-xs-12 col-sm-6" %)
39 (((
Ecaterina Moraru (Valica) 2.152 40 == User **Feedback** ==
Ecaterina Moraru (Valica) 2.50 41
42 > Need runnning as a deamon, better upgrade process with no data loosing
Ecaterina Moraru (Valica) 2.51 43
Ecaterina Moraru (Valica) 2.50 44 > Better upgrade process. Still very manual.
Ecaterina Moraru (Valica) 2.51 45
Ecaterina Moraru (Valica) 2.50 46 > Change it to a software for normal users/admins with easy installation, update and backup features and combine it with an appserver by delivery
47
Ecaterina Moraru (Valica) 2.52 48 * Upgrade seen as a lengthy / complicated process
Ecaterina Moraru (Valica) 2.127 49 )))
Ecaterina Moraru (Valica) 2.52 50
Ecaterina Moraru (Valica) 2.127 51 (% class="col-xs-12 col-sm-6" %)
52 (((
Ecaterina Moraru (Valica) 2.125 53 == Top 5 Voted Issues ==
Ecaterina Moraru (Valica) 2.124 54
55 * 7 votes
56 {{jiraIssues}}XWIKI-9920{{/jiraIssues}}
Ecaterina Moraru (Valica) 2.126 57 * 4 votes
58 {{jiraIssues}}XWIKI-8321{{/jiraIssues}}
59 * 3 votes
60 {{jiraIssues}}XWIKI-11502{{/jiraIssues}}
61 * 2 votes
62 {{jiraIssues}}XWIKI-9112{{/jiraIssues}}
63 * 2 votes
64 {{jiraIssues}}XWIKI-8608{{/jiraIssues}}
Ecaterina Moraru (Valica) 2.127 65 )))
66 )))
Ecaterina Moraru (Valica) 2.124 67
Ecaterina Moraru (Valica) 2.152 68 == Ideal upgrade (**Features**) ==
Ecaterina Moraru (Valica) 2.90 69
Ecaterina Moraru (Valica) 2.91 70 (% class="row" %)
71 (((
72 (% class="col-xs-12 col-sm-6" %)
73 (((
Ecaterina Moraru (Valica) 2.90 74 {{usecase}}
Ecaterina Moraru (Valica) 2.217 75 When starting an upgrade, everything will be **automated**, and users are provided a life preview of how the upgrade will look like (main wiki, subwikis, etc.). The administrator can browse and see the live instance, and if he likes the changes and validates there are no problems, he would press an "Apply" button.
Ecaterina Moraru (Valica) 2.90 76 {{/usecase}}
Ecaterina Moraru (Valica) 2.105 77
78 * We could replicate the virtual machine containing the instance; OR duplicate the folders, database, workdir and provide a way to make the dry run.
Ecaterina Moraru (Valica) 2.91 79 )))
Ecaterina Moraru (Valica) 2.90 80
Ecaterina Moraru (Valica) 2.91 81 (% class="col-xs-12 col-sm-6" %)
82 (((
83 {{warning}}
Ecaterina Moraru (Valica) 2.93 84 {{jiraIssues}}
Ecaterina Moraru (Valica) 2.91 85 XWIKI-9645,
Ecaterina Moraru (Valica) 2.92 86 XWIKI-11504,
Ecaterina Moraru (Valica) 2.102 87 XWIKI-9931,
Ecaterina Moraru (Valica) 2.95 88 XWIKI-12708,
Ecaterina Moraru (Valica) 2.106 89 XWIKI-11502
Ecaterina Moraru (Valica) 2.93 90 {{/jiraIssues}}
Ecaterina Moraru (Valica) 2.91 91 {{/warning}}
Ecaterina Moraru (Valica) 2.274 92
93 {{info}}
94 Related proposal: [[Extension Updater>>Proposal.Upgrade.SimplerUpgrade]]
95 {{/info}}
Ecaterina Moraru (Valica) 2.91 96 )))
97 )))
98
Ecaterina Moraru (Valica) 2.40 99 (% class="row" %)
100 (((
Ecaterina Moraru (Valica) 2.91 101 (% class="col-xs-12 col-sm-6" %)
102 (((
Ecaterina Moraru (Valica) 2.104 103 {{usecase}}
Ecaterina Moraru (Valica) 2.218 104 Before upgrading provide a **status** of the instance / wikis. Have a report showcasing what are the customisations made to that particular instance (custom skins, custom applications, pages changes, custom configurations, etc.). This would warm about the magnitude / duration / success of the future upgrade. We could display like a percentage of customisation, like "Your wiki is 45% Vanilla". It could also detect if the wiki has custom applications (some might have dependant .jars).
Ecaterina Moraru (Valica) 2.112 105 {{/usecase}}
106 )))
107
108 (% class="col-xs-12 col-sm-6" %)
109 (((
110
111 )))
112 )))
113
114 (% class="row" %)
115 (((
116 (% class="col-xs-12 col-sm-6" %)
117 (((
118 {{usecase}}
Ecaterina Moraru (Valica) 2.219 119 Have Artificial Intelligence inside XWiki that studies what decisions you take during a particular upgrade, learns from them, and will be able to apply **similar decisions** on the future upgrades it will make. For example, if we always do MERGE on WebPreferences, if will apply this decision on all WebPreference pages.
Ecaterina Moraru (Valica) 2.104 120 {{/usecase}}
121 )))
122
123 (% class="col-xs-12 col-sm-6" %)
124 (((
Ecaterina Moraru (Valica) 2.111 125 {{warning}}
126 {{jiraIssues}}
127 XWIKI-11074
128 {{/jiraIssues}}
129 {{/warning}}
Ecaterina Moraru (Valica) 2.104 130 )))
131 )))
132
133 (% class="row" %)
134 (((
135 (% class="col-xs-12 col-sm-6" %)
136 (((
Ecaterina Moraru (Valica) 2.106 137 {{usecase}}
Ecaterina Moraru (Valica) 2.221 138 Be able to make diffs also on the **WAR**. Currently only UI/Extensions/Pages have the DW step and showcase the diffs. For the WAR you still need to do manual diffs from the filesystem's console. We should see what are the new files, the missing files, and the files that have differences.
Ecaterina Moraru (Valica) 2.220 139 The **diff on configuration files** is the minimal thing we can do.
Ecaterina Moraru (Valica) 2.106 140 {{/usecase}}
Ecaterina Moraru (Valica) 2.91 141 )))
142
143 (% class="col-xs-12 col-sm-6" %)
144 (((
Ecaterina Moraru (Valica) 2.116 145 {{warning}}
146 {{jiraIssues}}
147 XWIKI-1761
148 {{/jiraIssues}}
149 {{/warning}}
Ecaterina Moraru (Valica) 2.269 150
151 {{box}}
Ecaterina Moraru (Valica) 2.270 152 Thomas: Upgrading the WAR from the wiki - impossible to do in a generic way. Easy in Debian, but no equivalent for other distro. List of environments. Easy to do with Jetty (demo - useless). XWiki doesn't have enough rights to proper install itself, cannot modify its own files.
Ecaterina Moraru (Valica) 2.269 153 {{/box}}
Ecaterina Moraru (Valica) 2.106 154 )))
155 )))
Ecaterina Moraru (Valica) 2.91 156
Ecaterina Moraru (Valica) 2.110 157 (% class="row" %)
158 (((
159 (% class="col-xs-12 col-sm-6" %)
160 (((
161 {{usecase}}
Ecaterina Moraru (Valica) 2.222 162 Provide support for custom Skins. There are a lot of manual operations that need to be done for **custom Skins**. Some local templates need to be overwritten, or Fonts files need to be manually added. Also some templates might be attached to pages that have XWikiSkins objects. Same case for customised PDF Exports. Sometimes xhtml2fo.xml files are attached to wiki pages that contain PDFTemplate objects.
Ecaterina Moraru (Valica) 2.110 163 {{/usecase}}
164 )))
165
166 (% class="col-xs-12 col-sm-6" %)
167 (((
168
169 )))
170 )))
171
Ecaterina Moraru (Valica) 2.106 172 {{comment}}
173 (%class="row"%)(((
174 (%class="col-xs-12 col-sm-6"%)(((
175 {{usecase}}
176
177 {{/usecase}}
Ecaterina Moraru (Valica) 2.91 178 )))
Ecaterina Moraru (Valica) 2.106 179 (%class="col-xs-12 col-sm-6"%)(((
Ecaterina Moraru (Valica) 2.91 180 )))
Ecaterina Moraru (Valica) 2.106 181 )))
182 {{/comment}}
Ecaterina Moraru (Valica) 2.91 183
184 (% class="row" %)
185 (((
Ecaterina Moraru (Valica) 2.40 186 (% class="col-xs-12" %)
187 (((
Ecaterina Moraru (Valica) 2.152 188 == Needing **improvements** in ==
Ecaterina Moraru (Valica) 2.41 189
Ecaterina Moraru (Valica) 2.11 190 === Merging Configuration files ===
Ecaterina Moraru (Valica) 2.40 191 )))
Ecaterina Moraru (Valica) 2.3 192
Ecaterina Moraru (Valica) 2.38 193 (% class="col-xs-12 col-sm-6" %)
194 (((
195 * Recommendation: Browse all the release notes from your version X to Y to see if there are things to modify.
196 * Automatically managing configuration changes
197 * Differences between Docker and Webapp update method:
Ecaterina Moraru (Valica) 2.4 198 ** Idea: Merge the configuration files and provide a differences view (either manually [GitHub+WinMerge] or from the DW).
Ecaterina Moraru (Valica) 2.5 199 ** Idea: Docker: "update script that does the copy and to copy also the original files and/or provide a diff or even better do the merge as we do it in the debian distribution" (Vincent).
Ecaterina Moraru (Valica) 2.38 200 )))
Ecaterina Moraru (Valica) 2.6 201
Ecaterina Moraru (Valica) 2.38 202 (% class="col-xs-12 col-sm-6" %)
203 (((
Ecaterina Moraru (Valica) 2.59 204 {{warning}}
Ecaterina Moraru (Valica) 2.42 205 * [[Forum entry>>https://forum.xwiki.org/t/managing-configuration-changes-when-upgrading-xwiki-using-docker/3631]] (Differences between Docker and Webapp)
206 * [[Forum entry>>https://forum.xwiki.org/t/503-service-unavailable-after-upgrade/3508]] (Apply release notes issues specific to a particular version)
Ecaterina Moraru (Valica) 2.59 207 {{/warning}}
Ecaterina Moraru (Valica) 2.252 208
209 {{info}}
Ecaterina Moraru (Valica) 2.264 210 Idea (Thomas):
Ecaterina Moraru (Valica) 2.266 211 * Environment validation step (java version, OS, configuration, etc.)
212 * Configuration Checker: Check and validate the configuration in the beginning of DW (+ provide info and documentation on where to change). Suggest bigger memory (+give link to documentation), etc.
Ecaterina Moraru (Valica) 2.252 213 {{/info}}
Ecaterina Moraru (Valica) 2.38 214 )))
215 )))
216
Ecaterina Moraru (Valica) 2.7 217 === Configuration values ===
218
Ecaterina Moraru (Valica) 2.15 219 (% class="row" %)
220 (((
221 (% class="col-xs-12 col-sm-6" %)
222 (((
Ecaterina Moraru (Valica) 2.89 223 Common configuration values for "production-ready" wikis (we might want to change / update the default values):
Ecaterina Moraru (Valica) 2.7 224
Ecaterina Moraru (Valica) 2.71 225 * Tomcat java opts variable(((
Ecaterina Moraru (Valica) 2.76 226 {{box}}
Ecaterina Moraru (Valica) 2.72 227 * ##-Xmx1024m## is not enough (edit ##setenv.sh##)
Ecaterina Moraru (Valica) 2.76 228 {{/box}}
Ecaterina Moraru (Valica) 2.71 229 )))
Ecaterina Moraru (Valica) 2.20 230 * LDAP Authentication
Ecaterina Moraru (Valica) 2.23 231 ** Install LDAP App
232 ** Configurations(((
Ecaterina Moraru (Valica) 2.73 233 {{box}}
Ecaterina Moraru (Valica) 2.75 234 * ##xwiki.authentication.authclass=org.xwiki.contrib.ldap.XWikiLDAPAuthServiceImpl##
235 * ##xwiki.authentication.ldap.trylocal=1##
Ecaterina Moraru (Valica) 2.73 236 {{/box}}
Ecaterina Moraru (Valica) 2.20 237 )))
Ecaterina Moraru (Valica) 2.6 238 * TLS/SSL configuration for Tomcat
Ecaterina Moraru (Valica) 2.132 239 * Short URLs
Ecaterina Moraru (Valica) 2.22 240 * Other:(((
Ecaterina Moraru (Valica) 2.75 241 {{box}}
Ecaterina Moraru (Valica) 2.8 242 * ##xwiki.plugin.watchlist.automaticwatch=none##
243 * ##xwiki.plugin.image.defaultQuality = 0.8##
244 * ##openoffice.homePath## and ##autostart##
245 * ##rendering.imageDimensionsIncludedInImageURL = false##
246 * Adding markdown to ##xwiki.rendering.syntaxes##
Ecaterina Moraru (Valica) 2.9 247 * Cache configuration ##xwiki.store.cache.capacity=500##
Ecaterina Moraru (Valica) 2.75 248 {{/box}}
Ecaterina Moraru (Valica) 2.15 249 )))
Ecaterina Moraru (Valica) 2.22 250 )))
Ecaterina Moraru (Valica) 2.12 251
Ecaterina Moraru (Valica) 2.15 252 (% class="col-xs-12 col-sm-6" %)
253 (((
Ecaterina Moraru (Valica) 2.64 254 {{warning}}
Ecaterina Moraru (Valica) 2.192 255 * [[Forum entry>>https://forum.xwiki.org/t/managing-configuration-changes-when-upgrading-xwiki-using-docker/3631/19]] (Config ex)
Ecaterina Moraru (Valica) 2.214 256 * [[Forum entry>>https://forum.xwiki.org/t/aws-ec2-ubuntu-tomcat-postgresql]] (AWS EC - memory value)
Ecaterina Moraru (Valica) 2.150 257
258 {{jiraIssues}}
259 XWIKI-913
260 {{/jiraIssues}}
Ecaterina Moraru (Valica) 2.151 261 {{/warning}}
Ecaterina Moraru (Valica) 2.271 262
263 {{box}}
264 Thomas: Very hard to provide a configuration file that will satisfy all the cases. We could modify the jetty one, but that's only for demo purposes.
265 {{/box}}
Ecaterina Moraru (Valica) 2.15 266 )))
267 )))
268
Ecaterina Moraru (Valica) 2.67 269 ==== Database ====
Ecaterina Moraru (Valica) 2.12 270
Ecaterina Moraru (Valica) 2.24 271 (% class="row" %)
272 (((
273 (% class="col-xs-12 col-sm-6" %)
274 (((
Ecaterina Moraru (Valica) 2.29 275 * SOLR data is not deleted when upgrading XWiki docker image
Ecaterina Moraru (Valica) 2.24 276 )))
Ecaterina Moraru (Valica) 2.12 277
Ecaterina Moraru (Valica) 2.24 278 (% class="col-xs-12 col-sm-6" %)
279 (((
Ecaterina Moraru (Valica) 2.61 280 {{warning}}
Ecaterina Moraru (Valica) 2.27 281 * [[Forum entry>>https://forum.xwiki.org/t/managing-configuration-changes-when-upgrading-xwiki-using-docker/3631/19]]
Ecaterina Moraru (Valica) 2.248 282
283 {{jiraIssues}}
284 XWIKI-14447,
285 XWIKI-13639
286 {{/jiraIssues}}
Ecaterina Moraru (Valica) 2.61 287 {{/warning}}
Ecaterina Moraru (Valica) 2.24 288 )))
289 )))
290
Ecaterina Moraru (Valica) 2.196 291 ==== Old Java ====
292
293 (% class="row" %)
294 (((
295 (% class="col-xs-12 col-sm-6" %)
296 (((
297 * We should update our Java version need to run XWiki. Currently max is 8.
298 )))
299
300 (% class="col-xs-12 col-sm-6" %)
301 (((
Ecaterina Moraru (Valica) 2.252 302 {{warning}}
303 * [[Forum entry>>https://forum.xwiki.org/t/installing-xwiki/]] (9.11.7)
304 {{/warning}}
305
Ecaterina Moraru (Valica) 2.225 306 {{info}}
Ecaterina Moraru (Valica) 2.236 307 Action to take: XWiki on Java 11.0
Ecaterina Moraru (Valica) 2.225 308 {{/info}}
Ecaterina Moraru (Valica) 2.196 309 )))
310 )))
311
Ecaterina Moraru (Valica) 2.77 312 ----
Ecaterina Moraru (Valica) 2.68 313
Ecaterina Moraru (Valica) 2.77 314 === Launching DW ===
315
Ecaterina Moraru (Valica) 2.68 316 (% class="row" %)
317 (((
318 (% class="col-xs-12 col-sm-6" %)
319 (((
Ecaterina Moraru (Valica) 2.77 320 * DW is not launched in some cases. Solutions to manually trigger it or prevent accidental skipping.
Ecaterina Moraru (Valica) 2.68 321 )))
322
323 (% class="col-xs-12 col-sm-6" %)
324 (((
Ecaterina Moraru (Valica) 2.227 325 {{warning}}
Ecaterina Moraru (Valica) 2.202 326 * [[Forum entry>>https://forum.xwiki.org/t/10-3-to-10-4-upgrade-no-update-to-ui-flavor-during-distribution-wizard/3140/8]] (XWiki 10.3 - 10.4)
327 * [[Forum entry>>https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/]] (XWiki 10.6.1 - 10.7)
Ecaterina Moraru (Valica) 2.77 328
329 {{jiraIssues}}
330 XWIKI-10769,
331 XWIKI-9818,
332 XWIKI-9112,
333 {{/jiraIssues}}
Ecaterina Moraru (Valica) 2.68 334 {{/warning}}
Ecaterina Moraru (Valica) 2.252 335
336 {{info}}
337 Proposal: [[DW Never Button>>Proposal.Upgrade.DWNeverButton]]
338 {{/info}}
Ecaterina Moraru (Valica) 2.68 339 )))
340 )))
341
Ecaterina Moraru (Valica) 2.36 342 ----
343
Ecaterina Moraru (Valica) 2.152 344 == Upgrade Issues / **Bugs** (2017 - 2018) ==
Ecaterina Moraru (Valica) 2.45 345
Ecaterina Moraru (Valica) 2.120 346 === Configurations ===
Ecaterina Moraru (Valica) 2.45 347
Ecaterina Moraru (Valica) 2.120 348 ==== Conflicting old configurations ====
Ecaterina Moraru (Valica) 2.118 349
Ecaterina Moraru (Valica) 2.45 350 (% class="row" %)
351 (((
352 (% class="col-xs-12 col-sm-6" %)
353 (((
Ecaterina Moraru (Valica) 2.120 354 * Some remaining configurations from the early versions which were incompatible with the current version
Ecaterina Moraru (Valica) 2.101 355 )))
Ecaterina Moraru (Valica) 2.45 356
357 (% class="col-xs-12 col-sm-6" %)
358 (((
Ecaterina Moraru (Valica) 2.66 359 {{warning}}
Ecaterina Moraru (Valica) 2.120 360 * XS*6-9280 (XWiki 6.4.4 - 7.4.3)
Ecaterina Moraru (Valica) 2.66 361
Ecaterina Moraru (Valica) 2.58 362 {{jiraIssues}}
Ecaterina Moraru (Valica) 2.120 363 XWIKI-13407
Ecaterina Moraru (Valica) 2.58 364 {{/jiraIssues}}
Ecaterina Moraru (Valica) 2.66 365 {{/warning}}
Ecaterina Moraru (Valica) 2.45 366 )))
367 )))
368
Ecaterina Moraru (Valica) 2.153 369 ==== Storage / Database attachment ====
Ecaterina Moraru (Valica) 2.141 370
371 (% class="row" %)
372 (((
373 (% class="col-xs-12 col-sm-6" %)
374 (((
375 * Having deprecated pre 9.9 configurations
376 {{code}}xwiki.store.attachment.recyclebin.hint=file{{/code}}
Ecaterina Moraru (Valica) 2.153 377 * DW didn't add the XWiki.Extensions page, because of an attachment
Ecaterina Moraru (Valica) 2.168 378 * Many attachments reported missing after upgrade. Useful [[Attachment Checker>>doc:snippets:Extension.Attachments Checker.WebHome]].
Ecaterina Moraru (Valica) 2.170 379 * After the upgrade, the attachments disappeared.
Ecaterina Moraru (Valica) 2.180 380 * Can’t find descriptor for the component
Ecaterina Moraru (Valica) 2.141 381 )))
382
383 (% class="col-xs-12 col-sm-6" %)
384 (((
Ecaterina Moraru (Valica) 2.253 385 {{info}}
386 * We could at [[least>>https://www.xwiki.org/xwiki/bin/viewrev/Documentation/AdminGuide/Attachments#HFilesystemAttachmentStore]] have an FAQ entry
Ecaterina Moraru (Valica) 2.260 387 * Improve the Release Notes app to list the breakages and configuration changes between versions
Ecaterina Moraru (Valica) 2.253 388 {{/info}}
389
Ecaterina Moraru (Valica) 2.228 390 {{warning}}
Ecaterina Moraru (Valica) 2.141 391 {{jiraIssues}}
Ecaterina Moraru (Valica) 2.155 392 RN-43
Ecaterina Moraru (Valica) 2.141 393 {{/jiraIssues}}
394 {{/warning}}
Ecaterina Moraru (Valica) 2.159 395
396 {{warning}}
397 * [[Forum entry>>https://forum.xwiki.org/t/upgrade-8-4-6-to-9-11-2-issue-with-deleted-attachments/2741]] (XWiki 8.4.6 - 9.11.2)
398 * [[Forum entry>>https://forum.xwiki.org/t/upgrade-9-9-to-9-10-failed-to-load-component-for-type-interface-com-xpn-xwiki-store-attachmentrecyclebinstore-for-hint-file/896]] (XWiki 9.9 - 9.10)
399 * [[Forum entry>>https://forum.xwiki.org/t/missing-extension-manager-after-upgrade-from-8-4-5-to-9-11-7/3489/13]] (8.4.5 - 9.11.7 - 9.11.6)
Ecaterina Moraru (Valica) 2.166 400 * [[Forum entry>>https://forum.xwiki.org/t/many-attachments-are-reported-missing-after-upgrade-to-10-4/]] (XWiki 6.0.1 - 10.4)
Ecaterina Moraru (Valica) 2.171 401 * [[Forum entry>>https://forum.xwiki.org/t/upgrade-10-1-10-4-failed-to-store-deleted-attachment/]] (XWiki 10.1 - 10.4)
Ecaterina Moraru (Valica) 2.180 402 * [[Forum entry>>https://forum.xwiki.org/t/upgrade-10-1-to-10-2-cant-find-descriptor-for-the-component]] (XWiki 10.1 - 10.2)
Ecaterina Moraru (Valica) 2.167 403
404 {{jiraIssues}}
405 XWIKI-15337
406 {{/jiraIssues}}
Ecaterina Moraru (Valica) 2.159 407 {{/warning}}
Ecaterina Moraru (Valica) 2.141 408 )))
Ecaterina Moraru (Valica) 2.157 409
410 (% class="col-xs-12 col-sm-6" %)
411 (((
412 * Changing the default theme logo, that attachment blocked the DW installation process.
Ecaterina Moraru (Valica) 2.141 413 )))
414
Ecaterina Moraru (Valica) 2.157 415 (% class="col-xs-12 col-sm-6" %)
416 (((
417 {{warning}}
Ecaterina Moraru (Valica) 2.160 418 * [[Forum entry>>https://forum.xwiki.org/t/problem-with-flavor-after-upgrade-from-xwiki-9-11-1-to-xwiki-10-0]] (XWiki 9.11.1 - 10.0)
Ecaterina Moraru (Valica) 2.157 419
420 {{jiraIssues}}
421 XWIKI-15025
422 {{/jiraIssues}}
423 {{/warning}}
424 )))
425 )))
426
Ecaterina Moraru (Valica) 2.118 427 ----
428
Ecaterina Moraru (Valica) 2.120 429 === Customisations ===
Ecaterina Moraru (Valica) 2.118 430
Ecaterina Moraru (Valica) 2.120 431 ==== PDF Export ====
Ecaterina Moraru (Valica) 2.118 432
433 (% class="row" %)
434 (((
435 (% class="col-xs-12 col-sm-6" %)
436 (((
Ecaterina Moraru (Valica) 2.120 437 * PDF Export broken. Needs 3 way merge for xhtml2fo.xsl
Ecaterina Moraru (Valica) 2.165 438 * Different PDF Export after upgrade caused by bugs in dependencies + manual need to copy FONTS. PDFTemplate and Skins should be treated specially.
Ecaterina Moraru (Valica) 2.131 439 )))
Ecaterina Moraru (Valica) 2.56 440
441 (% class="col-xs-12 col-sm-6" %)
442 (((
Ecaterina Moraru (Valica) 2.66 443 {{warning}}
Ecaterina Moraru (Valica) 2.120 444 * C*2-2453 (XWiki 8.4.5)
Ecaterina Moraru (Valica) 2.128 445 * XNS*6-3672 (XWiki 7.4.4)
Ecaterina Moraru (Valica) 2.164 446
447 {{jiraIssues}}
448 XWIKI-14279
449 {{/jiraIssues}}
Ecaterina Moraru (Valica) 2.66 450 {{/warning}}
Ecaterina Moraru (Valica) 2.251 451
452 {{info}}
453 Action to take: Better PDF export by making it easily customizable. We could investigate what are the regular customizations.
454 {{/info}}
Ecaterina Moraru (Valica) 2.56 455 )))
456 )))
457
Ecaterina Moraru (Valica) 2.118 458 ----
Ecaterina Moraru (Valica) 2.85 459
Ecaterina Moraru (Valica) 2.137 460 ==== Database ====
461
462 (% class="row" %)
463 (((
464 (% class="col-xs-12 col-sm-6" %)
465 (((
466 * Checking database sanity.
Ecaterina Moraru (Valica) 2.188 467 * Make sure the database has been migrated too (issues when schema comes from old version < 3.2)
468 * "Failed updating schema"
Ecaterina Moraru (Valica) 2.137 469 )))
470
471 (% class="col-xs-12 col-sm-6" %)
472 (((
473 {{warning}}
Ecaterina Moraru (Valica) 2.162 474 * XNS*6-3609 (< 3.2)
Ecaterina Moraru (Valica) 2.187 475 * [[Forum entry>>https://forum.xwiki.org/t/problem-upgrading-from-8-4-4-to-9-4/524]] (XWiki 8.4.4 - 9.4)
Ecaterina Moraru (Valica) 2.162 476
477 {{jiraIssues}}
478 XWIKI-5576
479 {{/jiraIssues}}
Ecaterina Moraru (Valica) 2.187 480 {{/warning}}
Ecaterina Moraru (Valica) 2.254 481
482 {{box}}
483 We already have some migration tests + docker will help do tests on multiple configurations.
484 {{/box}}
Ecaterina Moraru (Valica) 2.137 485 )))
486 )))
487
488 ----
489
Ecaterina Moraru (Valica) 2.118 490 === Extensions ===
491
Ecaterina Moraru (Valica) 2.147 492 ==== Some extensions not working properly ====
493
494 (% class="row" %)
495 (((
496 (% class="col-xs-12 col-sm-6" %)
497 (((
498 * "certain macros are broken (doctree), breadcrumbs are broken in the header section, and editing pages gives me a infinite spinning circle. If I spin down this instance, change the port number back to port 8080, then spin the instance back up, everything will work as intended."
499 ** Issue: "all the JavaScript code and the CSS styles are being cached by your browser. Try to clear the browser cache."
Ecaterina Moraru (Valica) 2.177 500 * "after upgrade, all the subpages under my wiki are gone, so are those things under Navigation"
501 ** "So make backups and make Shift + F5 your friend (at least until whatever the issue is gets fixed)"
Ecaterina Moraru (Valica) 2.147 502 )))
503
504 (% class="col-xs-12 col-sm-6" %)
505 (((
Ecaterina Moraru (Valica) 2.258 506 {{info}}
507 Action to take: Fix the resources versioning
508 {{/info}}
509
Ecaterina Moraru (Valica) 2.147 510 {{warning}}
Ecaterina Moraru (Valica) 2.161 511 * [[Forum entry>>https://forum.xwiki.org/t/xwiki-upgrade-breaks-certain-functionality-standalone-distro/149]] (XWiki 9.2 - 9.3.1 - 9.4)
Ecaterina Moraru (Valica) 2.177 512 * [[Forum entry>>https://forum.xwiki.org/t/all-subpages-are-gone-after-upgrade-to-10-3/]] (XWiki 10.1 - 10.2 - 10.3)
Ecaterina Moraru (Valica) 2.204 513 * [[Forum entry>>https://forum.xwiki.org/t/navigation-and-children-macro-not-working-on-9-5-1/262]] (XWiki 9.0 - 9.5.1)
Ecaterina Moraru (Valica) 2.147 514
515 {{jiraIssues}}
Ecaterina Moraru (Valica) 2.149 516 XWIKI-6073
Ecaterina Moraru (Valica) 2.147 517 {{/jiraIssues}}
518 {{/warning}}
519 )))
520 )))
521
Ecaterina Moraru (Valica) 2.230 522 (% class="row" %)
523 (((
524 (% class="col-xs-12 col-sm-6" %)
525 (((
Ecaterina Moraru (Valica) 2.118 526 ==== Conflicting old extensions ====
Ecaterina Moraru (Valica) 2.230 527 )))
Ecaterina Moraru (Valica) 2.118 528
Ecaterina Moraru (Valica) 2.230 529 (% class="col-xs-12 col-sm-6" %)
530 (((
531 {{info}}
Ecaterina Moraru (Valica) 2.272 532 Idea (Thomas):
533 * Invalid extensions step: too much oriented towards outdates extensions. It's not listing invalid extensions so that they could be uninstalled. Should be redesigned to be about INVALID extensions and how you can fix them. DESIGN: How to show invalid extension and what to do with them? What do we let the users do and what we show to the users.
534 * Redesigning Invalid Extensions Step: list dependencies. extension that is not needed anymore, because it's not a dependency anymore, not part of the flavor anymore. Clean-up step. Similar to Ubuntu - packages not needed anymore - ask to remove. Blog as example.
Ecaterina Moraru (Valica) 2.230 535 {{/info}}
536 )))
537 )))
538
Ecaterina Moraru (Valica) 2.85 539 (% class="row" %)
540 (((
541 (% class="col-xs-12 col-sm-6" %)
542 (((
Ecaterina Moraru (Valica) 2.184 543 * ##SEARCH##: Having old Lucene Search Application installed, although it was replaced by the Solr Search Application some time ago. Needs manual uninstall.
Ecaterina Moraru (Valica) 2.85 544 )))
545
546 (% class="col-xs-12 col-sm-6" %)
547 (((
548 {{warning}}
549 {{jiraIssues}}
550 XWIKI-11700,
551 XWIKI-15763
552 {{/jiraIssues}}
553 {{/warning}}
554 )))
555 )))
556
Ecaterina Moraru (Valica) 2.182 557 (% class="row" %)
558 (((
559 (% class="col-xs-12 col-sm-6" %)
560 (((
Ecaterina Moraru (Valica) 2.207 561 * ##BLOG##
562 ** Cannot upgrade Blog
563 ** Stale dependency
Ecaterina Moraru (Valica) 2.182 564 )))
565
566 (% class="col-xs-12 col-sm-6" %)
567 (((
568 {{warning}}
569 * [[Forum entry>>https://forum.xwiki.org/t/blog-upgrade-from-8-4-6-to-9-2-version-doesnt-work/]] (XWiki 8.4.6 - 9.11.2)
Ecaterina Moraru (Valica) 2.194 570 * [[Forum entry>>https://forum.xwiki.org/t/confused-about-stale-dependencies]] (9.3.3 - 9.4)
Ecaterina Moraru (Valica) 2.182 571
572 {{jiraIssues}}
573 XWIKI-14699,
Ecaterina Moraru (Valica) 2.200 574 BLOG-99
Ecaterina Moraru (Valica) 2.182 575 {{/jiraIssues}}
576 {{/warning}}
577 )))
578 )))
579
Ecaterina Moraru (Valica) 2.183 580 (% class="row" %)
581 (((
582 (% class="col-xs-12 col-sm-6" %)
583 (((
Ecaterina Moraru (Valica) 2.207 584 * ##NOTIFICATIONS##
585 ** Missing notification properties in user objects
586 ** Duplicate versions (one installed in a subwiki not specified)
Ecaterina Moraru (Valica) 2.183 587 )))
588
589 (% class="col-xs-12 col-sm-6" %)
590 (((
591 {{warning}}
Ecaterina Moraru (Valica) 2.186 592 * [[Forum entry>>https://forum.xwiki.org/t/missing-notification-properties-in-user-objects-after-upgrade/]] (XWiki 9.1.2 - 9.5.1; 9.5.1; 9.5.1 - 9.6)
Ecaterina Moraru (Valica) 2.207 593 * [[Forum entry>>https://forum.xwiki.org/t/duplicate-versions-of-extensions/]] (XWiki 10.1 - 10.7)
Ecaterina Moraru (Valica) 2.183 594
595 {{jiraIssues}}{{/jiraIssues}}
596 {{/warning}}
597 )))
598 )))
599
Ecaterina Moraru (Valica) 2.231 600 (% class="row" %)
601 (((
602 (% class="col-xs-12 col-sm-6" %)
603 (((
Ecaterina Moraru (Valica) 2.119 604 ==== Upgrading bundled Contrib extensions ====
Ecaterina Moraru (Valica) 2.231 605 )))
Ecaterina Moraru (Valica) 2.87 606
Ecaterina Moraru (Valica) 2.231 607 (% class="col-xs-12 col-sm-6" %)
608 (((
609 {{info}}
Ecaterina Moraru (Valica) 2.241 610 Related proposal: [[Notifications Types>>Proposal.NotificationsImprovements9xTypes]]
Ecaterina Moraru (Valica) 2.275 611 Event: [[NewExtensionVersionAvailableEvent>>https://github.com/xwiki/xwiki-platform/tree/master/xwiki-platform-core/xwiki-platform-extension/xwiki-platform-extension-versioncheck/src/main/java/org/xwiki/extension/versioncheck]]
Ecaterina Moraru (Valica) 2.231 612 {{/info}}
613 )))
614 )))
615
Ecaterina Moraru (Valica) 2.87 616 (% class="row" %)
617 (((
618 (% class="col-xs-12 col-sm-6" %)
619 (((
620 * For some extensions (like CKEditor) users are manually reminded to upgrade those extensions in intermediary versions
Ecaterina Moraru (Valica) 2.138 621 ** lots of manual upgrades of the CKEditor (in order to fix bugs or get the recent features)
Ecaterina Moraru (Valica) 2.87 622 ** great that the extensions are independent and do not need a full upgrade
623 ** we should [[notify the users using the notifications system>>attach:Proposal.NotificationsImprovements9xTypes@event_app_primary.png]].
624 )))
625
626 (% class="col-xs-12 col-sm-6" %)
627 (((
Ecaterina Moraru (Valica) 2.256 628 {{info}}
Ecaterina Moraru (Valica) 2.257 629 Idea (Thomas): Have a Local Index that contains all the local repositories and search in them. This would allow fast searching + will be able to do a lot more filtering to determine only valid extensions that could be proposed to upgrade.
Ecaterina Moraru (Valica) 2.256 630 {{jiraIssues}}
631 XWIKI-9920
632 {{/jiraIssues}}
633 {{/info}}
634
Ecaterina Moraru (Valica) 2.88 635 {{warning}}
Ecaterina Moraru (Valica) 2.139 636 * Issues fixed by upgrades examples: XNS*6-3865
Ecaterina Moraru (Valica) 2.88 637 {{/warning}}
Ecaterina Moraru (Valica) 2.87 638 )))
639 )))
640
Ecaterina Moraru (Valica) 2.119 641 ==== Upgrading extensions installed 'on farm' ====
Ecaterina Moraru (Valica) 2.80 642
643 (% class="row" %)
644 (((
645 (% class="col-xs-12 col-sm-6" %)
646 (((
647 * Some issues with extensions installed "on farm" or partially installed that have XAR dependencies from platform (example CKEditor 1.19)
Ecaterina Moraru (Valica) 2.83 648 * Manually upgrading the extensions installed "on farm" before proceeding to upgrade the wikis.
649 ** Apparently what Extension Manager does when it has to replace an extension with an "on farm" installation is that it applies "Uninstall" on each wiki and then re-installs the extension as "on farm".
Ecaterina Moraru (Valica) 2.80 650 )))
651
652 (% class="col-xs-12 col-sm-6" %)
653 (((
Ecaterina Moraru (Valica) 2.81 654 {{warning}}
Ecaterina Moraru (Valica) 2.82 655 * XNS*6-3435 (XWiki 6.4.6, 5.4.6 - 6.4.8)
Ecaterina Moraru (Valica) 2.81 656 {{/warning}}
Ecaterina Moraru (Valica) 2.80 657 )))
658 )))
659
Ecaterina Moraru (Valica) 2.118 660 ----
661
Ecaterina Moraru (Valica) 2.120 662 === Users ===
Ecaterina Moraru (Valica) 2.78 663
Ecaterina Moraru (Valica) 2.120 664 ==== Missing some user rights ====
Ecaterina Moraru (Valica) 2.118 665
Ecaterina Moraru (Valica) 2.78 666 (% class="row" %)
667 (((
668 (% class="col-xs-12 col-sm-6" %)
669 (((
Ecaterina Moraru (Valica) 2.120 670 * XWiki admin user is removed from the XWikiAdminUser group. Rights are lost. Macros are broken.(((
671 {{code}}
672 "The execution of the
673 [velocity] script macro is not allowed. Check the rights of its last author
674 or the parameters if it's rendered from another script"
675 {{/code}}
Ecaterina Moraru (Valica) 2.78 676 )))
Ecaterina Moraru (Valica) 2.120 677 * The best practice in DW when dealing with ##WebPreferences## pages is to automatically apply ##MERGE##
678 )))
Ecaterina Moraru (Valica) 2.78 679
680 (% class="col-xs-12 col-sm-6" %)
681 (((
682 {{warning}}
Ecaterina Moraru (Valica) 2.198 683 * XS*6-9199 (XWiki 6.4.4 - 7.4.3)
Ecaterina Moraru (Valica) 2.120 684 * [[Forum entry>>https://forum.xwiki.org/t/upgrade-fails-every-time/746]]
Ecaterina Moraru (Valica) 2.198 685 * [[Forum entry>>https://forum.xwiki.org/t/can-not-see-user-administration-after-update-6-3-9-11-1]] (6.3 - 9.11.1)
Ecaterina Moraru (Valica) 2.120 686
687 {{jiraIssues}}
688 XWIKI-13574,
689 XWIKI-9591
690 {{/jiraIssues}}
Ecaterina Moraru (Valica) 2.78 691 {{/warning}}
Ecaterina Moraru (Valica) 2.246 692
693 {{box}}
Ecaterina Moraru (Valica) 2.247 694 Already fixed by defining in the .pom file the [[entry type>>Proposal.XARentriestypes]], mentioning what pages are protected in the upgrade.
Ecaterina Moraru (Valica) 2.246 695 {{/box}}
Ecaterina Moraru (Valica) 2.78 696 )))
697 )))
698
Ecaterina Moraru (Valica) 2.178 699 ==== Translations ====
700
701 (% class="row" %)
702 (((
703 (% class="col-xs-12 col-sm-6" %)
704 (((
705 * Wiki Manager missing translations registered with a GLOBAL scope (hence requiring Programming Rights).
706 )))
707
708 (% class="col-xs-12 col-sm-6" %)
709 (((
710 {{warning}}
711 * [[Forum entry>>https://forum.xwiki.org/t/wiki-manager-missing-translations-after-upgrade-to-10-2]] (XWiki 10.1 - 10.2)
712
713 {{jiraIssues}}
714 XWIKI-15012
715 {{/jiraIssues}}
716 {{/warning}}
Ecaterina Moraru (Valica) 2.245 717
718 {{info}}
Ecaterina Moraru (Valica) 2.261 719 Action to take (Thomas): "fix the Programming Rights issue on subwikis - example: myxwiki.org admin with broken pages that need PR (fix PR pages in XS, but extensions could have problems too)"
Ecaterina Moraru (Valica) 2.245 720 * Some way to give PR to anyone who would like to install a specific extension. Trusted extensions (or version) that could be installed with superadmin.
721 * Wiki Status: See broken pages that have PR needed: status of those pages || broken wiki components.
722 {{/info}}
Ecaterina Moraru (Valica) 2.178 723 )))
724 )))
725
Ecaterina Moraru (Valica) 2.120 726 ----
727
Ecaterina Moraru (Valica) 2.205 728 === Downgrades ===
729
730 (% class="row" %)
731 (((
732 (% class="col-xs-12 col-sm-6" %)
733 (((
Ecaterina Moraru (Valica) 2.213 734 * By request or by mistake
Ecaterina Moraru (Valica) 2.205 735 )))
736
737 (% class="col-xs-12 col-sm-6" %)
738 (((
739 {{warning}}
740 * [[Forum entry>>https://forum.xwiki.org/t/how-to-downgrade-xwiki/]] (XWiki 9.1 - 8.3)
Ecaterina Moraru (Valica) 2.206 741 * [[Forum entry>>https://forum.xwiki.org/t/installed-wrong-version-of-extension-manager/]] (XWiki 9.6 - 9.4)
Ecaterina Moraru (Valica) 2.205 742 {{/warning}}
743 )))
744 )))
745
Ecaterina Moraru (Valica) 2.30 746 {{comment}}
747 (%class="row"%)(((
748 (%class="col-xs-12 col-sm-6"%)(((
749 )))
750 (%class="col-xs-12 col-sm-6"%)(((
751 )))
752 )))
753 {{/comment}}

Get Connected