summaryrefslogtreecommitdiffstats
path: root/agents/manual/fence_ack_manual.8
diff options
context:
space:
mode:
Diffstat (limited to 'agents/manual/fence_ack_manual.8')
-rw-r--r--agents/manual/fence_ack_manual.839
1 files changed, 39 insertions, 0 deletions
diff --git a/agents/manual/fence_ack_manual.8 b/agents/manual/fence_ack_manual.8
new file mode 100644
index 0000000..6b4cd14
--- /dev/null
+++ b/agents/manual/fence_ack_manual.8
@@ -0,0 +1,39 @@
+.TH FENCE_ACK_MANUAL 8 2009-12-21 cluster cluster
+
+.SH NAME
+fence_ack_manual \- a program to override fenced fencing operations
+
+.SH SYNOPSIS
+.B fence_ack_manual
+[OPTIONS]
+.I nodename
+
+.SH DESCRIPTION
+When
+.BR fenced (8)
+fails to fence a node, it retries indefinately.
+.BR fence_ack_manual (8)
+tells fenced to stop retrying and consider the node fenced.
+
+.P
+It is important that this only be done after the node has been manually
+turned off or prevented from writing to shared storage.
+Without this manual action and verification, the storage that fencing
+protects may become corrupted.
+
+.P
+When fenced fences a node that has no fence devices defined in the cluster
+configuration, the fencing operation fails. This failure will be repeated
+indefinately until fence_ack_manual is run by an operator to indicate
+the node is in a safe state to proceed.
+(Defining no fencing devices for node is the equivalent of using the
+fence_manual agent in previous versions.)
+
+.SH OPTIONS
+.TP
+.B \-h
+Print a help message describing available options, then exit.
+
+.SH SEE ALSO
+.BR fenced (8)
+