Skip to content

Commit

Permalink
Merge pull request #11220 from nextcloud/backport/11146/stable25
Browse files Browse the repository at this point in the history
  • Loading branch information
kesselb authored Oct 17, 2023
2 parents 74bb613 + 50f7e89 commit 17b44d0
Showing 1 changed file with 25 additions and 4 deletions.
29 changes: 25 additions & 4 deletions admin_manual/maintenance/restore.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,6 @@ restore:
.. note:: You must have both the database and data directory. You cannot
complete restoration unless you have both of these.

When you have completed your restoration, also make sure to run the
:ref:`maintenance:data-fingerprint <maintenance_commands_label>` command
afterwards, to ensure your sync clients can recover from the restored backup.

Restore folders
---------------

Expand Down Expand Up @@ -82,3 +78,28 @@ PostgreSQL
::

PGPASSWORD="password" psql -h [server] -U [username] -d nextcloud -f nextcloud-sqlbkp.bak

Synchronising with clients after data recovery
----------------------------------------------

By default the Nextcloud server is considered the authorative source for the data.
If the data on the server and the client differs
clients will default to fetching the data from the server.

If the recovered backup is outdated
the state of the clients may be more up to date than the state of the server.
In this case also make sure to run the
:ref:`maintenance:data-fingerprint <maintenance_commands_label>` command
afterwards.
It changes the logic of the synchronisation algorithm
to try an recover as much data as possible.
Files missing on the server are therefore recovered from the clients
and in case of different content the users will be asked.

.. note:: The usage of `maintenance:data-fingerprint` can cause conflict dialogues
and difficulties deleting files on the client.
Therefore it's only recommended to prevent dataloss if the backup was outdated.

If you are running multiple application servers you will need to make sure
the config files are synced between them so that the updated `data-fingerprint`
is applied on all instances.

0 comments on commit 17b44d0

Please sign in to comment.