Version 7.1 by slauriere on 2019/06/06

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 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.
6
7 <insert description of release here>
8
9 = New and Noteworthy (since XWiki <version - 1>) =
10
11 [[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>]].
12
13 {{releasenotechanges/}}
14
15 === Moved Modules ===
16
17 <description deprecated, retired and moved projects>
18
19 === Upgrades ===
20
21 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]]):
22
23 * [[Hibernate 5.4.3>>https://jira.xwiki.org/browse/XWIKI-8286]]
24 * [[Commons DBCP2 2.6.0>>https://jira.xwiki.org/browse/XCOMMONS-1487]]
25 * [[liquibase 3.6.3>>https://jira.xwiki.org/browse/XWIKI-16123]]
26
27 = Translations =
28
29 The following translations have been updated:
30
31 {{language codes="none, none"/}}
32
33 {{comment}}
34 TODO: uncomment and update with proper link when the report is ready.
35
36 = Tested Browsers & Databases =
37
38 {{include reference="TestReports.<test report page>"/}}
39 {{/comment}}
40
41 {{comment}}
42 TODO: uncomment and update with proper links when the report is ready.
43
44 = Performances tests compared to <last super stable version> =
45
46 <a summary of the comparison with latest super stable version>
47
48 More details on <link to the test report>.
49 {{/comment}}
50
51 = Known issues =
52
53 * [[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]]
54
55 = Backward Compatibility and Migration Notes =
56
57 == General Notes ==
58
59 * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
60 ** ##xwiki.cfg##
61 ** ##xwiki.properties##
62 ** ##web.xml##
63 ** ##hibernate.cfg.xml##
64 * 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.
65
66 == Issues specific to XWiki 11.5RC1 ==
67
68 === XWiki now requires JDBC 4.2 ===
69
70 In practice it just means you need to make sure the database connector you are using is not too old (JDBC 4.2 came with Java 8 so you should be fine if you downloaded the connector in recent years).
71
72 === Hibernate 5.4.x upgrade ===
73
74 Hibernate has (finally) been upgraded to the very last version. While it means you will benefit from bugfix/improvement/new features it's also a huge jump (previous version was close to 10 years old) and you will probably have issues if you are directly manipulating Hibernate APIs or some library expecting a much older version of Hibernate. You can find the details on https://github.com/hibernate/hibernate-orm/wiki/Migration-Guides but here is an extract from XWiki point of view:
75
76 * HQL '##?##'-based wildcards are not supported anymore at all by Hibernate. We added an automatic converter (to '##?1##' JPQL style) which seems to work well but it might not be perfect and it's producing a deprecating warning log
77 * You might need to update your ##hibernate.cfg.xml## file
78 * Various Hibernate classes have been removed or moved to different Java packages
79 * Various Hibernate methods have been removed from the APIs or not having any effect anymore even if still here and deprecated
80
81 === HTML head extension point identifier update ===
82
83 The identifier of [[the HTML header extension point>>Documentation.DevGuide.ExtensionPoint.HTMLHead]] allowing to inject HTML in the pages ##head## tag has been updated from ##org.xwiki.platform.head## to ##org.xwiki.platform.html.head##.
84
85 == API Breakages ==
86
87 The following APIs were modified since <project> <version - 1>:
88
89 {{comment}}
90 Remove!
91 {{backwardCompatiblityReport version="<version>"/}}
92 {{/comment}}
93
94 = Credits =
95
96 The following people have contributed code and translations to this release (sorted alphabetically):
97
98 <code contributors>

Get Connected