Skip to content

Commit 3044bf7

Browse files
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 <[email protected]>
1 parent 3ae1930 commit 3044bf7

File tree

2 files changed

+14
-5
lines changed

2 files changed

+14
-5
lines changed

doc/cephfs/fs-volumes.rst

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -44,11 +44,14 @@ Create a volume by running the following command:
4444

4545
.. prompt:: bash #
4646

47-
ceph fs volume create <vol_name> [placement]
48-
49-
This creates a CephFS file system and its data and metadata pools. This command
50-
can also deploy MDS daemons for the filesystem using a Ceph Manager orchestrator
51-
module (for example Rook). See :doc:`/mgr/orchestrator`.
47+
ceph fs volume create <vol_name> [placement] [--data-pool <data-pool-name>] [--meta-pool <metadata-pool-name>]
48+
49+
This creates a CephFS file system and its data and metadata pools. Alternately,
50+
if the data pool and/or metadata pool needed for creating a CephFS volume
51+
already exist, these pool names can be passed to this command so that the
52+
volume is created using these existing pools. This command can also deploy MDS
53+
daemons for the filesystem using a Ceph Manager orchestrator module (for
54+
example Rook). See :doc:`/mgr/orchestrator`.
5255

5356
``<vol_name>`` is the volume name (an arbitrary string). ``[placement]`` is an
5457
optional string that specifies the :ref:`orchestrator-cli-placement-spec` for

doc/cephfs/multifs.rst

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,12 @@ support the new file system. The deployment technology used, e.g. cephadm, will
2929
also configure the MDS affinity (see: :ref:`mds-join-fs`) of new MDS daemons to
3030
operate the new file system.
3131

32+
If the data and metadata pools for the volume are already present, the names of
33+
these pool(s) can be passed as follows::
34+
35+
ceph fs volume create <vol-name> --meta-pool <meta-pool-name> --data-pool <data-pool-name>
36+
37+
3238

3339
Securing access
3440
---------------

0 commit comments

Comments
 (0)