src/ceph/doc/rados/deployment/ceph-deploy-mds.rst

   1 ============================
   2  Add/Remove Metadata Server
   3 ============================
   4
   5 With ``ceph-deploy``, adding and removing metadata servers is a simple task. You
   6 just add or remove one or more metadata servers on the command line with one
   7 command.
   8
   9 .. important:: You must deploy at least one metadata server to use CephFS.
  10     There is experimental support for running multiple metadata servers.
  11     Do not run multiple active metadata servers in production.
  12
  13 See `MDS Config Reference`_ for details on configuring metadata servers.
  14
  15
  16 Add a Metadata Server
  17 =====================
  18
  19 Once you deploy monitors and OSDs you may deploy the metadata server(s). ::
  20
  21         ceph-deploy mds create {host-name}[:{daemon-name}] [{host-name}[:{daemon-name}] ...]
  22
  23 You may specify a daemon instance a name (optional) if you would like to run
  24 multiple daemons on a single server.
  25
  26
  27 Remove a Metadata Server
  28 ========================
  29
  30 Coming soon...
  31
  32 .. If you have a metadata server in your cluster that you'd like to remove, you may use
  33 .. the ``destroy`` option. ::
  34
  35 ..      ceph-deploy mds destroy {host-name}[:{daemon-name}] [{host-name}[:{daemon-name}] ...]
  36
  37 .. You may specify a daemon instance a name (optional) if you would like to destroy
  38 .. a particular daemon that runs on a single server with multiple MDS daemons.
  39
  40 .. .. note:: Ensure that if you remove a metadata server, the remaining metadata
  41    servers will be able to service requests from CephFS clients. If that is not
  42    possible, consider adding a metadata server before destroying the metadata
  43    server you would like to take offline.
  44
  45
  46 .. _MDS Config Reference: ../../../cephfs/mds-config-ref