Version 3.3 by Vincent Massol on 2022/01/31

Show last authors
1 {{velocity}}
2 #set ($rnObject = $doc.getObject('ReleaseNotes.Code.ReleaseNoteClass'))
3 #set ($product = $rnObject.product)
4 #set ($version = $rnObject.version)
5 #set ($versionPrefix = $stringtool.substringBefore($version, '-'))
6 #set ($versionParts = $stringtool.split($versionPrefix, '.'))
7 #set ($isRC = $version.contains('rc'))
8 #set ($isFinal = !$isRC)
9 #set ($isFirstFinal = $versionParts.size() == 2 && $isFinal)
10 {{/velocity}}
11
12 {{box cssClass="floatinginfobox" title="**Contents**"}}
13 {{toc/}}
14 {{/box}}
15
16 This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]. They share the same release notes as they are released together and have the same version.
17
18 This is the first release of 14.x cycle which introduces the drop of Java 8: XWiki now requires Java 11 to work. As part of this cycle we're also dropping support of Internet Explorer 11. This release includes new work to allow refactoring of attachments, a few new UI extension points for developpers and better explanatory messages when macro are missing, among other improvments.
19
20 {{comment}}
21 Uncomment when there's at least one issue listed in the table!
22 {{error}}
23 The following regressions were introduced in this release (and found after it was released). Please check them out and if they impact you we recommend waiting to upgrade to a version where they are fixed.
24
25 {{velocity}}
26 #if ($isFirstFinal)
27 #set ($affectedVersions = "${version}-rc-1, ${version}")
28 #set ($fixVersionJQL = " and (fixVersion != ${version}-rc-1 or fixVersion is empty)")
29 #else
30 #set ($affectedVersions = "${version}")
31 #set ($fixVersionJQL = "")
32 #end
33 {{jira id="xwikiorg" source="jql"}}
34 category = 10000 and affectedVersion in ($affectedVersions)${fixVersionJQL}and priority = Blocker and resolution in (Fixed, Unresolved)
35 {{/jira}}
36 {{/velocity}}
37 {{/error}}
38 {{/comment}}
39
40 = New and Noteworthy (since {{velocity}}$product{{/velocity}} 13.10.2) =
41
42 [[Full list of issues fixed and Dashboard for XWiki 14.0>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14909]].
43
44 {{releasenotechanges/}}
45
46 === Upgrades ===
47
48 The following runtime dependencies have been upgraded (they have a different release cycle than [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]):
49
50 * [[jasmine-maven-plugin 3.0-beta-02>>https://jira.xwiki.org/browse/XWIKI-19248]] (xwiki-platform-livedata-webjar only)
51 * [[frontend-maven-plugin 1.12.0>>https://jira.xwiki.org/browse/XWIKI-19247]]
52 * [[less 4.1.2>>https://jira.xwiki.org/browse/XWIKI-19246]] (xwiki-platform-livedata-webjar only)
53 * [[eslint-plugin-vue 7.20.0>>https://jira.xwiki.org/browse/XWIKI-19245]]
54 * [[@vue/test-utils 1.3.0>>https://jira.xwiki.org/browse/XWIKI-19243]]
55 * [[@vue/cli-plugin-unit-jest 4.5.15>>https://jira.xwiki.org/browse/XWIKI-19241]]
56 * [[@vue/cli-plugin-eslint 4.5.15>>https://jira.xwiki.org/browse/XWIKI-19240]]
57 * [[@vue/cli-plugin-babel 4.5.15>>https://jira.xwiki.org/browse/XWIKI-19239]]
58 * [[@testing-library/jest-dom 5.16.1>>https://jira.xwiki.org/browse/XWIKI-19238]]
59 * [[@babel/eslint-parser 7.16.5>>https://jira.xwiki.org/browse/XWIKI-19237]]
60 * [[vue-tippy 4.13.0>>https://jira.xwiki.org/browse/XWIKI-18988]]
61 * [[log4j API 2.17.0>>https://jira.xwiki.org/browse/XCOMMONS-2327]]
62 * [[log4j API 2.17.1>>https://jira.xwiki.org/browse/XCOMMONS-2340]]
63 * [[Logback 1.2.10>>https://jira.xwiki.org/browse/XCOMMONS-2330]]
64 * [[CKEditor Integration 1.58>>https://jira.xwiki.org/browse/XWIKI-19273]]
65 * [[CKEditor 4.17.1>>https://jira.xwiki.org/browse/CKEDITOR-416]]
66 * [[H2 MVStore 2.1.210>>https://jira.xwiki.org/browse/XWIKI-19191]]
67 * [[Maven 3.8.4>>https://jira.xwiki.org/browse/XWIKI-19164]]
68 * [[JNR POSIX 3.1.12>>https://jira.xwiki.org/browse/XWIKI-19163]]
69 * [[Snakeyaml 1.30>>https://jira.xwiki.org/browse/XCOMMONS-2335]]
70 * [[Infinispan 13.0.5.Final>>https://jira.xwiki.org/browse/XCOMMONS-2334]]
71 * [[Apache PDFBox 2.0.25>>https://jira.xwiki.org/browse/XWIKI-19253]]
72 * [[Jackson 2.13.1>>https://jira.xwiki.org/browse/XCOMMONS-2332]]
73 * [[httpasyncclient 4.1.5>>https://jira.xwiki.org/browse/XCOMMONS-2328]]
74 * [[Liquibase 4.6.2>>https://jira.xwiki.org/browse/XWIKI-19214]]
75 * [[Doxia 1.11.1>>https://jira.xwiki.org/browse/XRENDERING-626]]
76 * [[Checker Qual 3.20.0>>https://jira.xwiki.org/browse/XCOMMONS-2325]]
77 * [[HTTP Core 4.4.15>>https://jira.xwiki.org/browse/XCOMMONS-2323]]
78 * [[Bouncy Castle 1.70>>https://jira.xwiki.org/browse/XCOMMONS-2321]]
79 * [[Plexus Containers 2.1.1>>https://jira.xwiki.org/browse/XCOMMONS-2337]]
80 * [[Hibernate Validator 6.2.1.Final>>https://jira.xwiki.org/browse/XCOMMONS-2339]]
81 * [[Tika 2.2.1>>https://jira.xwiki.org/browse/XWIKI-19254]]
82 * [[Rome 1.18.0>>https://jira.xwiki.org/browse/XWIKI-19275]]
83 * [[JavaCC 7.0.10>>https://jira.xwiki.org/browse/XRENDERING-635]]
84 * [[Closure Compiler v20220104>>https://jira.xwiki.org/browse/XCOMMONS-2129]]
85 * [[Checker Qual 3.21.1>>https://jira.xwiki.org/browse/XCOMMONS-2333]]
86 * [[JNR POSIX 3.1.15>>https://jira.xwiki.org/browse/XWIKI-19213]]
87 * [[JNR FFI 2.2.11>>https://jira.xwiki.org/browse/XWIKI-19162]]
88 * [[JFFI 1.3.9>>https://jira.xwiki.org/browse/XWIKI-19161]]
89 * [[JBoss Logging 3.4.3>>https://jira.xwiki.org/browse/XCOMMONS-2348]]
90 * [[Protobuf Java 3.19.3>>https://jira.xwiki.org/browse/XCOMMONS-2344]]
91 * [[Liquibase 4.7.0>>https://jira.xwiki.org/browse/XWIKI-19315]]
92 * [[SLF4J 1.7.33>>https://jira.xwiki.org/browse/XCOMMONS-2352]]
93 * [[Byte Buddy 1.12.7>>https://jira.xwiki.org/browse/XCOMMONS-2316]]
94 * [[Woodstox 6.2.8>>https://jira.xwiki.org/browse/XCOMMONS-2315]]
95 * [[Netty 4.1.73.Final>>https://jira.xwiki.org/browse/XWIKI-19231]]
96 * [[jdom 2.0.6.1>>https://jira.xwiki.org/browse/XCOMMONS-2324]]
97 * [[MySQL connector 8.0.28>>https://jira.xwiki.org/browse/XWIKI-19322]]
98 * [[Hibernate 5.6.4>>https://jira.xwiki.org/browse/XWIKI-19255]]
99 * [[Java Diff Utils>>https://jira.xwiki.org/browse/XCOMMONS-2169]] (migrated from ##com.googlecode.java-diff-utils:diffutils:1.3.0## to ##io.github.java-diff-utils:java-diff-utils:4.11##)
100 * [[Bootstrap Date Time Picker 4.17.49>>https://jira.xwiki.org/browse/XWIKI-19330]]
101 * [[Bootstrap Switch 3.3.4>>https://jira.xwiki.org/browse/XWIKI-19329]]
102 * [[Bootstrap Date Range Picker 3.1>>https://jira.xwiki.org/browse/XWIKI-19325]]
103 * [[Bootstrap Select 1.13.18>>https://jira.xwiki.org/browse/XWIKI-19323]]
104 * [[Drawer 3.2.2>>https://jira.xwiki.org/browse/XWIKI-13140]]
105 * [[iscroll 5.2.0>>https://jira.xwiki.org/browse/XWIKI-19328]]
106 * [[selectize.js 0.13.3>>https://jira.xwiki.org/browse/XWIKI-19326]]
107 * [[momentjs 2.29.1>>https://jira.xwiki.org/browse/XWIKI-19324]]
108 * [[jstree 3.3.12>>https://jira.xwiki.org/browse/XWIKI-18875]]
109
110 = Translations =
111
112 The following translations have been updated:
113
114 {{language codes="de,fr,zh"/}}
115
116 {{comment}}
117 TODO: uncomment and update with proper link when the report is ready.
118
119 = Tested Browsers & Databases =
120
121 {{include reference="TestReports.<test report page>"/}}
122 {{/comment}}
123
124 {{comment}}
125 TODO: uncomment and update with proper links when the report is ready.
126
127 = Performances tests compared to <last super stable version> =
128
129 {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}}
130
131 More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]].
132 {{/comment}}
133
134 = Known issues =
135
136 * [[Bugs we know about>>https://jira.xwiki.org/issues/?jql=category%20%3D%2010000%20AND%20issuetype%20%3D%20Bug%20AND%20resolution%20%3D%20Unresolved%20ORDER%20BY%20updated%20DESC]]
137
138 = Backward Compatibility and Migration Notes =
139
140 == General Notes ==
141
142 * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
143 ** ##xwiki.cfg##
144 ** ##xwiki.properties##
145 ** ##web.xml##
146 ** ##hibernate.cfg.xml##
147 * Add ##xwiki.store.migration=1## in ##xwiki.cfg## so that XWiki will attempt to automatically migrate your current database to any new schema. Make sure you backup your Database before doing anything.
148
149 == Issues specific to {{velocity}}$product $version{{/velocity}} ==
150
151 === Drop support of Java 8 ===
152
153 XWiki now [[requires Java 11>>dev:Community.SupportStrategy.JavaSupportStrategy]] to run.
154
155 {{gallery}}
156 image:ReleaseNotes.Data.XWiki.14\.0RC1.WebHome@java11.png
157 {{/gallery}}
158
159 === Drop support of Internet Explorer 11 ===
160
161 Internet Explorer 11 support has been [[dropped>>https://forum.xwiki.org/t/drop-support-for-ie11-in-xwiki-14-0/9647/]]: we removed most of the hacks that were required by IE11 which makes this new version of XWiki unusable with this old web browser. Check the [[Browser Support Strategy>>dev:Community.SupportStrategy.BrowserSupportStrategy]] documentation to see the list of supported web browsers.
162
163 === Mentions ===
164
165 A local database is stored in the permanent directories and stores the updated document that needs to be analyzed for new mentions. This database is based on [[H2 MVStore>>url:https://www.h2database.com/html/mvstore.html]]. When upgrading to 14.0RC1+ the file format of H2 MVStore changes and the old one becomes unsupported. The old database file is moved to a backup file, and a new one is created.
166
167 {{warning}}
168 In this case, any updated document queued for upgrade when the server is stopped will be discarded, and some users will not be notified of their mentions.
169 Please make sure that the queue size is at zero before upgrading (see [[JMX>>doc:extensions:Extension.Mentions Application.WebHome||anchor="HJMX"]]).
170 {{/warning}}
171
172 == API Breakages ==
173
174 The following APIs were modified since {{velocity}}$product{{/velocity}} 13.10.2:
175
176 {{comment}}
177 Remove!
178 {{velocity}}
179 {{backwardCompatibilityReport134 version="$version"/}}
180 {{/velocity}}
181 {{/comment}}
182
183 = Credits =
184
185 The following people have contributed code and translations to this release (sorted alphabetically):
186
187 <code and translation contributors>

Get Connected