Steps

To move an existing XWiki instance to a different server and upgrade it, run the two operations one after the other rather than together:

1. Install on the new server the same XWiki version as the one running on the old server.
2. Move the database and the permanent data to the new server.
3. Start the instance on the new server.
4. Check that the content and the features work as they did on the old server.
5. Upgrade the instance, both the distribution and the flavor.
6. Check that the wiki reports the new version at the bottom of any page.

   

FAQ

Why should the server migration be separated from the XWiki upgrade process?

Separating the two makes it easier to identify and fix problems, instead of mixing infrastructure issues with data migration issues.

Can I move and upgrade in one operation, by exporting the content into a new instance?

That is the export/import method, which applies none of the data migrations a regular upgrade performs, so keep it for the cases where nothing else works.

Related

• Upgrade the Flavor Using the Export/Import Method.