ceph/doc/cephadm/services/mds.rst

   1 ===========
   2 MDS Service
   3 ===========
   4
   5
   6 .. _orchestrator-cli-cephfs:
   7
   8 Deploy CephFS
   9 =============
  10
  11 One or more MDS daemons is required to use the :term:`CephFS` file system.
  12 These are created automatically if the newer ``ceph fs volume``
  13 interface is used to create a new file system. For more information,
  14 see :ref:`fs-volumes-and-subvolumes`.
  15
  16 For example:
  17
  18 .. prompt:: bash #
  19
  20   ceph fs volume create <fs_name> --placement="<placement spec>"
  21
  22 where ``fs_name`` is the name of the CephFS and ``placement`` is a
  23 :ref:`orchestrator-cli-placement-spec`. For example, to place
  24 MDS daemons for the new ``foo`` volume on hosts labeled with ``mds``:
  25
  26 .. prompt:: bash #
  27
  28   ceph fs volume create foo --placement="label:mds"
  29
  30 You can also update the placement after-the-fact via:
  31
  32 .. prompt:: bash #
  33
  34   ceph orch apply mds foo 'mds-[012]'
  35
  36 For manually deploying MDS daemons, use this specification:
  37
  38 .. code-block:: yaml
  39
  40     service_type: mds
  41     service_id: fs_name
  42     placement:
  43       count: 3
  44       label: mds
  45
  46
  47 The specification can then be applied using:
  48
  49 .. prompt:: bash #
  50
  51    ceph orch apply -i mds.yaml
  52
  53 See :ref:`orchestrator-cli-stateless-services` for manually deploying
  54 MDS daemons on the CLI.
  55
  56 Further Reading
  57 ===============
  58
  59 * :ref:`ceph-file-system`
  60
  61