Wiki Home » Project Release Notes » Release Notes for XWiki 4.4 RC 1

Release Notes for XWiki 4.4 RC 1

Last modified by Vincent Massol on 2013/03/02
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.

This is a stabilization release and as such it mostly contains bug fixes.

New and Noteworthy (since XWiki 4.3.1)

Full list of issues fixed and Dashboard for 4.4.

Full list of issues fixed:

  • Bug Closed XWIKI-8896 Lucene RSS search feed malforms output with <pre>
  • Bug Closed XWIKI-8635 No vertical scrollbar visible in the Tree document index
  • Bug Closed XWIKI-8632 Distribution Wizard propose a downgrade after importing the default XAR
  • Bug Closed XWIKI-8628 Console error when installing/creating a workspace using workspaces installed with EM
  • Bug Closed XWIKI-8620 XWiki.WatchListClass class is re-saved at each startup
  • Bug Closed XWIKI-8612 More workspace template issues (pretty name and membership type)
  • Improvement Closed XWIKI-8597 Add solr.xml configuration file to support upgrading to solr 4.0
  • Improvement Closed XWIKI-8578 Upgrade solr to version 4.0.0
  • Bug Closed XWIKI-8577 Move lucene plugin classes to an internal package
  • Bug Closed XWIKI-8566 Limiting search to one space will actually return more results, many unrelated
  • Bug Closed XWIKI-8565 Rendering cache does not work on JBOSS AS7
  • Improvement Closed XWIKI-8512 Make the "Hide suggestions" button of the Suggest widget more customizable
  • Improvement Closed XWIKI-8503 Reimplement form field hints (withTip behavior) based on the HTML5 "placeholder" attribute
  • Bug Closed XWIKI-8496 After installing from scratch XE with DW the status in the next restarts will be seen as PARTIAL
  • Bug Closed XWIKI-8490 JS error when importing a XAR and the server returns an error message
  • Improvement Closed XWIKI-8489 Make the autosave widget more configurable
  • Bug Closed XWIKI-8487 Blog categories aren't added in the right place on IE9
  • Bug Closed XWIKI-8464 Content dirty flag is spuriously set to true
  • Bug Closed XWIKI-8447 Search RSS Feed downloads file on Firefox
  • Bug Closed XWIKI-8432 Watchlist RSS Feed downloads file on IE and Chrome
  • Improvement Closed XWIKI-8404 Upgrade to lucene 4.0.0
  • Bug Closed XWIKI-8192 Trying to search for documents only from one space might include results from other spaces with similar names
  • Bug Closed XWIKI-8090 Including Main.WebHome in a dashboard gadget causes a crash.
  • Bug Closed XWIKI-7990 Input fields overflow their palettes when editing a Color Theme
  • Bug Closed XWIKI-7749 ImagePlugin caches image thumnail bytes, but new temporary files for each are recreated on each request
  • Bug Closed XWIKI-7394 Error when searching for some text followed by ! char
  • Bug Closed XWIKI-7056 Not empty modal when Version Mandatory Summary is enabled
  • Improvement Closed XWIKI-6230 If the query does not return any results display an appropiate message
  • Improvement Closed XWIKI-6225 Index date fields in objects formatted and untokenized
  • Bug Closed XWIKI-5524 Adding a class property that already exists succeeds without errors, although the property wasn't really added
  • Improvement Closed XRENDERING-262 Stop shading the standalone JAR and instead dsitribute a zip containing all dependencies
  • Task Closed XRENDERING-257 Upgrade to Pegdown 1.2.0
  • Bug Closed XEM-237 rome jar is duplicated in the XEM packages
  • Task Closed XEM-232 Remove override of the QuickLinks panel
  • Task Closed XCOMMONS-321 Don't draw Ant in HTML Cleaner module
  • Improvement Closed XCOMMONS-315 Make sure to do nothing in the logback module when logback is not present
  • Bug Closed XCOMMONS-308 Component related events send Class based role instead of Type based
  • Bug Closed XCOMMONS-302 Maven handler do more request than needed

For Developers

Upgrades

The following dependencies have been upgraded:

Miscellaneous

Translations

The following translations have been updated: 

  • Italian
  • Catalan
  • Czech
  • Danish
  • German
  • Spanish
  • French
  • Galician
  • Hindi
  • Croatian
  • Italian
  • Korean
  • Latvian
  • Dutch
  • Norwegian
  • Polish
  • Portuguese (Brazil)
  • Romanian
  • Russian
  • Slovak
  • Swedish
  • Ukrainian
  • Vietnamese
  • Simplified Chinese
  • Traditional Chinese

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.0.1

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

Test Report

No manual test were done for this version (see other past test reports if you're curious).

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).

Issues specific to XWiki 4.4 RC 1

  • The Toucan skin has been removed from the platform and from the distribution packages. You can find the sources in the xwiki-contrib repository on github.
  • The Lucene index specification has been changed to include a new field exactspace and three other fields have been altered to better support exact matches. It is recommended to rebuild the whole Lucene index.

API Breakages

The following APIs were modified since XWiki 4.3.1:

  •  Moved to Lucene 4 + moved non API classes to the internal package:
    com.xpn.xwiki.plugin.lucene.LucenePlugin: Parameter 1 of 'public void init(com.xpn.xwiki.plugin.lucene.IndexUpdater, com.xpn.xwiki.XWikiContext)' has changed its type to com.xpn.xwiki.plugin.lucene.internal.IndexUpdater
    com.xpn.xwiki.plugin.lucene.LucenePlugin: Parameter 1 of 'public void init(com.xpn.xwiki.plugin.lucene.IndexUpdater, com.xpn.xwiki.plugin.lucene.IndexRebuilder, com.xpn.xwiki.XWikiContext)' has changed its type to com.xpn.xwiki.plugin.lucene.internal.IndexUpdater
    com.xpn.xwiki.plugin.lucene.LucenePlugin: Parameter 2 of 'public void init(com.xpn.xwiki.plugin.lucene.IndexUpdater, com.xpn.xwiki.plugin.lucene.IndexRebuilder, com.xpn.xwiki.XWikiContext)' has changed its type to com.xpn.xwiki.plugin.lucene.internal.IndexRebuilder
Tags:
Created by Vincent Massol on 2012/11/22