Last modified by Thomas Mortagne on 2017/03/24

Show last authors
1 {{velocity}}
2 $xwiki.ssx.use("ReleaseNotesXWikiEnterprise30M3")
3 {{/velocity}}
4
5 {{box cssClass="floatinginfobox" title="**Contents**"}}
6 {{toc/}}
7 {{/box}}
8
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.
10
11 = New and Noteworthy (since XWiki Enterprise 3.1M1) =
12
13 == Upgrades ==
14
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]]
21
22 == For developers ==
23
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.
25
26 == Miscellaneous ==
27
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]]
34
35 == Translations ==
36
37 * No changes were added to translations.
38
39 = Known issues =
40
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]]
42
43 = Test Report =
44
45 You can check the [[manual test report>>TestReports.ManualTestReportXE31M2]] to learn about what was tested and the results on various browsers.
46
47 = Backward Compatibility and Migration Notes =
48
49 == Java 1.6 ==
50
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 ==
54
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.
56
57 == WYSIWYG Editor Configuration ==
58
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:
60
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)
63 1. change the value of the //Menu Bar// property to use the following JSON format:(((
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}}
86 )))
87
88 If importing ##XWiki.WysiwygEditorConfig## or ##XWiki.WysiwygEditorConfigTemplate## fails then you have to follow this steps in order to update the WYSIWYG editor configuration:
89
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
94
95 == General Notes ==
96
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 ==
108
109 No APIs were modified since XWiki Enterprise 3.0.

Get Connected