Release Notes for XWiki Enterprise 3.5

Last modified by Thomas Mortagne on 2017/03/24

This is the last major release of the 3.x development cycle (there will still be bugfix releases on the 3.5.x branch, if needed). The next release is going to be 4.0.

This is a stabilization release, with no major new features to highlight.

New and Noteworthy (since XWiki Enterprise 3.4 version)

Statistics about this release are available in our JIRA Dashboard.

Extension Manager improvements

  • XWIKI-7249 When an extension is already installed do not show a clickable "Install" button
  • XWIKI-7367 Add clustering support for extensions
  • XWIKI-7426 Search should be case insensitive on XWiki Repository
  • XWIKI-7429 Clicking "Install" after "Show details" brings the user out of the Administration interface
  • XWIKI-7430 Extension manager should provide a custom user agent when connection to repositories
  • XWIKI-7452 Can't resolve an extension with id containing UTF-8 char in XWiki Repository
  • XWIKI-7453 Can't find an extension on XWiki Repository when searching with a pattern containing an UTF-8 character
  • XWIKI-7455 Provide UI to import and synchronize an external extension in the repository
  • XWIKI-7458 Getting "Unknown macro: warn" instead of the actual warning when installing/uninstalling an extension
  • XWIKI-7477 XWiki Repository REST services should provide a content-disposition with the file name
  • XWIKI-7492 Separate local extensions by folders
  • XWIKI-7544 Add support for standard proxy settings in Extension Manager
  • XWIKI-7549 Install state of an extension located in a sub-folder of the local repository is lost after restart

See the full list of Extension Manager issues that have been fixed in this release.

Documents macro

A new macro that can be used to display documents in a live table. Read more about it on extensions wiki.



Bug fixes and improvements

  • XE-1096 The attachment selector should also work with the /edit/ action in 'Inline form' edit mode
  • XE-1105 Default class sheet doesn't display correctly the class title
  • XWIKI-6305 Keep the current user in the administration application when editing user details
  • XWIKI-7411 Cannot import a XAR containing %3A in its file name
  • XWIKI-7462 Improve the Profile breadcrumb to be more user friendly
  • XWIKI-7484 Write a log line in the console instructing the user to open XWiki in a browser
  • XWIKI-7520 Activity Stream performance regression
  • XWIKI-7558 Creating a space using Space Dashboard Template will result in a page with blank creator/author

See the full list of JIRA issues fixed in this release.

For Developers

  • XCOMMONS-94 Set the minimum required Maven version (3.0) to build XWiki in the POM
  • XWIKI-7476 Sheets need to be able to display the title of the document they are applied to
  • XWIKI-7502 Replace notion of Container's ApplicationContext with the notion of Environment
  • XWIKI-7504 Files within WEB-INF directory readable by using Velocity
  • XWIKI-7526 Enable Infinispan JMX mbeans by default for runtime monitoring of XWiki caches
  • XE-1108 Provide tomcat5 and tomcat7 based Debian packages


The following dependencies have been upgraded:

  • Groovy 1.8.6
  • JFreeChart 1.0.14
  • JUnit 4.9
  • Maven Archetype plugin 2.2
  • Maven Assembly plugin 2.3
  • Maven Checkstyle plugin 2.9
  • Maven Dependency plugin 2.4
  • Maven Exec plugin 1.2.1
  • Maven Findbugs plugin 2.4.0
  • Maven JAR plugin 2.4
  • Maven Javadoc plugin 2.8.1
  • Maven Plugin plugin 2.9
  • Maven Release plugin 2.2.2
  • Maven Site plugin 3.0
  • Maven SSH Wagon 2.2
  • Maven Surefire plugin 2.12
  • Maven War plugin 2.2
  • OSCache 2.4.1


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

Internet Explorer
Internet Explorer

Known issues

Test Report

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

Backward Compatibility and Migration Notes

General Notes

If you're running in a multiwiki setup you'll also need to define the property in your xwiki.cfg file if you want to explicitly name some databases to be migrated as the default is now to migrate all databases. Database that are not migrated could not be accessed.

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

  • The default configuration property for the permanent directory was renamed from container.persistentDirectory to environment.permanentDirectory in
  • We've disabled support for Event parameters in the Event Stream (this was a feature for developers) because it caused a regression of performance in the Activity Stream. We'll put it back when we find out to have it and still get good performances. In the meantime if you really need to add this feature back, extract activitystream.hbm.xml located in the Activity Stream JAR in WEB-INF/lib to the WEB-INF/classes directory and uncomment the map mapping in the file.
  • It seems that upgrading from an earlier version to 3.5 when using PostgreSQL fails. The workaround is to extract xwiki.hbm.xml located in the Old Core JAR in WEB-INF/lib to the WEB-INF/classes directory and add the materialized_clob typedef as in:
    <hibernate-mapping auto-import="true">
     <typedef name="materialized_clob" class="org.hibernate.type.StringClobType" />
     <class name="com.xpn.xwiki.doc.XWikiDocument" table="xwikidoc">

API Breakages

The following APIs were modified since version 3.4:

org.xwiki.container.ContainerFactory: Class org.xwiki.container.ContainerFactory removed

Get Connected