From 18060073f14809645c27d99c72c4109216f5631c Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Tue, 4 Apr 2023 13:59:46 +1000 Subject: [PATCH] doc/rados/operations: Acting Set question Clear up a paragraph that describes the behavior of the Acting Set. https://tracker.ceph.com/issues/58485 Signed-off-by: Zac Dover (cherry picked from commit 3bc9cfd83b3b836775433c7f1b075fe397b56463) --- doc/rados/operations/monitoring-osd-pg.rst | 11 ++++++----- doc/rados/operations/pg-concepts.rst | 2 ++ 2 files changed, 8 insertions(+), 5 deletions(-) diff --git a/doc/rados/operations/monitoring-osd-pg.rst b/doc/rados/operations/monitoring-osd-pg.rst index 39c0b08f48a82..3ddf1a5f6551d 100644 --- a/doc/rados/operations/monitoring-osd-pg.rst +++ b/doc/rados/operations/monitoring-osd-pg.rst @@ -117,11 +117,12 @@ pseudo-random placement that takes into account the failure domains that you have set in your `CRUSH map`_; for this reason, PGs are rarely assigned to immediately adjacent OSDs in a large cluster. -Ceph processes a client request using the **Acting Set**, which is the set of -OSDs that will actually handle the requests since they have a full and working -version of a placement group shard. The set of OSDs that should contain a shard -of a particular placement group as the **Up Set**, i.e. where data is -moved/copied to (or planned to be). +Ceph processes client requests with the **Acting Set** of OSDs: this is the set +of OSDs that currently have a full and working version of a PG shard and that +are therefore responsible for handling requests. By contrast, the **Up Set** is +the set of OSDs that contain a shard of a specific PG. Data is moved or copied +to the **Up Set**, or planned to be moved or copied, to the **Up Set**. See +:ref:`Placement Group Concepts `. Sometimes an OSD in the Acting Set is ``down`` or otherwise unable to service requests for objects in the PG. When this kind of situation diff --git a/doc/rados/operations/pg-concepts.rst b/doc/rados/operations/pg-concepts.rst index 636d6bf9a1e5b..83062b53a1d94 100644 --- a/doc/rados/operations/pg-concepts.rst +++ b/doc/rados/operations/pg-concepts.rst @@ -1,3 +1,5 @@ +.. _rados_operations_pg_concepts: + ========================== Placement Group Concepts ========================== -- 2.39.5