Version 10.1 by Thomas Mortagne on 2010/06/02

First milestone of the XWiki Enterprise 2.4 version (Roadmap).

The highlights of this release are: Lucene by default and Lucene admin, rendering cache

New and Noteworthy (since XWiki Enterprise 2.3)


Changed default search engine

Lucene Search is promoted as default search.


The Lucene search has several benefits over the Database search:

  • It indexes attachments (such as PDFs or MS Word documents) searchable. It does not replace the search page itself but rather makes more content available for searching.
  • It provides a scoring for the search results.
  • It offers pagination when there are lots of results.
  • It scales well when there are lots of documents in the wiki.
  • It supports multi wikis.
  • It supports a strong query syntax.

New search configuration UI


The Search Application now has a dedicated section in the wiki administration section from which you can:

  • Choose the default engine (Lucene or Database).
  • See the status for the Lucene Search: the number of indexed elements and the number of elements waiting in the queue.
  • Control the Lucene index by indexing the whole farm, indexing the wiki or customizing the index to your specific preferences.

For more information check out the documentation page.

Rendering cache

It's now possible to provide a list of pages for which to cache the result. See core.renderingcache.* properties to control it.

It's also possiblet to force a page to refresh by using refresh=1 parameter in the URL.

New Code macro configuration

It's now possible to indicate which Pygments style to use with the default highlighter based on Pygments.

See for more details.

Security improvements


  • XSS

Performance improvements


  • defered scripts

Chart macro improvements

Chart macro now support more than 26 columns.


  • WYSIWYG newly supported language: Russian
  • All the translations have been updated

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 the improvements listed above.

Always make sure you compare your xwiki.cfg file with the newest version since some configuration parameters were added. 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.

Migration Notes

  • the main entry point for search UI is now the Main.Search page that will use the configured search engine (Lucene by default), if you explicitly want to refer to Lucene or Database search you can Main.LuceneSearch and Main.DatabaseSearch pages. Note that nothing is broken here (Main.WebSearch page is still there and include Main.DatabaseSearch page), it's just the new clean way of targeting the search page.

Get Connected