Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PACEMAKER-FENCED(7)	     Pacemaker Configuration	     PACEMAKER-FENCED(7)

NAME
     pacemaker-fenced  -  Instance  attributes available for all "stonith"-class
     resources

SYNOPSIS
     [pcmk_host_argument=string] [pcmk_host_map=string]  [pcmk_host_list=string]
     [pcmk_host_check=select]	[pcmk_delay_max=time]	[pcmk_delay_base=string]
     [pcmk_action_limit=integer] [pcmk_reboot_action=string]  [pcmk_reboot_time-
     out=time]	     [pcmk_reboot_retries=integer]	[pcmk_off_action=string]
     [pcmk_off_timeout=time] [pcmk_off_retries=integer]  [pcmk_on_action=string]
     [pcmk_on_timeout=time]  [pcmk_on_retries=integer] [pcmk_list_action=string]
     [pcmk_list_timeout=time]	[pcmk_list_retries=integer]    [pcmk_monitor_ac-
     tion=string]   [pcmk_monitor_timeout=time]   [pcmk_monitor_retries=integer]
     [pcmk_status_action=string]   [pcmk_status_timeout=time]	[pcmk_status_re-
     tries=integer]

DESCRIPTION
     Instance attributes available for all "stonith"-class resources and used by
     Pacemaker's fence daemon, formerly known as stonithd

