File bsc#1174696-0003-Doc-controller-Pacemaker-Expla... of Package pacemaker.20188

Overview Repositories Revisions Requests Users Attributes Meta

File bsc#1174696-0003-Doc-controller-Pacemaker-Explained-improve-the-docum.patch of Package pacemaker.20188

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]

Places

File bsc#1174696-0003-Doc-controller-Pacemaker-Explained-improve-the-docum.patch of Package pacemaker.20188

Places