Changes for page Distribution Wizard
Last modified by Thomas Mortagne on 2023/10/10
From version 93.2
edited by Vincent Massol
on 2017/09/06
on 2017/09/06
Change comment:
Update document after refactoring.
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -11,7 +11,7 @@ 11 11 12 12 = Clean Install = 13 13 14 -After putting your XWiki WAR inside your Servlet Container (Tomcat, Jetty, etc.) you start XWiki. When XWiki is first accessed, it will trigger the Distribution Wizard. If the wizard fails to appear check the [[troubleshooting section>>||anchor="troubleshooting"]]. 14 +After putting your XWiki WAR inside your Servlet Container (Tomcat, Jetty, etc.) you start XWiki. When XWiki is first accessed, it will trigger the Distribution Wizard. If the wizard fails to appear check the [[troubleshooting section>>platform:Features.DistributionWizard||anchor="troubleshooting"]]. 15 15 16 16 == Welcome Step == 17 17 ... ... @@ -164,7 +164,7 @@ 164 164 165 165 Starting with version 7.1 you can record an install or upgrade and replay it on a different wiki: 166 166 167 -* You start by following the steps described in the [[Clean Install>>||anchor="HCleanInstall"]], [[Upgrade>>||anchor="HUpgrade"]] or [[Upgrade with Repair>>||anchor="HUpgradewithRepair"]] sections. The decisions you take (e.g. which extension to repair, which extensions to upgrade, merge conflict resolution, page cleanup) are automatically recorded (the XWiki WAR must have version 7.1+). 167 +* You start by following the steps described in the [[Clean Install>>platform:Features.DistributionWizard||anchor="HCleanInstall"]], [[Upgrade>>platform:Features.DistributionWizard||anchor="HUpgrade"]] or [[Upgrade with Repair>>platform:Features.DistributionWizard||anchor="HUpgradewithRepair"]] sections. The decisions you take (e.g. which extension to repair, which extensions to upgrade, merge conflict resolution, page cleanup) are automatically recorded (the XWiki WAR must have version 7.1+). 168 168 * After you finished with the install/upgrade of the default/recommended UI (XAR), you can install/upgrade additional extensions. 169 169 * Then you go to the [[Extension History>>extensions:Extension.Extension Manager Application||anchor="HExtensionHistory"]] section in the [[wiki administration>>extensions:Extension.Administration Application]] and export the actions that you wish to be replayed on a different wiki 170 170 * Access the wiki where you want to replay the recorded actions. When the Distribution Wizard appears, skip it by choosing the "Replay recorded actions" sub-option of the "Later" button from the Welcome step.((( ... ... @@ -182,7 +182,7 @@ 182 182 183 183 If you're doing a first time install and the Distribution Wizard doesn't appear it's probably because you've copied some directories from an existing install. Namely, the Distribution Wizard looks for status files located in your permanent directory (the ##environment.permanentDirectory## property in ##xwiki.properties##). 184 184 185 -Thus you'll need to remove the ##.../jobs/status/distribution/status.xml## file located inside your permanent directory (##/var/lib/xwiki/...## for [[APT installation>>AdminGuide.InstallationViaAPT]] or ##/var/lib/tomcatX/webapps/...## for [[WAR installation>>AdminGuide.InstallationWAR]]). 185 +Thus you'll need to remove the ##.../jobs/status/distribution/status.xml## file located inside your permanent directory (##/var/lib/xwiki/...## for [[APT installation>>platform:AdminGuide.InstallationViaAPT]] or ##/var/lib/tomcatX/webapps/...## for [[WAR installation>>platform:AdminGuide.InstallationWAR]]). 186 186 187 187 Now, if you have done an upgrade of the XWiki WAR, you'll need to be logged with a user having Admin rights to see the Distribution Wizard appear. 188 188 ... ... @@ -209,7 +209,7 @@ 209 209 1. ((( 210 210 To clear local data in filesystem empty or remove the permanent directory (see environment.permanentDirectory property in xwiki.properties file). 211 211 212 -For example if you have installed XWiki using [[APT>>AdminGuide.InstallationViaAPT]], execute command: 212 +For example if you have installed XWiki using [[APT>>platform:AdminGuide.InstallationViaAPT]], execute command: 213 213 214 214 {{code language="none"}} 215 215 sudo rm -fr /var/lib/xwiki/data /var/cache/tomcat7/Catalina/localhost/xwiki/