From 9ed69cf2c9c532300c2a796ff067d54025bb599a Mon Sep 17 00:00:00 2001
From: Vasil Averyanau <vasil.averyanau@scylladb.com>
Date: Tue, 3 Dec 2024 12:56:38 +0100
Subject: [PATCH] chore(docs): how to avoid restore and backup/repair task
 interference

This documents how to prevent interference between restore and backup/repair
tasks.

Fixes: #3742
---
 docs/source/restore/index.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/source/restore/index.rst b/docs/source/restore/index.rst
index cbc4a94d9..67948c894 100644
--- a/docs/source/restore/index.rst
+++ b/docs/source/restore/index.rst
@@ -85,3 +85,18 @@ Restore speed is controlled by many parameters (see :ref:`sctool restore <sctool
 The ``--unpin-agent-cpu`` is disabled by default, but in case you observe small download
 bandwidth, you could try to :ref:`pause <task-stop>` restore task, :ref:`update <restore-update>` it with ``--unpin-agent-cpu``,
 and :ref:`resume <task-start>` it.
+
+Interference with backup and repair tasks
+=========================================
+
+It is advisable to manually make sure that the restore task does not interfere with backup or repair tasks.
+
+#. Do not start backup or repair tasks when restore task is running.
+#. If scheduled runs of backup or repair tasks can interfier with restore task, then disable them until restore is complete::
+
+    # check Next column to determine when next run of a task is scheduled 
+    $ sctool tasks -a
+
+    # disable repair/backup tasks if needed
+    $ sctool repair update -c CLUSTER-ID SCHEDULED-REPAIR-TASK-ID --enabled=false
+    $ sctool backup update -c CLUSTER-ID SCHEDULED-BACKUP-TASK-ID --enabled=false