SUPPORTED PARAMETERS
     pcmk_host_argument = string [port]
	 ***  Advanced	Use Only *** An alternate parameter to supply instead of
	 'port'

	 Some devices do not support the standard 'port' parameter or  may  pro-
	 vide  additional  ones.  Use  this to specify an alternate, device-spe-
	 cific, parameter that should indicate the machine to be fenced. A value
	 of "none" can be used to tell the cluster not to supply any  additional
	 parameters.

     pcmk_host_map = string
	 A mapping of node names to port numbers for devices that do not support
	 node names.

	 For  example,	"node1:1;node2:2,3" would tell the cluster to use port 1
	 for node1 and ports 2 and 3 for node2.

     pcmk_host_list = string
	 Nodes targeted by this device

	 Comma-separated list of nodes that can be targeted by this device  (for
	 example, "node1,node2,node3"). If pcmk_host_check is "static-list", ei-
	 ther this or pcmk_host_map must be set.

     pcmk_host_check = select
	 How to determine which nodes can be targeted by the device

	 Use  "dynamic-list"  to  query the device via the 'list' command; "sta-
	 tic-list" to check the pcmk_host_list attribute; "status" to query  the
	 device  via  the 'status' command; or "none" to assume every device can
	 fence every node. The default value is "static-list"  if  pcmk_host_map
	 or  pcmk_host_list  is set; otherwise "dynamic-list" if the device sup-
	 ports the list operation; otherwise "status" if the device supports the
	 status operation; otherwise "none" Allowed values:  dynamic-list,  sta-
	 tic-list, status, none

     pcmk_delay_max = time [0s]
	 Enable  a  delay  of  no  more than the time specified before executing
	 fencing actions.

	 Enable a delay of no more than  the  time  specified  before  executing
	 fencing  actions.  Pacemaker  derives	the  overall delay by taking the
	 value of pcmk_delay_base and adding a random delay value such that  the
	 sum is kept below this maximum.

     pcmk_delay_base = string [0s]
	 Enable a base delay for fencing actions and specify base delay value.

	 This  enables	a static delay for fencing actions, which can help avoid
	 "death matches" where two nodes try to fence each  other  at  the  same
	 time. If pcmk_delay_max is also used, a random delay will be added such
	 that  the  total  delay  is kept below that value. This can be set to a
	 single time value to apply to any node targeted by this device  (useful
	 if  a	separate device is configured for each target), or to a node map
	 (for example, "node1:1s;node2:5") to set a  different	value  for  each
	 target.

     pcmk_action_limit = integer [1]
	 The  maximum number of actions can be performed in parallel on this de-
	 vice

	 Cluster  property  concurrent-fencing="true"  needs  to  be  configured
	 first.  Then  use  this to specify the maximum number of actions can be
	 performed in parallel on this device. A value of -1 means an  unlimited
	 number of actions can be performed in parallel.

     pcmk_reboot_action = string [reboot]
	 ***  Advanced	Use Only *** An alternate command to run instead of 're-
	 boot'

	 Some devices do not support the standard commands or may provide  addi-
	 tional ones. Use this to specify an alternate, device-specific, command
	 that implements the 'reboot' action.

     pcmk_reboot_timeout = time [60s]
	 ***  Advanced Use Only *** Specify an alternate timeout to use for 're-
	 boot' actions instead of stonith-timeout

	 Some devices need much more/less time to complete than normal. Use this
	 to specify an alternate, device-specific, timeout for 'reboot' actions.

     pcmk_reboot_retries = integer [2]
	 *** Advanced Use Only *** The maximum number of times to try  the  're-
	 boot' command within the timeout period

	 Some devices do not support multiple connections. Operations may "fail"
	 if  the  device is busy with another task. In that case, Pacemaker will
	 automatically retry the operation if there is time remaining. Use  this
	 option  to  alter the number of times Pacemaker tries a 'reboot' action
	 before giving up.

     pcmk_off_action = string [off]
	 *** Advanced Use Only *** An alternate command to run instead of 'off'

	 Some devices do not support the standard commands or may provide  addi-
	 tional ones. Use this to specify an alternate, device-specific, command
	 that implements the 'off' action.

     pcmk_off_timeout = time [60s]
	 *** Advanced Use Only *** Specify an alternate timeout to use for 'off'
	 actions instead of stonith-timeout

	 Some devices need much more/less time to complete than normal. Use this
	 to specify an alternate, device-specific, timeout for 'off' actions.

     pcmk_off_retries = integer [2]
	 ***  Advanced Use Only *** The maximum number of times to try the 'off'
	 command within the timeout period

	 Some devices do not support multiple connections. Operations may "fail"
	 if the device is busy with another task. In that case,  Pacemaker  will
	 automatically	retry the operation if there is time remaining. Use this
	 option to alter the number of times Pacemaker tries a 'off' action  be-
	 fore giving up.

     pcmk_on_action = string [on]
	 *** Advanced Use Only *** An alternate command to run instead of 'on'

	 Some  devices do not support the standard commands or may provide addi-
	 tional ones. Use this to specify an alternate, device-specific, command
	 that implements the 'on' action.

     pcmk_on_timeout = time [60s]
	 *** Advanced Use Only *** Specify an alternate timeout to use for  'on'
	 actions instead of stonith-timeout

	 Some devices need much more/less time to complete than normal. Use this
	 to specify an alternate, device-specific, timeout for 'on' actions.

     pcmk_on_retries = integer [2]
	 ***  Advanced	Use Only *** The maximum number of times to try the 'on'
	 command within the timeout period

	 Some devices do not support multiple connections. Operations may "fail"
	 if the device is busy with another task. In that case,  Pacemaker  will
	 automatically	retry the operation if there is time remaining. Use this
	 option to alter the number of times Pacemaker tries a 'on'  action  be-
	 fore giving up.

     pcmk_list_action = string [list]
	 *** Advanced Use Only *** An alternate command to run instead of 'list'

	 Some  devices do not support the standard commands or may provide addi-
	 tional ones. Use this to specify an alternate, device-specific, command
	 that implements the 'list' action.

     pcmk_list_timeout = time [60s]
	 *** Advanced Use Only *** Specify  an	alternate  timeout  to	use  for
	 'list' actions instead of stonith-timeout

	 Some devices need much more/less time to complete than normal. Use this
	 to specify an alternate, device-specific, timeout for 'list' actions.

     pcmk_list_retries = integer [2]
	 *** Advanced Use Only *** The maximum number of times to try the 'list'
	 command within the timeout period

	 Some devices do not support multiple connections. Operations may "fail"
	 if  the  device is busy with another task. In that case, Pacemaker will
	 automatically retry the operation if there is time remaining. Use  this
	 option to alter the number of times Pacemaker tries a 'list' action be-
	 fore giving up.

     pcmk_monitor_action = string [monitor]
	 *** Advanced Use Only *** An alternate command to run instead of 'moni-
	 tor'

	 Some  devices do not support the standard commands or may provide addi-
	 tional ones. Use this to specify an alternate, device-specific, command
	 that implements the 'monitor' action.

     pcmk_monitor_timeout = time [60s]
	 *** Advanced Use Only *** Specify an alternate timeout to use for 'mon-
	 itor' actions instead of stonith-timeout

	 Some devices need much more/less time to complete than normal. Use this
	 to specify an alternate, device-specific,  timeout  for  'monitor'  ac-
	 tions.

     pcmk_monitor_retries = integer [2]
	 *** Advanced Use Only *** The maximum number of times to try the 'moni-
	 tor' command within the timeout period

	 Some devices do not support multiple connections. Operations may "fail"
	 if  the  device is busy with another task. In that case, Pacemaker will
	 automatically retry the operation if there is time remaining. Use  this
	 option  to alter the number of times Pacemaker tries a 'monitor' action
	 before giving up.

     pcmk_status_action = string [status]
	 *** Advanced Use Only *** An alternate command to run instead of  'sta-
	 tus'

	 Some  devices do not support the standard commands or may provide addi-
	 tional ones. Use this to specify an alternate, device-specific, command
	 that implements the 'status' action.

     pcmk_status_timeout = time [60s]
	 *** Advanced Use Only *** Specify an alternate timeout to use for 'sta-
	 tus' actions instead of stonith-timeout

	 Some devices need much more/less time to complete than normal. Use this
	 to specify an alternate, device-specific, timeout for 'status' actions.

     pcmk_status_retries = integer [2]
	 *** Advanced Use Only *** The maximum number of times to try the  'sta-
	 tus' command within the timeout period

	 Some devices do not support multiple connections. Operations may "fail"
	 if  the  device is busy with another task. In that case, Pacemaker will
	 automatically retry the operation if there is time remaining. Use  this
	 option  to  alter the number of times Pacemaker tries a 'status' action
	 before giving up.

AUTHOR
     Andrew Beekhof <andrew@beekhof.net>
	 Author.

Pacemaker Configuration 	   08/01/2026		     PACEMAKER-FENCED(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pacemaker-fenced&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>

home | help