Release Notes for XWiki 5.4.4

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 is a bugfix release.

New and Noteworthy (since XWiki 5.4.3)

Full list of issues fixed and Dashboard for 5.4.4.

Wiki Alias

  • When the path mode is enabled, the alias of the wiki is now asked in the wiki creation wizard:
    wikialias.png
  • The default suffix for the wiki alias can be set in xwiki.properties:
    #-# [Since 5.4.4]
    #-# Add a default suffix to the alias of a new wiki in the wiki creation wizard, only when the path mode is used
    #-# (see url.standard.multiwiki.isPathBased). If this value is empty, XWiki will try to compute it automatically from
    #-# request URL.
    #-#
    #-# eg: if wiki.alias.suffix is "xwiki.org" and the wiki name "playground"
    #-#     then the computed alias will be: "playground.xwiki.org".
    #-#
    #-# The default is:
    wiki.alias.suffix=

For Developers

$services.wiki.user has new methods called hasPendingInvitation() and hasPendingRequest(). Same in the WikiUserManager interface.

Tested Browsers & Databases

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

BrowserStatus
Chrome30.pngGoogle Chrome 34 Not Tested
Firefox30.pngMozilla Firefox 28 Jira Tickets Marked as Fixed in the Release Notes, Migration from 4.1.4, Migrations from 4.5.4
IE30.pngInternet Explorer 8 Not Tested
IE30.pngInternet Explorer 9 Not Tested

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

DatabaseStatus
hypersql.pngHyperSQL 2.3.1 Jira Tickets Marked as Fixed in the Release Notes, Migration from 4.1.4
mysql.pngMySQL 5.6.17 Migration from 4.5.4
oracle.pngOracle 11.2 Migration from 4.5.4
postgresql.pngPostgreSQL 9.3.4 Migration from 4.5.4

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, xwiki.properties and web.xml files with the newest version since some configuration parameters may have been modified or 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.

Solr Search Index

We made changes to the Solr schema in this release (see XWIKI-10225) and unfortunately we don't have support for automatic Solr search index migration at this point. If you upgrade from XWiki 4.3 Milestone 2 or greater then you have to delete the 'solr' folder from the configured permanent directory of your XWiki instance (because the Solr schema is cached there). The Solr index will be recreated automatically and the entire wiki/farm will be re-indexed after a server restart.

API Breakages

The following APIs were modified XWiki 5.4.4:

org.xwiki.wiki.user.WikiUserManager: Method 'public boolean hasPendingInvitation(org.xwiki.model.reference.DocumentReference, java.lang.String)' has been added to an interface
org.xwiki.wiki.user.WikiUserManager: Method 'public boolean hasPendingRequest(org.xwiki.model.reference.DocumentReference, java.lang.String)' has been added to an interface
Tags:
   

Get Connected