Changes for page Distribution Wizard

Last modified by Thomas Mortagne on 2023/10/10

<
From version < 49.4 >
edited by panyasan
on 2014/03/06
To version < 50.1 >
edited by Vincent Massol
on 2014/03/07
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.panyasan
1 +XWiki.VincentMassol
Content
... ... @@ -4,11 +4,11 @@
4 4  
5 5  Starting with XWiki 4.2, the Distribution Wizard (also known as DW) was introduced as an experimental feature which helps users migrate their XWiki instances to newer versions without having to manually import the XAR (wiki pages) corresponding to their new version.
6 6  
7 -XWiki's Distribution Wizard comes as an aid to ease the migration and installation of the desired user interface (UI, the default set of wiki pages) in your flavour. It works using XWiki's Extension Manager to automatically detect your XWiki version to search, resolve, download and install the UI corresponding to your version. It requires an internet conection in order to work.
7 +XWiki's Distribution Wizard comes as an aid to ease the migration and installation of the desired user interface (UI, the default set of wiki pages) in your flavour. It works using XWiki's Extension Manager to automatically detect your XWiki version to search, resolve, download and install the UI corresponding to your version. It requires an internet connection in order to work.
8 8  
9 9  = Clean Install =
10 10  
11 -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.
11 +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"]].
12 12  
13 13  == Welcome Step ==
14 14  
... ... @@ -103,3 +103,15 @@
103 103  If you have multiple wikis, then the **Wikis** step will allow you to repair the user interface on each of the available wikis. The process is the same as for the main wiki, the one described above.
104 104  
105 105  {{image reference="dw-wikisStep-repairPreviousUI.png" /}}
106 +
107 +{{id name="troubleshooting/}}
108 += Troubleshooting =
109 +
110 +== The wizard fails to appear at startup ==
111 +
112 +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##).
113 +
114 +Thus you'll need to remove the ##jobs/status/distribution/status.xml## file located inside your permanent directory.
115 +
116 +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.
117 +

Get Connected