Release Notes for XWiki 6.1 Milestone 1

Version 43.1 by Marius Dumitru Florea on 2014/05/22
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

This is the release notes for XWiki Commons, XWiki Rendering, XWiki Platform and XWiki Enterprise. They share the same release notes as they are released together and have the same version.

<insert description of release here>

New and Noteworthy (since XWiki 6.0)

Full list of issues fixed and Dashboard for 6.1.

Improved Active Installs

The Active Installs feature has been improved a lot and a new data format has been set up in order to be able to provide more information, namely:

  • Graphing of Active Installs counter over time
  • Display pie charts of XWiki versions, Java versions, Servlet Containers and Databases used for Active Installs

as-dashboard

In addition it's now registered in the Applications Panel:

activeinstallsentry.png

Improved Panels

  • It is now possible to change the width of the panel columns:

panelWizard.png

  • Inside a panel, you can know the current width with the $xwikiPanelWidth variable.

Miscellaneous

  • The user directory is now displaying the user id (alias) instead of the full user document reference which is too technical:

    userDirectory.png

  • Added ability to configure Pie Chart labels using the pie_label_format property. For example using pie_label_format:{0} - {2} would give:

    pielabel.png

  • XWiki now support resolving a Maven extension with a parent from a different Maven repository
  • More HTTP cache settings, configurable using xwiki.httpheaders.cache in xwiki.cfg or headers_nocache in XWiki.XWikiPreferences:
    • 0: no Cache-Control header sent, use the browser's defaults. RFC 2616 only specifies optional behavior in this case
    • 1 (default): no-cache; caches must not serve this response in a subsequent response, but the page is stored for the bf-cache
    • 2: no-store, no-cache and max-age=0; the response will never be reused, not even for bf-cache; note that unsaved changes may be lost
    • 3: private; the response will be cached by personal caches, such as a browser cache
    • 4: public; the response may be cached by both personal and shared caches
  • To ensure the compatibility with Internet Explorer 8, the Flamingo skin uses Respond.js and HTML5Shiv. It enables CSS3 media queries and HTML5 tags.
  • "Human" requests like view or edit are not waiting XWiki initialization forever and display a waiting page with initialization progress instead: init.png

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

For Developers

LESS integration

  • We are happy to propose the ability of using the LESS preprocessor directly in XWiki. Right now, it is only able to compile some files located in the skin directory in the WAR. See LESS Module.

Upgrades

The following dependencies have been upgraded:

Miscellaneous

  • XCOMMONS-582: $escapetool.json should be used instead of $escapetool.javascript for escaping manually constructed JSON; $jsontool.serialize should be used for generating JSON, though, since it is safer.
  • Introduced job progress helper API, see Job Module for more details.
  • All component related API of com.xpn.xwiki.web.Utils are now using the context ComponentManager by default.
  • We added a new method to the component script service to access the component manager corresponding to a specific namespace:
    {{groovy}}
    def instanceForTestWiki = services.component.getComponentManager("wiki:test").getInstance(SomeRole.class)
    {{/groovy}}

Translations

The following translations have been updated: 

Tested Browsers & Databases

Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:TestReports.ManualTestReportXWiki61M1Summary]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

Here is the list of browsers we support and how they have been tested for this release:

BrowserStatus
Chrome30.pngGoogle Chrome 35Smoke tests
Firefox30.pngMozilla Firefox 29 Jira Tickets Marked as Fixed in the Release Notes, Migration from 5.4.4, Smoke tests
IE30.pngInternet Explorer 8Not Tested
IE30.pngInternet Explorer 9Smoke tests

Here is the list of databases we support and how they have been tested for this release:

DatabaseStatus
hypersql.pngHyperSQL 2.3.2 Jira Tickets Marked as Fixed in the Release Notes
mysql.pngMySQL 5.6.17Not Tested
oracle.pngOracle 11.2 Migration from 5.4.4
postgresql.pngPostgreSQL 9.3.4Not Tested

For the full list of tests see this page.

Known issues

Backward Compatibility and Migration Notes

General Notes

When upgrading make sure you compare your xwiki.cfg, xwiki.properties and web.xml files with the newest version since some configuration parameters may have been modified or added. Note that 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.

API Breakages

The following APIs were modified since XWiki 6.0:

  • Moved to internal package since none of those classes are supposed to be used from outside:
