Wiki source code of Release Notes for XWiki 4.4

Version 23.1 by Vincent Massol on 2013/01/21

Hide last authors
Vincent Massol 1.1 1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
Denis Gervalle 14.1 5 {{warning}}
6 If you are migrating from an earlier version than 4.0, and your database contains statistics collected using a version earlier than 2.2, you will probably encounter an issue during our automated database migration. To avoid that issue, you will need to clean up your statistics by executing some SQL commands described in issue [[XWIKI-8129>>http://jira.xwiki.org/browse/XWIKI-8129]]. Be sure to apply these before attempting the migration. If your are in doubt, apply it, these could not hurt. If you don't, you will face duplicate IDs errors during the migration process, and it will fail, preventing you to run your wiki.
7 {{/warning}}
8
Vincent Massol 1.1 9 This is the release notes for XWiki Platform, XWiki Enterprise and XWiki Enterprise Manager. They share the same release notes as they are released together and have the same version.
10
Vincent Massol 10.1 11 This is a stabilization release and as such it mostly contains bug fixes.
Vincent Massol 1.1 12
Vincent Massol 20.1 13 = New and Noteworthy (since XWiki 4.3.1) =
Vincent Massol 1.1 14
Vincent Massol 10.1 15 Full list of issues fixed:
Vincent Massol 1.1 16
Vincent Massol 20.2 17 {{jira style="list" url="http://jira.xwiki.org" fields="type, status, key, summary" source="jql"}}
Vincent Massol 22.1 18 Project in ("XWiki Commons", "XWiki Rendering", "XWiki Platform", "XWiki Enterprise", "XWiki Enterprise Manager") and fixVersion in ("4.4-rc-1", "4.4") and resolution in ("Fixed") and component not in ("Build, Infrastructure and Tests")
Vincent Massol 10.1 19 {{/jira}}
Vincent Massol 1.1 20
21 = For Developers =
22
23 == Upgrades ==
24
25 The following dependencies have been upgraded:
26
27 * [[Pegdown 1.2.0>>http://jira.xwiki.org/browse/XRENDERING-257]]
Thomas Mortagne 2.1 28 * [[logback 1.0.9>>http://jira.xwiki.org/browse/XCOMMONS-309]]
Jerome 6.1 29 * [[lucene 4.0.0>>http://jira.xwiki.org/browse/XWIKI-8404]]
30 * [[Solr 4.0.0>>http://jira.xwiki.org/browse/XWIKI-8578]]
Sergiu Dumitriu 9.1 31 * [[Apache commons-net 3.2>>http://jira.xwiki.org/browse/XCOMMONS-322]]
Vincent Massol 16.1 32 * [[JGroups 3.2.5>>https://issues.jboss.org/issues/?jql=project%20%3D%20JGRP%20AND%20fixVersion%20in%20%28%223.2.5%22%2C%20%223.2.4%22%2C%20%223.2.3%22%2C%20%223.2.2%22%2C%20%223.2.1%22%29%20AND%20status%20%3D%20Resolved%20ORDER%20BY%20priority%20DESC]]
Vincent Massol 1.1 33
34 == Miscellaneous ==
35
Vincent Massol 3.1 36 * We've [[replaced the Rendering Standalone JAR with a Rendering Standalone ZIP>>rendering:Main.GettingStarted||anchor="HUsingtheXWikiRenderingStandaloneZIP"]].
Vincent Massol 5.1 37 * Started experimenting with [[Mockito>>http://code.google.com/p/mockito/]].
Vincent Massol 8.1 38 * [[New unit and integration testing best practices>>dev:Community.Testing]].
Vincent Massol 22.2 39 * New Rendering Syntax module for the ##annotatedxhtml## syntax. Before this syntax was included in the Syntax module for the ##xhtml## syntax.
Vincent Massol 1.1 40
41 = Translations =
42
43 The following translations have been updated:
44
Vincent Massol 17.1 45 {{language codes="it,ca,cs,da,de,es,fr,gl,hi,hr,it,ko,lv,nl,no,pl,pt_BR,ro,ru,sk,sv,uk,vi,zh,zh_TW"/}}
Vincent Massol 1.1 46
Vincent Massol 11.1 47 = Tested Browsers & Databases =
Vincent Massol 1.1 48
49 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>>dev:Community.BrowserSupportStrategy]]):
50
51 {{velocity}}
52 ## name = iexplorer, firefox, chrome, safari, opera
53 {{/velocity}}
54
Vincent Massol 18.1 55 {{browser name="firefox" version="17.0.1"/}}
Vincent Massol 1.1 56
Vincent Massol 11.1 57 Here's the list of databases tested with this version (i.e. databases that we've tested as working - Check the list of [[supported databases>>dev:Community.DatabaseSupportStrategy]]):
58
59 {{velocity}}
60 ## name = hsqldb, mysql, postgresql, oracle, opera
61 {{/velocity}}
62
63 {{database name="hsqldb" version="2.2.9"/}}
64
Vincent Massol 1.1 65 = Known issues =
66
Vincent Massol 23.1 67 * Markdown support is broken due to a duplicate ASM JAR. To make it work, remove the ##asm-3.1.jar## file from your ##WEB-INF/lib## directory (fixed in XWiki 4.4.1).
Vincent Massol 1.1 68 * [[Bugs we know about>>http://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=category+%3D+%22Top+Level+Projects%22+AND+issuetype+%3D+Bug+AND+resolution+%3D+Unresolved+ORDER+BY+updated+DESC]]
69
70 = Test Report =
71
Vincent Massol 12.1 72 No manual test were done for this version (see [[other past test reports>>TestReports.WebHome]] if you're curious).
Vincent Massol 1.1 73
74 = Backward Compatibility and Migration Notes =
75
76 == General Notes ==
77
Denis Gervalle 21.1 78 {{warning}}
79 PLEASE, BACKUP YOUR DATABASE BEFORE STARTING YOUR WIKI.
80 AUTOMATED MIGRATION PROCEDURE TAKE PLACE AT STARTUP AND YOU MAY NEED TO START OVER IF YOU ENCOUNTER AN UNEXPECTED ISSUE.
81 {{/warning}}
82
Vincent Massol 1.1 83 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
84
85 {{warning}}
86 Always make sure you compare your ##xwiki.cfg## and ##xwiki.properties## files with the newest version since some configuration parameters were 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.
87 {{/warning}}
88
Denis Gervalle 21.1 89 {{warning}}
90 If you are migrating from an earlier version than 4.0, and your database contains statistics collected using a version earlier than 2.2, you will probably encounter an issue during our automated database migration. To avoid that issue, you will need to clean up your statistics by executing some SQL commands described in issue [[XWIKI-8129>>http://jira.xwiki.org/browse/XWIKI-8129]]. Be sure to apply these before attempting the migration. If your are in doubt, apply it, these could not hurt. If you don't, you will face duplicate IDs errors during the migration process, and it will fail, preventing you to run your wiki.
91 {{/warning}}
92
93 {{warning}}
94 If you have encountered an issue with the migration, you may need to start over from a backup. Be careful that during the migration, two new tables have been created (in each xwiki database for a farm) and should be dropped when you restore a backup of a database coming from a version earlier than 4.x. These two tables are DATABASECHANGELOG and DATABASECHANGELOGLOCK. These should only be removed if you restore a pre-4.x database schema. Mixing an old database with these two tables will surely cause issue during schema updates (liquibase checksum failure).
95 {{/warning}}
96
Vincent Massol 22.1 97 == Issues specific to XWiki 4.4 ==
Vincent Massol 1.1 98
Sergiu Dumitriu 15.1 99 * The Toucan skin has been removed from the platform and from the distribution packages. You can find the sources in the [[xwiki-contrib repository on github>>https://github.com/xwiki-contrib/skin-toucan]].
Sergiu Dumitriu 4.1 100 * The Lucene index specification has been changed to include a new field ##exactspace## and three other fields have been altered to better support exact matches. It is recommended to rebuild the whole Lucene index.
Vincent Massol 1.1 101
102 == API Breakages ==
103
Vincent Massol 20.1 104 The following APIs were modified since XWiki 4.3.1:
Vincent Massol 1.1 105
Vincent Massol 19.1 106 * Moved to Lucene 4 + moved non API classes to the ##internal## package:(((
Vincent Massol 1.1 107 {{code language="none"}}
Vincent Massol 19.1 108 com.xpn.xwiki.plugin.lucene.LucenePlugin: Parameter 1 of 'public void init(com.xpn.xwiki.plugin.lucene.IndexUpdater, com.xpn.xwiki.XWikiContext)' has changed its type to com.xpn.xwiki.plugin.lucene.internal.IndexUpdater
109 com.xpn.xwiki.plugin.lucene.LucenePlugin: Parameter 1 of 'public void init(com.xpn.xwiki.plugin.lucene.IndexUpdater, com.xpn.xwiki.plugin.lucene.IndexRebuilder, com.xpn.xwiki.XWikiContext)' has changed its type to com.xpn.xwiki.plugin.lucene.internal.IndexUpdater
110 com.xpn.xwiki.plugin.lucene.LucenePlugin: Parameter 2 of 'public void init(com.xpn.xwiki.plugin.lucene.IndexUpdater, com.xpn.xwiki.plugin.lucene.IndexRebuilder, com.xpn.xwiki.XWikiContext)' has changed its type to com.xpn.xwiki.plugin.lucene.internal.IndexRebuilder
Vincent Massol 1.1 111 {{/code}}
Vincent Massol 19.1 112 )))

Get Connected