File bsc#1174696-0003-Doc-controller-Pacemaker-Explained-improve-the-docum.patch of Package pacemaker.29826
From 2c54a4c9f9bc71cd454d02ea50c65569d064fcb0 Mon Sep 17 00:00:00 2001
From: "Gao,Yan" <ygao@suse.com>
Date: Fri, 14 Aug 2020 13:31:43 +0200
Subject: [PATCH 3/3] Doc: controller, Pacemaker Explained: improve the
documentation of `stonith-watchdog-timeout` cluster option
This commit also marks out the default value `0` of
`stonith-watchdog-timeout` cluster option in the metadata of controller
to be consistent with "Pacemaker Explained".
---
daemons/controld/controld_control.c | 22 +++++++++++++++++---
doc/Pacemaker_Explained/en-US/Ch-Options.txt | 20 +++++++++++++++---
doc/sphinx/Pacemaker_Explained/options.rst | 22 ++++++++++++++++----
3 files changed, 54 insertions(+), 10 deletions(-)
Index: pacemaker-2.0.4+20200616.2deceaa3a/daemons/controld/controld_control.c
===================================================================
--- pacemaker-2.0.4+20200616.2deceaa3a.orig/daemons/controld/controld_control.c
+++ pacemaker-2.0.4+20200616.2deceaa3a/daemons/controld/controld_control.c
@@ -612,10 +612,26 @@ static pcmk__cluster_option_t crmd_opts[
},
{
"stonith-watchdog-timeout", NULL, "time", NULL,
- NULL, pcmk__valid_sbd_timeout,
+ "0", pcmk__valid_sbd_timeout,
"How long to wait before we can assume nodes are safely down "
- "when sbd is in use",
- NULL
+ "when watchdog-based self-fencing via SBD is in use",
+ "If nonzero, along with `have-watchdog=true` automatically set by the "
+ "cluster, when fencing is required, watchdog-based self-fencing "
+ "will be performed via SBD without requiring a fencing resource "
+ "explicitly configured. "
+ "If `stonith-watchdog-timeout` is set to a positive value, unseen "
+ "nodes are assumed to self-fence within this much time. +WARNING:+ "
+ "It must be ensured that this value is larger than the "
+ "`SBD_WATCHDOG_TIMEOUT` environment variable on all nodes. "
+ "Pacemaker verifies the settings individually on all nodes and "
+ "prevents startup or shuts down if configured wrongly on the fly. "
+ "It's strongly recommended that `SBD_WATCHDOG_TIMEOUT` is set to "
+ "the same value on all nodes. "
+ "If `stonith-watchdog-timeout` is set to a negative value, and "
+ "`SBD_WATCHDOG_TIMEOUT` is set, twice that value will be used. "
+ "+WARNING:+ In this case, it's essential (currently not verified by "
+ "pacemaker) that `SBD_WATCHDOG_TIMEOUT` is set to the same value on "
+ "all nodes."
},
{
"stonith-max-attempts", NULL, "integer", NULL,
Index: pacemaker-2.0.4+20200616.2deceaa3a/doc/Pacemaker_Explained/en-US/Ch-Options.txt
===================================================================
--- pacemaker-2.0.4+20200616.2deceaa3a.orig/doc/Pacemaker_Explained/en-US/Ch-Options.txt
+++ pacemaker-2.0.4+20200616.2deceaa3a/doc/Pacemaker_Explained/en-US/Ch-Options.txt
@@ -272,9 +272,23 @@ immediately re-attempt it.
| stonith-watchdog-timeout | 0 |
indexterm:[stonith-watchdog-timeout,Cluster Option]
indexterm:[Cluster,Option,stonith-watchdog-timeout]
-If nonzero, rely on hardware watchdog self-fencing. If positive, assume unseen
-nodes self-fence within this much time. If negative, and the
-SBD_WATCHDOG_TIMEOUT environment variable is set, use twice that value.
+If nonzero, along with `have-watchdog=true` automatically set by the
+cluster, when fencing is required, watchdog-based self-fencing
+will be performed via SBD without requiring a fencing resource
+explicitly configured.
+If `stonith-watchdog-timeout` is set to a positive value, unseen
+nodes are assumed to self-fence within this much time. +WARNING:+
+It must be ensured that this value is larger than the
+`SBD_WATCHDOG_TIMEOUT` environment variable on all nodes.
+Pacemaker verifies the settings individually on all nodes and
+prevents startup or shuts down if configured wrongly on the fly.
+It's strongly recommended that `SBD_WATCHDOG_TIMEOUT` is set to
+the same value on all nodes.
+If `stonith-watchdog-timeout` is set to a negative value, and
+`SBD_WATCHDOG_TIMEOUT` is set, twice that value will be used.
++WARNING:+ In this case, it's essential (currently not verified by
+pacemaker) that `SBD_WATCHDOG_TIMEOUT` is set to the same value on
+all nodes.
| concurrent-fencing | FALSE |
indexterm:[concurrent-fencing,Cluster Option]