Last modified by Thomas Mortagne on 2017/03/24

Release Notes for XWiki Enterprise 1.2.2

This is a bug fix release.

Invalid macro parameters used for the [toc] macro. Cause: [Failed to validate bean: [must be greater than or equal to 1]]. Click on this message for details.

Summary of changes since XWiki Enterprise 1.2.1

Bugs fixed

  • XWIKI-2052 - XWikiDocument.equals always returns false if a document is compared to itself
  • XWIKI-2064 - DBListClass and DBTreeListClass are building invalid SQL statements
  • XWIKI-2065 - XWikiHibernateStore.deleteWiki don't works
  • XWIKI-2066 - Migrator fails to upgrade sub wiki databases
  • XWIKI-2068 - Rights Manager does not clean deleted user/group in all wikis
  • XWIKI-2074 - Database Migration fails when migrating from 1.0 or older directly to 1.2 without going through a 1.1 upgrade
  • XWIKI-2076 - "Content is not allowed in prolog" error while migrating a database to 1.2
  • XWIKI-2078 - Missing translation entry for the title of the Group Admin page
  • XWIKI-2079 - Fails to save document after migrating from a 1.0 or before database to 1.2
  • XWIKI-2080 - Server hangs while rendering certain pages
  • XWIKI-2087 - Attached files that we can't delete or link in the Wiki pages
  • XWIKI-2090 - Attaching images with a name containing special characters (é & è à ...) generates bugs (image are not displayed)
  • XWIKI-2101 - XWiki.clearName strips dots when using ascii option even if stripDots option is set to false
  • XWIKI-2102 - Attachments should not contain non-alphanumeric characters in the file name


  • XWIKI-1980 - $doc.displayTooltip should support internationalized strings

New Features

  • XWIKI-2088 - Add a method to retrieve the e-mail address of a user

Known issues

  • Bugs we know about
  • The watchlist feature doesn't fully work yet when XWiki used in virtual mode and thus the Watchlist menu is automatically disabled and hidden in that mode.

If you're using Oracle, you'll need to upgrade the Hibernate JAR version used by XWiki by replacing the WEB-INF/lib/hibernate-3.1.3.jar file with this file (Hibernate version, which solves an issue in Hibernate 3.1.3). See XWIKI-2009.

Common Migration notes

The database structure has been changed in XWiki Enterprise 1.2 but we have set up an automatic migration system so you shouldn't have to touch your Database to upgrade. Thus you can simply install this version and configure it to point to your existing database. 

If you're running in a multiwiki setup you'll also need to define the property to your xwiki.cfg file or explicitely name all databases to be migrated as in,db2,....

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

Always make sure you compare your xwiki.cfg file with the newest version since some configuration parameters were added. Of note, you should add so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.

Migrating from 1.1.2 or later

Nothing additional to perform.

Migrating from versions earlier than 1.1.2

Check the release notes for 1.1.2.

Get Connected