Last modified by Thomas Mortagne on 2017/03/24

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 This is the first bugfix release for the 3.5 series, and, since 3.5 is the final major release in the 3.x cycle, a bugfix release for the whole 3.x cycle. The main focus has been on quality assurance, improving the compatibility with various database systems, polishing the new sheet mechanism, the new extension manager, the skin, the WYSIWYG, and other parts of the XWiki platform.
6
7 = New and Noteworthy (since 3.5) =
8
9 == Database compatibility improvements ==
10
11 In XWiki 3.2 we [[upgraded to a new version of Hibernate and polished our mapping files>>ReleaseNotes.ReleaseNotesXWikiEnterprise32||anchor="HStorageimprovements"]], for improved performance and better consistency across different RDBMSs. However, this wasn't properly tested and caused upgrade problems when using Oracle or PostgreSQL. This release remedies the situation, and 3.5.1 has been fully tested both with new installations and with upgrades on all the [[supported databases>>dev:Community.DatabaseSupportStrategy]].
12
13 * [[XWIKI-7539>>https://jira.xwiki.org/browse/XWIKI-7539]] - Hibernate versioning broken with non-ascii characters when using a PostgreSQL database
14 * [[XWIKI-7564>>https://jira.xwiki.org/browse/XWIKI-7564]] - Upgrade from a version before 3.3 fails when running on a PostgreSQL database
15 * [[XWIKI-7644>>https://jira.xwiki.org/browse/XWIKI-7644]] - Add support for PostgreSQL as a known DatabaseProduct
16 * [[XWIKI-7645>>https://jira.xwiki.org/browse/XWIKI-7645]] - Upgrading from a version before 3.3 causes all attachments to be broken when running on an Oracle database
17 * [[XWIKI-7763>>https://jira.xwiki.org/browse/XWIKI-7763]] - Database migration (upgrade) fails from 3.5 to 4.0 with PostgreSQL
18 * [[XWIKI-7770>>https://jira.xwiki.org/browse/XWIKI-7770]] - Failing migration from 3.5 to 4.0-rc-1 on Oracle
19 * [[XWIKI-7771>>https://jira.xwiki.org/browse/XWIKI-7771]] - Failing migration from 3.5 to 4.0-rc-1 on PostgreSQL
20 * [[XE-1133>>https://jira.xwiki.org/browse/XE-1133]] - Use the PostgreSQL-specific mapping file when buiding the pgsql profile
21
22 == Skin improvements ==
23
24 In XWiki 3.4 we refreshed a bit the Colibri skin, towards a more modern look, with rounded corners and gradients. Unfortunately, this change was not perfectly backwards incompatible with older color themes, possibly causing some custom color themes to be "broken". We improved the skin in this version to better support both old and new color themes, enabling gradients only when the color theme properly defines gradients. We've also improved the color theme wizard to support the new gradients.
25
26 * [[XWIKI-7597>>https://jira.xwiki.org/browse/XWIKI-7597]] - Add new colortheme variables for the gradients introduced by 3.4 and allow their modification from the colorthemes wizard
27 * [[XWIKI-7615>>https://jira.xwiki.org/browse/XWIKI-7615]] - Remove gradient filters for inputs, textarea and select fields for IE8, IE9
28 * [[XWIKI-7616>>https://jira.xwiki.org/browse/XWIKI-7616]] - Bad display for ColorThemes that have empty gradient values in IE8 and IE9 (Ruby, Mint, Dusk + older colorthemes)
29 * [[XWIKI-7636>>https://jira.xwiki.org/browse/XWIKI-7636]] - The color picker doesn't open if the list of configured colors doesn't contain only hex codes
30 * [[XWIKI-7672>>https://jira.xwiki.org/browse/XWIKI-7672]] - Livetable's filter input's border-color should be consistent with the border color used for other form elements
31 * [[XE-1122>>https://jira.xwiki.org/browse/XE-1122]] - Add new colortheme variables for the gradients introduced by 3.4 and allow their modification from the colorthemes wizard
32 * [[XE-1126>>https://jira.xwiki.org/browse/XE-1126]] - Page header background color isn't updated in real time when editing a newly created Color Theme
33 * [[XE-1127>>https://jira.xwiki.org/browse/XE-1127]] - ColorTheme Wizard doesn't display the logo when creating a new ColorTheme or visualizing a theme that has a white header background
34 * [[XE-1128>>https://jira.xwiki.org/browse/XE-1128]] - Be able to preview value changes for the 3.4 gradients (#mainmenu, #contentmenu, .xwikipaneltitle, .button) from the ColorTheme Wizard
35 * [[XE-1130>>https://jira.xwiki.org/browse/XE-1130]] - Display gradients in the ColorTheme Wizard also for IE8 and IE9 browsers
36 * [[XE-1135>>https://jira.xwiki.org/browse/XE-1135]] - Small style improvements: on ColorTheme.WebHome make .x-theme-info style consistent (font, size) + polish 'Create theme' input
37
38 == Rendering and WYSIWYG improvements ==
39
40 * [[XRENDERING-177>>https://jira.xwiki.org/browse/XRENDERING-177]] - Empty lines around stand-alone macros are badly converted
41 * [[XWIKI-4048>>https://jira.xwiki.org/browse/XWIKI-4048]] - Automatically add empty new line before/after macros when inserting standalone macros
42 * [[XWIKI-6121>>https://jira.xwiki.org/browse/XWIKI-6121]] - Double clicking on text makes macro edit box appear
43 * [[XWIKI-7489>>https://jira.xwiki.org/browse/XWIKI-7489]] - WYSIWYG editor misbehaves when entering . (period) at the end of <ul> line
44 * [[XWIKI-7565>>https://jira.xwiki.org/browse/XWIKI-7565]] - Pass a relative URL to the inputURL WYSIWYG editor configuration parameter
45 * [[XWIKI-7573>>https://jira.xwiki.org/browse/XWIKI-7573]] - WYSWIG Editor Undo Level is limited to 10
46 * [[XWIKI-7593>>https://jira.xwiki.org/browse/XWIKI-7593]] - Links from other WYSIWYG fields are removed if the page is saved while a WYSIWYG field is edited in full screen
47 * [[XWIKI-7606>>https://jira.xwiki.org/browse/XWIKI-7606]] - Cannot delete a table row when the selection spans across multiple cells
48 * [[XWIKI-7619>>https://jira.xwiki.org/browse/XWIKI-7619]] - Infinite recursion when selecting a tree node if parent chain has cycles
49
50 == Debian package improvements ==
51
52 There have been several bugfixes for the new Debian packages:
53
54 * [[XE-1116>>https://jira.xwiki.org/browse/XE-1116]] - Upgrade to jdeb 0.10
55 * [[XE-1118>>https://jira.xwiki.org/browse/XE-1118]] - conffiles and postinst files should ends with a new line in debian packages
56 * [[XE-1119>>https://jira.xwiki.org/browse/XE-1119]] - postgres debian packages don't have the right name
57 * [[XE-1120>>https://jira.xwiki.org/browse/XE-1120]] - /etc/xwiki/hibernate.cfg.xml file is not generated by debian installer
58 * [[XE-1123>>https://jira.xwiki.org/browse/XE-1123]] - hibernate configuration file does not have the right owner in debian installer
59 * [[XE-1152>>https://jira.xwiki.org/browse/XE-1152]] - Debian tomcat/mysql based package has wrong names
60
61 == Sheet Module improvements ==
62
63 As with any new module, only intensive usage can reveal hard to spot bugs. Fortunately, we've been hard at work and we fixed most of the problems that we've detected, and this module should be more bulletproof now.
64
65 * [[XWIKI-7325>>https://jira.xwiki.org/browse/XWIKI-7325]] - Class sheets are not applied on document translations
66 * [[XWIKI-7529>>https://jira.xwiki.org/browse/XWIKI-7529]] - Comment preview doesn't work when a sheet is applied to a document
67
68 == AppWithinMinutes improvements ==
69
70 * [[XWIKI-7380>>https://jira.xwiki.org/browse/XWIKI-7380]] - Cannot go back from step 2 to step 1
71 * [[XWIKI-7466>>https://jira.xwiki.org/browse/XWIKI-7466]] - AppWithinMinutes Sheet generator makes sheet flow only 50% of the page
72 * [[XWIKI-7379>>https://jira.xwiki.org/browse/XWIKI-7379]] - Set AppWithinMinutes.WebHome as the parent of the application home page
73 * [[XWIKI-7563>>https://jira.xwiki.org/browse/XWIKI-7563]] - Application created by Application Within Minutes cuts "?" both in page names and page titles
74 * [[XWIKI-7610>>https://jira.xwiki.org/browse/XWIKI-7610]] - LiveTable generator does not escape XWiki syntax in JSON strings.
75
76 == Extension Manager improvements ==
77
78 * [[XWIKI-7588>>https://jira.xwiki.org/browse/XWIKI-7588]] - Extension JAR handler does not put the classloader associated to prefixed wiki name
79 * [[XWIKI-7614>>https://jira.xwiki.org/browse/XWIKI-7614]] - When in a subwiki XAR extension should be installed on the current wiki by default
80 * [[XWIKI-7646>>https://jira.xwiki.org/browse/XWIKI-7646]] - Jar extension does not produce component events when loaded at startup
81
82 == Miscellaneous ==
83
84 * [[XCOMMONS-118>>https://jira.xwiki.org/browse/XCOMMONS-118]] - EmbeddableComponentManager#hasComponent does not fallback on parent CM
85 * [[XWIKI-6784>>https://jira.xwiki.org/browse/XWIKI-6784]] - No error shown when having wrong CSRF token and saving with AJAX save and continue
86 * [[XWIKI-6934>>https://jira.xwiki.org/browse/XWIKI-6934]] - Preview action doesn't displays the page's title
87 * [[XWIKI-7513>>https://jira.xwiki.org/browse/XWIKI-7513]] - Failure to upload attachments using REST
88 * [[XWIKI-7591>>https://jira.xwiki.org/browse/XWIKI-7591]] - Query wiki is not fully taken into account
89 * [[XWIKI-7594>>https://jira.xwiki.org/browse/XWIKI-7594]] - Recent XWiki.XWikiPreferences properties are not created automatically
90 * [[XWIKI-7599>>https://jira.xwiki.org/browse/XWIKI-7599]] - Activity macro doesn't work when logged in as superadmin
91 * [[XWIKI-7617>>https://jira.xwiki.org/browse/XWIKI-7617]] - doc.fullName does not work as Livetable column because the JSON returns doc_fullname
92 * [[XWIKI-7633>>https://jira.xwiki.org/browse/XWIKI-7633]] - Impossible to restart XWiki application alone without restarting the application server
93 * [[XWIKI-7656>>https://jira.xwiki.org/browse/XWIKI-7656]] - Office Viewer plugin does not work with spaces in the attachments filename
94 * [[XWIKI-7682>>https://jira.xwiki.org/browse/XWIKI-7682]] - Fix 'delete this attachment' title's translation key
95 * [[XWIKI-7731>>https://jira.xwiki.org/browse/XWIKI-7731]] - ActivityStream subclasses can't provide their own subclasses of ActivityEvent anymore
96 * [[XWIKI-7736>>https://jira.xwiki.org/browse/XWIKI-7736]] - Trying to change the parent with the REST service results in an error
97
98 = Tested Browsers =
99
100 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]]):
101
102 {{browser name='iexplorer' version= '8'/}}
103
104 {{browser name='chrome' version= '17'/}}
105
106 {{browser name="firefox" version="3.6.23"/}}
107
108 {{browser name="firefox" version="11.0"/}}
109
110 {{browser name="iexplorer" version="9"/}}
111
112 = Tested Databases =
113
114 Here's the list of RDBMSs tested with this version (i.e. databases that we've tested as working, both for new installations and for upgrades - Check the list of [[supported databases>>dev:Community.DatabaseSupportStrategy]]):
115
116 {{database name="hsqldb" version="2.2.8"/}}
117
118 {{database name="mysql" version="5.x"/}}
119
120 {{database name='oracle' version= '11.x'/}}
121
122 {{database name='postgresql' version= '9.x'/}}
123
124 = Known issues =
125
126 * [[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]]
127
128 = Test Report =
129
130 You can check the [[manual test report>>TestReports.ManualTestReportXE351]] to learn about what was tested and the results on various browsers.
131
132 = Backward Compatibility and Migration Notes =
133
134 == General Notes ==
135
136 {{warning}}
137 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,...//.
138 {{/warning}}
139
140 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
141
142 {{warning}}
143 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.
144 {{/warning}}
145
146 == Issues specific to the 3.5.1 version ==
147
148 As stated above in the [[Database compatibility improvements>>ReleaseNotesXWikiEnterprise351||anchor="HDatabasecompatibilityimprovements"]] section, in XWiki 3.2 we changed the Hibernate mapping files which caused some incompatibilities for PostgreSQL and Oracle databases. All new installations should work without any problems, and upgrades from older versions have been thoroughly tested and there shouldn't be any problems except the one noted below. However, given that some column types have changed between since older versions, **do make a backup of your database first**. If you encounter any problems, please [[report them>>https://jira.xwiki.org/]].
149
150 === Upgrade from a version between 3.2 and 3.5 to 3.5.1 on PostgreSQL ===
151
152 The mapping file for PostgreSQL was broken for these versions, causing [[XWIKI-7539>>https://jira.xwiki.org/browse/XWIKI-7539]], so all history entries containing non-ASCII characters were broken. This data loss is permanent and can't be undone, there's no way of getting back a valid history from the database. While we tried to fix as many history entries as possible, this kind of entries will remain broken, leading to inaccessible older versions for some documents. We kept valid the history meta data though, so you can still see when and by whom each version was created.
153
154 == API Breakages ==
155
156 No APIs were modified since 3.5.

Get Connected