Release Notes for XWiki Enterprise 3.4

Version 3.1 by Marius Dumitru Florea on 2012/01/24

XWiki Enterprise 3.4 is a stabilization release as we're approaching the end of the 3.x cycle so its main goal was to improve the Extension Manager and App Within Minutes features. However, this release also comes with a new look and a new default wiki page syntax.

New and Noteworthy (since XWiki Enterprise 3.3 version)

Checkout the full unabridged list of issues fixed in this release and, if you're interested in statistics, the JIRA dashboard.


Bug fixes and improvements


For Developers



The following dependencies have been upgraded:

  • AETHER 1.13.1
  • Groovy 1.8.5
  • Hibernate 3.6.9
  • jdeb 0.9
  • Restlet 2.0.11
  • Selenium 2.17
  • Selenium Maven Plugin 2.2
  • SmartGWT 3.0


The following translations have been updated:

Tested Browsers

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


Test Report

You can check the manual test report to learn about what was tested and the results on various browsers.

Known issues

Backward Compatibility and Migration Notes

General Notes

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

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 files with the newest version since some configuration parameters were added. Note that 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.

Issues specific to XWiki Enterprise 3.4

Default wiki access method changed to path-based

In virtual mode, XWiki can work in two ways: based on domain names, where each virtual wiki is accessed from a different DNS domain, like, and path-based, where each virtual wiki is accessed on a different path of the same domain, like Since the former mode is harder to set up, since it requires a custom DNS server, we have enabled the second mode by default in this release.

When merging the xwiki.cfg for the migration process, keep in mind that the value of 'xwiki.virtual.usepath' has been changed to a default of 1 instead of 0. If your wiki is set to virtual mode and is using subdomains to access subwikis, make sure to set 'xwiki.virtual.usepath' to 0.

API Breakages

The following APIs were modified since version 3.3:


Get Connected