Skip to content

squid: doc/cephfs: link section for pausing async threads in section for...#62874

Merged
anthonyeleven merged 1 commit intoceph:squidfrom
zdover23:wip-doc-2025-04-18-backport-62300-to-squid
Apr 18, 2025
Merged

squid: doc/cephfs: link section for pausing async threads in section for...#62874
anthonyeleven merged 1 commit intoceph:squidfrom
zdover23:wip-doc-2025-04-18-backport-62300-to-squid

Conversation

@zdover23
Copy link
Contributor

@zdover23 zdover23 commented Apr 18, 2025

disabling volumes plugin part.

Fixes: https://tracker.ceph.com/issues/70479
Signed-off-by: Rishabh Dave ridave@redhat.com
(cherry picked from commit 36cfbfb)

Contribution Guidelines

  • To sign and title your commits, please refer to Submitting Patches to Ceph.

  • If you are submitting a fix for a stable branch (e.g. "quincy"), please refer to Submitting Patches to Ceph - Backports for the proper workflow.

  • When filling out the below checklist, you may click boxes directly in the GitHub web UI. When entering or editing the entire PR message in the GitHub web UI editor, you may also select a checklist item by adding an x between the brackets: [x]. Spaces and capitalization matter when checking off items this way.

Checklist

  • Tracker (select at least one)
    • References tracker ticket
    • Very recent bug; references commit where it was introduced
    • New feature (ticket optional)
    • Doc update (no ticket needed)
    • Code cleanup (no ticket needed)
  • Component impact
    • Affects Dashboard, opened tracker ticket
    • Affects Orchestrator, opened tracker ticket
    • No impact that needs to be tracked
  • Documentation (select at least one)
    • Updates relevant documentation
    • No doc update is appropriate
  • Tests (select at least one)
Show available Jenkins commands

disabling volumes plugin part.

Fixes: https://tracker.ceph.com/issues/70479
Signed-off-by: Rishabh Dave <ridave@redhat.com>
(cherry picked from commit 36cfbfb)
@zdover23 zdover23 requested a review from a team as a code owner April 18, 2025 02:53
@github-actions github-actions bot added cephfs Ceph File System documentation labels Apr 18, 2025
@github-actions github-actions bot added this to the squid milestone Apr 18, 2025
@anthonyeleven anthonyeleven merged commit 532c8ad into ceph:squid Apr 18, 2025
14 checks passed
Comment on lines +131 to +161
* **Dont tweak max_mds** Modifying the FS setting variable ``max_mds`` is
sometimes perceived as a good step during troubleshooting or recovery effort.
Instead, doing so might further destabilize the cluster. If ``max_mds`` must
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:

.. code:: bash

ceph config set mgr mgr/volumes/pause_purging true

To resume purging run::

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:

.. code:: bash

ceph config set mgr mgr/volumes/pause_cloning true

To resume cloning run::

ceph config set mgr mgr/volumes/pause_cloning false
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a note: This backport PR ended up backporting lots of unrelated docs along with docs that shoud've been backported in #60398. See https://github.com/ceph/ceph/pull/62300/files#diff-e904eee3ec04a225e8f903100e5e8e46da8c435ff8d39fdf369fcc5f35ca39e6 for comparison.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cephfs Ceph File System documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants