From: arthur <zzou(a)redhat.com>
Since kdump already support dump in cluster environment, this patch
add a howto file to RPM package to describe how to configure kdump
in cluster environment.
Signed-off-by: arthur <zzou(a)redhat.com>
---
kdump-in-cluster-environment.txt | 56 ++++++++++++++++++++++++++++++++++++++++
kexec-tools.spec | 3 +++
2 files changed, 59 insertions(+)
create mode 100644 kdump-in-cluster-environment.txt
diff --git a/kdump-in-cluster-environment.txt b/kdump-in-cluster-environment.txt
new file mode 100644
index 0000000..1e6a43a
--- /dev/null
+++ b/kdump-in-cluster-environment.txt
@@ -0,0 +1,56 @@
+Kdump-in-cluster-environment HOWTO
+
+Introduction
+
+Kdump is a kexec based crash dumping mechansim for Linux. This docuement
+illustrate how to configure kdump in cluster environment to allow the kdump
+crash recovery service complete without being preempted by traditional power
+fencing methods.
+
+Overview
+
+Kexec/Kdump
+
+Details about Kexec/Kdump are available in Kexec-Kdump-howto file and will not
+be described here.
+
+fence_kdump
+
+fence_kdump is an I/O fencing agent to be used with the kdump crash recovery
+service. When the fence_kdump agent is invoked, it will listen for a message
+from the failed node that acknowledges that the failed node it executing the
+kdump crash kernel. Note that fence_kdump is not a replacement for traditional
+fencing methods. The fence_kdump agent can only detect that a node has entered
+the kdump crash recovery service. This allows the kdump crash recovery service
+complete without being preempted by traditional power fencing methods.
+
+How to configure cluster environment:
+
+If we want to use kdump in cluster environment, fence-agents-kdump should be
+installed in every nodes in the cluster. You can achieve this via the following
+command:
+
+ # yum install -y fence-agents-kdump
+
+Next is to add kdump_fence to the cluster. Assuming that the cluster consists
+of three nodes, they are node1, node2 and node3, and use Pacemaker to perform
+resource management and pcs as cli configuration tool.
+
+With pcs it is easy to add a stonith resource to the cluster. For example, add
+a stonith resource named mykdumpfence with fence type of fence_kdump via the
+following commands:
+
+ # pcs stonith create mykdumpfence fence_kdump \
+ pcmk_host_check=static-list pcmk_host_list="node1 node2 node3"
+ # pcs stonith update mykdumpfence pcmk_monitor_action=metadata --force
+ # pcs stonith update mykdumpfence pcmk_status_action=metadata --force
+ # pcs stonith update mykdumpfence pcmk_reboot_action=off --force
+
+Then enable stonith
+ # pcs property set stonith-enabled=true
+
+How to configure kdump:
+
+Actually there is nothing special in configuration between normal kdump and
+cluster environment kdump. So please refer to Kexec-Kdump-howto file for more
+information.
diff --git a/kexec-tools.spec b/kexec-tools.spec
index 0b948c2..219bef1 100644
--- a/kexec-tools.spec
+++ b/kexec-tools.spec
@@ -25,6 +25,7 @@ Source17: rhcrashkernel-param
Source18: kdump.sysconfig.s390x
Source19: eppic_030413.tar.gz
Source20: kdump-lib.sh
+Source21: kdump-in-cluster-environment.txt
#######################################
# These are sources for mkdumpramfs
@@ -162,6 +163,7 @@ export CFLAGS="-O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2"
rm -f kexec-tools.spec.in
# setup the docs
cp %{SOURCE10} .
+cp %{SOURCE21} .
make
%ifarch %{ix86} x86_64 ia64 ppc64 s390x
@@ -346,6 +348,7 @@ done
%doc COPYING
%doc TODO
%doc kexec-kdump-howto.txt
+%doc kdump-in-cluster-environment.txt
%ifarch %{ix86} x86_64 ia64 ppc64 s390x
%files eppic
--
1.8.4.2