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

FreeBSD Manual Pages

  
 
  

home | help
OCF_PACEMAKER_IFSPEE(7)	    Pacemaker Configuration    OCF_PACEMAKER_IFSPEE(7)

NAME
       ocf_pacemaker_ifspeed - Network interface speed monitor

SYNOPSIS
       [OCF_RESKEY_name=string]	[OCF_RESKEY_iface=string]
       [OCF_RESKEY_ip=string] [OCF_RESKEY_bridge_ports=string]
       [OCF_RESKEY_weight_base=integer]	[OCF_RESKEY_dampen=integer]
       [OCF_RESKEY_debug=string]

       ifspeed [start |	stop | monitor | meta-data | validate-all |
       reload-agent]

DESCRIPTION
       This agent's monitor action records the speed of	a specified network
       interface as a node attribute. The attribute can	be used	in rules to
       prefer nodes based on network speeds. This agent	can monitor physical
       interfaces, bonded interfaces, bridges, VLANs, or any combination
       thereof.	For example: *)	Bridge on top of one 10Gbps interface (eth2)
       and 802.3ad bonding (bond0) built on two	1Gbps interfaces (eth0 and
       eth1). *) Active-backup bonding built on	top of one physical interface
       and one VLAN on another interface. For STP-enabled bridges, this	agent
       tries to	determine the network topology,	and by default looks only on
       ports which are connected to an upstream	switch.	This can be overridden
       by 'bridge_ports' parameter. Active interfaces in this case are those
       in "forwarding" state. For balancing bonded interfaces, this agent uses
       80% of the sum of the speeds of underlying "up" ports. For
       non-balancing bonded interfaces ("active-backup"	and probably
       "broadcast"), only the speed of the currently active port is
       considered.

SUPPORTED PARAMETERS
       OCF_RESKEY_name = string	[ifspeed]
	   Attribute name

	   Name	of the node attribute to set

       OCF_RESKEY_iface	= string []
	   Network interface

	   If this is set, monitor this	network	interface. One of iface	or ip
	   must	be set.

       OCF_RESKEY_ip = string []
	   IPv4	or IPv6	address

	   If this is set instead of iface, monitor the	interface that holds
	   this	IP address. The	address	may be specified in dotted-quad
	   notation for	IPv4 (for example, 192.168.1.1)	or hexadecimal
	   notation for	IPv6 (for example, 2001:db8:DC28:0:0:FC57:D4C8:1FFF).
	   One of iface	or ip must be set.

       OCF_RESKEY_bridge_ports = string	[detect]
	   Bridge ports

	   If set and iface is a bridge, consider these	bridge ports (by
	   default, all	ports which have designated_bridge=root_id)

       OCF_RESKEY_weight_base =	integer	[1000]
	   Weight of 1Gbps

	   Relative weight of 1Gbps in interface speed.	Can be used to tune
	   how big attribute value will	be.

       OCF_RESKEY_dampen = integer [5]
	   Dampening interval

	   The time to wait (dampening)	for further changes to occur.

       OCF_RESKEY_debug	= string [false]
	   Verbose logging

	   Log more verbosely.

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

Pacemaker Configuration		  05/13/2025	       OCF_PACEMAKER_IFSPEE(7)

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

home | help