'\" t .\" Title: pacemaker-controld .\" Author: Andrew Beekhof .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 02/05/2024 .\" Manual: Pacemaker Configuration .\" Source: Pacemaker Configuration .\" Language: English .\" .TH "PACEMAKER\-CONTROLD" "7" "02/05/2024" "Pacemaker Configuration" "Pacemaker Configuration" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" pacemaker-controld \- Pacemaker controller options .SH "SYNOPSIS" .PP [\fBdc\-version\fR=string] [\fBcluster\-infrastructure\fR=string] [\fBcluster\-name\fR=string] [\fBdc\-deadtime\fR=time] [\fBcluster\-recheck\-interval\fR=time] [\fBload\-threshold\fR=percentage] [\fBnode\-action\-limit\fR=integer] [\fBfence\-reaction\fR=string] [\fBelection\-timeout\fR=time] [\fBshutdown\-escalation\fR=time] [\fBjoin\-integration\-timeout\fR=time] [\fBjoin\-finalization\-timeout\fR=time] [\fBtransition\-delay\fR=time] [\fBstonith\-watchdog\-timeout\fR=time] [\fBstonith\-max\-attempts\fR=integer] [\fBno\-quorum\-policy\fR=select] [\fBshutdown\-lock\fR=boolean] [\fBshutdown\-lock\-limit\fR=time] .SH "DESCRIPTION" .PP Cluster options used by Pacemaker\*(Aqs controller .SH "SUPPORTED PARAMETERS" .PP \fBdc\-version\fR = string [none] .RS 4 Pacemaker version on cluster node elected Designated Controller (DC) .sp Includes a hash which identifies the exact changeset the code was built from\&. Used for diagnostic purposes\&. .RE .PP \fBcluster\-infrastructure\fR = string [corosync] .RS 4 The messaging stack on which Pacemaker is currently running .sp Used for informational and diagnostic purposes\&. .RE .PP \fBcluster\-name\fR = string .RS 4 An arbitrary name for the cluster .sp This optional value is mostly for users\*(Aq convenience as desired in administration, but may also be used in Pacemaker configuration rules via the #cluster\-name node attribute, and by higher\-level tools and resource agents\&. .RE .PP \fBdc\-deadtime\fR = time [20s] .RS 4 How long to wait for a response from other nodes during start\-up .sp The optimal value will depend on the speed and load of your network and the type of switches used\&. .RE .PP \fBcluster\-recheck\-interval\fR = time [15min] .RS 4 Polling interval to recheck cluster state and evaluate rules with date specifications .sp Pacemaker is primarily event\-driven, and looks ahead to know when to recheck cluster state for failure timeouts and most time\-based rules\&. However, it will also recheck the cluster after this amount of inactivity, to evaluate rules with date specifications and serve as a fail\-safe for certain types of scheduler bugs\&. Allowed values: Zero disables polling, while positive values are an interval in seconds(unless other units are specified, for example "5min") .RE .PP \fBload\-threshold\fR = percentage [80%] .RS 4 Maximum amount of system load that should be used by cluster nodes .sp The cluster will slow down its recovery process when the amount of system resources used (currently CPU) approaches this limit .RE .PP \fBnode\-action\-limit\fR = integer [0] .RS 4 Maximum number of jobs that can be scheduled per node (defaults to 2x cores) .RE .PP \fBfence\-reaction\fR = string [stop] .RS 4 How a cluster node should react if notified of its own fencing .sp A cluster node may receive notification of its own fencing if fencing is misconfigured, or if fabric fencing is in use that doesn\*(Aqt cut cluster communication\&. Allowed values are "stop" to attempt to immediately stop Pacemaker and stay stopped, or "panic" to attempt to immediately reboot the local node, falling back to stop on failure\&. .RE .PP \fBelection\-timeout\fR = time [2min] .RS 4 *** Advanced Use Only *** .sp Declare an election failed if it is not decided within this much time\&. If you need to adjust this value, it probably indicates the presence of a bug\&. .RE .PP \fBshutdown\-escalation\fR = time [20min] .RS 4 *** Advanced Use Only *** .sp Exit immediately if shutdown does not complete within this much time\&. If you need to adjust this value, it probably indicates the presence of a bug\&. .RE .PP \fBjoin\-integration\-timeout\fR = time [3min] .RS 4 *** Advanced Use Only *** .sp If you need to adjust this value, it probably indicates the presence of a bug\&. .RE .PP \fBjoin\-finalization\-timeout\fR = time [30min] .RS 4 *** Advanced Use Only *** .sp If you need to adjust this value, it probably indicates the presence of a bug\&. .RE .PP \fBtransition\-delay\fR = time [0s] .RS 4 *** Advanced Use Only *** Enabling this option will slow down cluster recovery under all conditions .sp Delay cluster recovery for this much time to allow for additional events to occur\&. Useful if your configuration is sensitive to the order in which ping updates arrive\&. .RE .PP \fBstonith\-watchdog\-timeout\fR = time [0] .RS 4 How long before nodes can be assumed to be safely down when watchdog\-based self\-fencing via SBD is in use .sp If this is set to a positive value, lost nodes are assumed to self\-fence using watchdog\-based SBD within this much time\&. This does not require a fencing resource to be explicitly configured, though a fence_watchdog resource can be configured, to limit use to specific nodes\&. If this is set to 0 (the default), the cluster will never assume watchdog\-based self\-fencing\&. If this is set to a negative value, the cluster will use twice the local value of the `SBD_WATCHDOG_TIMEOUT` environment variable if that is positive, or otherwise treat this as 0\&. WARNING: When used, this timeout must be larger than `SBD_WATCHDOG_TIMEOUT` on all nodes that use watchdog\-based SBD, and Pacemaker will refuse to start on any of those nodes where this is not true for the local value or SBD is not active\&. When this is set to a negative value, `SBD_WATCHDOG_TIMEOUT` must be set to the same value on all nodes that use SBD, otherwise data corruption or loss could occur\&. .RE .PP \fBstonith\-max\-attempts\fR = integer [10] .RS 4 How many times fencing can fail before it will no longer be immediately re\-attempted on a target .RE .PP \fBno\-quorum\-policy\fR = select [stop] .RS 4 What to do when the cluster does not have quorum .sp What to do when the cluster does not have quorum Allowed values: stop, freeze, ignore, demote, suicide .RE .PP \fBshutdown\-lock\fR = boolean [false] .RS 4 Whether to lock resources to a cleanly shut down node .sp When true, resources active on a node when it is cleanly shut down are kept "locked" to that node (not allowed to run elsewhere) until they start again on that node after it rejoins (or for at most shutdown\-lock\-limit, if set)\&. Stonith resources and Pacemaker Remote connections are never locked\&. Clone and bundle instances and the promoted role of promotable clones are currently never locked, though support could be added in a future release\&. .RE .PP \fBshutdown\-lock\-limit\fR = time [0] .RS 4 Do not lock resources to a cleanly shut down node longer than this .sp If shutdown\-lock is true and this is set to a nonzero time duration, shutdown locks will expire after this much time has passed since the shutdown was initiated, even if the node has not rejoined\&. .RE .SH "AUTHOR" .PP \fBAndrew Beekhof\fR <\&andrew@beekhof\&.net\&> .RS 4 Author. .RE