Release Notes for XWiki 5.0 Release Candidate 1

Version 21.1 by Vincent Massol on 2013/04/21

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

This is mostly a stabilization release leading to 5.0 but we included a few bonus items: Distribution Wizard improvements to support multiwiki use cases and the ability to see which extensions have updates.

New and Noteworthy (since XWiki 5.0 M2)

Full list of issues fixed and Dashboard for 5.0.

New wiki mode in distribution wizard

By default you can now get the same distribution wizard you used to have for main wiki only on subwikis too. When enabled it means that each wiki administrator is able to take care of his own wiki upgrade and farm administrator will only deal with main wiki.

There is two modes:

  • ALL IN ONE: the former Distribution Wizard behavior where everything is done at main wiki level
  • WIKI: on main wiki only the main wiki is upgraded and each wiki gets its own Distribution Wizard and its own status

A new step to setup the upgrade mode has been added.

upgrademode.png

Extension Updater

We added a new section to the Extension Manager administration UI that lists the available extension updates.

EM-extensionUpdater.png

Miscellaneous

  • Automatically register translations for the Annotations application

Full Issue List

For Developers

Joda Time plugin adds Duration API

The Joda Time plugin API was extended with 2 new methods for creating durations. Here's an example:

{{velocity}}
#set ($endDate = $xwiki.jodatime.getDateTime($endDateTimeStamp))
#set ($currentDate = $xwiki.jodatime.getDateTime())
#set ($duration = $xwiki.jodatime.getDuration($endDate, $currentDate))
The number of days passed since the end date is: $duration.standardDays
{{/velocity}}

Check the Duration javadoc for more information.

Deprecated and Retired projects

No deprecated nor retired projects in this release.

Upgrades

The following dependencies have been upgraded:

  • Groovy 2.1.3
  • Joda Time 2.2

Translations

The following translations have been updated: 

Tested Browsers & Databases

Here's the list of browsers we support and how they've been tested specifically for this release:

BrowserTestedDetails
Chrome30.pngGoogle Chrome 26PartiallyMost of these issues marked as tested
Firefox30.pngMozilla Firefox 20Not Tested
IE30.pngInternet Explorer 8Partially 
IE30.pngInternet Explorer 9Partially

Here's the list of databases we support and how they've been tested specifically for this release:


DatabaseTestedDetails
hypersql.pngHyperSQL 2.2.9PartiallyTested a clean Manager Install
These issues marked as tested
mysql.pngMySQL 5.6.10PartiallyTested a clean Manager Install
Tested migration from 3.5.1.
oracle.pngOracle 11.2PartiallyTested a clean Manager Install
postgresql.pngPostgreSQL 9.1.3PartiallyTested a clean Manager Install

Known issues

Backward Compatibility and Migration Notes

General Notes

You may also want to import the default wiki XAR in order to benefit from all the improvements listed above.

Always make sure you compare your xwiki.cfg and xwiki.properties files with the newest version since some configuration parameters were added. Note that you should add xwiki.store.migration=1 so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.

Issues specific to XWiki 5.0 Release Candidate 1

  • The xwikistringlists table added in 5.0M2 has been removed and that change is postponed to 5.1M1 due to serious migration issues. Migration from release 5.0M2 to any newer version will be broken

API Breakages

The following APIs were modified since XWiki 4.5.3:

  • [Young API] Made public by mistake:
    org.xwiki.job.AbstractJob: Class org.xwiki.job.AbstractJob removed
  • [Young API] Interfaces missing methods for uninstalling an Extension and the notion of "Features" means that an upgraded extension can have several previous extensions:
    org.xwiki.extension.handler.ExtensionHandler: Method 'public void uninstall(org.xwiki.extension.InstalledExtension, java.lang.String, org.xwiki.job.Request)' has been added to an interface
    org.xwiki.extension.handler.ExtensionHandlerManager: Method 'public void uninstall(org.xwiki.extension.InstalledExtension, java.lang.String, org.xwiki.job.Request)' has been added to an interface
  • [Young API] The notion of "Features" means that an upgraded extension can have several previous extensions:
    org.xwiki.extension.handler.ExtensionHandler: Method 'public void upgrade(java.util.Collection, org.xwiki.extension.LocalExtension, java.lang.String, org.xwiki.job.Request)' has been added to an interface
    org.xwiki.extension.handler.ExtensionHandlerManager: Method 'public void upgrade(java.util.Collection, org.xwiki.extension.LocalExtension, java.lang.String, org.xwiki.job.Request)' has been added to an interface
    org.xwiki.extension.job.plan.ExtensionPlanAction: Method 'public java.util.Collection getPreviousExtensions()' has been added to an interface

Get Connected