Show last authors
author | version | line-number | content |
---|---|---|---|
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> |