ReleaseNotesXWikiEnterprise18M2

Last modified by Thomas Mortagne on 2017/03/24

ContentsThe [toc] macro is a standalone macro and it cannot be used inline. Click on this message for details.

Release Notes for XWiki Enterprise 1.8 Milestone 2

Second milestone of the XWiki Enterprise 1.8 version (Roadmap).

Summary of changes since XWiki Enterprise 1.8 Milestone 1

Main changes

  • New Wiki Dashboard on the home page:
    • Spaces: all the spaces within your wiki (technical spaces are hidden):
      • Links to the list of pages within each spaces.
      • Links to the administration of each space.
      • Allows to create new spaces.
    • Tags: all the tags in the wiki under the form of a tag cloud.
    • Recent changes: all the recent modifications in the wiki, grouped by author and by date.

      * New way of displaying tags, with 2 new features:
    • Tag rename.
    • Tag delete.

      * Page loading time reduced by 30%. Statistics on Sandbox.WebHome, without client-side file caching (most of the downloaded files are cached on the client after the first request):{table}
  • | XE 1.8M1 | XE 1.8M2

    Requests number | 37 | 25 Total size | 332Ko | 200Ko Download @ T1 (seconds) | 9.16 | 6.06 {table}

  • Improved information section in document footer, including document children:

    * Added wiki syntax for embedded documents
  • Improved authentication performance for LDAP. By default the authentication system now calls the authenticator only once by session, this means it does not call the LDAP authenticator and does not generate queries on the LDAP server for each request anymore. This can be changed using the

Important bug fixes

  • Many bug fixes and improvements in the new GWT WYSIWYG editor
  • Add support for Velocity and HTML as well as many bug fixes and improvements in the XWiki syntax converter to convert from 1.0 syntax to 2.0 syntax.

Known issues

If you're on Mac and want to run XWiki Enterprise on the JDK 1.5 but have JDK 1.6 installed then the Groovy macro in the new rendering won't work fine and you'll get some exceptions. This is because of a Mac problem: When Java 1.6.0 is installed in OSX 10.5 it overwrites /System/Library/Java/Extensions/AppleScriptEngine.jar with a 1.6 specific one. When the ScriptEngineManager gets initialized if finds it and tries to use it. However it only works on JDK 1.6. Moving both AppleScriptEngine.jar and libAppleScriptEngine.jnilib somewhere else fixes the problem.

Migration Notes

Data migration

If you're running in a multiwiki setup you'll also need to define the property xwiki.store.migration.databases=all to your xwiki.cfg file or explicitly name all databases to be migrated as in xwiki.store.migration.databases=db1,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 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.

Applications migration

XE 1.8M2 has introduced conditional loading of JavaScript and StyleSheet files in order for pages to load faster, sending to the browser only the files it needs to display the requested pages. This might break existing applications developed on top of XWiki that relied on such JavaScript and CSS files being present all the time. Concerned files and libraries are the following:

  • scriptaculous files
  • accordions files
  • chart wizard files
  • usersandgroups.js and usersandgroups.css
  • livetable.js and livetable.css
  • lightbox.js
  • tablefilterNsort.js and table.css
  • fullscreenEdit.js and fullscreenEdit.css

If you have applications that relies on one or several of these libraries, you will need to explicitly make them request the desired files using the Skin Extension plugin. For example, if your application needs the live-table feature (the dynamic AJAX grid), add the following lines to the code page that requires it:

$xwiki.jsfx.use('js/xwiki/table/livetable.js') ## Inject livetable.js <script> tag in the header
$xwiki.ssfx.use('js/xwiki/table/livetable.css') ## Inject livetable.css <link> tag in the header

Get Connected