[Sheepdog] [PATCH] Place INSTALL directions in INSTALL file
Steven Dake
sdake at redhat.com
Fri Sep 17 19:01:02 CEST 2010
It is customary to have a separate INSTALL file which explains how to
build, compile, and install software from source (or upstream pre-built repos).
This patch separates those instructions into separate files.
Signed-off-by: Steven Dake <sdake at redhat.com>
---
INSTALL | 81 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
README | 28 ++++------------------
2 files changed, 86 insertions(+), 23 deletions(-)
create mode 100644 INSTALL
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 0000000..fde77f6
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,81 @@
+===========================
+Sheepdog Installation Guide
+===========================
+
+Run-time dependencies
+---------------------
+* Three or more x86-64 machines.
+* The corosync and corosync lib package.
+* QEMU 0.13 or later
+
+Compile-time dependencies
+-------------------------
+* GNU Autotools
+* corosync devel package
+* git (when compiling from source repo)
+* svn (when compiling from source repo)
+* nss devel packages (when compiling corosync from source)
+
+Compiling and installing from source
+------------------------------------
+1. Compile or install the Corosync packages:
+
+ 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:
+ $ aptitude install corosync
+
+ For RPM package based systems:
+ $ sudo yum install corosynclib-devel
+
+ If your distribution doesn't provide the corosync packages, or you prefer
+ to compile from source:
+
+ $ svn co http://svn.fedorahosted.org/svn/corosync/branches/flatiron
+ $ cd flatiron
+ $ ./autogen.sh
+ $ ./configure
+ $ sudo make install
+ $ cd ..
+
+2. Download, build and install QEMU with Sheepdog support:
+
+ QEMU 0.13 provides built-in support for sheepdog devies. Some distributions
+ provide pre-built versions of this newer version of QEMU. If your
+ distribution has an older version of QEMU or you prefer to compile from
+ source, retrieve the latest QEMU and compile:
+
+ $ git clone git://git.sv.gnu.org/qemu.git
+ $ cd qemu
+ $ ./onfigure
+ $ sudo make install
+ $ cd ..
+
+3. Download, build and install the Sheepdog server and command line tools:
+
+ $ git clone git://sheepdog.git.sf.net/gitroot/sheepdog/sheepdog
+ $ cd sheepdog
+ $ ./autogen.sh
+ $ ./configure
+ $ sudo make install
+ $ cd ..
+
+ Please note, sheepdog supports a "make rpm" target which will generate
+ an rpm package that can be installed on the local machine. To use this
+ installation method, use the following instructions:
+
+ $ git clone git://sheepdog.git.sf.net/gitroot/sheepdog/sheepdog
+ $ cd sheepdog
+ $ ./autogen.sh
+ $ ./configure
+ $ make rpm
+ $ sudo rpm -ivh x86_64/sheepdog-0.*
+ $ cd ..
+
+Please read the README file, the sheep(8) or collie(8) man page for further
+usage instructions.
+
+===============================================================================
+Copyright (C) 2009-2010, Nippon Telegraph and Telephone Corporation.
diff --git a/README b/README
index d623548..f3b7ed2 100644
--- a/README
+++ b/README
@@ -22,32 +22,14 @@ Requirements
Install
-------
-1. Install x86-64 Linux.
-2. Install and setup corosync.
-
- If you use Debian Squeeze,
-
- $ aptitude install corosync # or compile corosync.
- $ sudo corosync # run corosync daemon as root
-
-3. Download QEMU and Sheepdog codes.
-
- $ git clone git://git.sv.gnu.org/qemu.git
- $ git clone git://sheepdog.git.sf.net/gitroot/sheepdog/sheepdog
-
-4. Build
-
- $ cd qemu
- $ ./configure
- $ make install
- $ cd ../sheepdog
- $ ./autogen.sh
- $ ./configure
- $ make install
- $ cd ..
+Please read the INSTALL file distributed with this package for detailed
+instructions on installing or compiling from source.
Usage
-----
+* Configure corosync. Reference 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.2.2
More information about the sheepdog
mailing list