From: Neeraj Pratap Singh Date: Tue, 28 Jun 2022 13:29:03 +0000 (+0530) Subject: doc: Add command to check the presence of any subvolumegroup/subvolume X-Git-Tag: v18.0.0~344^2~1 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=1c5fe5188aac8ac5394b591c73db40e8faf9a5b6;p=ceph.git doc: Add command to check the presence of any subvolumegroup/subvolume Fixes: https://tracker.ceph.com/issues/55821 Signed-off-by: Neeraj Pratap Singh --- diff --git a/doc/cephfs/fs-volumes.rst b/doc/cephfs/fs-volumes.rst index c3b5b1390cbd..55bd7b40d9d1 100644 --- a/doc/cephfs/fs-volumes.rst +++ b/doc/cephfs/fs-volumes.rst @@ -152,6 +152,16 @@ The output format is json and contains fields as follows. * created_at: time of creation of subvolume group in the format "YYYY-MM-DD HH:MM:SS" * data_pool: data pool the subvolume group belongs to +Check the presence of any subvolume group using:: + + $ ceph fs subvolumegroup exist + +The strings returned by the 'exist' command: + * "subvolumegroup exists": if any subvolumegroup is present + * "no subvolumegroup exists": if no subvolumegroup is present + +.. note:: It checks for the presence of custom groups and not the default one. To validate the emptiness of the volume, subvolumegroup existence check alone is not sufficient. The subvolume existence also needs to be checked as there might be subvolumes in the default group. + Resize a subvolume group using:: $ ceph fs subvolumegroup resize [--no_shrink] @@ -292,6 +302,14 @@ List subvolumes using:: .. note:: subvolumes that are removed but have snapshots retained, are also listed. +Check the presence of any subvolume using:: + + $ ceph fs subvolume exist [--group_name ] + +The strings returned by the 'exist' command: + * "subvolume exists": if any subvolume of given group_name is present + * "no subvolume exists": if no subvolume of given group_name is present + Set custom metadata on the subvolume as a key-value pair using:: $ ceph fs subvolume metadata set [--group_name ]