Distribution Wizard Does Not Appear at Startup
Explanation
The Distribution Wizard does not open when XWiki is started, although the instance has just been installed or upgraded.
Cause
The wizard records what it has already done in the jobs/status/3/distribution sub-directory of the permanent directory. An instance whose permanent directory was copied from another install therefore starts with the record of a run that is already finished, and the wizard has no reason to open.
After an upgrade of the XWiki WAR, the wizard also stays closed until a user who has administration rights logs in.
Solution
Delete the status.xml.zip file from that sub-directory, restart XWiki, and log in with a user who has administration rights.
FAQ
Does the wizard need Internet access to open?
No. It opens whether or not the instance can reach the Internet, and needs the connection only to download the extensions it installs.
How is the wizard opened again on a wiki that is already set up?
By emptying the instance, as described in Rerun the Distribution Wizard on an Empty Instance.
