From 9a9c4f9ee9b9af31822e929572b543f886f4d61c Mon Sep 17 00:00:00 2001 From: Dhairya Parmar Date: Sun, 18 Jun 2023 17:27:58 +0530 Subject: [PATCH] doc/cephfs: document usage of set option with 'fs new' Fixes: https://tracker.ceph.com/issues/58072 Signed-off-by: Dhairya Parmar --- doc/cephfs/createfs.rst | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/doc/cephfs/createfs.rst b/doc/cephfs/createfs.rst index 4a282e562fe3c..ce91660c2ef2e 100644 --- a/doc/cephfs/createfs.rst +++ b/doc/cephfs/createfs.rst @@ -52,13 +52,16 @@ Once the pools are created, you may enable the file system using the ``fs new`` .. code:: bash - $ ceph fs new [--force] [--allow-dangerous-metadata-overlay] [] [--recover] + $ ceph fs new [--force] [--allow-dangerous-metadata-overlay] [] [--recover] [--yes-i-really-really-mean-it] [...] This command creates a new file system with specified metadata and data pool. The specified data pool is the default data pool and cannot be changed once set. Each file system has its own set of MDS daemons assigned to ranks so ensure that you have sufficient standby daemons available to accommodate the new file system. +.. note:: + ``--yes-i-really-really-mean-it`` may be used for some ``fs set`` commands + The ``--force`` option is used to achieve any of the following: - To set an erasure-coded pool for the default data pool. Use of an EC pool for the @@ -82,11 +85,14 @@ failed. So when a MDS daemon eventually picks up rank 0, the daemon reads the existing in-RADOS metadata and doesn't overwrite it. The flag also prevents the standby MDS daemons to join the file system. +The ``set`` option allows to set multiple options supported by ``fs set`` +atomically with the creation of the file system. + For example: .. code:: bash - $ ceph fs new cephfs cephfs_metadata cephfs_data + $ ceph fs new cephfs cephfs_metadata cephfs_data set max_mds 2 allow_standby_replay true $ ceph fs ls name: cephfs, metadata pool: cephfs_metadata, data pools: [cephfs_data ] -- 2.39.5