<
From version < 4.1 >
edited by Marius Dumitru Florea
on 2020/10/15
To version < 6.2 >
edited by Eduard Moraru
on 2020/10/20
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.mflorea
1 +XWiki.enygma
Content
... ... @@ -6,9 +6,9 @@
6 6  
7 7  <insert description of release here>
8 8  
9 -= New and Noteworthy (since XWiki <version - 1>) =
9 += New and Noteworthy (since XWiki 12.8) =
10 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>]].
11 +[[Full list of issues fixed and Dashboard for 12.9>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14622]].
12 12  
13 13  {{releasenotechanges/}}
14 14  
... ... @@ -23,6 +23,29 @@
23 23  * [[CSS4J 3.0.0>>https://jira.xwiki.org/browse/XWIKI-17898]]
24 24  * [[XWiki Syntax Highlighting Application 4.5.2>>https://jira.xwiki.org/browse/XWIKI-17932]]
25 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]]
26 26  
27 27  = Translations =
28 28  
... ... @@ -63,10 +63,118 @@
63 63  ** ##hibernate.cfg.xml##
64 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 65  
66 -== Issues specific to XWiki <version> ==
89 +== Issues specific to XWiki 12.9RC1 ==
67 67  
68 -<issues specific to the project>
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:
69 69  
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 +
70 70  == API Breakages ==
71 71  
72 72  The following APIs were modified since <project> <version - 1>:

Get Connected