Release Notes for XWiki 6.2 RC 1

Last modified by Thomas Mortagne on 2017/03/24

This is the release notes for XWiki Commons, XWiki Rendering, XWiki Platform and XWiki Enterprise. They share the same release notes as they are released together and have the same version.

This release is a Release Candidate and, as such, it focuses on stabilization, bugfixes (35) and performance improvements. Make sure to try it out and report any problems that may affect the upcoming final release.

New and Noteworthy (since XWiki 6.2 milestone 2)

Full list of issues fixed and Dashboard for 6.2.

Blog Application

The blog panels are now displayed on the right column by default, to fit Flamingo:



  • The Font Awesome Icon Theme has been improved with 50 new icons.
  • In Flamingo, the form of the login page has been changed to navigate easily using the keyboard.
  • Annotations initialization speedup
  • Wiki macros initialization speedup

See the full list of JIRA issues fixed in this release.

For Developers


The following dependencies have been upgraded:



The following translations have been updated: 

Tested Browsers & Databases

Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:TestReports.ManualTestReportXWiki62RC1Summary]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

Here is the list of browsers we support and how they have been tested for this release:

Chrome30.pngGoogle Chrome 37Smoke testing
Firefox30.pngMozilla Firefox 32Smoke testing, Jira Tickets Marked as Fixed in the Release Notes
IE30.pngInternet Explorer 8Smoke testing
IE30.pngInternet Explorer 9Smoke testing
IE30.pngInternet Explorer 10Smoke testing
IE30.pngInternet Explorer 11Smoke testing

Here is the list of databases we support and how they have been tested for this release:

hypersql.pngHyperSQL 2.3.2Smoke testing, Jira Tickets Marked as Fixed in the Release Notes
mysql.pngMySQL 5.6.17Not Tested
oracle.pngOracle 11.2Not Tested
postgresql.pngPostgreSQL 9.3.4Not Tested

For the full list of tests see this page.

Known issues

Backward Compatibility and Migration Notes

General Notes

When upgrading make sure you compare your xwiki.cfg, and web.xml files with the newest version since some configuration parameters may have been modified or added. Note that you should add so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.

API Breakages

The following APIs were modified since XWiki 6.1:

  • Young APIs:
    org.xwiki.rendering.transformation.RenderingContext: Method 'public org.xwiki.rendering.syntax.Syntax getTargetSyntax()' has been added to an interface
    • Added an API for a very common use case so that we optimize it Method 'public java.util.Collection getAllIds()' has been added to an interface
    org.xwiki.mail.MailSender: Method 'public void send(javax.mail.internet.MimeMessage, javax.mail.Session, org.xwiki.mail.MailResultListener)' has been removed
    org.xwiki.mail.MailSender: Method 'public void sendAsynchronously(javax.mail.internet.MimeMessage, javax.mail.Session, org.xwiki.mail.MailResultListener)' has been added to an interface
    org.xwiki.mail.MailResultListener: Parameter 2 of 'public void onError(javax.mail.internet.MimeMessage, java.lang.Throwable)' has changed its type to java.lang.Exception
    org.xwiki.mail.script.MimeMessageWrapper: Parameter 1 of 'public MimeMessageWrapper(javax.mail.internet.MimeMessage, javax.mail.Session, org.xwiki.mail.MailSender, org.xwiki.context.Execution, org.xwiki.component.manager.ComponentManager)' has changed its type to org.xwiki.mail.internal.ExtendedMimeMessage
    org.xwiki.mail.script.MimeMessageWrapper: Return type of method 'public javax.mail.internet.MimeMessage getMessage()' has been changed to org.xwiki.mail.internal.ExtendedMimeMessage
  • The extended class got moved to a new package with the upgrade to velocity-tools 2.0 and the old location got deprecated.
    org.xwiki.velocity.XWikiWebappResourceLoader: Removed from the list of superclasses
  • Not really APIs to begin with.
    com.xpn.xwiki.doc.XWikiDocument: Removed field compactEntityReferenceSerializer
    com.xpn.xwiki.doc.XWikiDocument: Removed field compactWikiEntityReferenceSerializer
    com.xpn.xwiki.doc.XWikiDocument: Removed field currentDocumentReferenceResolver
    com.xpn.xwiki.doc.XWikiDocument: Removed field currentMixedDocumentReferenceResolver
    com.xpn.xwiki.doc.XWikiDocument: Removed field currentReferenceDocumentReferenceResolver
    com.xpn.xwiki.doc.XWikiDocument: Removed field currentReferenceObjectReferenceResolver
    com.xpn.xwiki.doc.XWikiDocument: Removed field defaultEntityReferenceSerializer
    com.xpn.xwiki.doc.XWikiDocument: Removed field explicitDocumentReferenceResolver
    com.xpn.xwiki.doc.XWikiDocument: Removed field explicitReferenceDocumentReferenceResolver
    com.xpn.xwiki.doc.XWikiDocument: Removed field localEntityReferenceSerializer
    com.xpn.xwiki.doc.XWikiDocument: Removed field localUidStringEntityReferenceSerializer
    com.xpn.xwiki.doc.XWikiDocument: Removed field relativeEntityReferenceResolver
    com.xpn.xwiki.doc.XWikiDocument: Removed field syntaxFactory
    com.xpn.xwiki.doc.XWikiDocument: Removed field uidStringEntityReferenceSerializer
    com.xpn.xwiki.doc.XWikiDocument: Removed field xClassEntityReferenceResolver

Get Connected