Version 4.1 by Marius Dumitru Florea on 2012/07/12

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 This release fixes a serious issue preventing the migration from version 3.5.1 and earlier (especially when the wiki had statistics data in the database).
6 This version also provide a new migration procedure that is almost 200 times faster, fixing the problematic downtime for large wikis and wiki farm.
7
8 = New and Noteworthy (since XWiki Enterprise 4.1.2) =
9
10 == Full Issue List ==
11
12 {{jira style="list" url="http://jira.xwiki.org" jql="true"}}
13 Project in ("XWiki Commons", "XWiki Rendering", "XWiki Platform", "XWiki Enterprise", "XWiki Enterprise Manager") and fixVersion in ("4.1.3") and resolution in ("Fixed")
14 {{/jira}}
15
16 == Extension Manager improvements ==
17
18 * When displaying a conflict during XAR extension install the right future author of the document is indicated for "next" and "merged" versions.
19 * Indicate the language of the imported document in the log when installing a XAR extension
20
21 = Known issues =
22
23 * [[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]]
24
25 = Backward Compatibility and Migration Notes =
26
27 == General Notes ==
28
29 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
30
31 {{warning}}
32 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(s) to the new schema. Make sure you backup your Database before doing anything.
33 {{/warning}}
34
35 == New migration R40000XWIKI6990 ==
36
37 A new id migration procedure is now used per default. It provide a 200x speed improvement compare to the original one, but in some rare cases, it could failed to migrate your database properly. **It is really important that you keep a backup of your database ready in case of failure**. If you encounter an issue with this new faster procedure, you may want to try the older procedure by first restoring your original database, and by adding the following line in your xwiki.cfg before restarting xwiki.
38
39 {{code}}
40 xwiki.store.migration.R40000XWIKI6990.safemode=1
41 {{/code}}
42
43 This will trigger the old, slower, but potentially safer mode for migrating your data.
44
45 If you still encounter issues while migrating your data, please ask us on our user mailing list and do not forget to provide a link to your failing logs so we may provide helpful hints.
46
47 == Comments stored with a custom mapping or custom annotation class ==
48
49 If you happened to use a custom mapping for storing ##XWiki.XWikiComments## objects in a separate table, you may have experienced problems with the migration ##R40001XWIKI7540##. Dealing with custom mappings is outside the scope of the migration so now, if such a custom mapping is detected, the migration is simply skipped. The migration is also skipped if you use a custom annotation class for your annotation objects, other than the default ##AnnotationCode.AnnotationClass##.
50
51 If you are in one of the two cases above and the migration is skipped, you will want to make sure that the ##Annotations## docextra tab is still visible. To make it visible, set ##Administration > Look & Feel > Page Elements > Document metadata visibility > Show document annotations## to ##Yes##. You will continue to use your custom annotations (in the Annotations tab) or custom mapped comments (in the Comments tab) as before, without them being merged into one Comments tab, as it happens by default in the latest versions.
52
53 Please see {{jira style="enum" url="http://jira.xwiki.org"}}XWIKI-8036{{/jira}} for more details.
54
55 == Custom displayers in the XWikiUsers class ==
56
57 If you have added some custom displayers to new or existing fields in the ##XWiki.XWikiUsers## class, you need to check and make sure that they are written in the currently default wiki syntax. This is required because the XWikiUsers document will now always be forced to use the currently default wiki syntax, no matter what syntax you save it with. If your custom displayers are written in 1.0 syntax, for example, and the class document is in 2.1 syntax, they will not render.
58
59 == Issues specific to XWiki Enterprise 4.1.3 ==
60
61 Nothing specific.
62
63 == API Breakages ==
64
65 No breakage.

Get Connected