Last modified by Ilie Andriuta on 2020/10/27

<
From version < 5.1 >
edited by Simon Urli
on 2020/10/19
To version < 3.1 >
edited by Vincent Massol
on 2020/10/12
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.surli
1 +XWiki.VincentMassol
Content
... ... @@ -22,11 +22,10 @@
22 22  
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 -* [[CKEditor Integration 1.51>>https://jira.xwiki.org/browse/XWIKI-17919]]
26 26  
27 27  = Translations =
28 28  
29 -The following translations have been updated:
28 +The following translations have been updated:
30 30  
31 31  {{language codes="none, none"/}}
32 32  
... ... @@ -63,118 +63,10 @@
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 12.9RC1 ==
65 +== Issues specific to XWiki <version> ==
67 67  
68 -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:
67 +<issues specific to the project>
69 69  
70 -{{code language="none"}}
71 -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])
72 -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)
73 -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]
74 -java.lang.NoClassDefFoundError: org/xwiki/ratings/internal/SeparatePageRatingsManager
75 - at java.lang.ClassLoader.defineClass1(Native Method)
76 - at java.lang.ClassLoader.defineClass(ClassLoader.java:756)
77 - at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:142)
78 - at java.net.URLClassLoader.defineClass(URLClassLoader.java:468)
79 - at java.net.URLClassLoader.access$100(URLClassLoader.java:74)
80 - at java.net.URLClassLoader$1.run(URLClassLoader.java:369)
81 - at java.net.URLClassLoader$1.run(URLClassLoader.java:363)
82 - at java.security.AccessController.doPrivileged(Native Method)
83 - at java.net.URLClassLoader.findClass(URLClassLoader.java:362)
84 - at java.lang.ClassLoader.loadClass(ClassLoader.java:418)
85 - at java.lang.ClassLoader.loadClass(ClassLoader.java:351)
86 - at org.xwiki.component.annotation.ComponentAnnotationLoader.getComponentsDescriptors(ComponentAnnotationLoader.java:161)
87 - at org.xwiki.component.annotation.ComponentAnnotationLoader.register(ComponentAnnotationLoader.java:217)
88 - at org.xwiki.component.annotation.ComponentAnnotationLoader.initialize(ComponentAnnotationLoader.java:138)
89 - at org.xwiki.extension.jar.internal.handler.JarExtensionHandler.loadComponents(JarExtensionHandler.java:251)
90 - at org.xwiki.extension.jar.internal.handler.JarExtensionHandler.install(JarExtensionHandler.java:183)
91 - at org.xwiki.extension.jar.internal.handler.JarExtensionHandler.initialize(JarExtensionHandler.java:144)
92 - at org.xwiki.extension.handler.internal.DefaultExtensionHandlerManager.initialize(DefaultExtensionHandlerManager.java:154)
93 - at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initializeExtensionInNamespace(DefaultExtensionInitializer.java:178)
94 - at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initializeExtensionInNamespace(DefaultExtensionInitializer.java:151)
95 - at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initializeExtension(DefaultExtensionInitializer.java:126)
96 - at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initialize(DefaultExtensionInitializer.java:104)
97 - at org.xwiki.extension.handler.internal.DefaultExtensionInitializer.initialize(DefaultExtensionInitializer.java:80)
98 - at org.xwiki.component.embed.InitializableLifecycleHandler.handle(InitializableLifecycleHandler.java:39)
99 - at org.xwiki.component.embed.EmbeddableComponentManager.createInstance(EmbeddableComponentManager.java:365)
100 - at org.xwiki.component.embed.EmbeddableComponentManager.getComponentInstance(EmbeddableComponentManager.java:451)
101 - at org.xwiki.component.embed.EmbeddableComponentManager.getInstance(EmbeddableComponentManager.java:201)
102 - at org.xwiki.component.embed.EmbeddableComponentManager.getInstance(EmbeddableComponentManager.java:189)
103 - at org.xwiki.container.servlet.XWikiServletContextListener.contextInitialized(XWikiServletContextListener.java:115)
104 - at org.eclipse.jetty.server.handler.ContextHandler.callContextInitialized(ContextHandler.java:1002)
105 - at org.eclipse.jetty.servlet.ServletContextHandler.callContextInitialized(ServletContextHandler.java:553)
106 - at org.eclipse.jetty.server.handler.ContextHandler.contextInitialized(ContextHandler.java:931)
107 - at org.eclipse.jetty.servlet.ServletHandler.initialize(ServletHandler.java:764)
108 - at org.eclipse.jetty.servlet.ServletContextHandler.startContext(ServletContextHandler.java:360)
109 - at org.eclipse.jetty.webapp.WebAppContext.startWebapp(WebAppContext.java:1445)
110 - at org.eclipse.jetty.webapp.WebAppContext.startContext(WebAppContext.java:1409)
111 - at org.eclipse.jetty.server.handler.ContextHandler.doStart(ContextHandler.java:844)
112 - at org.eclipse.jetty.servlet.ServletContextHandler.doStart(ServletContextHandler.java:275)
113 - at org.eclipse.jetty.webapp.WebAppContext.doStart(WebAppContext.java:524)
114 - at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
115 - at org.eclipse.jetty.deploy.bindings.StandardStarter.processBinding(StandardStarter.java:46)
116 - at org.eclipse.jetty.deploy.AppLifeCycle.runBindings(AppLifeCycle.java:188)
117 - at org.eclipse.jetty.deploy.DeploymentManager.requestAppGoal(DeploymentManager.java:513)
118 - at org.eclipse.jetty.deploy.DeploymentManager.addApp(DeploymentManager.java:154)
119 - at org.eclipse.jetty.deploy.providers.ScanningAppProvider.fileAdded(ScanningAppProvider.java:173)
120 - at org.eclipse.jetty.deploy.providers.WebAppProvider.fileAdded(WebAppProvider.java:447)
121 - at org.eclipse.jetty.deploy.providers.ScanningAppProvider$1.fileAdded(ScanningAppProvider.java:66)
122 - at org.eclipse.jetty.util.Scanner.reportAddition(Scanner.java:784)
123 - at org.eclipse.jetty.util.Scanner.reportDifferences(Scanner.java:753)
124 - at org.eclipse.jetty.util.Scanner.scan(Scanner.java:641)
125 - at org.eclipse.jetty.util.Scanner.doStart(Scanner.java:540)
126 - at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
127 - at org.eclipse.jetty.deploy.providers.ScanningAppProvider.doStart(ScanningAppProvider.java:146)
128 - at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
129 - at org.eclipse.jetty.deploy.DeploymentManager.startAppProvider(DeploymentManager.java:599)
130 - at org.eclipse.jetty.deploy.DeploymentManager.doStart(DeploymentManager.java:249)
131 - at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
132 - at org.eclipse.jetty.util.component.ContainerLifeCycle.start(ContainerLifeCycle.java:169)
133 - at org.eclipse.jetty.server.Server.start(Server.java:408)
134 - at org.eclipse.jetty.util.component.ContainerLifeCycle.doStart(ContainerLifeCycle.java:117)
135 - at org.eclipse.jetty.server.handler.AbstractHandler.doStart(AbstractHandler.java:97)
136 - at org.eclipse.jetty.server.Server.doStart(Server.java:372)
137 - at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
138 - at org.eclipse.jetty.xml.XmlConfiguration.lambda$main$1(XmlConfiguration.java:1929)
139 - at java.security.AccessController.doPrivileged(Native Method)
140 - at org.eclipse.jetty.xml.XmlConfiguration.main(XmlConfiguration.java:1878)
141 - at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
142 - at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
143 - at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
144 - at java.lang.reflect.Method.invoke(Method.java:498)
145 - at org.eclipse.jetty.start.Main.invokeMain(Main.java:218)
146 - at org.eclipse.jetty.start.Main.start(Main.java:491)
147 - at org.eclipse.jetty.start.Main.main(Main.java:77)
148 -Caused by: java.lang.ClassNotFoundException: org.xwiki.ratings.internal.SeparatePageRatingsManager
149 - at java.net.URLClassLoader.findClass(URLClassLoader.java:382)
150 - at java.lang.ClassLoader.loadClass(ClassLoader.java:418)
151 - at java.lang.ClassLoader.loadClass(ClassLoader.java:351)
152 - ... 73 common frames omitted
153 -{{/code}}
154 -
155 -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.
156 -
157 -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.
158 -
159 -Also note that at first start, a data migration of Ratings and Likes will be performed, you might see some logs like that:
160 -
161 -{{code language="none"}}
162 -2020-10-16 17:40:31,319 [XWiki initialization] INFO .HibernateDataMigrationManager - R120901000XWIKI17761 - Move old Ratings XObject to the default Solr rating store.
163 -2020-10-16 17:40:31,319 [XWiki initialization] INFO .HibernateDataMigrationManager - Checking Hibernate mapping and updating schema if needed for wiki [xwiki]
164 -2020-10-16 17:40:31,508 [XWiki initialization] INFO .HibernateDataMigrationManager - Starting data migration [R120901000XWIKI17761] with version [120901000] on database [xwiki]
165 -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
166 -2020-10-16 17:40:35,869 [XWiki Solr index thread] INFO .HibernateDataMigrationManager - Storage schema updates and data migrations are enabled
167 -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.
168 -2020-10-16 17:40:36,415 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - Starting recomputation of average ratings on rated pages for consistency of data.
169 -2020-10-16 17:40:37,088 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - Average ratings have been recomputed on all [4] pages.
170 -2020-10-16 17:40:37,089 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - Starting migration of Likes information to the Ratings Solr Core.
171 -2020-10-16 17:40:37,100 [XWiki initialization] INFO SolrDocumentMigration120900000 - [2] like information migrated.
172 -2020-10-16 17:40:37,175 [XWiki initialization] INFO 0901000XWIKI17761DataMigration - The migration is now finished.
173 -2020-10-16 17:40:37,178 [XWiki initialization] INFO .HibernateDataMigrationManager - Data migration [R120901000XWIKI17761] applied successfully, database [xwiki] upgraded to version [120901000]
174 -{{/code}}
175 -
176 -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"]].
177 -
178 178  == API Breakages ==
179 179  
180 180  The following APIs were modified since <project> <version - 1>:

Get Connected