Distribution Wizard
Explanation
The Distribution Wizard is the tool XWiki opens in the browser when an instance is not ready to be used yet. It provisions an empty wiki with a flavor, registers the user who owns the wiki, and brings the wiki content up to date after the distribution has been upgraded.
The wizard carries no content of its own: it drives the Extension Manager, which resolves the extensions matching the running XWiki version and downloads them from the remote repositories. An instance with no access to the Internet needs those extensions available locally before the wizard can complete.
Whether the wizard opens, and what it offers once it does, depends on the state of the instance and on its configuration:
Every run walks through the same sequence of steps. What the run achieves is the reason it was started:
- Install the Flavor Using the Distribution Wizard, on the first start of a freshly installed instance.
- Upgrade the Standard Flavor of the Wiki Using the Distribution Wizard, on the first start after the distribution was upgraded.
- Repair the Previously Installed Flavor, when the Extension Manager has no record of the user interface that was installed before and the wizard asks for it.
- Replay a Recorded Install or Upgrade, to apply on another wiki the decisions taken during one of the runs above.
- Rerun the Distribution Wizard on an Empty Instance, to start over on a wiki that has already been set up.
If the wizard does not open when you expect it, see Distribution Wizard Does Not Appear at Startup.
FAQ
Who is allowed to run the Distribution Wizard?
A user with administration rights on the wiki, or the superadmin user while the database is still empty. Upgrading the flavor also requires Programming Rights.
Can the Distribution Wizard be removed from the wiki?
No. It is part of the XWiki distribution rather than an extension, so it can only be configured not to start.
More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.
