doc: very basic doc on mstart

A very basic explanation of getting started with using mstart to deploy
multiple clusters on a machine

Signed-off-by: Abhishek Lekshmanan <abhishek@suse.com>

diff --git a/doc/dev/dev_cluster_deployement.rst b/doc/dev/dev_cluster_deployement.rst
index 4c64c4f7766f000356e4419a2d612336bd2f1dcf..2dd232f09a3e636df21213dce38b3f8739cf810f 100644 (file)
--- a/doc/dev/dev_cluster_deployement.rst
+++ b/doc/dev/dev_cluster_deployement.rst
@@ -100,3 +100,30 @@ Theses environment variables will contains the number of instances of the desire
 Example: ::
 
        OSD=3 MON=3 RGW=1 vstart.sh
+
+
+============================================================
+ Deploying multiple development clusters on the same machine
+============================================================
+
+In order to bring up multiple ceph clusters on the same machine, *mstart.sh* a
+small wrapper around the above *vstart* can help.
+
+Usage
+=====
+
+To start multiple clusters, you would run mstart for each cluster you would want
+to deploy, and it will start monitors, rgws for each cluster on different ports
+allowing you to run multiple mons, rgws etc. on the same cluster. Invoke it in
+the following way::
+
+  mstart.sh <cluster-name> <vstart options>
+
+For eg::
+
+  ./mstart.sh cluster1 -n -r
+
+
+For stopping the cluster, you do::
+
+  ./mstop.sh <cluster-name>