From: Sebastian Wagner Date: Thu, 25 Feb 2021 14:14:36 +0000 (+0100) Subject: doc/cephadm: group MDS sections into one chapter X-Git-Tag: v16.2.0~119^2~40 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=ee2a8bef04115cc846726e4cb97a5d6916fbcf7f;p=ceph.git doc/cephadm: group MDS sections into one chapter Signed-off-by: Sebastian Wagner (cherry picked from commit 1033c46ad79795479fb75bfc8cc5b8116210d501) --- diff --git a/doc/cephadm/index.rst b/doc/cephadm/index.rst index 141517d8038f..59660e74f069 100644 --- 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 8fcd0688f2e0..9c0891723bd9 100644 --- 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 --placement="""" - -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 index 000000000000..fbee8d6bdc29 --- /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 --placement="" + +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 1af9bd3ba08a..2a634e84d59a 100644 --- 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 - -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: