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 This release brings improved display of liked pages and users that like a page, usability improvements when changing page syntax, finer configuration options for skipping the recycle bin and a new and improved Ratings API.
8
9 {{error}}
10 A bug has been found in XWiki 12.9RC1 impacting users of Ratings (https://jira.xwiki.org/browse/XWIKI-17968 ): if you are using Ratings in your wiki it is advised to wait XWiki 12.9 release before upgrading.
11 {{/error}}
12
13 = New and Noteworthy (since XWiki 12.8) =
14
15 [[Full list of issues fixed and Dashboard for 12.9>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14622]].
16
17 {{releasenotechanges/}}
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="es, fr, hr, lv, mr, no, ru, sk, zh"/}}
55
56 = Tested Browsers & Databases =
57
58 {{include reference="TestReports.ManualTestReportSummaryXWiki129RC1.WebHome"/}}
59
60 {{comment}}
61 TODO: uncomment and update with proper links when the report is ready.
62
63 = Performances tests compared to <last super stable version> =
64
65 {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}}
66
67 More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]].
68 {{/comment}}
69
70 = Known issues =
71
72 * [[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]]
73
74 = Backward Compatibility and Migration Notes =
75
76 == General Notes ==
77
78 * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
79 ** ##xwiki.cfg##
80 ** ##xwiki.properties##
81 ** ##web.xml##
82 ** ##hibernate.cfg.xml##
83 * 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.
84
85 == Issues specific to XWiki 12.9RC1 ==
86
87 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:
88
89 {{code language="none"}}
90 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])
91 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)
92 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]
93 java.lang.NoClassDefFoundError: org/xwiki/ratings/internal/SeparatePageRatingsManager
94 at java.lang.ClassLoader.defineClass1(Native Method)
95 at java.lang.ClassLoader.defineClass(ClassLoader.java:756)
96 at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:142)
97 at java.net.URLClassLoader.defineClass(URLClassLoader.java:468)
98 at java.net.URLClassLoader.access$100(URLClassLoader.java:74)
99 at java.net.URLClassLoader$1.run(URLClassLoader.java:369)
100 at java.net.URLClassLoader$1.run(URLClassLoader.java:363)
101 at java.security.AccessController.doPrivileged(Native Method)
102 at java.net.URLClassLoader.findClass(URLClassLoader.java:362)
103 at java.lang.ClassLoader.loadClass(ClassLoader.java:418)
104 at java.lang.ClassLoader.loadClass(ClassLoader.java:351)
105 at org.xwiki.component.annotation.ComponentAnnotationLoader.getComponentsDescriptors(ComponentAnnotationLoader.java:161)
106 at org.xwiki.component.annotation.ComponentAnnotationLoader.register(ComponentAnnotationLoader.java:217)
107 at org.xwiki.component.annotation.ComponentAnnotationLoader.initialize(ComponentAnnotationLoader.java:138)
108 at org.xwiki.extension.jar.internal.handler.JarExtensionHandler.loadComponents(JarExtensionHandler.java:251)
109 at org.xwiki.extension.jar.internal.handler.JarExtensionHandler.install(JarExtensionHandler.java:183)
110 at org.xwiki.extension.jar.internal.handler.JarExtensionHandler.initialize(JarExtensionHandler.java:144)
111 at org.xwiki.extension.handler.internal.DefaultExtensionHandlerManager.initialize(DefaultExtensionHandlerManager.java:154)
112 at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initializeExtensionInNamespace(DefaultExtensionInitializer.java:178)
113 at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initializeExtensionInNamespace(DefaultExtensionInitializer.java:151)
114 at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initializeExtension(DefaultExtensionInitializer.java:126)
115 at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initialize(DefaultExtensionInitializer.java:104)
116 at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initialize(DefaultExtensionInitializer.java:80)
117 at org.xwiki.component.embed.InitializableLifecycleHandler.handle(InitializableLifecycleHandler.java:39)
118 at org.xwiki.component.embed.EmbeddableComponentManager.createInstance(EmbeddableComponentManager.java:365)
119 at org.xwiki.component.embed.EmbeddableComponentManager.getComponentInstance(EmbeddableComponentManager.java:451)
120 at org.xwiki.component.embed.EmbeddableComponentManager.getInstance(EmbeddableComponentManager.java:201)
121 at org.xwiki.component.embed.EmbeddableComponentManager.getInstance(EmbeddableComponentManager.java:189)
122 at org.xwiki.container.servlet.XWikiServletContextListener.contextInitialized(XWikiServletContextListener.java:115)
123 at org.eclipse.jetty.server.handler.ContextHandler.callContextInitialized(ContextHandler.java:1002)
124 at org.eclipse.jetty.servlet.ServletContextHandler.callContextInitialized(ServletContextHandler.java:553)
125 at org.eclipse.jetty.server.handler.ContextHandler.contextInitialized(ContextHandler.java:931)
126 at org.eclipse.jetty.servlet.ServletHandler.initialize(ServletHandler.java:764)
127 at org.eclipse.jetty.servlet.ServletContextHandler.startContext(ServletContextHandler.java:360)
128 at org.eclipse.jetty.webapp.WebAppContext.startWebapp(WebAppContext.java:1445)
129 at org.eclipse.jetty.webapp.WebAppContext.startContext(WebAppContext.java:1409)
130 at org.eclipse.jetty.server.handler.ContextHandler.doStart(ContextHandler.java:844)
131 at org.eclipse.jetty.servlet.ServletContextHandler.doStart(ServletContextHandler.java:275)
132 at org.eclipse.jetty.webapp.WebAppContext.doStart(WebAppContext.java:524)
133 at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
134 at org.eclipse.jetty.deploy.bindings.StandardStarter.processBinding(StandardStarter.java:46)
135 at org.eclipse.jetty.deploy.AppLifeCycle.runBindings(AppLifeCycle.java:188)
136 at org.eclipse.jetty.deploy.DeploymentManager.requestAppGoal(DeploymentManager.java:513)
137 at org.eclipse.jetty.deploy.DeploymentManager.addApp(DeploymentManager.java:154)
138 at org.eclipse.jetty.deploy.providers.ScanningAppProvider.fileAdded(ScanningAppProvider.java:173)
139 at org.eclipse.jetty.deploy.providers.WebAppProvider.fileAdded(WebAppProvider.java:447)
140 at org.eclipse.jetty.deploy.providers.ScanningAppProvider$1.fileAdded(ScanningAppProvider.java:66)
141 at org.eclipse.jetty.util.Scanner.reportAddition(Scanner.java:784)
142 at org.eclipse.jetty.util.Scanner.reportDifferences(Scanner.java:753)
143 at org.eclipse.jetty.util.Scanner.scan(Scanner.java:641)
144 at org.eclipse.jetty.util.Scanner.doStart(Scanner.java:540)
145 at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
146 at org.eclipse.jetty.deploy.providers.ScanningAppProvider.doStart(ScanningAppProvider.java:146)
147 at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
148 at org.eclipse.jetty.deploy.DeploymentManager.startAppProvider(DeploymentManager.java:599)
149 at org.eclipse.jetty.deploy.DeploymentManager.doStart(DeploymentManager.java:249)
150 at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
151 at org.eclipse.jetty.util.component.ContainerLifeCycle.start(ContainerLifeCycle.java:169)
152 at org.eclipse.jetty.server.Server.start(Server.java:408)
153 at org.eclipse.jetty.util.component.ContainerLifeCycle.doStart(ContainerLifeCycle.java:117)
154 at org.eclipse.jetty.server.handler.AbstractHandler.doStart(AbstractHandler.java:97)
155 at org.eclipse.jetty.server.Server.doStart(Server.java:372)
156 at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
157 at org.eclipse.jetty.xml.XmlConfiguration.lambda$main$1(XmlConfiguration.java:1929)
158 at java.security.AccessController.doPrivileged(Native Method)
159 at org.eclipse.jetty.xml.XmlConfiguration.main(XmlConfiguration.java:1878)
160 at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
161 at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
162 at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
163 at java.lang.reflect.Method.invoke(Method.java:498)
164 at org.eclipse.jetty.start.Main.invokeMain(Main.java:218)
165 at org.eclipse.jetty.start.Main.start(Main.java:491)
166 at org.eclipse.jetty.start.Main.main(Main.java:77)
167 Caused by: java.lang.ClassNotFoundException: org.xwiki.ratings.internal.SeparatePageRatingsManager
168 at java.net.URLClassLoader.findClass(URLClassLoader.java:382)
169 at java.lang.ClassLoader.loadClass(ClassLoader.java:418)
170 at java.lang.ClassLoader.loadClass(ClassLoader.java:351)
171 ... 73 common frames omitted
172 {{/code}}
173
174 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.
175
176 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.
177
178 Also note that at first start, a data migration of Ratings and Likes will be performed, you might see some logs like that:
179
180 {{code language="none"}}
181 2020-10-16 17:40:31,319 [XWiki initialization] INFO .HibernateDataMigrationManager - R120901000XWIKI17761 - Move old Ratings XObject to the default Solr rating store.
182 2020-10-16 17:40:31,319 [XWiki initialization] INFO .HibernateDataMigrationManager - Checking Hibernate mapping and updating schema if needed for wiki [xwiki]
183 2020-10-16 17:40:31,508 [XWiki initialization] INFO .HibernateDataMigrationManager - Starting data migration [R120901000XWIKI17761] with version [120901000] on database [xwiki]
184 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
185 2020-10-16 17:40:35,869 [XWiki Solr index thread] INFO .HibernateDataMigrationManager - Storage schema updates and data migrations are enabled
186 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.
187 2020-10-16 17:40:36,415 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - Starting recomputation of average ratings on rated pages for consistency of data.
188 2020-10-16 17:40:37,088 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - Average ratings have been recomputed on all [4] pages.
189 2020-10-16 17:40:37,089 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - Starting migration of Likes information to the Ratings Solr Core.
190 2020-10-16 17:40:37,100 [XWiki initialization] INFO SolrDocumentMigration120900000 - [2] like information migrated.
191 2020-10-16 17:40:37,175 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - The migration is now finished.
192 2020-10-16 17:40:37,178 [XWiki initialization] INFO .HibernateDataMigrationManager - Data migration [R120901000XWIKI17761] applied successfully, database [xwiki] upgraded to version [120901000]
193 {{/code}}
194
195 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"]].
196
197 == API Breakages ==
198
199 The following APIs were modified since XWiki 12.8:
200
201 {{backwardCompatiblityReportXml version="12.9-rc-1"/}}
202
203 = Credits =
204
205 The following people have contributed code and translations to this release (sorted alphabetically):
206
207 Carlos Amengual
208 DenisF
209 Eduard Moraru
210 Francisco GarcĂ­a Moreno
211 ignatescustefan
212 Jarle Sandmo
213 jason
214 Manuel Leduc
215 Marius Dumitru Florea
216 Simon Urli
217 Thomas Mortagne
218 Vincent Massol
219 xrichard

Get Connected