Last modified by Thomas Mortagne on 2017/03/24

Hide last authors
Sergiu Dumitriu 1.1 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
Thomas Mortagne 4.1 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
Sergiu Dumitriu 1.1 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
Thomas Mortagne 4.1 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
Sergiu Dumitriu 1.1 37
38 == Rendering and WYSIWYG improvements ==
39
Thomas Mortagne 4.1 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
Sergiu Dumitriu 1.1 49
50 == Debian package improvements ==
51
52 There have been several bugfixes for the new Debian packages:
53
Thomas Mortagne 4.1 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
Sergiu Dumitriu 1.1 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
Thomas Mortagne 4.1 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
Sergiu Dumitriu 1.1 67
68 == AppWithinMinutes improvements ==
69
Thomas Mortagne 4.1 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.
Sergiu Dumitriu 1.1 75
76 == Extension Manager improvements ==
77
Thomas Mortagne 4.1 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
Sergiu Dumitriu 1.1 81
82 == Miscellaneous ==
83
Thomas Mortagne 4.1 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
Sergiu Dumitriu 1.1 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
Thomas Mortagne 4.1 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]]
Sergiu Dumitriu 1.1 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
Sergiu Dumitriu 2.1 146 == Issues specific to the 3.5.1 version ==
147
Thomas Mortagne 4.1 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/]].
Sergiu Dumitriu 2.1 149
150 === Upgrade from a version between 3.2 and 3.5 to 3.5.1 on PostgreSQL ===
151
Thomas Mortagne 4.1 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.
Sergiu Dumitriu 2.1 153
Sergiu Dumitriu 1.1 154 == API Breakages ==
155
Sergiu Dumitriu 3.1 156 No APIs were modified since 3.5.

Get Connected