Upgrade xwiki from 8.4.3 to latest version

Hello all,

I have a xwiki in version 8.4.3 and the database is a Postgresql 9.5. Since this version is already very old and also the server system on which this runs is no longer current I would like to upgrade the xwiki to the latest version or install the latest version on a new server and then migrate the data.

Is it possible to migrate the data as well as the DB from this old version to the new one? The problem is that the xwiki has grown a lot over the years and there are some plugins. No data should be lost. I have been trying to migrate this for some time but it has never worked properly. Is there anyone here who has experienced a similar scenario and can possibly tell me the points how and what needs to be done.

The other question is I read that the installation on Debian 9 is officially supported, would an installation on RHEL 8 also work?

Thanks in advance for the answers

Yes, this should not be a problem. The important thing if you move to a different server is to move the exact same version of XWiki on the new system and only then upgrade XWiki.

You will have to give more detail as XWiki is designed to support this use case.

XWiki provides a Debian package, but that’s not the only way to install XWiki and what is officially supported is more expressed in terms of Java, database engine and Servlet contains versions (it’s just that the Debian package rely on supported version of Java and Tomcat). The differences between the various Linux systems should not have a noticeable impact on XWiki side.

Sorry for the late feedback.

Currently our xwiki system is on a Windows 2012 R2 server, it should move to a current server hardware and since xwiki runs better with Linux we wanted to use the latest Debian version.
It means that if I want to migrate xwiki, I first have to bring the current xwiki version including Postgres DB to the new server.
If I now install the xwiki on Debian, the current xwiki system is automatically on it.

Is there maybe a tutorial or a HowTo for this?

Translated with DeepL

The steps are as follow:

Backup of the database and the directory is no problem so far.

But how do I get the “old” xwiki 8.4.3 for Debian so I can install it on a current debian OS?
Because I can as far as I have now noticed xwiki update only when I have restored this to the new server.

This is not really an XWiki thing, you will have to use the backup tool of your database (mysqldump for MySQL for example).

I have tried several times now, how can I install an old xwiki on a new Debian system to be able to update it.

I can’t find any info on the xwiki page where to get the old v8.

What did you try and what did not work ? Or you just did not really try anything because you could not find the 8.4.3 packages ? You don’t necessarily need to actually run XWiki 8.4.3 but the database/permanent dir need to look exactly like an 8.4.3 one so that the new version can migrate it properly.

Maybe an easier way for you would be to install the new version the way you intend it to be setup and when it’s all OK you wipe and replace the database and permanent directory content by the one coming from the old installation so that it does the migration and the upgrade of extensions.

What I have done so far is this:

  • New server installed with Debian 11
  • Installed the latest xwiki version with Postgresql DB on the Debian server.
  • Postgresql DB backed up from old system
  • Restored the DB on the new PSQL15
  • Permanent Directory, WAR, Config Files,… restored on new system

I did everything as described on the xwiki page, also with the adjustments of the paths because I moved from Windows to Linux.

Only restore the permanent directory.

For the config file, all you need to do is re-apply whatever customization you used to have in the old version than make sense in the new one too. Don’t just replace the new one with the old.

Of course, do that while XWiki is not running. Once you are done and you start XWiki, it will migrate the database and permanent directory and upgrade to the new flavor version.