Last modified by Thomas Mortagne on 2017/03/24

Hide last authors
Marius Dumitru Florea 10.1 1 {{velocity}}
2 $xwiki.ssx.use("ReleaseNotesXWikiEnterprise30M3")
3 {{/velocity}}
4
Caleb James DeLisle 1.1 5 {{box cssClass="floatinginfobox" title="**Contents**"}}
6 {{toc/}}
7 {{/box}}
8
Caleb James DeLisle 22.1 9 Second milestone of the XWiki Enterprise 3.1 version ([[Roadmap>>Main.Roadmap]]). This is mostly an "upgrade" release in which we've upgraded lots of third party libraries we use. In addition we're now requiring Java 6 at runtime.
Caleb James DeLisle 1.1 10
Caleb James DeLisle 22.1 11 = New and Noteworthy (since XWiki Enterprise 3.1M1) =
Caleb James DeLisle 1.1 12
Caleb James DeLisle 22.1 13 == Upgrades ==
Caleb James DeLisle 21.2 14
Thomas Mortagne 24.1 15 * [[XWiki now requires Java 6!>>https://jira.xwiki.org/browse/XWIKI-5607]]
16 * [[Upgrade JGroups to latest version 2.12.1>>https://jira.xwiki.org/browse/XWIKI-4769]]
17 * [[Upgrade to Groovy 1.8>>https://jira.xwiki.org/browse/XWIKI-6571]]
18 * [[Upgrade to commons-net-3.0>>https://jira.xwiki.org/browse/XCOMMONS-12]]
19 * [[Move from Commons Logging/Log4J to SLF4J/Logback>>https://jira.xwiki.org/browse/XCOMMONS-9]]
20 * [[Upgrade to hibernate-validator 4.1.0.Final>>https://jira.xwiki.org/browse/XE-924]]
Vincent Massol 15.4 21
Caleb James DeLisle 22.1 22 == For developers ==
23
Thomas Mortagne 24.1 24 * [[XCOMMONS-10>>https://jira.xwiki.org/browse/XCOMMONS-10]]: Add support for injecting Logger with @Inject. Now you can have the XWiki Commons logging implementation inserted into your module using dependency injection.
Caleb James DeLisle 22.1 25
Caleb James DeLisle 15.1 26 == Miscellaneous ==
Caleb James DeLisle 22.1 27
Thomas Mortagne 24.1 28 * [[XWIKI-6583>>https://jira.xwiki.org/browse/XWIKI-6583]]: Completion of [[Office document export>>ReleaseNotes.ReleaseNotesXWikiEnterprise31M1#HOfficeDocumentExport]] from milestone 1 by fixing the embedding of images.
29 * [[XWIKI-116>>https://jira.xwiki.org/browse/XWIKI-116]]: Added the ability to dictate what mode documents should be edited in by default on a document by document basis.
30 * [[XWIKI-6574>>https://jira.xwiki.org/browse/XWIKI-6574]]: Created a repository for automatically downloading XWiki Extensions using the Extension Manager.
31 * [[XWIKI-6599>>https://jira.xwiki.org/browse/XWIKI-6599]]: Support for suggestion sources to provide custom icon/images for individual result entry
32 * [[XWIKI-6635>>https://jira.xwiki.org/browse/XWIKI-6635]]: Add support for non-interactive wizard steps
33 * Lots of bug fixes and improvements, [[see a full list of issues closed in the 3.1M2 frame>>https://jira.xwiki.org/secure/IssueNavigator!executeAdvanced.jspa?jqlQuery=fixVersion+%3D+%273.1+M2%27&runQuery=true&clear=true]]
Caleb James DeLisle 1.1 34
35 == Translations ==
36
Caleb James DeLisle 22.1 37 * No changes were added to translations.
38
Caleb James DeLisle 1.1 39 = Known issues =
Caleb James DeLisle 22.1 40
Thomas Mortagne 24.1 41 * [[Bugs we know about>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&&type=1&pid=10010&resolution=-1&sorter/field=updated&sorter/order=DESC]]
Caleb James DeLisle 1.1 42
43 = Test Report =
44
Caleb James DeLisle 22.1 45 You can check the [[manual test report>>TestReports.ManualTestReportXE31M2]] to learn about what was tested and the results on various browsers.
46
Caleb James DeLisle 1.1 47 = Backward Compatibility and Migration Notes =
48
Caleb James DeLisle 15.1 49 == Java 1.6 ==
Marius Dumitru Florea 18.1 50
Caleb James DeLisle 15.1 51 XWiki Enterprise 3.1 Milestone 2 and all subsequent versions will be compiled with Java6, Java5 is no longer supported.
52
53 == Deprecated XClass database tables removed ==
Marius Dumitru Florea 18.1 54
Thomas Mortagne 24.1 55 In [[XWIKI-6624>>https://jira.xwiki.org/browse/XWIKI-6624]] a set of database tables and their supporting infrastructure were removed. These tables held XWiki Class information but since XWiki 1.0, the table method of storage has been deprecated and non-default. If upgrading from a pre-1.0 version of XWiki, it is important to make sure you are using the XML XWiki class storage and not the database tables first.
Caleb James DeLisle 15.1 56
Marius Dumitru Florea 16.1 57 == WYSIWYG Editor Configuration ==
58
Thomas Mortagne 24.1 59 In order to implement [[XWIKI-6618>>https://jira.xwiki.org/browse/XWIKI-6618]] we changed the format of the menu bar configuration. If you exclude the ##XWiki.WysiwygEditorConfig## page when you upgrade your wiki pages (which you should do in order to preserve your WYSIWYG editor configuration) then you have to:
Marius Dumitru Florea 18.1 60
Marius Dumitru Florea 16.1 61 1. edit the ##XWiki.WysiwygEditorConfig## page with the object editor
62 1. remove deprecated properties (you have to do this because we changed the type of the //Menu Bar// property to accommodate the new format)
Marius Dumitru Florea 17.1 63 1. change the value of the //Menu Bar// property to use the following JSON format:(((
Marius Dumitru Florea 16.1 64 {{code}}
65 [{
66 "feature" : "link",
67 "subMenu" : ["linkEdit", "linkRemove", "linkWikiPage", "linkAttachment", "|", "linkWebPage", "linkEmail"]
68 },
69 {
70 "feature" : "image",
71 "subMenu" : ["imageInsertAttached", "imageInsertURL", "imageEdit", "imageRemove"]
72 },
73 {
74 "feature" : "table",
75 "subMenu" : ["inserttable", "insertcolbefore", "insertcolafter", "deletecol", "|", "insertrowbefore", "insertrowafter", "deleterow", "|", "deletetable"]
76 },
77 {
78 "feature" : "macro",
79 "subMenu" : ["macroInsert", "macroEdit", "|", "macroRefresh", "|", "macroCollapse", "macroExpand"]
80 },
81 {
82 "feature" : "import",
83 "subMenu" : ["importOffice"]
84 }]
85 {{/code}}
Marius Dumitru Florea 17.1 86 )))
Marius Dumitru Florea 16.1 87
Marius Dumitru Florea 19.1 88 If importing ##XWiki.WysiwygEditorConfig## or ##XWiki.WysiwygEditorConfigTemplate## fails then you have to follow this steps in order to update the WYSIWYG editor configuration:
Marius Dumitru Florea 18.1 89
Caleb James DeLisle 22.1 90 1. Revert the ##XWiki.WysiwygEditorConfigClass## page to its previous version, i.e. the version before the import
91 1. Delete the ##XWiki.WysiwygEditorConfig## and ##XWiki.WysiwygEditorConfigTemplate## pages from your wiki
92 1. Import only the ##XWiki.WysiwygEditorConfigClass## page from the upgrade XAR
93 1. Import the ##XWiki.WysiwygEditorConfig## and ##XWiki.WysiwygEditorConfigTemplate## pages from the upgrade XAR
Marius Dumitru Florea 18.1 94
Caleb James DeLisle 22.1 95 == General Notes ==
Sergiu Dumitriu 21.1 96
Caleb James DeLisle 1.1 97 {{warning}}
98 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,...//.
99 {{/warning}}
100
101 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above.
102
103 {{warning}}
104 Always make sure you compare your //xwiki.cfg// file with the newest version since some configuration parameters were added. 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.
105 {{/warning}}
106
107 == API Breakages ==
Caleb James DeLisle 22.1 108
Caleb James DeLisle 2.1 109 No APIs were modified since XWiki Enterprise 3.0.

Get Connected