Last modified by Thomas Mortagne on 2017/03/24

Hide last authors
Vincent Massol 1.1 1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
Denis Gervalle 3.1 5 {{warning}}
Thomas Mortagne 8.1 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>>https://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.
Denis Gervalle 3.1 7 {{/warning}}
8
Sorin Burjan 7.1 9 {{warning}}
Thomas Mortagne 8.1 10 If you are upgrading to this version from an older version which uses Lucene 3.x, you have to manually delete the lucene directory in the xwiki data directory. For example, that could cause Lucene to loop endlessly while trying to index pages, among other things. This is caused by the Lucene migration to 4.0 (see [[XWIKI-8404>>https://jira.xwiki.org/browse/XWIKI-8404]]).
Sorin Burjan 7.1 11 {{/warning}}
12
13
Vincent Massol 1.1 14 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.
15
Vincent Massol 5.1 16 = New and Noteworthy (since XWiki 4.4) =
Vincent Massol 1.1 17
18 == Full Issue List ==
19
Thomas Mortagne 8.1 20 {{jira style="list" url="https://jira.xwiki.org" fields="type, status, key, summary" source="jql"}}
Vincent Massol 5.1 21 Project in ("XWiki Commons", "XWiki Rendering", "XWiki Platform", "XWiki Enterprise", "XWiki Enterprise Manager") and fixVersion in ("4.4.1") and resolution in ("Fixed") and component not in ("Build, Infrastructure and Tests")
Vincent Massol 1.1 22 {{/jira}}
23
24 = Translations =
25
26 The following translations have been updated:
27
Vincent Massol 6.1 28 {{language codes="fr,ko,ru,sv"/}}
Vincent Massol 1.1 29
30 = Tested Browsers & Databases =
31
32 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]]):
33
34 {{velocity}}
35 ## name = iexplorer, firefox, chrome, safari, opera
36 {{/velocity}}
37
Manuel Smeria 2.4 38 {{browser name="firefox" version="17"/}}
Vincent Massol 1.1 39
40 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]]):
41
42 {{velocity}}
43 ## name = hsqldb, mysql, postgresql, oracle, opera
44 {{/velocity}}
45
Manuel Smeria 2.4 46 {{database name="hsqldb" version="2.2.9"/}}
Vincent Massol 1.1 47
48 = Known issues =
49
Thomas Mortagne 8.1 50 * [[Bugs we know about>>https://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]]
Vincent Massol 1.1 51
52 = Backward Compatibility and Migration Notes =
53
54 == General Notes ==
55
Denis Gervalle 4.1 56 {{warning}}
57 PLEASE, BACKUP YOUR DATABASE BEFORE STARTING YOUR WIKI.
58 AUTOMATED MIGRATION PROCEDURE TAKE PLACE AT STARTUP AND YOU MAY NEED TO START OVER IF YOU ENCOUNTER AN UNEXPECTED ISSUE.
59 {{/warning}}
60
Vincent Massol 1.1 61 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
62
63 {{warning}}
64 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.
65 {{/warning}}
Denis Gervalle 4.1 66
67 {{warning}}
Thomas Mortagne 8.1 68 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>>https://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.
Denis Gervalle 4.1 69 {{/warning}}
70
71 {{warning}}
72 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).
73 {{/warning}}
Vincent Massol 7.2 74
75 == API Breakages ==
76
77 The following APIs were modified since XWiki 4.4:
78
79 * Request was not supposed to contain this method in the first place:(((
80 {{code language="none"}}
81 org.xwiki.job.Request: Method 'public java.lang.Object removeProperty(java.lang.String)' has been removed
82 {{/code}}
83 )))
Vincent Massol 7.3 84 * New method to allow building an UI for reporting migration issues (mainly for sub-wiki):(((
85 {{code language="none"}}
86 com.xpn.xwiki.store.migration.DataMigrationManager: Method 'public com.xpn.xwiki.store.migration.DataMigrationStatus getDataMigrationStatus()' has been added to an interface
87 {{/code}}
88 )))

Get Connected