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 * <list libraries that have been upgraded>
24
25 = Translations =
26
27 The following translations have been updated:
28
29 {{language codes="none, none"/}}
30
31 {{comment}}
32 TODO: uncomment and update with proper link when the report is ready.
33
34 = Tested Browsers & Databases =
35
36 {{include reference="TestReports.<test report page>"/}}
37 {{/comment}}
38
39 {{comment}}
40 TODO: uncomment and update with proper links when the report is ready.
41
42 = Performances tests compared to <last super stable version> =
43
44 <a summary of the comparison with latest super stable version>
45
46 More details on <link to the test report>.
47 {{/comment}}
48
49 = Known issues =
50
51 * [[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]]
52
53 = Backward Compatibility and Migration Notes =
54
55 == General Notes ==
56
57 * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
58 ** ##xwiki.cfg##
59 ** ##xwiki.properties##
60 ** ##web.xml##
61 ** ##hibernate.cfg.xml##
62 * 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.
63
64 == Issues specific to XWiki 11.5RC1 ==
65
66 === XWiki now require JDBC 4.2 ===
67
68 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).
69
70 === Hibernate 5.4.x upgrade ===
71
72 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:
73
74 * HQL '?' based wildcard 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
75 * You might need to update your hibernate.cfg.xml file
76 * various Hibernate classes have been removed or move to different packages
77 * various Hibernate methods removed from the API or not having eny effect anymore even if still here and deprecated
78
79 == API Breakages ==
80
81 The following APIs were modified since <project> <version - 1>:
82
83 {{comment}}
84 Remove!
85 {{backwardCompatiblityReport version="<version>"/}}
86 {{/comment}}
87
88 = Credits =
89
90 The following people have contributed code and translations to this release (sorted alphabetically):
91
92 <code contributors>

Get Connected