From d4ed4223d914328361528990f89f1ee4acd30e79 Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Fri, 19 May 2023 07:07:02 +1000 Subject: [PATCH] doc/radosgw: explain multisite dynamic sharding Add a note to doc/radosgw/dynamicresharding.rst and a note to doc/radosgw/multisite.rst that explains that dynamic resharding is not supported in releases prior to Reef. This commit is made in response to a request from Mathias Chapelain. Co-authored-by: Anthony D'Atri Signed-off-by: Zac Dover --- doc/radosgw/dynamicresharding.rst | 5 +++-- doc/radosgw/multisite.rst | 15 ++++++++++++--- 2 files changed, 15 insertions(+), 5 deletions(-) diff --git a/doc/radosgw/dynamicresharding.rst b/doc/radosgw/dynamicresharding.rst index 19a2a2b468284..db4ab57befe0a 100644 --- a/doc/radosgw/dynamicresharding.rst +++ b/doc/radosgw/dynamicresharding.rst @@ -37,8 +37,9 @@ resharding tasks, one at a time. Multisite ========= -Dynamic resharding is not supported in a multisite environment. - +Prior to the Reef release, RGW does not support dynamic resharding in a +multisite environment. For information on dynamic resharding, see +:ref:`Resharding ` in the RGW multisite documentation. Configuration ============= diff --git a/doc/radosgw/multisite.rst b/doc/radosgw/multisite.rst index ac0b17a5deec6..471e85892d666 100644 --- a/doc/radosgw/multisite.rst +++ b/doc/radosgw/multisite.rst @@ -1582,14 +1582,23 @@ Supported Features .. _feature_resharding: -resharding +Resharding ~~~~~~~~~~ -Allows buckets to be resharded in a multisite configuration without interrupting the replication of their objects. When ``rgw_dynamic_resharding`` is enabled, it runs on each zone independently, and zones may choose different shard counts for the same bucket. When buckets are resharded manually with ``radosgw-admin bucket reshard``, only that zone's bucket is modified. A zone feature should only be marked as supported after all of its radosgws and osds have upgraded. +This feature allows buckets to be resharded in a multisite configuration +without interrupting the replication of their objects. When +``rgw_dynamic_resharding`` is enabled, it runs on each zone independently, and +zones may choose different shard counts for the same bucket. When buckets are +resharded manually with ``radosgw-admin bucket reshard``, only that zone's +bucket is modified. A zone feature should only be marked as supported after all +of its RGWs and OSDs have upgraded. + +.. note:: Dynamic resharding is not supported in multisite deployments prior to + the Reef release. Commands ------------------ +-------- Add support for a zone feature ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~