From 44e9082ffd89b604c4f7dd2bc2a2a92c3093ed21 Mon Sep 17 00:00:00 2001 From: Rishabh Dave Date: Mon, 3 Mar 2025 22:06:10 +0530 Subject: [PATCH] doc/cephfs: mention new options for "fs volume create" cmd Command "ceph fs volume create" accepts 2 new options to allow users to pass data and metadata pool name. Update docs to include mention of both the options. Signed-off-by: Rishabh Dave (cherry picked from commit 3044bf7e4b667fb5de5062c41e22e866fc6bb9a6) --- doc/cephfs/fs-volumes.rst | 13 ++++++++----- doc/cephfs/multifs.rst | 6 ++++++ 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/doc/cephfs/fs-volumes.rst b/doc/cephfs/fs-volumes.rst index d313cfe471f..c83c8b04b56 100644 --- a/doc/cephfs/fs-volumes.rst +++ b/doc/cephfs/fs-volumes.rst @@ -44,11 +44,14 @@ Create a volume by running the following command: .. prompt:: bash # - ceph fs volume create [placement] - -This creates a CephFS file system and its data and metadata pools. This command -can also deploy MDS daemons for the filesystem using a Ceph Manager orchestrator -module (for example Rook). See :doc:`/mgr/orchestrator`. + ceph fs volume create [placement] [--data-pool ] [--meta-pool ] + +This creates a CephFS file system and its data and metadata pools. Alternately, +if the data pool and/or metadata pool needed for creating a CephFS volume +already exist, these pool names can be passed to this command so that the +volume is created using these existing pools. This command can also deploy MDS +daemons for the filesystem using a Ceph Manager orchestrator module (for +example Rook). See :doc:`/mgr/orchestrator`. ```` is the volume name (an arbitrary string). ``[placement]`` is an optional string that specifies the :ref:`orchestrator-cli-placement-spec` for diff --git a/doc/cephfs/multifs.rst b/doc/cephfs/multifs.rst index 2dcba7ae006..8a001052ce4 100644 --- a/doc/cephfs/multifs.rst +++ b/doc/cephfs/multifs.rst @@ -29,6 +29,12 @@ support the new file system. The deployment technology used, e.g. cephadm, will also configure the MDS affinity (see: :ref:`mds-join-fs`) of new MDS daemons to operate the new file system. +If the data and metadata pools for the volume are already present, the names of +these pool(s) can be passed as follows:: + + ceph fs volume create --meta-pool --data-pool + + Securing access --------------- -- 2.39.5