summaryrefslogtreecommitdiffstats
path: root/src/ceph/doc/rados/deployment/ceph-deploy-mds.rst
blob: d2afaec3d46b1a5fe3b4ddae7cef8cb27c148c0a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
============================
 Add/Remove Metadata Server
============================

With ``ceph-deploy``, adding and removing metadata servers is a simple task. You
just add or remove one or more metadata servers on the command line with one
command.

.. important:: You must deploy at least one metadata server to use CephFS.
    There is experimental support for running multiple metadata servers.
    Do not run multiple active metadata servers in production.

See `MDS Config Reference`_ for details on configuring metadata servers.


Add a Metadata Server
=====================

Once you deploy monitors and OSDs you may deploy the metadata server(s). ::

	ceph-deploy mds create {host-name}[:{daemon-name}] [{host-name}[:{daemon-name}] ...]

You may specify a daemon instance a name (optional) if you would like to run
multiple daemons on a single server.


Remove a Metadata Server
========================

Coming soon...

.. If you have a metadata server in your cluster that you'd like to remove, you may use 
.. the ``destroy`` option. :: 

..	ceph-deploy mds destroy {host-name}[:{daemon-name}] [{host-name}[:{daemon-name}] ...]

.. You may specify a daemon instance a name (optional) if you would like to destroy
.. a particular daemon that runs on a single server with multiple MDS daemons.
 
.. .. note:: Ensure that if you remove a metadata server, the remaining metadata
   servers will be able to service requests from CephFS clients. If that is not
   possible, consider adding a metadata server before destroying the metadata 
   server you would like to take offline.


.. _MDS Config Reference: ../../../cephfs/mds-config-ref