Version 10.1 by Vincent Massol on 2012/02/21

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 This is the last major release of the 3.x [[development cycle>>dev:Community.VersioningAndReleasePractices||anchor="HReleaseCyclesandReleaseStrategy"]] (there will still be bugfix releases on the 3.5.x branch, if needed). The next release is going to be 4.0.
6
7 This is a stabilization release, with no major new features to highlight.
8
9 = New and Noteworthy (since XWiki Enterprise 3.4 version) =
10
11 Statistics about this release are available in our [[JIRA Dashboard>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=10794]].
12
13 == Extension Manager improvements ==
14
15 * [[XWIKI-7249>>http://jira.xwiki.org/browse/XWIKI-7249]] When an extension is already installed do not show a clickable "Install" button
16 * [[XWIKI-7367>>http://jira.xwiki.org/browse/XWIKI-7367]] Add clustering support for extensions
17 * [[XWIKI-7426>>http://jira.xwiki.org/browse/XWIKI-7426]] Search should be case insensitive on XWiki Repository
18 * [[XWIKI-7429>>http://jira.xwiki.org/browse/XWIKI-7429]] Clicking "Install" after "Show details" brings the user out of the Administration interface
19 * [[XWIKI-7430>>http://jira.xwiki.org/browse/XWIKI-7430]] Extension manager should provide a custom user agent when connection to repositories
20 * [[XWIKI-7452>>http://jira.xwiki.org/browse/XWIKI-7452]] Can't resolve an extension with id containing UTF-8 char in XWiki Repository
21 * [[XWIKI-7453>>http://jira.xwiki.org/browse/XWIKI-7453]] Can't find an extension on XWiki Repository when searching with a pattern containing an UTF-8 character
22 * [[XWIKI-7455>>http://jira.xwiki.org/browse/XWIKI-7455]] Provide UI to import and synchronize an external extension in the repository
23 * [[XWIKI-7458>>http://jira.xwiki.org/browse/XWIKI-7458]] Getting "Unknown macro: warn" instead of the actual warning when installing/uninstalling an extension
24 * [[XWIKI-7477>>http://jira.xwiki.org/browse/XWIKI-7477]] XWiki Repository REST services should provide a content-disposition with the file name
25 * [[XWIKI-7492>>http://jira.xwiki.org/browse/XWIKI-7492]] Separate local extensions by folders
26 * [[XWIKI-7544>>http://jira.xwiki.org/browse/XWIKI-7544]] Add support for standard proxy settings in Extension Manager
27 * [[XWIKI-7549>>http://jira.xwiki.org/browse/XWIKI-7549]] Install state of an extension located in a sub-folder of the local repository is lost after restart
28
29 See the full list of [[Extension Manager issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/temp/SearchRequest.html?jqlQuery=project+%3D+XWIKI+AND+resolution+%3D+Fixed+AND+fixVersion+in+%2812862%2C+12857%29+AND+component+%3D+%22Extension+Manager%22+AND+status+%3D+Closed+ORDER+BY+priority+DESC&tempMax=1000]] that have been fixed in this release.
30
31 == Documents macro ==
32
33 A new macro that can be used to display documents in a live table. Read more about it on [[extensions wiki>>extensions:Extension.Documents Macro]].
34
35 = Bug fixes and improvements =
36
37 * [[XE-1096>>http://jira.xwiki.org/browse/XE-1096]] The attachment selector should also work with the ##/edit/## action in 'Inline form' edit mode
38 * [[XE-1105>>http://jira.xwiki.org/browse/XE-1105]] Default class sheet doesn't display correctly the class title
39 * [[XWIKI-6305>>http://jira.xwiki.org/browse/XWIKI-6305]] Keep the current user in the administration application when editing user details
40 * [[XWIKI-7411>>http://jira.xwiki.org/browse/XWIKI-7411]] Cannot import a XAR containing ##%3A## in its file name
41 * [[XWIKI-7462>>http://jira.xwiki.org/browse/XWIKI-7462]] Improve the Profile breadcrumb to be more user friendly
42 * [[XWIKI-7484>>http://jira.xwiki.org/browse/XWIKI-7484]] Write a log line in the console instructing the user to open XWiki in a browser
43 * [[XWIKI-7520>>http://jira.xwiki.org/browse/XWIKI-7520]] Activity Stream performance regression
44 * [[XWIKI-7558>>http://jira.xwiki.org/browse/XWIKI-7558]] Creating a space using Space Dashboard Template will result in a page with blank creator/author
45
46 See the full list of [[JIRA issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/temp/SearchRequest.html?jqlQuery=project+in+%28XCOMMONS%2C+XRENDERING%2C+XWIKI%2C+XE%2C+XEM%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+in+%28%223.5-milestone-1%22%2C+%223.5%22%29&tempMax=1000]] fixed in this release.
47
48 = For Developers =
49
50 * [[XCOMMONS-94>>http://jira.xwiki.org/browse/XCOMMONS-94]] Set the minimum required Maven version (3.0) to build XWiki in the POM
51 * [[XWIKI-7476>>http://jira.xwiki.org/browse/XWIKI-7476]] Sheets need to be able to display the title of the document they are applied to
52 * [[XWIKI-7502>>http://jira.xwiki.org/browse/XWIKI-7502]] Replace notion of Container's ApplicationContext with the notion of Environment
53 * [[XWIKI-7504>>http://jira.xwiki.org/browse/XWIKI-7504]] Files within WEB-INF directory readable by using Velocity
54 * [[XWIKI-7526>>http://jira.xwiki.org/browse/XWIKI-7526]] Enable Infinispan JMX mbeans by default for runtime monitoring of XWiki caches
55 * [[XE-1108>>http://jira.xwiki.org/browse/XE-1108]] Provide tomcat5 and tomcat7 based Debian packages
56
57 == Upgrades ==
58
59 The following dependencies have been upgraded:
60
61 * Groovy 1.8.6
62 * JFreeChart 1.0.14
63 * JUnit 4.9
64 * Maven Archetype plugin 2.2
65 * Maven Assembly plugin 2.3
66 * Maven Checkstyle plugin 2.9
67 * Maven Dependency plugin 2.4
68 * Maven Exec plugin 1.2.1
69 * Maven Findbugs plugin 2.4.0
70 * Maven JAR plugin 2.4
71 * Maven Javadoc plugin 2.8.1
72 * Maven Plugin plugin 2.9
73 * Maven Release plugin 2.2.2
74 * Maven Site plugin 3.0
75 * Maven SSH Wagon 2.2
76 * Maven Surefire plugin 2.12
77 * Maven War plugin 2.2
78 * OSCache 2.4.1
79
80 == Translations ==
81
82 The following translations have been updated:
83
84 {{language codes="fr, it, ko, lv, sv"/}}
85
86 = Tested Browsers =
87
88 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]]):
89
90 {{browser name="firefox" version="10"/}}
91
92 {{browser name="chrome" version="17"/}}
93
94 {{browser name="iexplorer" version="8"/}}
95
96 {{browser name="iexplorer" version="9"/}}
97
98 = Known issues =
99
100 * [[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]]
101
102 = Test Report =
103
104 You can check the [[manual test report>>TestReports.ManualTestReportXE35]] to learn about what was tested and the results on various browsers.
105
106 = Backward Compatibility and Migration Notes =
107
108 == General Notes ==
109
110 {{warning}}
111 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,...//.
112 {{/warning}}
113
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}}
119
120 == Issues specific to XWiki Enterprise 3.5 ==
121
122 * The default configuration property for the permanent directory was renamed from ##container.persistentDirectory## to ##environment.permanentDirectory## in ##xwiki.properties##.
123 * We've disabled support for Event parameters in the Event Stream (this was a feature for developers) because it caused a [[regression of performance in the Activity Stream>>http://jira.xwiki.org/browse/XWIKI-7520]]. We'll put it back when [[we find out to have it and still get good performances>>http://jira.xwiki.org/browse/XWIKI-7554]]. In the meantime if you really need to add this feature back, extract ##activitystream.hbm.xml## located in the Activity Stream JAR in ##WEB-INF/lib## to the ##WEB-INF/classes## directory and uncomment the ##map## mapping in the file.
124 * It seems that [[upgrading from an earlier version to 3.5 when using PostgreSQL fails>>http://jira.xwiki.org/browse/XWIKI-7564]]. The workaround is to extract ##xwiki.hbm.xml## located in the Old Core JAR in ##WEB-INF/lib## to the ##WEB-INF/classes## directory and add the ##materialized_clob## typedef as in:(((
125 {{code}}
126 <hibernate-mapping auto-import="true">
127 ...
128 <typedef name="materialized_clob" class="org.hibernate.type.StringClobType" />
129 ...
130 <class name="com.xpn.xwiki.doc.XWikiDocument" table="xwikidoc">
131 ...
132 {{/code}}
133 )))
134
135 == API Breakages ==
136
137 The following APIs were modified since version 3.4:
138
139 {{code language="none"}}
140 org.xwiki.container.ContainerFactory: Class org.xwiki.container.ContainerFactory removed
141 com.xpn.xwiki.plugin.zipexplorer.ZipExplorerPlugin: Class com.xpn.xwiki.plugin.zipexplorer.ZipExplorerPlugin removed
142 com.xpn.xwiki.plugin.zipexplorer.ZipExplorerPluginAPI: Class com.xpn.xwiki.plugin.zipexplorer.ZipExplorerPluginAPI removed
143 {{/code}}

Get Connected