Signed-off-by: Valerio Pachera <[email protected]> --- 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 -- sheepdog mailing list [email protected] http://lists.wpkg.org/mailman/listinfo/sheepdog
