Version 2.1 by Thomas Mortagne on 2021/06/28

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 main focus of this release is stabilization. In addition, a new UI is now proposed to administrate the rights that are provided by extensions. On a final note, more Livetables are migrated to Live Data and a few improvements are proposed to developpers.
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 ")
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}} <version - 1>) =
41
42 [[Full list of issues fixed and Dashboard for <full version here even for RC, e.g. 10.5>>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=<fill id here>]].
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 * [[CSS4J 3.5.1>>https://jira.xwiki.org/browse/XWIKI-18702]]
51 * [[Snakeyaml 1.29>>https://jira.xwiki.org/browse/XCOMMONS-2226]]
52 * [[PostgresSQL connector 42.2.22>>https://jira.xwiki.org/browse/XWIKI-18751]]
53 * [[Hibernate 5.5.2>>https://jira.xwiki.org/browse/XWIKI-18713]]
54 * [[Commons IO 2.10.0>>https://jira.xwiki.org/browse/XCOMMONS-2229]]
55 * [[Liquibase 4.4.0>>https://jira.xwiki.org/browse/XWIKI-18750]]
56 * [[Byte Buddy 1.11.2>>https://jira.xwiki.org/browse/XCOMMONS-2220]]
57 * [[Apache PDFBox 2.0.24>>https://jira.xwiki.org/browse/XWIKI-18749]]
58 * [[Protobuf Java 3.17.3>>https://jira.xwiki.org/browse/XCOMMONS-2211]]
59 * [[Bouncy Castle 1.69>>https://jira.xwiki.org/browse/XCOMMONS-2225]]
60 * [[JNR Constants 0.10.2>>https://jira.xwiki.org/browse/XWIKI-18720]]
61 * [[JNR FFI 2.2.4>>https://jira.xwiki.org/browse/XWIKI-18682]]
62 * [[JNR POSIX 3.1.7>>https://jira.xwiki.org/browse/XWIKI-18683]]
63 * [[Checker Qual 3.14.0>>https://jira.xwiki.org/browse/XCOMMONS-2222]]
64 * [[Commons Pool 2.10.0>>https://jira.xwiki.org/browse/XCOMMONS-2221]]
65 * [[Infinispan 12.1.4 and Protostream 4.4.1>>https://jira.xwiki.org/browse/XCOMMONS-2116]]
66 * [[Commons IO 2.9.0>>https://jira.xwiki.org/browse/XCOMMONS-2217]]
67 * [[JBoss Logging 3.4.2>>https://jira.xwiki.org/browse/XCOMMONS-2218]]
68 * [[Gson 2.8.7>>https://jira.xwiki.org/browse/XCOMMONS-2216]]
69 * [[Netty 4.1.65.Final>>https://jira.xwiki.org/browse/XWIKI-18652]]
70 * [[JFFI 1.3.4>>https://jira.xwiki.org/browse/XWIKI-18681]]
71 * [[XStream 1.4.17>>https://jira.xwiki.org/browse/XCOMMONS-2213]]
72 * [[MariaDB connector 2.7.3>>https://jira.xwiki.org/browse/XWIKI-18651]]
73 * [[Error Prone annotations 2.7.1>>https://jira.xwiki.org/browse/XCOMMONS-2212]]
74 * [[MySQL connector 8.0.25>>https://jira.xwiki.org/browse/XWIKI-18649]]
75
76 = Translations =
77
78 The following translations have been updated:
79
80 {{language codes="none, none"/}}
81
82 {{comment}}
83 TODO: uncomment and update with proper link when the report is ready.
84
85 = Tested Browsers & Databases =
86
87 {{include reference="TestReports.<test report page>"/}}
88 {{/comment}}
89
90 {{comment}}
91 TODO: uncomment and update with proper links when the report is ready.
92
93 = Performances tests compared to <last super stable version> =
94
95 {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}}
96
97 More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]].
98 {{/comment}}
99
100 = Known issues =
101
102 * [[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]]
103
104 = Backward Compatibility and Migration Notes =
105
106 == General Notes ==
107
108 * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
109 ** ##xwiki.cfg##
110 ** ##xwiki.properties##
111 ** ##web.xml##
112 ** ##hibernate.cfg.xml##
113 * 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.
114
115 == Like Right moved to Extension Rights section ==
116
117 As explained in [[this dedicated release change>>doc:.Entry001.WebHome]], a new administration section has been provided for Extension Rights, and the Like rights should now be configured in there. So the Like right won't appear anymore in the Rights section of Administration, but all settings are kept as they were.
118
119 == API Breakages ==
120
121 The following APIs were modified since {{velocity}}$product{{/velocity}} <version - 1>:
122
123 {{comment}}
124 Remove!
125 {{velocity}}
126 {{backwardCompatiblityReportXml version="$version"/}}
127 {{/velocity}}
128 {{/comment}}
129
130 = Credits =
131
132 The following people have contributed code and translations to this release (sorted alphabetically):
133
134 <code contributors>

Get Connected