Wiki source code of Rerun the Distribution Wizard on an Empty Instance
Last modified by Eleni Cojocariu-testing account on 2026/08/21 16:52
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Emptying an instance makes the [[Distribution Wizard>>doc:documentation.xs.admin.distribution-wizard.WebHome]] run from the start again on a wiki that has already been set up, which is how a test instance is brought back to the state of a fresh install. | ||
| 2 | |||
| 3 | 1. Stop the Servlet Container. | ||
| 4 | 1. Drop and recreate the main database, and drop the databases of the subwikis if the farm has any. With MySQL:((( | ||
| 5 | {{code language="sql"}} | ||
| 6 | DROP DATABASE xwiki; | ||
| 7 | CREATE DATABASE xwiki CHARACTER SET utf8mb4 COLLATE utf8mb4_bin; | ||
| 8 | GRANT ALL PRIVILEGES ON xwiki.* TO 'xwiki'@'localhost'; | ||
| 9 | {{/code}} | ||
| 10 | ))) | ||
| 11 | 1. Empty the [[permanent directory>>doc:documentation.xs.admin.configuration.directories.permanent-directory.WebHome]], which is the ##environment.permanentDirectory## property of ##xwiki.properties##. On an installation from the Debian packages:((( | ||
| 12 | {{code language="bash"}} | ||
| 13 | sudo rm -rf /var/lib/xwiki/data | ||
| 14 | {{/code}} | ||
| 15 | ))) | ||
| 16 | 1. Start the Servlet Container and open the wiki in a browser. | ||
| 17 | 1. The Distribution Wizard greets you as on a new install, as follows:((( | ||
| 18 | {{image reference="wizard-welcome-empty-instance.png" size="extra" alt="The Welcome step of the Distribution Wizard on an instance whose database and permanent directory have been emptied"/}} | ||
| 19 | ))) |
