Wiki source code of Upgrade the Demo Package
Last modified by Eleni Cojocariu on 2026/08/13 15:14
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | To upgrade an XWiki instance installed from the [[standalone (demo) distribution>>documentation.xs.admin.installation.methods.install-standalone-demo-distribution.WebHome]], install the new version beside the old one and move your data across: | ||
| 2 | |||
| 3 | 1. Back up the [[configuration files>>Documentation.AdminGuide.Backup||anchor="HConfigurationfiles"]], the [[permanent data>>Documentation.AdminGuide.Backup||anchor="HBackupPermanentData"]] (the /##data## directory, which already contains the HSQLDB database) and, optionally, the [[log files>>Documentation.AdminGuide.Backup||anchor="HBackupLogfiles"]]. | ||
| 4 | 1. Check the [[Release Notes>>xwiki:ReleaseNotes.WebHome]] of every version between the one you are running and the one you are upgrading to, in particular the sections named {{code language="none"}}"Issues specific to XWiki <version>"{{/code}} and any change to the [[prerequisites>>documentation.xs.admin.installation.prerequisites.WebHome]]. | ||
| 5 | 1. [[Download the new version>>documentation.xs.admin.installation.methods.install-standalone-demo-distribution.WebHome||anchor="HDownloadStandalone"]] as you did when installing the distribution. | ||
| 6 | 1. Stop the XWiki instance, to prevent file corruption and database inconsistencies. | ||
| 7 | 1. [[Install the new version>>documentation.xs.admin.installation.methods.install-standalone-demo-distribution.WebHome||anchor="HInstallStandalone"]] in a different directory, keeping both installations. | ||
| 8 | 1. Keep the new configuration files when you never customized the old ones, and otherwise merge the old files into the new ones instead of copying them over, since the new version may have added options. | ||
| 9 | 1. Copy the ##data## directory from the old instance to the new one. | ||
| 10 | 1. Check that migrations are enabled, as described in [[Database Upgrade>>documentation.xs.admin.upgrade.distribution.database-upgrade.WebHome]]. | ||
| 11 | 1. Start the new instance. | ||
| 12 | 1. [[Upgrade the flavor>>documentation.xs.admin.upgrade.flavor.WebHome]] from a browser, which the Distribution Wizard offers as soon as you log in. | ||
| 13 | |||
| 14 | The new instance then serves the content of the old one, which stays untouched in its own directory until you remove it. |
