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 25.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 25.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
Vincent Massol 1.1 13 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.
14
Vincent Massol 8.1 15 = New and Noteworthy (since XWiki 4.5) =
Vincent Massol 1.1 16
Thomas Mortagne 25.1 17 [[Full list of issues fixed and Dashboard for 4.5.1>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11494]].
Vincent Massol 17.1 18
Marius Dumitru Florea 14.1 19 == Extension Manager improvements ==
20
Marius Dumitru Florea 20.1 21 We added more information to the Description section and we added the ability to retrieve the list of stable versions that are available in the configured extension repositories.
22
23 {{image reference="EM-extensionDescription.png" /}}
24
Marius Dumitru Florea 22.1 25 We also grouped the action buttons (e.g. Install and Install of farm) as you can see in the image above. This allowed us to move the Apply button that you had to click to confirm an extension action like install from the bottom of the Progress section to the extension actions section. The Install and Install of farm buttons are still available in the drop down menu to allow you recompute the install plan if you want to.
Marius Dumitru Florea 20.1 26
27 {{image reference="EM-continueInstall.png" /}}
28
29 See the [[Extension Manager Application documentation>>extensions:Extension.Extension Manager Application]] for more information.
30
Marius Dumitru Florea 14.1 31 == Distribution Wizard improvements ==
32
Thomas Mortagne 25.1 33 We fixed an important bug in Distribution Wizard ({{jira url="https://jira.xwiki.org" style="enum"}}XWIKI-8749{{/jira}}) that was preventing you from properly upgrading the installed extensions in the second step. We now list extensions by the namespace (wiki) where they have been installed. For now you have to review and upgrade each extension individually. We hope to improve this soon by allowing you upgrade more extensions at once.
Marius Dumitru Florea 16.1 34
35 {{image reference="DW-upgradeExtensions.png"/}}
36
Vincent Massol 23.1 37 == Full Issue List ==
38
Thomas Mortagne 25.1 39 {{jira style="list" url="https://jira.xwiki.org" fields="type, status, key, summary" source="jql"}}
Vincent Massol 23.1 40 Project in ("XWiki Commons", "XWiki Rendering", "XWiki Platform", "XWiki Enterprise", "XWiki Enterprise Manager") and fixVersion in ("4.5.1") and resolution in ("Fixed") and component not in ("Build, Infrastructure and Tests")
41 {{/jira}}
42
43 = For Developers =
44
Marius Dumitru Florea 13.1 45 == Button Group Widget ==
46
47 We added a small widget to group form buttons.
48
Marius Dumitru Florea 16.1 49 {{image reference="buttonGroup.png"/}}
Marius Dumitru Florea 13.1 50
51 It can be used either with a static list of buttons, when you know beforehand that you have more than 1 button and you know the main one, or with a dynamic list of buttons, if you want the buttons to be grouped on the client side if there are more than one.
52
53 The static button group works even with JavaScript disabled (in a modern browser):
54
55 {{code language="html"}}
56 <p class="buttons">
57 <span class="buttonwrapper button-group">
58 <button>Action</button><a href="#foo" class="dropdown-toggle" tabindex="0"><span/></a>
59 <span id="foo" class="dropdown-menu">
60 <button>First item</button>
61 <input type="submit" value="Second item" class="button" />
62 <a href="#third">Third item</a>
63 </span>
64 </span>
65 </p>
66 {{/code}}
67
68 The dynamic group obviously requires JavaScript. The first button found in the group is considered the main one. The buttons are grouped only if there are more than one. If the main button is secondary then the button group is styled as a secondary button.
69
70 {{code language="html"}}
71 <span class="dynamic-button-group">
72 <span class="buttonwrapper">
73 <button>One</button>
74 </span>
75 <span class="buttonwrapper">
76 <input type="submit" class="button secondary" value="Two" />
77 </span>
78 <span class="buttonwrapper">
79 <a href="#three" class="secondary">Three</a>
80 </span>
81 </span>
82 {{/code}}
83
84 In both cases you need to include the widget resources:
85
86 {{code language="none"}}
87 #set ($discard = $xwiki.ssfx.use('uicomponents/widgets/buttonGroup.css', true))
88 #set ($discard = $xwiki.jsfx.use('uicomponents/widgets/buttonGroup.js'))
89 {{/code}}
90
Vincent Massol 1.1 91 = Translations =
92
93 The following translations have been updated:
94
Vincent Massol 24.1 95 {{language codes="fr"/}}
Vincent Massol 1.1 96
97 = Tested Browsers & Databases =
98
Manuel Smeria 11.1 99 {{include reference="TestReports.ManualTestReportXWiki451Summary"/}}
Vincent Massol 1.1 100
101 = Known issues =
102
Thomas Mortagne 25.1 103 * [[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 104
105 = Backward Compatibility and Migration Notes =
106
107 == General Notes ==
108
Denis Gervalle 4.1 109 {{warning}}
110 PLEASE, BACKUP YOUR DATABASE BEFORE STARTING YOUR WIKI.
111 AUTOMATED MIGRATION PROCEDURE TAKE PLACE AT STARTUP AND YOU MAY NEED TO START OVER IF YOU ENCOUNTER AN UNEXPECTED ISSUE.
112 {{/warning}}
113
Vincent Massol 1.1 114 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
115
116 {{warning}}
117 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.
118 {{/warning}}
Denis Gervalle 4.1 119
120 {{warning}}
Thomas Mortagne 25.1 121 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 122 {{/warning}}
123
124 {{warning}}
125 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).
126 {{/warning}}
Vincent Massol 7.2 127
128 == API Breakages ==
129
Vincent Massol 8.1 130 No API breakage since XWiki 4.5.

Get Connected