Upgrade / Major migration paths

[lab-at-nohl]

Help with Updates - including historical installations

In addition to the Wiki chapter on Updates I'd like to discuss all problems related to Upgrades here. Hopefully we can build an archive for issues while updating. I am happy to share my notes here that I collected over several years.

Rules of discussion

Put every series into its own comment and answer to that. Like this:

+ Help with Updates (the opening comment)
|
+ 2020.08 to 2021.02
|   + Please help with update
|   + Suggesstion for this series
|
+ 2020.02 to 2020.08
|   + ...
|

Tine 2.0 Updates will change the Database and/or the Virtual File System.
Always make a full Backup before a Update/Upgrade attempt.

In case of errors, please state your PHP version and MySQL or MariaDB version. Please try to include a log file, level DEBUG, while upgrading.

General Upgrade procedure

Please keep in mind that major upgrades are compatible to the last minor update only.

Thus, at the beginning update to the latest minor in a series (20xx.02.1 --> 20xx.02.5). Only then do the upgrade to the next series (20xx.08.3), whereas you do not need to use the smallest minor of a series (note the minor version 3 not 1 necessarily). All versions mentioned are examples only.

[lab-at-nohl]

2020.08 to 2021.02

Updated from 2020.08.8 to 2021.02.1 without any difficulties yesterday. Updated from 2020.08.7 before.
Major change, PHP 7.4 is required!

[lab-at-nohl]

2021.02 to 2021.12

I used 2021.02.1 to upgrade to 2021.02.1. However, you can find 2021.02.4 in packages, this version should be used for upgrade officially.

[lab-at-nohl]

2021.12 to 2022.12

The first yearly community release, 2022.12. is published. While it works very good out of the box, I recommend some of the improvements of the following nightlies like 2022.12.10.61 (for ldap users see also #7426).

PHP 8.0 is recommended but PHP 7.4 also works.