org.xwiki.rendering.wikimodel.common.javacc.CommonWikiScanner: Class org.xwiki.rendering.wikimodel.common.javacc.CommonWikiScanner removed
org.xwiki.rendering.wikimodel.common.javacc.CommonWikiScannerConstants: Class org.xwiki.rendering.wikimodel.common.javacc.CommonWikiScannerConstants removed
org.xwiki.rendering.wikimodel.common.javacc.CommonWikiScannerTokenManager: Class org.xwiki.rendering.wikimodel.common.javacc.CommonWikiScannerTokenManager removed
org.xwiki.rendering.wikimodel.common.javacc.ParseException: Class org.xwiki.rendering.wikimodel.common.javacc.ParseException removed
org.xwiki.rendering.wikimodel.common.javacc.SimpleCharStream: Class org.xwiki.rendering.wikimodel.common.javacc.SimpleCharStream removed
org.xwiki.rendering.wikimodel.common.javacc.Token: Class org.xwiki.rendering.wikimodel.common.javacc.Token removed
org.xwiki.rendering.wikimodel.common.javacc.TokenMgrError: Class org.xwiki.rendering.wikimodel.common.javacc.TokenMgrError removed
org.xwiki.rendering.wikimodel.confluence.javacc.ConfluenceWikiScanner: Class org.xwiki.rendering.wikimodel.confluence.javacc.ConfluenceWikiScanner removed
org.xwiki.rendering.wikimodel.confluence.javacc.ConfluenceWikiScannerConstants: Class org.xwiki.rendering.wikimodel.confluence.javacc.ConfluenceWikiScannerConstants removed
org.xwiki.rendering.wikimodel.confluence.javacc.ConfluenceWikiScannerTokenManager: Class org.xwiki.rendering.wikimodel.confluence.javacc.ConfluenceWikiScannerTokenManager removed
org.xwiki.rendering.wikimodel.confluence.javacc.ParseException: Class org.xwiki.rendering.wikimodel.confluence.javacc.ParseException removed
org.xwiki.rendering.wikimodel.confluence.javacc.SimpleCharStream: Class org.xwiki.rendering.wikimodel.confluence.javacc.SimpleCharStream removed
org.xwiki.rendering.wikimodel.confluence.javacc.Token: Class org.xwiki.rendering.wikimodel.confluence.javacc.Token removed
org.xwiki.rendering.wikimodel.confluence.javacc.TokenMgrError: Class org.xwiki.rendering.wikimodel.confluence.javacc.TokenMgrError removed
org.xwiki.rendering.wikimodel.creole.javacc.CreoleWikiScanner: Class org.xwiki.rendering.wikimodel.creole.javacc.CreoleWikiScanner removed
org.xwiki.rendering.wikimodel.creole.javacc.CreoleWikiScannerConstants: Class org.xwiki.rendering.wikimodel.creole.javacc.CreoleWikiScannerConstants removed
org.xwiki.rendering.wikimodel.creole.javacc.CreoleWikiScannerTokenManager: Class org.xwiki.rendering.wikimodel.creole.javacc.CreoleWikiScannerTokenManager removed
org.xwiki.rendering.wikimodel.creole.javacc.ParseException: Class org.xwiki.rendering.wikimodel.creole.javacc.ParseException removed
org.xwiki.rendering.wikimodel.creole.javacc.SimpleCharStream: Class org.xwiki.rendering.wikimodel.creole.javacc.SimpleCharStream removed
org.xwiki.rendering.wikimodel.creole.javacc.Token: Class org.xwiki.rendering.wikimodel.creole.javacc.Token removed
org.xwiki.rendering.wikimodel.creole.javacc.TokenMgrError: Class org.xwiki.rendering.wikimodel.creole.javacc.TokenMgrError removed
org.xwiki.rendering.wikimodel.gwiki.javacc.GWikiScanner: Class org.xwiki.rendering.wikimodel.gwiki.javacc.GWikiScanner removed
org.xwiki.rendering.wikimodel.gwiki.javacc.GWikiScannerConstants: Class org.xwiki.rendering.wikimodel.gwiki.javacc.GWikiScannerConstants removed
org.xwiki.rendering.wikimodel.gwiki.javacc.GWikiScannerTokenManager: Class org.xwiki.rendering.wikimodel.gwiki.javacc.GWikiScannerTokenManager removed
org.xwiki.rendering.wikimodel.gwiki.javacc.ParseException: Class org.xwiki.rendering.wikimodel.gwiki.javacc.ParseException removed
org.xwiki.rendering.wikimodel.gwiki.javacc.SimpleCharStream: Class org.xwiki.rendering.wikimodel.gwiki.javacc.SimpleCharStream removed
org.xwiki.rendering.wikimodel.gwiki.javacc.Token: Class org.xwiki.rendering.wikimodel.gwiki.javacc.Token removed
org.xwiki.rendering.wikimodel.gwiki.javacc.TokenMgrError: Class org.xwiki.rendering.wikimodel.gwiki.javacc.TokenMgrError removed
org.xwiki.rendering.wikimodel.jspwiki.javacc.JspWikiScanner: Class org.xwiki.rendering.wikimodel.jspwiki.javacc.JspWikiScanner removed
org.xwiki.rendering.wikimodel.jspwiki.javacc.JspWikiScannerConstants: Class org.xwiki.rendering.wikimodel.jspwiki.javacc.JspWikiScannerConstants removed
org.xwiki.rendering.wikimodel.jspwiki.javacc.JspWikiScannerTokenManager: Class org.xwiki.rendering.wikimodel.jspwiki.javacc.JspWikiScannerTokenManager removed
org.xwiki.rendering.wikimodel.jspwiki.javacc.ParseException: Class org.xwiki.rendering.wikimodel.jspwiki.javacc.ParseException removed
org.xwiki.rendering.wikimodel.jspwiki.javacc.SimpleCharStream: Class org.xwiki.rendering.wikimodel.jspwiki.javacc.SimpleCharStream removed
org.xwiki.rendering.wikimodel.jspwiki.javacc.Token: Class org.xwiki.rendering.wikimodel.jspwiki.javacc.Token removed
org.xwiki.rendering.wikimodel.jspwiki.javacc.TokenMgrError: Class org.xwiki.rendering.wikimodel.jspwiki.javacc.TokenMgrError removed
org.xwiki.rendering.wikimodel.mediawiki.javacc.MediawikiScanner: Class org.xwiki.rendering.wikimodel.mediawiki.javacc.MediawikiScanner removed
org.xwiki.rendering.wikimodel.mediawiki.javacc.MediawikiScannerConstants: Class org.xwiki.rendering.wikimodel.mediawiki.javacc.MediawikiScannerConstants removed
org.xwiki.rendering.wikimodel.mediawiki.javacc.MediawikiScannerTokenManager: Class org.xwiki.rendering.wikimodel.mediawiki.javacc.MediawikiScannerTokenManager removed
org.xwiki.rendering.wikimodel.mediawiki.javacc.ParseException: Class org.xwiki.rendering.wikimodel.mediawiki.javacc.ParseException removed
org.xwiki.rendering.wikimodel.mediawiki.javacc.SimpleCharStream: Class org.xwiki.rendering.wikimodel.mediawiki.javacc.SimpleCharStream removed
org.xwiki.rendering.wikimodel.mediawiki.javacc.Token: Class org.xwiki.rendering.wikimodel.mediawiki.javacc.Token removed
org.xwiki.rendering.wikimodel.mediawiki.javacc.TokenMgrError: Class org.xwiki.rendering.wikimodel.mediawiki.javacc.TokenMgrError removed
org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.ParseException: Class org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.ParseException removed
org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.SimpleCharStream: Class org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.SimpleCharStream removed
org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.Token: Class org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.Token removed
org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.TokenMgrError: Class org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.TokenMgrError removed
org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.XWikiScanner: Class org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.XWikiScanner removed
org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.XWikiScannerConstants: Class org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.XWikiScannerConstants removed
org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.XWikiScannerTokenManager: Class org.xwiki.rendering.wikimodel.xwiki.xwiki20.javacc.XWikiScannerTokenManager removed
org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.ParseException: Class org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.ParseException removed
org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.SimpleCharStream: Class org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.SimpleCharStream removed
org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.Token: Class org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.Token removed
org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.TokenMgrError: Class org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.TokenMgrError removed
org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.XWikiScanner: Class org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.XWikiScanner removed
org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.XWikiScannerConstants: Class org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.XWikiScannerConstants removed
org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.XWikiScannerTokenManager: Class org.xwiki.rendering.wikimodel.xwiki.xwiki21.javacc.XWikiScannerTokenManager removed
  • Young API
org.xwiki.activeinstalls.server.DataManager: Method 'public com.google.gson.JsonObject countInstalls(java.lang.String, java.lang.String, java.util.Map)' has been added to an interface
org.xwiki.activeinstalls.server.DataManager: Method 'public long getInstallCount(java.lang.String)' has been removed
org.xwiki.activeinstalls.server.DataManager: Method 'public com.google.gson.JsonObject searchInstalls(java.lang.String, java.lang.String, java.util.Map)' has been added to an interface
org.xwiki.activeinstalls.server.script.ActiveInstallsScriptService: Method 'public long getInstallCount(java.lang.String)' has been removed

Get Connected