Cluster Project branch, STABLE2, updated. cluster-2.02.00-3-g73d4d07

Cluster Project branch, STABLE2, updated. cluster-2.02.00-3-g73d4d07

[teigland]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Cluster Project".

http://sources.redhat.com/git/gitweb.cgi?p=cluster.git;a=commitdiff;h=73d4d073e91ac3b866afee9697e0da37e22a02be

The branch, STABLE2 has been updated
       via  73d4d073e91ac3b866afee9697e0da37e22a02be (commit)
      from  241d93efae78a509e8cae5a2300ff2205686a5f9 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 73d4d073e91ac3b866afee9697e0da37e22a02be
Author: David Teigland <teigland@redhat.com>
Date:   Fri Mar 7 09:17:43 2008 -0600

    doc: update usage.txt

-----------------------------------------------------------------------

Summary of changes:
 doc/usage.txt |   87 +++++++++++++++++++--------------------------------------
 1 files changed, 29 insertions(+), 58 deletions(-)

diff --git a/doc/usage.txt b/doc/usage.txt
index f9e2866..dac33f8 100644
--- a/doc/usage.txt
+++ b/doc/usage.txt
@@ -7,58 +7,23 @@ http://sources.redhat.com/cluster/
 Install
 -------
 
-Install a Linux kernel with GFS2, DLM, configfs, IPV6 and SCTP,
-  2.6.23-rc1 or later
-
-  If you want to use gfs1 (from cluster/gfs-kernel), then you need to
-  export three additional symbols from gfs2 by adding the following lines
-  to the end of linux/fs/gfs2/locking.c:
-     EXPORT_SYMBOL_GPL(gfs2_unmount_lockproto);
-     EXPORT_SYMBOL_GPL(gfs2_mount_lockproto);
-     EXPORT_SYMBOL_GPL(gfs2_withdraw_lockproto);
-
-Install openais
-  get the latest "whitetank" (stable) release from
-  http://openais.org/
-  or
-  svn checkout http://svn.osdl.org/openais
-  cd openais/branches/whitetank
-  make; make install DESTDIR=/
-
-Install gfs/dlm/fencing/etc components
-  get the latest cluster-2.xx.yy tarball from
-  ftp://sources.redhat.com/pub/cluster/
-  or
-  cvs -d :pserver:cvs@sources.redhat.com:/cvs/cluster login cvs
-  cvs -d :pserver:cvs@sources.redhat.com:/cvs/cluster checkout cluster
-  the password is "cvs"
-  cd cluster
-  ./configure --kernel_src=/path/to/kernel
-  make install
-
-  NOTE: On 64-bit systems, you will usually need to add '--libdir=/usr/lib64'
-        to the configure line.
-
-Install LVM2/CLVM (optional)
-  cvs -d :pserver:cvs@sources.redhat.com:/cvs/lvm2 login cvs
-  cvs -d :pserver:cvs@sources.redhat.com:/cvs/lvm2 checkout LVM2
-  cvs -d :pserver:cvs@sources.redhat.com:/cvs/lvm2
-  the password is "cvs"
-  cd LVM2
-  ./configure --with-clvmd=cman --with-cluster=shared
-  make; make install
-
-  NOTE: On 64-bit systems, you will usually need to add '--libdir=/usr/lib64'
-        to the configure line.
+Install the version of the linux kernel and openais that are compatible
+with the given cluster release.  gfs requires this additional kernel
+patch that exports some symbols from gfs2:
+  ftp://sources.redhat.com/pub/cluster/releases/lockproto-exports.patch
+
+Install the cluster release
+cd cluster
+./configure --kernel_src=/usr/src/linux
+(./configure --help for more options, --libdir=/usr/lib64 needed on x86-64)
+make install
+
 
 Load kernel modules
 -------------------
 
-modprobe gfs2
-modprobe gfs
-modprobe lock_dlm
-modprobe lock_nolock
-modprobe dlm
+gfs2, dlm, lock_dlm, lock_nolock (from the kernel)
+gfs (from cluster/gfs-kernel)
 
 
 Configuration
@@ -72,7 +37,7 @@ Create /etc/cluster/cluster.conf and copy it to all nodes.
   The one change you will need to make is to add nodeids for all nodes
   in the cluster. These are now mandatory. eg:
 
-     <clusternode name="node12.mycluster.mycompany.com" votes="1" nodeid="12">
+     <clusternode name="node12.mycluster.mycompany.com" nodeid="12">
 
   If you already have a cluster.conf file with no nodeids in it, then you can
   use the 'ccs_tool addnodeids' command to add them.
@@ -89,17 +54,17 @@ use for openais/cman/dlm communication.
 <cluster name="alpha" config_version="1">
 
 <clusternodes>
-<clusternode name="node01" nodeid="1">
+<clusternode name="node01.mycluster.mycompany.com" nodeid="1">
         <fence>
         </fence>
 </clusternode>
 
-<clusternode name="node02" nodeid="2">
+<clusternode name="node02.mycluster.mycompany.com" nodeid="2">
         <fence>
         </fence>
 </clusternode>
 
-<clusternode name="node03" nodeid="3">
+<clusternode name="node03.mycluster.mycompany.com" nodeid="3">
         <fence>
         </fence>
 </clusternode>
@@ -114,6 +79,10 @@ use for openais/cman/dlm communication.
 Startup procedure
 -----------------
 
+To use the init script, run "service cman start" on all nodes.  When getting a
+cluster set up initially, it can be helpful to do all the steps manually as
+follows.
+
 Run these commands on each cluster node:
 
 > mount -t configfs none /sys/kernel/config
@@ -124,12 +93,12 @@ Run these commands on each cluster node:
 > fence_tool join
 > dlm_controld
 > gfs_controld
-> clvmd (optional)
-> mkfs -t gfs2 -p lock_dlm -t <clustername>:<fsname> -j <#journals> <blockdev>
-> mount -t gfs2 [-v] <blockdev> <mountpoint>
+> clvmd (only necessary if using clvm volumes for gfs)
+> mkfs -t gfs -p lock_dlm -t <clustername>:<fsname> -j <#journals> <blockdev>
+> mount -t gfs [-v] <blockdev> <mountpoint>
 
 Notes:
-- replace "gfs2" with "gfs" above to use gfs1 instead of gfs2
+- replace "gfs" with "gfs2" above to use gfs2 instead of gfs
 - <clustername> in mkfs should match the one in cluster.conf.
 - <fsname> in mkfs is any name you pick, each fs must have a different name.
 - <#journals> in mkfs should be greater than or equal to the number of nodes
@@ -141,8 +110,10 @@ Notes:
   of the cluster.
 - The group_tool command shows the status of fencing, dlm and gfs groups
   that the local node is part of.
-- The "cman" init script can be used for starting everything up through
-  gfs_controld in the list above.
+- See the following man pages for more details:
+  ccs(7), ccsd(8), cluster.conf(5), cman(5), cman_tool(8), groupd(8),
+  group_tool(8), fence(8), fenced(8), fence_tool(8), dlm_controld(8),
+  gfs_controld(8), gfs(8), gfs_mkfs(8)
 
 
 Shutdown procedure


hooks/post-receive
--
Cluster Project