# How to restart the Distribution Wizard?

**URL:** <https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526>\
**Category:** Help / Discuss\
**Created:** [August 31, 2018, 4:05pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526 "2018-08-31T16:05:28Z")\
**Posts on this page:** 14\
**Page:** 1

<div class="post-metadata">

**Author:** ![laurin1](https://forum.xwiki.org/user_avatar/forum.xwiki.org/laurin1/32/9_2.png) [@laurin1](https://forum.xwiki.org/u/laurin1)\
**Post date:** [August 31, 2018, 4:05pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/1 "2018-08-31T16:05:29Z")

</div>

Upgraded to 10.7. I stopped the XWiki service before I logged in the first, because I had forgotten to leave xwiki.store.migration set to 1 before I started the service the first time and the next time the DW did not appear. Since I was told not to delete the status.xml in this post, [10.3 To 10.4 Upgrade - No update to UI (Flavor) during Distribution Wizard](https://forum.xwiki.org/t/10-3-to-10-4-upgrade-no-update-to-ui-flavor-during-distribution-wizard/3140), how do I get the DW to start?

---

<div class="post-metadata">

**Author:** ![laurin1](https://forum.xwiki.org/user_avatar/forum.xwiki.org/laurin1/32/9_2.png) [@laurin1](https://forum.xwiki.org/u/laurin1)\
**Post date:** [August 31, 2018, 4:09pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/2 "2018-08-31T16:09:39Z")

</div>

Well, scratch that, my upgrade process failed and I’m still on 10.6.1. Still, how do force the DW to run again if we need to?

---

<div class="post-metadata">

**Author:** ![vmassol](https://forum.xwiki.org/user_avatar/forum.xwiki.org/vmassol/32/6_2.png) [@vmassol](https://forum.xwiki.org/u/vmassol)\
**Post date:** [August 31, 2018, 4:15pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/3 "2018-08-31T16:15:48Z")

</div>

The DW will only appear if you’re logged in and logged in as admin (see [https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/DistributionWizard#HThewizardfailstoappearatstartup](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/DistributionWizard#HThewizardfailstoappearatstartup)).

Normally you don’t have to force it, it’ll appear when it should appear 🙂

---

<div class="post-metadata">

**Author:** ![tmortagne](https://forum.xwiki.org/user_avatar/forum.xwiki.org/tmortagne/32/4930_2.png) [@tmortagne](https://forum.xwiki.org/u/tmortagne)\
**Post date:** [August 31, 2018, 6:21pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/4 "2018-08-31T18:21:44Z")

</div>

> how do force the DW to run again if we need to

The DW always appear if there is stuff to do. That’s unless you force it to not appear (by clicking on “Never”) in which case all you can do is remove or modify the status.xml since that’s where this information in stored.

---

<div class="post-metadata">

**Author:** ![laurin1](https://forum.xwiki.org/user_avatar/forum.xwiki.org/laurin1/32/9_2.png) [@laurin1](https://forum.xwiki.org/u/laurin1)\
**Post date:** [August 31, 2018, 7:20pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/5 "2018-08-31T19:20:09Z")

</div>

I’ve had it not appear though in the past, for various reasons. I’d have to go back through my list and find the instances this occurred. So there is no “safe” way to force it to run again?

---

<div class="post-metadata">

**Author:** ![vmassol](https://forum.xwiki.org/user_avatar/forum.xwiki.org/vmassol/32/6_2.png) [@vmassol](https://forum.xwiki.org/u/vmassol)\
**Post date:** [August 31, 2018, 7:47pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/6 "2018-08-31T19:47:25Z")

</div>

> [@laurin1](#):
>
> So there is no “safe” way to force it to run again?

I guess you can edit the status.xml and change the state to force it, but you shouldn’t need to do that, unless you clicked “never”. Did you do that?

@tmortagne I think we need to document this since users can click “never” and then need to run the DW so we probably need to update the doc and explain precisely what to change in this case. WDYT about adding this to [https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/DistributionWizard#HThewizardfailstoappearatstartup](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/DistributionWizard#HThewizardfailstoappearatstartup) ?

---

<div class="post-metadata">

**Author:** ![laurin1](https://forum.xwiki.org/user_avatar/forum.xwiki.org/laurin1/32/9_2.png) [@laurin1](https://forum.xwiki.org/u/laurin1)\
**Post date:** [August 31, 2018, 8:07pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/7 "2018-08-31T20:07:48Z")

</div>

> [@vmassol](#):
>
> unless you clicked “never”. Did you do that?

I don’t think so. Most of the times it works fine, but even in [10.3 To 10.4 Upgrade - No update to UI (Flavor) during Distribution Wizard - #4 by laurin1](https://forum.xwiki.org/t/10-3-to-10-4-upgrade-no-update-to-ui-flavor-during-distribution-wizard/3140/4), I did not get it until I deleted status.xml.

So there are times we might not get it or we should get it on every upgrade?

---

<div class="post-metadata">

**Author:** ![laurin1](https://forum.xwiki.org/user_avatar/forum.xwiki.org/laurin1/32/9_2.png) [@laurin1](https://forum.xwiki.org/u/laurin1)\
**Post date:** [August 30, 2019, 12:18pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/8 "2019-08-30T12:18:21Z")

</div>

This does not appear to have been done. I’m concerned that the DW did not finish completely ([Upgrade 11.5 to 11.6.1 - Navigation Menu Missing / Distribution Wizard Did Not Run](https://forum.xwiki.org/t/upgrade-11-5-to-11-6-1-navigation-menu-missing-distribution-wizard-did-not-run/5370)). Is there not a way to verify this?

---

<div class="post-metadata">

**Author:** ![laurin1](https://forum.xwiki.org/user_avatar/forum.xwiki.org/laurin1/32/9_2.png) [@laurin1](https://forum.xwiki.org/u/laurin1)\
**Post date:** [August 30, 2019, 12:28pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/9 "2019-08-30T12:28:05Z")

</div>

I just went ahead and started the 11.7 upgrade and the DW is running now.

---

<div class="post-metadata">

**Author:** ![laurin1](https://forum.xwiki.org/user_avatar/forum.xwiki.org/laurin1/32/9_2.png) [@laurin1](https://forum.xwiki.org/u/laurin1)\
**Post date:** [August 30, 2019, 1:03pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/10 "2019-08-30T13:03:00Z")

</div>

Well, that worked, up to the point of [Distribution Wizard - Global Administration: Message Stream?](https://forum.xwiki.org/t/distribution-wizard-global-administration-message-stream/5463). Now, I’m in the same boat. Don’t know if DW finished. Can’t restart it.

---

<div class="post-metadata">

**Author:** ![xrichard](https://forum.xwiki.org/user_avatar/forum.xwiki.org/xrichard/32/8779_2.png) [@xrichard](https://forum.xwiki.org/u/xrichard)\
**Post date:** [May 3, 2022, 6:34am UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/11 "2022-05-03T06:34:29Z")

</div>

Hi,

I’m also wondering **how to restart the Distribution Wizard?**

Can you please confirm / clarify:

- if admin “postponed” the upgrade to “later”: when the DW will be automaticaly launched again?
- if admin signed off then signed in again to the wiki: the DW should normally be triggered again?

Maybe answers to these questions can be added to the official page here: [https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/DistributionWizard](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/DistributionWizard)

---

<div class="post-metadata">

**Author:** ![tmortagne](https://forum.xwiki.org/user_avatar/forum.xwiki.org/tmortagne/32/4930_2.png) [@tmortagne](https://forum.xwiki.org/u/tmortagne)\
**Post date:** [May 3, 2022, 7:15am UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/12 "2022-05-03T07:15:50Z")

</div>

> [@xrichard](#):
>
> if admin “postponed” the upgrade to “later”: when the DW will be automaticaly launched again?

Next restart.

> [@xrichard](#):
>
> if admin signed off then signed in again to the wiki: the DW should normally be triggered again?

The triggering of the DW has nothing to do with the user, you need to be admin to access it, but there is only one, running in the background and triggered right after XWiki initialization.

> [@xrichard](#):
>
> Maybe answers to these questions can be added to the official page here: [Distribution Wizard (XWiki.org)](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/DistributionWizard)

I see “ **Later** : DW will prompt you again after XWiki is restarted” in [that page](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/DistributionWizard#HWelcomeStep) (this is also explained when your mouse is over the `Later` button from what I remember) so that part seems covered to me and I feel the other part was also documented, but I updated [https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/DistributionWizard#HCleanInstall](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/DistributionWizard#HCleanInstall) to make it even more clear hopefully

---

<div class="post-metadata">

**Author:** ![xrichard](https://forum.xwiki.org/user_avatar/forum.xwiki.org/xrichard/32/8779_2.png) [@xrichard](https://forum.xwiki.org/u/xrichard)\
**Post date:** [May 3, 2022, 1:31pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/13 "2022-05-03T13:31:19Z")

</div>

@tmortagne thanks for your answers and also for the improvements made to the Documentation 👍.

As far as I understand the DW upgrades extensions? If it’s the case maybe a workaround [1] could be to upgrade all extensions from the admin menu?

[1] because sometimes even admin can not restart XWiki server (for instance on myxwiki).

---

<div class="post-metadata">

**Author:** ![tmortagne](https://forum.xwiki.org/user_avatar/forum.xwiki.org/tmortagne/32/4930_2.png) [@tmortagne](https://forum.xwiki.org/u/tmortagne)\
**Post date:** [May 3, 2022, 1:36pm UTC](https://forum.xwiki.org/t/how-to-restart-the-distribution-wizard/3526/14 "2022-05-03T13:36:00Z")

</div>

> [@xrichard](#):
>
> If it’s the case maybe a workaround [1] could be to upgrade all extensions from the admin menu?

Yes, the DW is mostly a helper around Extension Manager, plus a bit of cleanup (but this part is not always required).
