From e76604224c0e74bbb3350743910d263c6591fd26 Mon Sep 17 00:00:00 2001 From: Dan van der Ster Date: Tue, 12 Mar 2019 16:42:25 +0100 Subject: [PATCH] doc: describe metadata_heap cleanup Fixes: http://tracker.ceph.com/issues/18174 Signed-off-by: Dan van der Ster --- doc/radosgw/pools.rst | 2 ++ doc/radosgw/troubleshooting.rst | 31 +++++++++++++++++++++++++++++++ 2 files changed, 33 insertions(+) diff --git a/doc/radosgw/pools.rst b/doc/radosgw/pools.rst index 2d88a3c103b..a904883b36c 100644 --- a/doc/radosgw/pools.rst +++ b/doc/radosgw/pools.rst @@ -22,6 +22,8 @@ placement groups for these pools. See `Pools `__ for details on pool creation. +.. _radosgw-pool-namespaces: + Pool Namespaces =============== diff --git a/doc/radosgw/troubleshooting.rst b/doc/radosgw/troubleshooting.rst index 69c2627258b..4a084e82a7a 100644 --- a/doc/radosgw/troubleshooting.rst +++ b/doc/radosgw/troubleshooting.rst @@ -175,3 +175,34 @@ Also, check to ensure that the default site is disabled. :: +Numerous objects in default.rgw.meta pool +========================================= + +Clusters created prior to *jewel* have a metadata archival feature enabled by default, using the ``default.rgw.meta`` pool. +This archive keeps all old versions of user and bucket metadata, resulting in large numbers of objects in the ``default.rgw.meta`` pool. + +Disabling the Metadata Heap +--------------------------- + +Users who want to disable this feature going forward should set the ``metadata_heap`` field to an empty string ``""``:: + + $ radosgw-admin zone get --rgw-zone=default > zone.json + [edit zone.json, setting "metadata_heap": ""] + $ radosgw-admin zone set --rgw-zone=default --infile=zone.json + $ radosgw-admin period update --commit + +This will stop new metadata from being written to the ``default.rgw.meta`` pool, but does not remove any existing objects or pool. + +Cleaning the Metadata Heap Pool +------------------------------- + +Clusters created prior to *jewel* normally use ``default.rgw.meta`` only for the metadata archival feature. + +However, from *luminous* onwards, radosgw uses :ref:`Pool Namespaces ` within ``default.rgw.meta`` for an entirely different purpose, that is, to store ``user_keys`` and other critical metadata. + +Users should check zone configuration before proceeding any cleanup procedures:: + + $ radosgw-admin zone get --rgw-zone=default | grep default.rgw.meta + [should not match any strings] + +Having confirmed that the pool is not used for any purpose, users may safely delete all objects in the ``default.rgw.meta`` pool, or optionally, delete the entire pool itself.