[sheepdog] [PATCH 04/11] Doc. "Sheepdog Basic" add chapter "start the cluster"

[Liu Yuan]

On Sun, Oct 20, 2013 at 10:40:57AM +0200, Valerio Pachera wrote:
> 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
> +

'M' field has been already removed in the master branch. So we'd better update
it in the doc too.

Thanks
Yuan