If you are migrating from an earlier version than 4.0, and your database contains statistics collected using a version earlier than 2.2, you will probably encounter an issue during our automated database migration. To avoid that issue, you will need to clean up your statistics by executing some SQL commands described in issue XWIKI-8129. Be sure to apply these before attempting the migration. If your are in doubt, apply it, these could not hurt. If you don't, you will face duplicate IDs errors during the migration process, and it will fail, preventing you to run your wiki.
If you are upgrading to this version from an older version which uses Lucene 3.x, you have to manually delete the lucene directory in the xwiki data directory. For example, that could cause Lucene to loop endlessly while trying to index pages, among other things. This is caused by  the Lucene migration to 4.0 (see XWIKI-8404).

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.

New and Noteworthy (since XWiki 4.5.3)

This is a bugfix release for the 4.5.x cycle, hopefully the last on the 4.x cycle. Affected areas include the distribution wizard and the extension manager, Internet Explorer compatibility, Oracle and PostgreSQL compatibility, and multiwiki improvements.

Full list of issues fixed and Dashboard for 4.5.4.

Full Issue List

Failed to execute the [jira] macro. Cause: [Server returned HTTP response code: 400 for URL: https://jira.xwiki.org/sr/jira.issueviews:searchrequest-xml/temp/SearchRequest.xml?jqlQuery=Project+in+%28%22XWiki+Commons%22%2C+%22XWiki+Rendering%22%2C+%22XWiki+Platform%22%2C+%22XWiki+Enterprise%22%2C+%22XWiki+Enterprise+Manager%22%29+and+fixVersion+in+%28%224.5.4%22%29+and+resolution+in+%28%22Fixed%22%29+and+component+not+in+%28%22Build%2C+Infrastructure+and+Tests%22%29]. Click on this message for details.

Translations

The following translations have been updated: 

  • Danish
  • German
  • French
  • Latvian
  • Portuguese (Brazil)
  • Russian
  • Swedish

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 26PartiallyJira Tickets Marked as Fixed for 4.5.4
Firefox30.pngMozilla Firefox 20Not Tested
IE30.pngInternet Explorer 8PartiallyVarious tests related to: wysiwyg, panels, app within minutes, attachments, comments, creating a subwiki and creating a workspace
IE30.pngInternet Explorer 9FullyManual Test Report for XWiki 4.5.4

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

DatabaseTestedDetails
hypersql.pngHyperSQL 2.2.9FullyManual Test Report for XWiki 4.5.4
mysql.pngMySQL 5.6.10PartiallyMigration from 4.5.3 to 4.5.4
oracle.pngOracle 11.2PartiallyMigration from 4.5.3 to 4.5.4; Migration from 4.2 to 4.5.4 Closed XWIKI-9019 Closed XWIKI-8957
postgresql.pngPostgreSQL 9.1.3PartiallyMigration from 4.5.3 to 4.5.4

Known issues

  • Bugs we know about
  • If you're migrating an XWiki instance using PostgreSQL or Oracle you may get this error (fixed in XWiki 5.2). The workaround is to remove the hibernate_sequence sequence prior to starting XWiki (for the main wiki and all subwikis).

Backward Compatibility and Migration Notes

General Notes

PLEASE, BACKUP YOUR DATABASE BEFORE STARTING YOUR WIKI.
AUTOMATED MIGRATION PROCEDURE TAKE PLACE AT STARTUP AND YOU MAY NEED TO START OVER IF YOU ENCOUNTER AN UNEXPECTED ISSUE.

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.
If you are migrating from an earlier version than 4.0, and your database contains statistics collected using a version earlier than 2.2, you will probably encounter an issue during our automated database migration. To avoid that issue, you will need to clean up your statistics by executing some SQL commands described in issue XWIKI-8129. Be sure to apply these before attempting the migration. If your are in doubt, apply it, these could not hurt. If you don't, you will face duplicate IDs errors during the migration process, and it will fail, preventing you to run your wiki.
If you have encountered an issue with the migration, you may need to start over from a backup. Be careful that during the migration, two new tables have been created (in each xwiki database for a farm) and should be dropped when you restore a backup of a database coming from a version earlier than 4.x. These two tables are DATABASECHANGELOG and DATABASECHANGELOGLOCK. These should only be removed if you restore a pre-4.x database schema. Mixing an old database with these two tables will surely cause issue during schema updates (liquibase checksum failure).

API Breakages

No API breakage since XWiki 4.5.3.

Tags:
Created by Vincent Massol on 2013/05/13
   

Get Connected