doc/cephadm: group MDS sections into one chapter

Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
(cherry picked from commit 1033c46ad79795479fb75bfc8cc5b8116210d501)

diff --git a/doc/cephadm/index.rst b/doc/cephadm/index.rst
index 141517d8038f1e6161861418e1b23351b2f56702..59660e74f069b4816b37e1da4d3b31386c296009 100644 (file)
--- a/doc/cephadm/index.rst
+++ b/doc/cephadm/index.rst
@@ -34,6 +34,7 @@ versions of Ceph.
     mon
     osd
     rgw
+    mds
     nfs
     iscsi
     custom-container

diff --git a/doc/cephadm/install.rst b/doc/cephadm/install.rst
index 8fcd0688f2e065c84fb491000b783c0c2cb8a409..9c0891723bd9701c3fd141385dc19fdb97876381 100644 (file)
--- a/doc/cephadm/install.rst
+++ b/doc/cephadm/install.rst
@@ -235,24 +235,10 @@ available and unused device:
 
 Or See :ref:`cephadm-deploy-osds` for more detailed instructions.
 
+Using Ceph
+==========
 
-Deploy CephFS
-=============
-
-One or more MDS daemons is required to use the CephFS file system.
-These are created automatically if the newer ``ceph fs volume``
-interface is used to create a new file system. For more information,
-see :ref:`fs-volumes-and-subvolumes`.
-
-For example:
-
-.. prompt:: bash #
-
-  ceph fs volume create <fs_name> --placement=""<placement spec>""
-
-See :ref:`orchestrator-cli-stateless-services` for manually deploying
-MDS daemons.
-
+To use the *Ceph Filesystem*, follow :ref:`orchestrator-cli-cephfs`.
 
 To use the *Ceph Object Gateway*, follow :ref:`cephadm-deploy-rgw`.
 

diff --git a/doc/cephadm/mds.rst b/doc/cephadm/mds.rst
new file mode 100644 (file)
index 0000000..fbee8d6
--- /dev/null
+++ b/doc/cephadm/mds.rst
@@ -0,0 +1,46 @@
+===========
+MDS Service
+===========
+
+
+.. _orchestrator-cli-cephfs:
+
+Deploy CephFS
+=============
+
+One or more MDS daemons is required to use the :term:`CephFS` file system.
+These are created automatically if the newer ``ceph fs volume``
+interface is used to create a new file system. For more information,
+see :ref:`fs-volumes-and-subvolumes`.
+
+For example:
+
+.. prompt:: bash #
+
+  ceph fs volume create <fs_name> --placement="<placement spec>"
+
+where ``fs_name`` is the name of the CephFS and ``placement`` is a
+:ref:`orchestrator-cli-placement-spec`.
+
+For manually deploying MDS daemons, use this specification:
+
+.. code-block:: yaml
+
+    service_type: mds
+    service_id: fs_name
+    placement:
+      count: 3
+
+
+The specification can then be applied using:
+
+.. prompt:: bash #
+
+   ceph orch apply -i mds.yaml
+
+See :ref:`orchestrator-cli-stateless-services` for manually deploying
+MDS daemons on the CLI.
+
+
+
+

diff --git a/doc/mgr/orchestrator.rst b/doc/mgr/orchestrator.rst
index 1af9bd3ba08a556e9c3b4e2d0f781d8f40e22ce2..2a634e84d59a54b16b4eb0a49962e9ed3acdb653 100644 (file)
--- a/doc/mgr/orchestrator.rst
+++ b/doc/mgr/orchestrator.rst
@@ -106,21 +106,6 @@ To remove a label, run::
     where ``journal`` is the filestore journal device, ``wal`` is the bluestore
     write ahead log device, and ``all`` stands for all devices associated with the OSD
 
-.. _orchestrator-cli-cephfs:
-
-Deploying CephFS
-================
-
-In order to set up a :term:`CephFS`, execute::
-
-    ceph fs volume create <fs_name> <placement spec>
-
-where ``name`` is the name of the CephFS and ``placement`` is a
-:ref:`orchestrator-cli-placement-spec`.
-
-This command will create the required Ceph pools, create the new
-CephFS, and deploy mds servers.
-
 
 .. _orchestrator-cli-stateless-services: