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.4)
Full Issue List
XWIKI-8736 Some application pages have their translation flag wrongly set to 1
XWIKI-8730 {{html}} visible when dragging the Content field if the current user sets the default editor to wiki
XWIKI-8724 Liquibase checksum error while restarting a migration after failure
XWIKI-8722 Add experimental warning on the SolrSearch page
XWIKI-8721 PanelWizard not rendering any statistics panels content correctly
XWIKI-8720 Translation document loaded several time at startup
XWIKI-8719 Count filter doesn't work if the query statement starts with whitespace
XWIKI-8718 Improve the message in the UI when the database is not up to date to properly report the exact cause of failure
XWIKI-8714 Allow the customization of the xwiki.properties file with extra settings at build time
XWIKI-8711 Failure to update the schema during migration doesn't fail the migration
XWIKI-8705 Attachment on-disk file cache leaks open file descriptor
XWIKI-8702 Success Message macro does not have translation keys
XWIKI-8701 Display macro does not have translation keys
XWIKI-8700 Comment macro does not have translation keys
XWIKI-8699 Cache macro does not have translation keys
XWIKI-8697 Notification widget should have a callback function that gets called when the notification hides
XWIKI-8696 Search suggestions for the "User Name" field from the "Workspace Users" administration page don't appear correctly
XWIKI-8695 Blog pages should not set template field
XWIKI-8694 Hidden display mode doesn't work anymore for date, user and group fields
XWIKI-8693 repair job does not return proper job status
XWIKI-8690 Lucene leaks file descriptor
XWIKI-8687 Allow the user to specify the previously installed UI when upgrading from very old versions
XWIKI-8685 Chart macro should use current document as reference when resolving "document" parameter.
XWIKI-8681 XWikiAttachmentContent on-disk file cache leak open file descriptors
XWIKI-8677 Link to an anchor in a unknown page fails to redirect
XWIKI-8675 Strange character in the french translation (admin page > Layout)
XWIKI-8674 Impossible to save and use a wiki/global scope translation in the same request
XWIKI-8673 On demand translation does not seems to work
XWIKI-8668 Minor translation problems in the workspace application
XWIKI-8663 Image attachments are not scaled any more when the image dimensions are specified on the download request
XWIKI-8657 Markdown syntax not working anymore (Lucene Search is drawing ASM 3.1 instead of 4.x)
XWIKI-8653 Statistics space main page broken due to missing inclusion
XWIKI-8648 DateProperty#equals pretty much never works between a document loaded from the database and a document loaded from the XAR for example
XWIKI-8641 GLOBAL scope does not work for translations
XWIKI-8630 Failed to create wiki component(s) during default XAR import
XWIKI-8627 It should not be possible to install the proposed extension on the whole farm in first step of the DW
XWIKI-8599 Object Editor displays unrendered HTML as property value for objects that contain users/groups list field displayer
XWIKI-8396 Users not available in the workspace owner selector (prevents owner change)
XE-1271 Search suggestions for the Send Message gadget don't appear correctly when selecting "User" or "Group" from the Send Message drop-down list
XCOMMONS-327 Request interface should not contain removeProperty method
Translations
The following translations have been updated:
- French
- Korean
- Russian
- Swedish
Tested Browsers & Databases
Here's the list of browsers tested with this version (i.e. browsers that we've tested as working - Check the list of supported browsers):
- Firefox
- 17
Here's the list of databases tested with this version (i.e. databases that we've tested as working - Check the list of supported databases):
- HyperSQL
- 2.2.9
Known issues
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
The following APIs were modified since XWiki 4.4:
- Request was not supposed to contain this method in the first place:
org.xwiki.job.Request: Method 'public java.lang.Object removeProperty(java.lang.String)' has been removed
- New method to allow building an UI for reporting migration issues (mainly for sub-wiki):
com.xpn.xwiki.store.migration.DataMigrationManager: Method 'public com.xpn.xwiki.store.migration.DataMigrationStatus getDataMigrationStatus()' has been added to an interface