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 12.8) =
10
11 [[Full list of issues fixed and Dashboard for 12.9>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14622]].
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 * [[CSS4J 3.0.0>>https://jira.xwiki.org/browse/XWIKI-17898]]
24 * [[XWiki Syntax Highlighting Application 4.5.2>>https://jira.xwiki.org/browse/XWIKI-17932]]
25 * [[CKEditor Integration 1.51>>https://jira.xwiki.org/browse/XWIKI-17919]]
26 * [[httpclient 4.5.13>>https://jira.xwiki.org/browse/XCOMMONS-2040]]
27 * [[cssparser 0.9.28>>https://jira.xwiki.org/browse/XCOMMONS-2044]]
28 * [[Woodstox 6.2.3>>https://jira.xwiki.org/browse/XCOMMONS-2053]]
29 * [[Snakeyaml 1.27>>https://jira.xwiki.org/browse/XCOMMONS-2027]]
30 * [[PostgresSQL connector 42.2.17>>https://jira.xwiki.org/browse/XWIKI-17928]]
31 * [[MariaDB connector 2.7.0>>https://jira.xwiki.org/browse/XWIKI-17865]]
32 * [[Jackson 2.11.3>>https://jira.xwiki.org/browse/XCOMMONS-2045]]
33 * [[JNR POSIX 3.1.2>>https://jira.xwiki.org/browse/XWIKI-17863]]
34 * [[JNR Netdb 1.2.0>>https://jira.xwiki.org/browse/XWIKI-17862]]
35 * [[JNR FFI 2.2.0>>https://jira.xwiki.org/browse/XWIKI-17861]]
36 * [[JNR Constants 0.10.0>>https://jira.xwiki.org/browse/XWIKI-17860]]
37 * [[JGroups 4.2.7>>https://jira.xwiki.org/browse/XCOMMONS-2041]]
38 * [[JFFI 1.3.0>>https://jira.xwiki.org/browse/XWIKI-17859]]
39 * [[JBoss Marshalling 2.0.10.Final>>https://jira.xwiki.org/browse/XCOMMONS-2035]]
40 * [[Hibernate 5.4.22>>https://jira.xwiki.org/browse/XWIKI-17929]]
41 * [[Commons Pool 2.9.0>>https://jira.xwiki.org/browse/XCOMMONS-2037]]
42 * [[Commons Net 3.7.2>>https://jira.xwiki.org/browse/XCOMMONS-2047]]
43 * [[Commons DBCP2 2.8.0>>https://jira.xwiki.org/browse/XCOMMONS-2034]]
44 * [[Commons CLI 1.4>>https://jira.xwiki.org/browse/XCOMMONS-2036]]
45 * [[Checker Qual 3.7.0>>https://jira.xwiki.org/browse/XCOMMONS-2046]]
46 * [[Caffeine 2.8.6>>https://jira.xwiki.org/browse/XCOMMONS-2048]]
47 * [[Byte Buddy 1.10.16>>https://jira.xwiki.org/browse/XCOMMONS-2028]]
48 * [[ASM 9.0>>https://jira.xwiki.org/browse/XCOMMONS-2030]]
49
50 = Translations =
51
52 The following translations have been updated:
53
54 {{language codes="none, none"/}}
55
56 {{comment}}
57 TODO: uncomment and update with proper link when the report is ready.
58
59 = Tested Browsers & Databases =
60
61 {{include reference="TestReports.<test report page>"/}}
62 {{/comment}}
63
64 {{comment}}
65 TODO: uncomment and update with proper links when the report is ready.
66
67 = Performances tests compared to <last super stable version> =
68
69 {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}}
70
71 More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]].
72 {{/comment}}
73
74 = Known issues =
75
76 * [[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]]
77
78 = Backward Compatibility and Migration Notes =
79
80 == General Notes ==
81
82 * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
83 ** ##xwiki.cfg##
84 ** ##xwiki.properties##
85 ** ##web.xml##
86 ** ##hibernate.cfg.xml##
87 * 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.
88
89 == Issues specific to XWiki 12.9RC1 ==
90
91 The [[Ratings API>>extensions:Extension.Ratings API]] have been rewritten in order to support more usecases, but we voluntarely broke the backward compatibility when doing so. If you are upgrading from XWiki 12.7RC1 or after, or from an XWiki version on which [[Ratings Application>>extensions:Extension.Ratings Application]] is installed, you might see some logs like that at first restart:
92
93 {{code language="none"}}
94 2020-10-16 17:39:53,897 [main] WARN ltInstalledExtensionRepository - Invalid extension [org.xwiki.platform:xwiki-platform-distribution-flavor-mainwiki/12.8] on namespace [wiki:xwiki] (InvalidExtensionException: Dependency [org.xwiki.platform:xwiki-platform-oldcore-[12.8]] is incompatible with the core extension [org.xwiki.platform:xwiki-platform-oldcore/12.9-SNAPSHOT])
95 2020-10-16 17:39:53,897 [main] WARN ltInstalledExtensionRepository - Invalid extension [org.xwiki.platform:xwiki-platform-ratings-api/12.8] (InvalidExtensionException: Extension [org.xwiki.platform:xwiki-platform-ratings-api/12.8] already exists as a core extension)
96 2020-10-16 17:39:54,486 [main] ERROR .i.DefaultExtensionInitializer - Failed to initialize local extension [org.xwiki.platform:xwiki-platform-like-api/12.8]
97 java.lang.NoClassDefFoundError: org/xwiki/ratings/internal/SeparatePageRatingsManager
98 at java.lang.ClassLoader.defineClass1(Native Method)
99 at java.lang.ClassLoader.defineClass(ClassLoader.java:756)
100 at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:142)
101 at java.net.URLClassLoader.defineClass(URLClassLoader.java:468)
102 at java.net.URLClassLoader.access$100(URLClassLoader.java:74)
103 at java.net.URLClassLoader$1.run(URLClassLoader.java:369)
104 at java.net.URLClassLoader$1.run(URLClassLoader.java:363)
105 at java.security.AccessController.doPrivileged(Native Method)
106 at java.net.URLClassLoader.findClass(URLClassLoader.java:362)
107 at java.lang.ClassLoader.loadClass(ClassLoader.java:418)
108 at java.lang.ClassLoader.loadClass(ClassLoader.java:351)
109 at org.xwiki.component.annotation.ComponentAnnotationLoader.getComponentsDescriptors(ComponentAnnotationLoader.java:161)
110 at org.xwiki.component.annotation.ComponentAnnotationLoader.register(ComponentAnnotationLoader.java:217)
111 at org.xwiki.component.annotation.ComponentAnnotationLoader.initialize(ComponentAnnotationLoader.java:138)
112 at org.xwiki.extension.jar.internal.handler.JarExtensionHandler.loadComponents(JarExtensionHandler.java:251)
113 at org.xwiki.extension.jar.internal.handler.JarExtensionHandler.install(JarExtensionHandler.java:183)
114 at org.xwiki.extension.jar.internal.handler.JarExtensionHandler.initialize(JarExtensionHandler.java:144)
115 at org.xwiki.extension.handler.internal.DefaultExtensionHandlerManager.initialize(DefaultExtensionHandlerManager.java:154)
116 at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initializeExtensionInNamespace(DefaultExtensionInitializer.java:178)
117 at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initializeExtensionInNamespace(DefaultExtensionInitializer.java:151)
118 at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initializeExtension(DefaultExtensionInitializer.java:126)
119 at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initialize(DefaultExtensionInitializer.java:104)
120 at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initialize(DefaultExtensionInitializer.java:80)
121 at org.xwiki.component.embed.InitializableLifecycleHandler.handle(InitializableLifecycleHandler.java:39)
122 at org.xwiki.component.embed.EmbeddableComponentManager.createInstance(EmbeddableComponentManager.java:365)
123 at org.xwiki.component.embed.EmbeddableComponentManager.getComponentInstance(EmbeddableComponentManager.java:451)
124 at org.xwiki.component.embed.EmbeddableComponentManager.getInstance(EmbeddableComponentManager.java:201)
125 at org.xwiki.component.embed.EmbeddableComponentManager.getInstance(EmbeddableComponentManager.java:189)
126 at org.xwiki.container.servlet.XWikiServletContextListener.contextInitialized(XWikiServletContextListener.java:115)
127 at org.eclipse.jetty.server.handler.ContextHandler.callContextInitialized(ContextHandler.java:1002)
128 at org.eclipse.jetty.servlet.ServletContextHandler.callContextInitialized(ServletContextHandler.java:553)
129 at org.eclipse.jetty.server.handler.ContextHandler.contextInitialized(ContextHandler.java:931)
130 at org.eclipse.jetty.servlet.ServletHandler.initialize(ServletHandler.java:764)
131 at org.eclipse.jetty.servlet.ServletContextHandler.startContext(ServletContextHandler.java:360)
132 at org.eclipse.jetty.webapp.WebAppContext.startWebapp(WebAppContext.java:1445)
133 at org.eclipse.jetty.webapp.WebAppContext.startContext(WebAppContext.java:1409)
134 at org.eclipse.jetty.server.handler.ContextHandler.doStart(ContextHandler.java:844)
135 at org.eclipse.jetty.servlet.ServletContextHandler.doStart(ServletContextHandler.java:275)
136 at org.eclipse.jetty.webapp.WebAppContext.doStart(WebAppContext.java:524)
137 at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
138 at org.eclipse.jetty.deploy.bindings.StandardStarter.processBinding(StandardStarter.java:46)
139 at org.eclipse.jetty.deploy.AppLifeCycle.runBindings(AppLifeCycle.java:188)
140 at org.eclipse.jetty.deploy.DeploymentManager.requestAppGoal(DeploymentManager.java:513)
141 at org.eclipse.jetty.deploy.DeploymentManager.addApp(DeploymentManager.java:154)
142 at org.eclipse.jetty.deploy.providers.ScanningAppProvider.fileAdded(ScanningAppProvider.java:173)
143 at org.eclipse.jetty.deploy.providers.WebAppProvider.fileAdded(WebAppProvider.java:447)
144 at org.eclipse.jetty.deploy.providers.ScanningAppProvider$1.fileAdded(ScanningAppProvider.java:66)
145 at org.eclipse.jetty.util.Scanner.reportAddition(Scanner.java:784)
146 at org.eclipse.jetty.util.Scanner.reportDifferences(Scanner.java:753)
147 at org.eclipse.jetty.util.Scanner.scan(Scanner.java:641)
148 at org.eclipse.jetty.util.Scanner.doStart(Scanner.java:540)
149 at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
150 at org.eclipse.jetty.deploy.providers.ScanningAppProvider.doStart(ScanningAppProvider.java:146)
151 at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
152 at org.eclipse.jetty.deploy.DeploymentManager.startAppProvider(DeploymentManager.java:599)
153 at org.eclipse.jetty.deploy.DeploymentManager.doStart(DeploymentManager.java:249)
154 at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
155 at org.eclipse.jetty.util.component.ContainerLifeCycle.start(ContainerLifeCycle.java:169)
156 at org.eclipse.jetty.server.Server.start(Server.java:408)
157 at org.eclipse.jetty.util.component.ContainerLifeCycle.doStart(ContainerLifeCycle.java:117)
158 at org.eclipse.jetty.server.handler.AbstractHandler.doStart(AbstractHandler.java:97)
159 at org.eclipse.jetty.server.Server.doStart(Server.java:372)
160 at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
161 at org.eclipse.jetty.xml.XmlConfiguration.lambda$main$1(XmlConfiguration.java:1929)
162 at java.security.AccessController.doPrivileged(Native Method)
163 at org.eclipse.jetty.xml.XmlConfiguration.main(XmlConfiguration.java:1878)
164 at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
165 at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
166 at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
167 at java.lang.reflect.Method.invoke(Method.java:498)
168 at org.eclipse.jetty.start.Main.invokeMain(Main.java:218)
169 at org.eclipse.jetty.start.Main.start(Main.java:491)
170 at org.eclipse.jetty.start.Main.main(Main.java:77)
171 Caused by: java.lang.ClassNotFoundException: org.xwiki.ratings.internal.SeparatePageRatingsManager
172 at java.net.URLClassLoader.findClass(URLClassLoader.java:382)
173 at java.lang.ClassLoader.loadClass(ClassLoader.java:418)
174 at java.lang.ClassLoader.loadClass(ClassLoader.java:351)
175 ... 73 common frames omitted
176 {{/code}}
177
178 If not nice, those errors are expected: they are showing that our internal Extension Manager found that the Ratings API compatibility was broken. This error will prevent using the Ratings Application or the Like Application until you have completely performed the upgrade.
179
180 During the upgrade, you will be proposed to remove the old Ratings API extension: keep the default value for it (it should be checked) to avoid any inconsistency.
181
182 Also note that at first start, a data migration of Ratings and Likes will be performed, you might see some logs like that:
183
184 {{code language="none"}}
185 2020-10-16 17:40:31,319 [XWiki initialization] INFO .HibernateDataMigrationManager - R120901000XWIKI17761 - Move old Ratings XObject to the default Solr rating store.
186 2020-10-16 17:40:31,319 [XWiki initialization] INFO .HibernateDataMigrationManager - Checking Hibernate mapping and updating schema if needed for wiki [xwiki]
187 2020-10-16 17:40:31,508 [XWiki initialization] INFO .HibernateDataMigrationManager - Starting data migration [R120901000XWIKI17761] with version [120901000] on database [xwiki]
188 2020-10-16 17:40:31,633 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - [5] pages containing ratings xobjects have been found: those objects will be migrated to the new storage system and will be removed. The pages holding those xobjects will remain
189 2020-10-16 17:40:35,869 [XWiki Solr index thread] INFO .HibernateDataMigrationManager - Storage schema updates and data migrations are enabled
190 2020-10-16 17:40:36,415 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - All pages have been handled to migrate their Ratings xobject. Total: [5] pages handled and [5] xobjects migrated.
191 2020-10-16 17:40:36,415 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - Starting recomputation of average ratings on rated pages for consistency of data.
192 2020-10-16 17:40:37,088 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - Average ratings have been recomputed on all [4] pages.
193 2020-10-16 17:40:37,089 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - Starting migration of Likes information to the Ratings Solr Core.
194 2020-10-16 17:40:37,100 [XWiki initialization] INFO SolrDocumentMigration120900000 - [2] like information migrated.
195 2020-10-16 17:40:37,175 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - The migration is now finished.
196 2020-10-16 17:40:37,178 [XWiki initialization] INFO .HibernateDataMigrationManager - Data migration [R120901000XWIKI17761] applied successfully, database [xwiki] upgraded to version [120901000]
197 {{/code}}
198
199 Finally if you have a custom extension or custom scripts using the Ratings API, you will be interested about this [[migration guide>>extensions:Extension.Ratings API||anchor="HMigrationfromoldRatingsAPI28before12.9RC129"]].
200
201 == API Breakages ==
202
203 The following APIs were modified since <project> <version - 1>:
204
205 {{comment}}
206 Remove!
207 {{backwardCompatiblityReportXml version="<version>"/}}
208 {{/comment}}
209
210 = Credits =
211
212 The following people have contributed code and translations to this release (sorted alphabetically):
213
214 <code contributors>

Get Connected