Changes for page Upgrading

Last modified by Vincent Massol on 2023/11/14

<
From version < 30.1 >
edited by Ecaterina Moraru (Valica)
on 2018/10/12
To version < 31.1 >
edited by Thomas Mortagne
on 2018/10/12
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.evalica
1 +XWiki.ThomasMortagne
Content
... ... @@ -117,7 +117,7 @@
117 117  
118 118  == (% class="label label-primary" %)Part 2(%%) Upgrading the flavor ==
119 119  
120 -=== (% class="label label-default" %)Method 2.A(%%) Using Distribution Wizard ===
120 +=== Using Distribution Wizard ===
121 121  
122 122  (% class="label label-success" %)Recommended(%%) The recommended way to upgrade an XWiki installation is to use the [[Distribution Wizard>>platform:Features.DistributionWizard]] which is automatically triggered after you upgrade the XWiki WAR. It allows you to automatically upgrade extensions installed in your wiki, supporting automatic merges and conflict resolution.
123 123  
... ... @@ -139,22 +139,6 @@
139 139  If you have already done the upgrade with a user not having Programming Rights, then log in with a user having those permissions (or ask someone who has them), [[navigate to those pages>>xwiki:FAQ.How can I navigate to a given page]], edit them (using the wiki editor preferably) and save them without any modification.
140 140  {{/warning}}
141 141  
142 -=== (% class="label label-default" %)Method 2.B(%%) Using Manual Import ===
143 -
144 -(% class="label label-warning" %)Old versions < 4.3(%%) Prior to XWiki 4.3, Distribution Wizard didn't existed and you had to perform the upgrade manually as explained below.
145 -
146 -As mentioned in the [[Installing the Default Wiki XAR section>>xwiki:Documentation.AdminGuide.InstallationWAR||acnhor="HInstallingtheDefaultWikiXAR"]] you should be very careful and when doing the import make sure you selectively decide what pages you wish to import. More specifically the following pages should be imported with great care:
147 -
148 -* XWiki.XWikiPreferences: This page contains some configuration of your wiki (it overrides the configuration defined in ##xwiki.cfg##). If you import a new version of this page you'll lose any customization you may have made such as the skin to use, the rights for your wiki, etc.
149 -* XWiki.WebPreferences, Main.WebPreferences, and all other spaces WebPreferences pages: Same as XWiki.XWikiPreferences but at the level of a space
150 -* XWiki.XWikiAllGroup (list of registered users) and XWiki.AdminGroup (list of Admins): If you have existing users and import a new version of these pages, you'll find that your users do not belong to these groups anymore and thus may not be able to edit pages, log in, etc. You'll need to add them again to the right groups
151 -* XWiki.Admin: This page contains the Admin user with the default password. If you import it you'll create a security hole. Thus it's very important not to import this page
152 -* *.*Config: These are configuration pages and thus must not be overwritten. Some examples:
153 -** XWiki.RegistrationConfig: Contains Registration configuration of your wiki
154 -** Invitation.InvitationConfig: Configuration for the [[Invitation Application>>extensions:Extension.Invitation Application]]
155 -* XWiki.XWikiServerXwiki (multi wiki): This page contains the server descriptors and wiki properties
156 -* Any other page you have modified, such as Main.WebHome, a modified Panel, etc.
157 -
158 158  ----
159 159  
160 160  == (% class="label label-default" %)Alternative(%%) Start fresh, plus Export and Reimport your data ==

Get Connected