Wiki source code of ReleaseNotesXWiki10RC1

Last modified by Thomas Mortagne on 2020/01/28

Show last authors
1 1 Release Notes for XWiki 1.0 RC 1
2
3 The 1.0 RC 1 release is meant to have fixed all important bugs leading to a final 1.0 release. If no new important bugs are found in the 1 to 2 weeks after the RC1 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 2 release and repeat the process. Compared to 1.0 Beta 6, the RC 1 release is a bug fix release with some minor improvements (see details below).
4
5 #toc("" "" "")
6
7 1.1 Changes from 1.0 Beta 6
8
9 * [Lots of bugs fixed>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&&type=1&pid=10010&fixfor=10173&sorter/field=issuekey&sorter/order=DESC]
10 * Updated French translation
11 * New translation: Simplified Chinese and Russian
12 * Search is now case insensitive in the default Wiki for all DBMS (it was working fine for MySQL previously)
13 * Ability to navigate backlinks documents on the Rename page
14 * Lucene plugin is now working
15 * Fixed \#skype macro which is now using Skype's Presence Service (was previously using jyve.com which is not working anymore)
16 * New [\#pagedViewLinks macro>extensions:Extension.Paged View Links Macro] that displays links to the first, previous, next and last pages in a paged view
17 * Lots of Macros have been documented on the [Extensions wiki>extensions:Main.WebHome]
18 * Non ASCII chars can now be used in document names and attachments (This requires correct [encoding configuration>platform:AdminGuide.Encoding])
19 * Superadmin is set to use the [Advanced editing mode>platform:Features.PageEditing#HSimpleandAdvancededitionmodes] by default (was in Simple mode)
20 * \{style\} macro now [supports border and icon attributes>extensions:Extension.Style Macro (Radeox)]
21 * Added [support for Oracle>platform:AdminGuide.InstallationOracle]
22
23 See the [full list of changes>https://jira.xwiki.org/secure/ReleaseNote.jspa?version=10173&styleName=Html&projectId=10010&Create=Create].
24
25 1.1 Known issues
26
27 * [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]
28 * 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):
29 {code}
30 \$\xwiki\.\refreshLinks\()
31 {code}
32
33 1.1 Migrating from versions prior or equal to XWiki 1.0 Beta 4
34
35 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:
36
37 # Remove the VelocityViewServlet from your web.xml
38 # Add the following 2 elements to your web.xml: context-param, listener. Here's an example:
39
40 {code:xml}
41 <web-app>
42 ...
43 <description>XWiki Application</description>
44
45 <!-- Define context level parameters for XWiki's initialization -->
46 <context-param>
47 <param-name>org.apache.velocity.properties</param-name>
48 <param-value>/WEB-INF/velocity.properties</param-value>
49 <description>Velocity's configuration</description>
50 </context-param>
51
52 <filter>
53 ...
54 </filter-mapping>
55
56 <!-- XWiki's initialization is done in a Servlet Context Listener. This is where we set up
57 everything that should be initialized prior to XWiki servicing requests. For example this
58 is where we initialize Velocity. -->
59 <listener>
60 <listener-class>com.xpn.xwiki.web.InitializationServletContextListener</listener-class>
61 </listener>
62
63 <servlet>
64 ...
65 {code}
66
67 #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)")
68
69 Make sure you check the additional migration notes for the specific version you're migrating from below.
70
71 1.1 Migration from 1.0 Beta 2, Beta 3, Beta 4, Beta 5 or Beta 6
72
73 * Start by making a backup of your current database.
74 * Plug your new XWiki install to point to your database.
75 * [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).
76
77 1.1 Migration from 1.0 Beta 1
78
79 * Start by making a backup of your current database.
80 * Plug your new XWiki install to point to your database.
81 * 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.
82 * You should also reimport the [Panels Application>extensions:Extension.Panels Application] since several bugs have been fixed.
83
84 1.1 Migration from 0.9.x versions
85
86 * Start by making a backup of your current database.
87 * Then there are 2 possible use cases:
88 ** __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.
89 ** __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".
90 * 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>Main.Download] and then selecting only that page to be imported in the Import tab of the Administration view.
91
92 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.
93

Get Connected