From dfe18632d726c17a87ecb41b43fb2d40391cfc0e Mon Sep 17 00:00:00 2001 From: Ferdinand Thiessen Date: Wed, 9 Apr 2025 21:11:39 +0200 Subject: [PATCH] fix(admin): adjust ownCloud migration path 10.14 and 10.15 are tested by doing major by major migrations. Co-authored-by: Ferdinand Thiessen Co-authored-by: rakekniven <2069590+rakekniven@users.noreply.github.com> Signed-off-by: Ferdinand Thiessen --- .../maintenance/migrating_owncloud.rst | 26 ++++++++++++++----- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/admin_manual/maintenance/migrating_owncloud.rst b/admin_manual/maintenance/migrating_owncloud.rst index 1650ea6cc..983a9915f 100644 --- a/admin_manual/maintenance/migrating_owncloud.rst +++ b/admin_manual/maintenance/migrating_owncloud.rst @@ -15,7 +15,9 @@ See the table below for a version map, where migrating is easily possible: +-------------------+-------------------------------+ | ownCloud | Nextcloud | +===================+===============================+ -| 10.13.x | 25.0.x (but at least 25.0.13) | +| 10.13.x | 25.0.13 | +| 10.14.x | 25.0.13 | +| 10.15.x | 25.0.13 | +-------------------+-------------------------------+ .. note:: Since ownCloud does not and will not support PHP 8.0 or higher, you @@ -37,13 +39,23 @@ See the table below for a version map, where migrating is easily possible: * ``occ db:add-missing-indices`` * ``occ db:add-missing-primary-keys`` -5. If system cron was used, please verify if crontab entry was using the command ``occ system:cron``. If yes, please adjust it to use the ``php`` command instead according to :ref:`the background jobs configuration documentation` +5. If system cron was used, please verify if crontab entry was using the command ``occ system:cron``. + If yes, please adjust it to use the ``php`` command instead according to :ref:`the background jobs configuration documentation` -6. Use the :doc:`Nextcloud built-in updater` to update your instance to the newest version. +6. As Nextcloud 25 is the last Nextcloud version supporting PHP 7 you need to upgrade your PHP installation afterwards to continue updating to current Nextcloud release. + We recommend to update PHP to version 8.1 before continuing with the updates. -7. Make sure to also verify the "Security & setup warnings" in the "Overview" section on the settings page. +7. Use the :doc:`Nextcloud built-in updater` to update your instance to the newest version. + This must be done for every major version, since updates between multiple major versions are not supported. + So the update path would be: 26 → 27.1 → 28 → 29 → 30 → 31. -8. In some cases, apps installed from the ownCloud Market might have been disabled as incompatible - (ex: calendar and contacts), so you should reinstall the Nextcloud ones using - ``occ app:enable calendar``, ``occ app:enable contacts``, etc +8. When reaching Nextcloud 30 or 31 we recommend to update PHP again to a current version like PHP 8.3. + You can do so also in between, as PHP 8.2 is already supported since Nextcloud 26 and PHP 8.3 since Nextcloud 28, + but in most cases it is easier to first complete the Nextcloud version updates. + +9. Make sure to also verify the "Security & setup warnings" in the "Overview" section on the settings page. + +10. In some cases, apps installed from the ownCloud Market might have been disabled as incompatible + (ex: calendar and contacts), so you should reinstall the Nextcloud ones using + ``occ app:enable calendar``, ``occ app:enable contacts``, etc