Hide last authors
Thomas Mortagne 1.1 1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
Sergiu Dumitriu 14.2 5 First milestone of the XWiki Enterprise 3.3 version ([[Roadmap>>Main.Roadmap]]). Since we're getting closer to the end of the 3.x cycle, there are fewer new features in this release, most of the changes being internal.
Thomas Mortagne 1.1 6
Vincent Massol 20.1 7 {{error}}
Thomas Mortagne 21.1 8 We've found that this release is a lot more memory-hungry than XWiki Enterprise 3.1 and before. The technical reason is because we're caching the rendering of pages in the document cache and [[those objects are very big>>https://jira.xwiki.org/browse/XRENDERING-161]] (up to 27MB for a very large page). In XWiki Enterprise 3.3 RC1+ we've optimized the space taken in memory by those objects. As a consequence we recommend using a reduced document cache size with this version and/or increasing the memory allocated to the JVM.
Vincent Massol 20.1 9 {{/error}}
10
Thomas Mortagne 1.1 11 = New and Noteworthy (since XWiki Enterprise 3.2 version) =
12
Sergiu Dumitriu 14.3 13 == Preview of the upcoming application designer ==
14
Thomas Mortagne 21.1 15 A key element of the Application Within Minutes feature, the application designer makes its debut in this release with a preview of the new class editor. While not ready for production yet, you're invited to test it and provide feedback on the interaction and user experience, by [[commenting on the issue>>https://jira.xwiki.org/browse/XWIKI-7110]] or [[replying to the email thread>>http://lists.xwiki.org/pipermail/devs/2011-October/024440.html]].
Sergiu Dumitriu 14.3 16
Marius Dumitru Florea 17.1 17 [[[[image:classEditor.png||width="500px" style="border:1px solid #EFEFEF"]]>>attach:classEditor.png]]
18
19 You can give it a try by simply adding an object of type ##XWiki.DocumentSheetBinding## to an existing class or a new document, setting the ##sheet## property to ##AppWithinMinutes.ClassEditSheet## and then editing that document in "Inline form" edit mode.
20
Thomas Mortagne 1.1 21 == Debian packages ==
22
23 Starting with 3.3 Milestone 1 Debian packages and repositories are released.
24
Vincent Massol 15.2 25 You can add one of the following list files to ##/etc/debian/apt/source.list.d/##:
Thomas Mortagne 1.1 26 * http://maven.xwiki.org/stable/xwiki-stable.list : all stable releases starting with 3.3 (so nothing right now)
27 * http://maven.xwiki.org/releases/xwiki-releases.list : all releases starting with 3.3 Milestone 1
28 * http://maven.xwiki.org/snapshots/xwiki-snapshots.list : all snapshots release starting with 3.3 branch
29
30 {{code}}
31 sudo wget http://maven.xwiki.org/stable/xwiki-stable.list -P /etc/apt/sources.list.d
32 {{/code}}
33
Thomas Mortagne 9.1 34 == LDAP user membership improvements ==
Thomas Mortagne 1.1 35
Thomas Mortagne 10.1 36 Organization unit and search filter support have been added in the group membership mapping settings. To use them, replace the group DN with an organization unit DN or with any search filter.
Thomas Mortagne 1.1 37
Vincent Massol 19.1 38 == Attachments improvements ==
Sergiu Dumitriu 14.1 39
40 Since the filesystem attachment storage allows uploading very large files, a necessary improvement is to be able to pause and resume downloads. Starting with this version, it is possible to do so, since the ##/download/## action now respects the ##Range## HTTP header.
41
42 Several bugs with downloading attachments when the filesystem storage is enabled have also been fixed, making this feature ready for production use.
43
Vincent Massol 19.1 44 == Link Checker ==
45
46 It's now possible to tell XWiki to check for validity of external links found in the Wiki (to verify broken links for example). This is implemented through a [[Link Checker Transformation>>rendering:Main.Transformations#HLinkCheckerTransformation]].
47
48 It's not enabled by default. To enable it, edit the ##xwiki.properties## file and add ##linkchecker## to the list of transformations to execute. For example:
49
50 {{code}}
51 rendering.transformations = macro, icon, linkchecker
52 {{/code}}
53
54 Note that there's no UI for it yet (planned for 3.3 Milestone 2) but the Link States can be access through a Script Service. For example from Velocity:
55
56 {{code}}
57 {{velocity}}
58 #set ($states = $services.linkchecker.getLinkStates())
59 {{/velocity}}
60 {{/code}}
61
Thomas Mortagne 1.1 62 = For Developers =
63
Sergiu Dumitriu 13.2 64 == Script services for Application Manager and Wiki Manager ==
Thomas Mortagne 1.1 65
Sergiu Dumitriu 13.2 66 There are script services now available for the old application and wiki manager plugins. You can access them via ##$services.applicationmanager## and ##$services.wikimanager##, and call all the methods previously exposed by their respective plugin APIs. For the moment the plugins are still there, with the script services just bridging them to the new prefered way of accessing APIs from Velocity scripts.
Thomas Mortagne 1.1 67
Sergiu Dumitriu 14.1 68 == Cache improvements ==
69
70 Several bugfixes and improvements have been committed, affecting the rendering cache, the cache macro, and the cache infrastructure in general. An important change is the introduction of an infinispan-based cache implementation, replacing JBossCache as the default one.
71
Thomas Mortagne 18.1 72 == New xdom+xml syntax ==
73
74 The rendering now come with two reference XML based syntaxes which are the exact representation of rendering events.
75
76 Two variants are provided:
77 * 1.0: a stable syntax which represent the rendering events in the state they had when this version has been released. If anything change a new version of the syntax will be created (1.1, etc.)
78 * current: always in sync with rendering events whatever the version but also mean that it can change anytime without warning, only use that for internal use when you are sure you will render and parse with the same version of XWiki Rendering
79
Sergiu Dumitriu 14.1 80 == XE and XEM XAR changes ==
81
82 The XAR plugin by default doesn't bundle dependencies anymore, so the XE and XEM XARs now come in two variants:
83
84 * the old ##xwiki-enterprise-wiki## module has been renamed into [[##xwiki-enterprise-ui##>>https://github.com/xwiki/xwiki-enterprise/tree/xwiki-enterprise-3.3-milestone-1/xwiki-enterprise-ui]], and produces a XAR only with the documents specific to XWiki Enterprise, without dependencies;
85 * the full XAR with all the dependencies bundled in it is now produced by the [[##xwiki-enterprise-ui-all##>>https://github.com/xwiki/xwiki-enterprise/tree/xwiki-enterprise-3.3-milestone-1/xwiki-enterprise-distribution/xwiki-enterprise-ui-all]] module.
86
Thomas Mortagne 1.1 87 == Upgrades ==
88
Sergiu Dumitriu 13.2 89 The following dependencies have been upgraded:
Thomas Mortagne 1.1 90
Sergiu Dumitriu 13.2 91 * CSS4J 0.13
92 * Groovy 1.8.3
Vincent Massol 3.1 93 * JGroups 2.12.2
Sergiu Dumitriu 13.2 94 * reflections 0.9.6
Sergiu Dumitriu 14.1 95 * Selenium 2.11
Vincent Massol 4.1 96 * SLF4J 1.6.3
Thomas Mortagne 1.1 97
98 == Miscellaneous ==
99
Vincent Massol 6.1 100 * Make it simple to add Icon Transformation mappings when using the Rendering in standalone mode
101 * Add support for being able to override components more than once TODO: Document it and linke to the documentation
Vincent Massol 7.1 102 * Bundle the Icon and WikiWord Transformations in the Rendering Standalone JAR
103 * Comments Macro is not bundled in the Rendering Standalone JAR
Vincent Massol 8.1 104 * Allow setting time to live and max entries when using the Cache macro
105 * IRC Bot application improvements
106 * Move to JBoss Infinispan as default cache implementation
Thomas Mortagne 12.1 107 * Application Manager and Wiki Manager plugins now expose a ScriptService and don't need to be added as plugin in xwiki.cfg file anymore. You can access they using {{code language="velocity"}}$services.applicationmanager{{/code}} and {{code language="velocity"}}$services.wikimanager{{/code}}.
Thomas Mortagne 1.1 108
109 == Translations ==
110
Sergiu Dumitriu 13.2 111 The following translations have been updated:
Thomas Mortagne 1.1 112
Sergiu Dumitriu 13.2 113 {{language codes="fr, it, sv, uk"/}}
Thomas Mortagne 1.1 114
115 = Supported Browsers =
116
117 Here's the list of supported browsers for this version (i.e. browsers that we've tested as working):
118
119 {{velocity}}
120 ## name = iexplorer, firefox, chrome, safari, opera
121 {{/velocity}}
122
Sorin Burjan 19.2 123 {{browser name="iexplorer" version="8"/}}
Sorin Burjan 19.3 124
Sorin Burjan 19.2 125 {{browser name="iexplorer" version="9"/}}
Sorin Burjan 19.3 126
Sorin Burjan 19.2 127 {{browser name="firefox" version="3.6.23"/}}
Sorin Burjan 19.3 128
Sorin Burjan 19.2 129 {{browser name="firefox" version="7.0.1"/}}
Sorin Burjan 19.3 130
Sorin Burjan 19.2 131 {{browser name="chrome" version="15"/}}
Thomas Mortagne 1.1 132
133 = Known issues =
134
Thomas Mortagne 21.1 135 * [[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]]
Thomas Mortagne 1.1 136
137 = Test Report =
138
Sorin Burjan 19.4 139 You can check the [[manual test report>>TestReports.ManualTestReportXE33M1#<anchor to test report>]] to learn about what was tested and the results on various browsers.
Thomas Mortagne 1.1 140
141 = Backward Compatibility and Migration Notes =
142
143 == General Notes ==
144
145 {{warning}}
146 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,...//.
147 {{/warning}}
148
149 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
150
151 {{warning}}
152 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.
153 {{/warning}}
154
Sergiu Dumitriu 15.1 155 == Issues specific to XWiki Enterprise 3.3 Milestone 1 ==
Thomas Mortagne 1.1 156
Sergiu Dumitriu 15.1 157 === Default Cache implementation changed ===
Thomas Mortagne 1.1 158
Sergiu Dumitriu 15.1 159 As mentioned above, a new cache implementation based on the successor of JBossCache, Infinispan, has been implemented and selected as the default cache provider. Any custom code that deals with caches should be checked for eventual incompatibilities.
160
161 === Maven XAR plugin behavior changed ===
162
163 The Maven plugin used for packaging XAR modules has been changed so that by default it doesn't bundle the XAR dependencies. This is reflected in the default XE wiki, which now comes in two variants, described [[above>>#HXEandXEMXARchanges]]. If you're counting on the old behavior for your custom projects, you can configure the plugin to bundle dependencies by setting the ##includeDependencies## property to ##true##.
164
Thomas Mortagne 1.1 165 == API Breakages ==
166
Thomas Mortagne 21.1 167 Internals of the filesystem attachment store were moved around, there are not API and were never intended that way and not useful as API but clirr sees them as API so it is technically a break. See: [[XWIKI-7085>>https://jira.xwiki.org/browse/XWIKI-7085]].
Caleb James DeLisle 11.1 168
Thomas Mortagne 1.1 169 The following APIs were modified since <project> <version - 1>:
170
171 {{code language="none"}}
Sergiu Dumitriu 13.1 172 org.xwiki.component.annotation.ComponentAnnotationLoader: In method 'public void initialize(org.xwiki.component.manager.ComponentManager, java.lang.ClassLoader, java.util.List, java.util.List)' the number of arguments has changed
173 com.xpn.xwiki.plugin.applicationmanager.ApplicationManagerPlugin: Removed org.xwiki.observation.EventListener from the set of implemented interfaces
174 com.xpn.xwiki.plugin.applicationmanager.ApplicationManagerPlugin: Method 'public java.util.List getEvents()' has been removed
175 com.xpn.xwiki.plugin.applicationmanager.ApplicationManagerPlugin: Method 'public void onEvent(org.xwiki.observation.event.Event, java.lang.Object, java.lang.Object)' has been removed
176 org.xwiki.cache.eviction.EntryEvictionConfiguration: Method 'public void setAlgotithm(org.xwiki.cache.eviction.EntryEvictionConfiguration$Algorithm)' has been removed
177 org.xwiki.model.reference.ObjectPropertyReferenceResolver: Method 'public org.xwiki.model.reference.ObjectPropertyReference resolve(java.lang.Object, java.lang.Object[])' has been added to an interface
178 org.xwiki.model.reference.ObjectReferenceResolver: Method 'public org.xwiki.model.reference.ObjectReference resolve(java.lang.Object, java.lang.Object[])' has been added to an interface
179 com.xpn.xwiki.api.XWiki: Method 'public com.xpn.xwiki.plugin.query.XWikiQuery createQueryFromRequest(java.lang.String)' has been removed
180 com.xpn.xwiki.api.XWiki: Method 'public java.lang.String displaySearch(java.lang.String, java.lang.String)' has been removed
181 com.xpn.xwiki.api.XWiki: Method 'public java.lang.String displaySearch(java.lang.String, java.lang.String, com.xpn.xwiki.plugin.query.XWikiCriteria)' has been removed
182 com.xpn.xwiki.api.XWiki: Method 'public java.lang.String displaySearch(java.lang.String, java.lang.String, java.lang.String, com.xpn.xwiki.plugin.query.XWikiCriteria)' has been removed
183 com.xpn.xwiki.api.XWiki: Method 'public java.lang.String displaySearchColumns(java.lang.String, com.xpn.xwiki.plugin.query.XWikiQuery)' has been removed
184 com.xpn.xwiki.api.XWiki: Method 'public java.lang.String displaySearchColumns(java.lang.String, java.lang.String, com.xpn.xwiki.plugin.query.XWikiQuery)' has been removed
185 com.xpn.xwiki.api.XWiki: Method 'public java.lang.String displaySearchOrder(java.lang.String, com.xpn.xwiki.plugin.query.XWikiQuery)' has been removed
186 com.xpn.xwiki.api.XWiki: Method 'public java.lang.String displaySearchOrder(java.lang.String, java.lang.String, com.xpn.xwiki.plugin.query.XWikiQuery)' has been removed
187 com.xpn.xwiki.api.XWiki: Method 'public java.util.List search(com.xpn.xwiki.plugin.query.XWikiQuery)' has been removed
188 com.xpn.xwiki.api.XWiki: Method 'public java.lang.String searchAsTable(com.xpn.xwiki.plugin.query.XWikiQuery)' has been removed
189 com.xpn.xwiki.doc.DeletedFilesystemAttachment: Class com.xpn.xwiki.doc.DeletedFilesystemAttachment removed
190 com.xpn.xwiki.doc.FilesystemAttachmentContent: Class com.xpn.xwiki.doc.FilesystemAttachmentContent removed
191 com.xpn.xwiki.doc.ListAttachmentArchive: Class com.xpn.xwiki.doc.ListAttachmentArchive removed
192 com.xpn.xwiki.doc.MutableDeletedFilesystemAttachment: Class com.xpn.xwiki.doc.MutableDeletedFilesystemAttachment removed
193 com.xpn.xwiki.store.AttachmentArchiveDeleteRunnable: Class com.xpn.xwiki.store.AttachmentArchiveDeleteRunnable removed
194 com.xpn.xwiki.store.AttachmentArchiveSaveRunnable: Class com.xpn.xwiki.store.AttachmentArchiveSaveRunnable removed
195 com.xpn.xwiki.store.AttachmentContentStreamProvider: Class com.xpn.xwiki.store.AttachmentContentStreamProvider removed
196 com.xpn.xwiki.store.FilesystemAttachmentRecycleBinStore: Class com.xpn.xwiki.store.FilesystemAttachmentRecycleBinStore removed
197 com.xpn.xwiki.store.FilesystemAttachmentStore: Class com.xpn.xwiki.store.FilesystemAttachmentStore removed
198 com.xpn.xwiki.store.FilesystemAttachmentVersioningStore: Class com.xpn.xwiki.store.FilesystemAttachmentVersioningStore removed
199 com.xpn.xwiki.store.HibernateTransaction: Class com.xpn.xwiki.store.HibernateTransaction removed
200 com.xpn.xwiki.store.XWikiHibernateTransaction: Class com.xpn.xwiki.store.XWikiHibernateTransaction removed
201 org.xwiki.workspace.WorkspaceManagerException: Class org.xwiki.workspace.WorkspaceManagerException removed
Thomas Mortagne 1.1 202 {{/code}}

Get Connected