[sheepdog] [PATCH 4/11] Documentation, section "Sheepdog Basic", add chapter "start the cluster"

[Valerio Pachera]

Signed-off-by: Valerio Pachera <sirio81 at gmail.com>
---
 doc/start_the_cluster.rst |   88 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 88 insertions(+)
 create mode 100644 doc/start_the_cluster.rst

diff --git a/doc/start_the_cluster.rst b/doc/start_the_cluster.rst
new file mode 100644
index 0000000..7c9ba64
--- /dev/null
+++ b/doc/start_the_cluster.rst
@@ -0,0 +1,88 @@
+Start The Cluster
+=================
+
+Run sheep
+*********
+
+**IMPORTANT:**
+
+1. filesystem has to be mounted with *user_xattr* option (ext3, ext4);
+2. assign a whole device to sheep daemon
+
+
+You achieve both points editing */etc/fstab* correctly.
+Here's an example:
+
+::
+
+    /dev/sdb1      /mnt/sdb1       ext4    defaults,user_xattr        0       0
+
+Note: xfs uses *user_xattr* by default so you don't need to edit anything extra.
+
+We are ready to run sheep daemon
+
+::
+
+    sheep /mnt/sdb1
+
+Check if sheep is running:
+
+::
+
+    pgrep -l sheep
+
+Repat these steps on all your nodes.
+
+Check The Cluster
+*****************
+
+Now we have corosync and and sheep running on all hosts, but are 
+they *"working together"*?
+It's time to **interact** with sheep by **'dog'** command.
+You can run 'dog' from any of the nodes, so type:
+
+::
+
+    dog node list
+    It will print 3 nodes:
+    M   Id   Host:Port         V-Nodes       Zone
+    -    0   192.168.2.41:7000      50  688040128
+    -    1   192.168.2.42:7000      50  704817344
+    -    2   192.168.2.43:7000      92  721594560
+
+We'll go deeper later on that, but notice the 'Id' column.
+'dog' uses that to interact with nodes, not their ip.
+
+Now try [#]_: 
+
+::
+
+    # dog cluster info
+    
+    Cluster status: Waiting for cluster to be formatted
+
+
+Nodes "see" each other but the cluster is not ready to be used yet.
+We have to **format** it first:
+
+::
+
+    # dog cluster format
+
+Check the status again:
+
+::
+
+    # dog cluster info
+
+    Cluster status: running, auto-recovery enabled
+
+    Cluster created at Thu Jun  6 11:07:46 2013
+
+    Epoch Time           Version
+    2013-06-12 08:57:45      7 [192.168.2.44:7000, 192.168.2.45:7000, 192.168.2.46:7000]
+
+Here we are!
+The cluster is running and ready to host our vdi.
+
+.. [#] *you need at least 3 active nodes to format the cluster with default options.*
\ No newline at end of file
-- 
1.7.10.4