Wiki source code of ReleaseNotesXWiki10RC2

Last modified by Thomas Mortagne on 2017/03/24

Show last authors
1 1 Release Notes for XWiki 1.0 RC 2
2
3 The 1.0 RC 2 release fixes the last important bugs leading to the final 1.0 release. If no new important bugs are found one week after the RC2 release, it'll be automatically promoted as the final 1.0 release. If important bugs are found, we may have to go through a 1.0 RC 3 release and repeat the process.
4
5 #toc("" "" "")
6
7 1.1 Changes from 1.0 RC 1
8
9 * Several important bugs fixed:
10 ** PDF generation fails if a header text is repeated due to TOC numbering in headings
11 ** Filter conflict: external links can be rendered two times
12 ** Generated heading id-s are not unique
13 ** Save & Continue button switches you from the Global Rights tab to the Preferences tab
14 ** Levels and Users properties are saved with an extra empty value
15 ** Fail to import a XAR exported with history
16 ** Calling \$xwiki\.refreshLinks\() do not seem to generate backlinks for all pages
17 ** XML content inside \{code\} macro is rendered in the WYSIWYG editor
18 ** Bug when deleting attachment with accent with XWiki in UTF-8 encoding
19 ** Empty groups on XWiki.XWikiAllGroup, XWiki.XWikiAdminGroup and XWiki.XWikiGroupTemplate
20 ** Empty rights in Global Rights and in some spaces
21 ** Missing PDF templates for new PDF export configuration feature
22 ** Edition of a user do not show empty fields any more
23 ** Only if in the style macro has icon parameter then apply stylemacro class for the default value of class parameter.(to show icon image)
24 ** Do not display the register link if the current user do not have the register right
25 ** Global access levels are displayed in the local rights editor
26 ** The editor (wiki and wysiwyg) textarea in new skin don't fill 100% the editor panel
27 ** Cannot create pages with non ASCII characters in the XWiki standalone distribution
28 * Document that importing documents will replace the existing versions and specially explain how to import XWiki user documents
29 * Improve documentation for the Attachment and Skins pages of the User Guide
30
31 #error("IMPORTANT: XWiki 1.0 RC 2 fixes an important security issue in past releases where passwords were stored in clear in the database. Passwords are now hashed. If you are upgrading from a previous version, any new user or any password update will automatically get the password hashed. However existing users who do not change their passwords will still have their passwords in clear in the database. Thus, we are providing {attach:a tool to automatically hash all passwords from an existing database|file=CryptPasswords.xar}. Start by backuping your wiki by doing an export or backuping your database. Then import that XAR into your wiki (be sure to be logged as an Admin) and then go to the Admin.CryptPasswords and follow the instructions there.")
32
33 See the [full list of changes>https://jira.xwiki.org/secure/ReleaseNote.jspa?version=10230&styleName=Html&projectId=10010&Create=Create].
34
35 1.1 Known issues
36
37 * [Bugs we know about>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&&type=1&pid=10010&resolution=-1&sorter/field=updated&sorter/order=DESC]
38 * Backlinks are used to find all the links to rename when renaming a page. However backlinks are saved when a page is saved thus it may happen that you don't have all backlinks generated with a clean XWiki database. In this special case, you can call the following in a page to refresh all links (you'll need to be admin to do this):
39 {code}
40 \$\xwiki\.\refreshLinks\()
41 {code}
42
43 1.1 Migrating from versions prior or equal to XWiki 1.0 Beta 4
44
45 This is only for users using a custom ~~web.xml~~ file. We have changed slightly the way to configure XWiki in XWiki 1.0 Beta 5. Namely we have changed the way XWiki is initialized. Before we were initializing Velocity by using the ~~VelocityViewServlet~~ in ~~web.xml~~. This has been removed and we've added a ~~InitializationServletContextListener~~ class to perform all required XWiki initializations (right now we're only initializing Velocity). Thus you'll need to do the following starting from 1.0 Beta 5 onwards:
46
47 # Remove the VelocityViewServlet from your web.xml
48 # Add the following 2 elements to your web.xml: context-param, listener. Here's an example:
49
50 {code:xml}
51 <web-app>
52 ...
53 <description>XWiki Application</description>
54
55 <!-- Define context level parameters for XWiki's initialization -->
56 <context-param>
57 <param-name>org.apache.velocity.properties</param-name>
58 <param-value>/WEB-INF/velocity.properties</param-value>
59 <description>Velocity's configuration</description>
60 </context-param>
61
62 <filter>
63 ...
64 </filter-mapping>
65
66 <!-- XWiki's initialization is done in a Servlet Context Listener. This is where we set up
67 everything that should be initialized prior to XWiki servicing requests. For example this
68 is where we initialize Velocity. -->
69 <listener>
70 <listener-class>com.xpn.xwiki.web.InitializationServletContextListener</listener-class>
71 </listener>
72
73 <servlet>
74 ...
75 {code}
76
77 #warning("In addition if you're upgrading an existing installation make sure you remove previous version of the Velocity JARs located in ~~xwiki/WEB-INF/lib~~ (Velocity and Velocity-Tools) and replace them with the new versions (Velocity 1.5 Beta 2 and Velocity-Tools 1.3) which can be found in the standalone distribution (the .exe or .tar.gz version)")
78
79 Make sure you check the additional migration notes for the specific version you're migrating from below.
80
81 1.1 Migration from 1.0 Beta 2, Beta 3, Beta 4, Beta 5, Beta 6 or 1.0 RC 1
82
83 * Start by making a backup of your current database.
84 * Plug your new XWiki install to point to your database.
85 * [Import>platform:AdminGuide.ImportExport] the latest version of the [Panels application>extensions:Extension.Panels Application] to ensure you have the most up to date Panels in your wiki. Be careful that existing Panels which are also in the Panels Application will be overwritten (new Panels you have created won't be touched). Note that this is an optional step but recommended if you haven't upgraded to the latest XWiki version for a long time as there might be improvements in the Panels.
86
87 1.1 Migration from 1.0 Beta 1
88
89 * Start by making a backup of your current database.
90 * Plug your new XWiki install to point to your database.
91 * In order to be able to let users switch from "simple" to "advanced" modes, you should import the new XWiki.XWikiUsers and XWiki.XWikiUserSheet pages in your wiki. You can do that by importing the [full XAR>xwiki:Main.Download] and then selecting only that page to be imported in the Import tab of the Administration view.
92 * You should also reimport the [Panels Application>extensions:Extension.Panels Application] since several bugs have been fixed.
93
94 1.1 Migration from 0.9.x versions
95
96 * Start by making a backup of your current database.
97 * Then there are 2 possible use cases:
98 ** __You want to keep your existing skin__. In that case, simply [install>platform:AdminGuide.Installation] the new version and point it to your existing database.
99 ** __You want to use the new 1.0 skin with your current database__. In that case, [install>platform:AdminGuide.Installation] the new version and point it to your existing database. Then start XWiki and [import>platform:AdminGuide.ImportExport] the [Panels XAR>extensions:Extension.Panels Application] (this is required as the new skin makes use of them). Last, go to your wiki Administration page and in the skin section, enter "xwiki10b1".
100 * In order to be able to let users switch from "simple" to "advanced" modes, you should import the new XWiki.XWikiUsers and XWiki.XWikiUserSheet pages in your wiki. You can do that by importing the [full XAR>xwiki:Main.Download] and then selecting only that page to be imported in the Import tab of the Administration view.
101
102 Contact us on the [mailing list>dev:Community.MailingLists] if you're experiencing any problem. Just make sure you have your current database backed up before you do anything.
103

Get Connected