Wiki source code of Upgrade
Last modified by Eleni Cojocariu on 2026/03/31 15:34
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{warning}} | ||
| 2 | WIP: the whole documentation for the Upgrade topic is being under refactoring. Complete documentation is still in [[Upgrade>>Documentation.AdminGuide.Upgrade.WebHome]]. | ||
| 3 | {{/warning}} | ||
| 4 | |||
| 5 | You can upgrade your XWiki instance to newer versions to stay up to date, benefit from the best new features and keep your data safe from security threats. | ||
| 6 | |||
| 7 | Before proceeding with an upgrade, it is strongly recommended to: | ||
| 8 | |||
| 9 | 1. [[Backup your data>>xwiki:Documentation.AdminGuide.Backup]].((( | ||
| 10 | * Create a full backup of your data, just in case something goes wrong with the update/[[downgrade>>Documentation.AdminGuide.Upgrade.WebHome||anchor="HDowngrading"]]. | ||
| 11 | ))) | ||
| 12 | 1. [[Upgrade the extensions first>>extensions:Extension.Extension Manager Application||anchor="HUpgrade"]].((( | ||
| 13 | * It is recommended to update all installed extensions to make sure that all they are up to date since new versions might contain compatibility fixes that would have otherwise preventing the new version fully start. | ||
| 14 | ))) | ||
| 15 | 1. Check the [[Release Notes>>xwiki:ReleaseNotes.WebHome]].((( | ||
| 16 | * Review the release notes for the versions between your current version and the target version. | ||
| 17 | * Pay special attention to sections titled {{code language="none"}}"Issues specific to XWiki <version>"{{/code}} and to any changes in [[hardware of software requirements (prerequisites)>>documentation.xs.admin.installation.prerequisites.WebHome]]. | ||
| 18 | ))) | ||
| 19 | |||
| 20 | There are multiple methods to upgrade XWiki depending on how many data you need to migrate or how experienced you are with different tools. In the majority of cases an upgrade consists of two parts: | ||
| 21 | |||
| 22 | ((( | ||
| 23 | * Part 1: [[Upgrading the distribution>>documentation.xs.admin.upgrade.distribution.WebHome]] (server side). | ||
| 24 | * Part 2: [[Upgrading the flavor>>documentation.xs.admin.upgrade.flavor.WebHome]] (wiki Pages). | ||
| 25 | ))) |
