From 9349171b55f3c53198c783ea1aa70d0efed1a19c Mon Sep 17 00:00:00 2001 From: Ian Barwick Date: Wed, 30 Jan 2019 15:43:34 +0900 Subject: [PATCH] doc: document "node_rejoin_timeout" for switchover operations --- doc/repmgr-daemon-start.sgml | 1 + doc/repmgr-daemon-stop.sgml | 3 +- doc/repmgr-standby-switchover.sgml | 125 ++++++++++++++++++++++------- 3 files changed, 100 insertions(+), 29 deletions(-) diff --git a/doc/repmgr-daemon-start.sgml b/doc/repmgr-daemon-start.sgml index 9cd732d1..702ec2ff 100644 --- a/doc/repmgr-daemon-start.sgml +++ b/doc/repmgr-daemon-start.sgml @@ -70,6 +70,7 @@ + diff --git a/doc/repmgr-daemon-stop.sgml b/doc/repmgr-daemon-stop.sgml index 6a7b497f..74c957cc 100644 --- a/doc/repmgr-daemon-stop.sgml +++ b/doc/repmgr-daemon-stop.sgml @@ -78,7 +78,8 @@ - + + Wait for the specified number of seconds to confirm that repmgrd diff --git a/doc/repmgr-standby-switchover.sgml b/doc/repmgr-standby-switchover.sgml index 4287b704..cc4939a6 100644 --- a/doc/repmgr-standby-switchover.sgml +++ b/doc/repmgr-standby-switchover.sgml @@ -146,6 +146,7 @@ + @@ -163,27 +164,57 @@ Note that following parameters in repmgr.conf are relevant to the switchover operation: - + - - - replication_lag_critical: - if replication lag (in seconds) on the standby exceeds this value, the - switchover will be aborted (unless the -F/--force option - is provided) - - + - - - shutdown_check_timeout: maximum number of seconds to wait for the - demotion candidate (current primary) to shut down, before aborting the switchover. - - - Note that this parameter is set on the node where repmgr standby switchover - is executed (promotion candidate); setting it on the demotion candidate (former primary) will - have no effect. - + + + x + with "repmgr standby switchover " + + + + + + + + + + + + + replication_lag_critical + with "repmgr standby switchover " + + + + + + If replication lag (in seconds) on the standby exceeds this value, the + switchover will be aborted (unless the -F/--force option + is provided) + + + + + + + shutdown_check_timeout + with "repmgr standby switchover " + + + + + + maximum number of seconds to wait for the + demotion candidate (current primary) to shut down, before aborting the switchover. + + + Note that this parameter is set on the node where repmgr standby switchover + is executed (promotion candidate); setting it on the demotion candidate (former primary) will + have no effect. + In versions prior to &repmgr; 4.2, repmgr standby switchover would @@ -191,18 +222,56 @@ to determine the timeout for demotion candidate shutdown. - + + - - - standby_reconnect_timeout: - maximum number of seconds to attempt to wait for the demotion candidate (former primary) + + + standby_reconnect_timeout + with "repmgr standby switchover " + + + + + + maximum number of seconds to attempt to wait for the demotion candidate (former primary) to reconnect to the promoted primary (default: 60 seconds) - - + + + Note that this parameter is set on the node where repmgr standby switchover + is executed (promotion candidate); setting it on the demotion candidate (former primary) will + have no effect. + + + + + + + + node_rejoin_timeout + with "repmgr standby switchover " + + + + + + maximum number of seconds to attempt to wait for the demotion candidate (former primary) + to reconnect to the promoted primary (default: 60 seconds) + + + Note that this parameter is set on the the demotion candidate (former primary); + setting it on the node where repmgr standby switchover is + executed will have no effect. + + + However, this value must be less than on the + promotion candidate (node where repmgr standby switchover is executed). + + + + + - -