Add doc to migrate from OC 10.5 to NC 20.0

Signed-off-by: Vincent Petry <vincent@nextcloud.com>
This commit is contained in:
Vincent Petry 2021-01-12 18:09:24 +01:00 committed by backportbot[bot]
parent 0769a047cb
commit 3e377419a5
2 changed files with 25 additions and 8 deletions

View File

@ -57,6 +57,8 @@ access your server using the Internet. For example::
URL to call: http[s]://<domain-of-your-server>/nextcloud/cron.php
.. _system-cron-configuration-label:
Cron
^^^^
@ -103,7 +105,7 @@ This approach requires two files: **nextcloudcron.service** and **nextcloudcron.
[Unit]
Description=Nextcloud cron.php job
[Service]
User=www-data
ExecStart=/usr/bin/php -f /var/www/nextcloud/cron.php
@ -119,12 +121,12 @@ Note that the **.service** unit file does not need an ``[Install]`` section. Ple
[Unit]
Description=Run Nextcloud cron.php every 5 minutes
[Timer]
OnBootSec=5min
OnUnitActiveSec=5min
Unit=nextcloudcron.service
[Install]
WantedBy=timers.target

View File

@ -15,7 +15,9 @@ See the table below for a version map, where migrating is easily possible:
+-------------------+------------------------------+
| ownCloud | Nextcloud |
+===================+==============================+
| 10.0.1 or later | 12.0.x (but at least 12.0.1) |
| 10.0.5 or later | 20.0.x (but at least 20.0.5) |
+-------------------+------------------------------+
| 10.0.1 - 10.0.5 | 12.0.x (but at least 12.0.1) |
+-------------------+------------------------------+
| 10.0.0 | 12.0.0 |
+-------------------+------------------------------+
@ -34,8 +36,21 @@ See the table below for a version map, where migrating is easily possible:
so we can at least perform some basic migration tests, before you
migrate your production instance.
After downloading the correct version of Nextcloud from our
`older releases page <https://nextcloud.com/changelog/>`_,
proceed like described in the :doc:`manual_upgrade` manual.
1. First download the correct version of Nextcloud from our `older releases page <https://nextcloud.com/changelog/>`_,
Afterwards you can use the Nextcloud updater to update your instance to the newest version.
2. Make sure to have do a :doc:`backup<backup>` before migrating.
3. Follow the upgrade instructions described in the :doc:`manual_upgrade` manual.
4. When migrating to Nextcloud 20.0 or later, you will also need to run the following commands after ``occ upgrade``:
* ``occ db:convert-filecache-bigint``
* ``occ db:add-missing-columns``
* ``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<system-cron-configuration-label>`
6. Use the :doc:`Nextcloud built-in updater<update>` to update your instance to the newest version.
7. Make sure to also verify the "Security & setup warnings" in the "Overview" section on the settings page.