From 26a18fca808c0048f7a7eb53e3660670138aba7f Mon Sep 17 00:00:00 2001 From: Rishabh Dave Date: Wed, 25 Sep 2019 13:03:09 +0530 Subject: [PATCH] doc: move MDS deployment from main quick start to CephFS quick start Signed-off-by: Rishabh Dave --- doc/start/quick-ceph-deploy.rst | 24 +++++--------------- doc/start/quick-cephfs.rst | 40 +++++++++++++++++++++++++++++++++ 2 files changed, 46 insertions(+), 18 deletions(-) diff --git a/doc/start/quick-ceph-deploy.rst b/doc/start/quick-ceph-deploy.rst index 84b0998c00f..c9fe534840c 100644 --- a/doc/start/quick-ceph-deploy.rst +++ b/doc/start/quick-ceph-deploy.rst @@ -11,7 +11,7 @@ explore Ceph functionality. As a first exercise, create a Ceph Storage Cluster with one Ceph Monitor and three Ceph OSD Daemons. Once the cluster reaches a ``active + clean`` state, expand it -by adding a fourth Ceph OSD Daemon, a Metadata Server and two more Ceph Monitors. +by adding a fourth Ceph OSD Daemon, and two more Ceph Monitors. For best results, create a directory on your admin node for maintaining the configuration files and keys that ``ceph-deploy`` generates for your cluster. :: @@ -152,18 +152,18 @@ configuration details, perform the following steps using ``ceph-deploy``. Expanding Your Cluster ====================== -Once you have a basic cluster up and running, the next step is to -expand cluster. Add a Ceph Metadata Server to ``node1``. Then add a -Ceph Monitor and Ceph Manager to ``node2`` and ``node3`` to improve reliability and availability. +Once you have a basic cluster up and running, the next step is to expand +cluster. Then add a Ceph Monitor and Ceph Manager to ``node2`` and ``node3`` +to improve reliability and availability. .. ditaa:: /------------------\ /----------------\ | ceph-deploy | | node1 | | Admin Node | | cCCC | - | +-------->+ mon.node1 | + | +-------->+ | + | | | mon.node1 | | | | osd.0 | | | | mgr.node1 | - | | | mds.node1 | \---------+--------/ \----------------/ | | /----------------\ @@ -182,18 +182,6 @@ Ceph Monitor and Ceph Manager to ``node2`` and ``node3`` to improve reliability | mon.node3 | \----------------/ -Add a Metadata Server ---------------------- - -To use CephFS, you need at least one metadata server. Execute the following to -create a metadata server:: - - ceph-deploy mds create {ceph-node} - -For example:: - - ceph-deploy mds create node1 - Adding Monitors --------------- diff --git a/doc/start/quick-cephfs.rst b/doc/start/quick-cephfs.rst index cdc93ec1b60..b243edd6dbc 100644 --- a/doc/start/quick-cephfs.rst +++ b/doc/start/quick-cephfs.rst @@ -29,6 +29,46 @@ Prerequisites ceph -s [-m {monitor-ip-address}] [-k {path/to/ceph.client.admin.keyring}] +Deploy Metadata Server +====================== + +All metadata operations in CephFS happen via a metadata server, so you need at +least one metadata server. Execute the following to create a metadata server:: + + ceph-deploy mds create {ceph-node} + +For example:: + + ceph-deploy mds create node1 + +Now, your Ceph cluster would look like this: + +.. ditaa:: + /------------------\ /----------------\ + | ceph-deploy | | node1 | + | Admin Node | | cCCC | + | +-------->+ mon.node1 | + | | | osd.0 | + | | | mgr.node1 | + | | | mds.node1 | + \---------+--------/ \----------------/ + | + | /----------------\ + | | node2 | + | | cCCC | + +----------------->+ | + | | osd.1 | + | | mon.node2 | + | \----------------/ + | + | /----------------\ + | | node3 | + | | cCCC | + +----------------->+ | + | osd.2 | + | mon.node3 | + \----------------/ + Create a File System ==================== -- 2.39.5