[sheepdog] [PATCH] update some info in README

Liu Yuan namei.unix at gmail.com
Sun Aug 5 04:23:33 CEST 2012


From: Liu Yuan <tailai.ly at taobao.com>


Signed-off-by: Liu Yuan <tailai.ly at taobao.com>
---
 README |   48 +++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 43 insertions(+), 5 deletions(-)

diff --git a/README b/README
index 549c05d..f130e86 100644
--- a/README
+++ b/README
@@ -3,11 +3,11 @@ Sheepdog: Distributed Storage System for KVM
 
 Overview
 --------
-Sheepdog is a distributed storage system for KVM/QEMU. It provides
+Sheepdog is a distributed storage system for QEMU. It provides
 highly available block level storage volumes to virtual machines. 
 Sheepdog supports advanced volume management features such as snapshot,
-cloning, and thin provisioning. The architecture of Sheepdog is fully
-symmetric; there is no central node such as a meta-data server.
+cloning, and thin provisioning.
+
 Sheepdog is an Open Source software, released under the terms of the
 GNU General Public License version 2. 
 
@@ -15,6 +15,9 @@ For the latest information about Sheepdog, please visit our website at:
 
    http://www.osrg.net/sheepdog/
 
+And (recommended for new comers) wiki at:
+   https://github.com/collie/sheepdog/wiki/
+
 Requirements
 ------------
 * Three or more x86-64 machines
@@ -27,8 +30,43 @@ instructions on installing or compiling from source.
 
 Usage
 -----
-* Configure corosync.  Reference the corosync(8) and corosync.conf(5) man page
-  for further details.
+
+* Cluster Management Backends
+
+   Sheepdog uses a cluster management backend to manage membership and broadcast
+   messages to the cluster nodes.
+
+   For now, sheepdog can use local driver (for development on a single box),
+   corosync (the default), zookeeper and Accord.
+
+* Local Driver
+
+   This driver just makes use of UNIX IPC mechanism to manage the membership
+   on a single box, where we start multiple 'sheep' processes to simulate the
+   cluster. It is very easy and fast setup and especially useful to test
+   functionality without involving any other software.
+
+   To set up a 3 node cluster using local driver in one liner bash with debug mode:
+
+      $ mkdir /path/to/store
+      $ for i in 0 1 2; do sheep -c local -d /path/to/store/$i -z $i -p 700$i;sleep 1;done
+
+* Configure corosync.
+
+   Nearly every modern Linux distribution has x86_64 corosync binaries pre-built
+   available via their repositories. We recommend you use these packages if they
+   are available on your distribution.
+
+   For debian package based systems:
+
+      $ sudo aptitude install corosync libcorosync-dev
+
+   For RPM package based systems:
+
+      $ sudo yum install corosynclib-devel
+
+   Reference our wiki, the corosync(8) and corosync.conf(5) man page for further
+   details.
 
 * Setup Sheepdog
    1. Launch sheepdog on each machines of the cluster.
-- 
1.7.10.2




More information about the sheepdog mailing list