From 36cfbfb0eacbfbd459558d1bdff699daf8fae575 Mon Sep 17 00:00:00 2001 From: Rishabh Dave Date: Fri, 14 Mar 2025 18:09:56 +0530 Subject: [PATCH] doc/cephfs: link section for pausing async threads in section for... disabling volumes plugin part. Fixes: https://tracker.ceph.com/issues/70479 Signed-off-by: Rishabh Dave --- doc/cephfs/fs-volumes.rst | 3 ++- doc/cephfs/troubleshooting.rst | 2 ++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/doc/cephfs/fs-volumes.rst b/doc/cephfs/fs-volumes.rst index bf3f79e693b..1652923f038 100644 --- a/doc/cephfs/fs-volumes.rst +++ b/doc/cephfs/fs-volumes.rst @@ -1588,7 +1588,8 @@ services on the Ceph cluster accessed through this plugin. Before resorting to a measure as drastic as this, it is a good idea to try less drastic measures and then assess if the file system experience has improved due to it. One example of such less drastic measure is to disable asynchronous -threads launched by volumes plugins for cloning and purging trash. +threads launched by volumes plugins for cloning and purging trash. For details +on these see: :ref:`pause-purge-threads` and :ref:`pause-clone-threads`. .. _manila: https://github.com/openstack/manila diff --git a/doc/cephfs/troubleshooting.rst b/doc/cephfs/troubleshooting.rst index 56ab3406fb5..0efe3440c91 100644 --- a/doc/cephfs/troubleshooting.rst +++ b/doc/cephfs/troubleshooting.rst @@ -134,6 +134,7 @@ things to do: be changed in such circumstances, run the command to change ``max_mds`` with the confirmation flag (``--yes-i-really-mean-it``) +.. _pause-purge-threads: * **Turn off async purge threads** The volumes plugin spawns threads for asynchronously purging trashed/deleted subvolumes. To help troubleshooting or recovery effort, these purge threads can be disabled using: @@ -146,6 +147,7 @@ things to do: ceph config set mgr mgr/volumes/pause_purging false +.. _pause-clone-threads: * **Turn off async cloner threads** The volumes plugin spawns threads for asynchronously cloning subvolume snapshots. To help troubleshooting or recovery effort, these cloner threads can be disabled using: -- 2.39.5