1OCF_PACEMAKER_IFSPEE(7)     Pacemaker Configuration    OCF_PACEMAKER_IFSPEE(7)
2
3
4

NAME

6       ocf_pacemaker_ifspeed - Network interface speed monitor
7

SYNOPSIS

9       [OCF_RESKEY_name=string] [OCF_RESKEY_iface=string]
10       [OCF_RESKEY_ip=string] [OCF_RESKEY_bridge_ports=string]
11       [OCF_RESKEY_weight_base=integer] [OCF_RESKEY_dampen=integer]
12       [OCF_RESKEY_debug=string]
13
14       ifspeed [start | stop | monitor | meta-data | validate-all]
15

DESCRIPTION

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

SUPPORTED PARAMETERS

35       OCF_RESKEY_name = string [ifspeed]
36           Attribute name
37
38           Name of the node attribute to set
39
40       OCF_RESKEY_iface = string []
41           Network interface
42
43           If this is set, monitor this network interface. One of iface or ip
44           must be set.
45
46       OCF_RESKEY_ip = string []
47           IPv4 or IPv6 address
48
49           If this is set instead of iface, monitor the interface that holds
50           this IP address. The address may be specified in dotted-quad
51           notation for IPv4 (for example, 192.168.1.1) or hexadecimal
52           notation for IPv6 (for example, 2001:db8:DC28:0:0:FC57:D4C8:1FFF).
53           One of iface or ip must be set.
54
55       OCF_RESKEY_bridge_ports = string [detect]
56           Bridge ports
57
58           If set and iface is a bridge, consider these bridge ports (by
59           default, all ports which have designated_bridge=root_id)
60
61       OCF_RESKEY_weight_base = integer [1000]
62           Weight of 1Gbps
63
64           Relative weight of 1Gbps in interface speed. Can be used to tune
65           how big attribute value will be.
66
67       OCF_RESKEY_dampen = integer [5]
68           Dampening interval
69
70           The time to wait (dampening) for further changes to occur.
71
72       OCF_RESKEY_debug = string [false]
73           Verbose logging
74
75           Log more verbosely.
76

AUTHOR

78       Andrew Beekhof <andrew@beekhof.net>
79           Author.
80
81
82
83Pacemaker Configuration           11/27/2023           OCF_PACEMAKER_IFSPEE(7)