From a70a6f493acc2f7239198242a861c7e59d2b4265 Mon Sep 17 00:00:00 2001 From: Casey Bodley Date: Wed, 13 Mar 2024 18:20:55 -0400 Subject: [PATCH] doc/radosgw: generalize description of Zone Features so they make sense outside of multisite configurations Signed-off-by: Casey Bodley (cherry picked from commit 0a97eb89e1d9c99e96fd215e9dc31febc2e44de5) --- doc/radosgw/zone-features.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/doc/radosgw/zone-features.rst b/doc/radosgw/zone-features.rst index d397af9db0034..b439fd9dfd26f 100644 --- a/doc/radosgw/zone-features.rst +++ b/doc/radosgw/zone-features.rst @@ -2,9 +2,9 @@ Zone Features ============= -Some multisite features require support from all zones before they can be enabled. Each zone lists its ``supported_features``, and each zonegroup lists its ``enabled_features``. Before a feature can be enabled in the zonegroup, it must be supported by all of its zones. +Some features require support from all cooperating radosgws before they can be enabled. Each zone lists its ``supported_features``, and each zonegroup lists its ``enabled_features``. Before a feature can be enabled in the zonegroup, it must be supported by all of its zones. -On creation of new zones and zonegroups, all known features are supported and some features (see table below) are enabled by default. After upgrading an existing multisite configuration, however, new features must be enabled manually. +On creation of new zones and zonegroups, all known features are supported and some features (see table below) are enabled by default. After upgrading an existing zone, however, new features must be enabled manually. Supported Features ------------------ @@ -62,6 +62,9 @@ On the cluster that contains the given zone: radosgw-admin zone modify --rgw-zone={zone-name} --enable-feature={feature-name} radosgw-admin period update --commit +.. note:: The ``period update`` command only works if the zone belongs to a realm. + Otherwise, all radosgws will need to restart before they notice the change. + Remove support for a zone feature ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- 2.39.5