'\" t .\" Title: ocf_pacemaker_ifspeed .\" Author: Andrew Beekhof .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 03/31/2024 .\" Manual: Pacemaker Configuration .\" Source: Pacemaker Configuration .\" Language: English .\" .TH "OCF_PACEMAKER_IFSPEE" "7" "03/31/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" ocf_pacemaker_ifspeed \- Network interface speed monitor .SH "SYNOPSIS" .PP [\fBOCF_RESKEY_name\fR=string] [\fBOCF_RESKEY_iface\fR=string] [\fBOCF_RESKEY_ip\fR=string] [\fBOCF_RESKEY_bridge_ports\fR=string] [\fBOCF_RESKEY_weight_base\fR=integer] [\fBOCF_RESKEY_dampen\fR=integer] [\fBOCF_RESKEY_debug\fR=string] \fBifspeed\fR [start | stop | monitor | meta\-data | validate\-all | reload\-agent] .SH "DESCRIPTION" .PP This agent\*(Aqs 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 \*(Aqbridge_ports\*(Aq 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\&. .SH "SUPPORTED PARAMETERS" .PP \fBOCF_RESKEY_name\fR = string [ifspeed] .RS 4 Attribute name .sp Name of the node attribute to set .RE .PP \fBOCF_RESKEY_iface\fR = string [] .RS 4 Network interface .sp If this is set, monitor this network interface\&. One of iface or ip must be set\&. .RE .PP \fBOCF_RESKEY_ip\fR = string [] .RS 4 IPv4 or IPv6 address .sp 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\&. .RE .PP \fBOCF_RESKEY_bridge_ports\fR = string [detect] .RS 4 Bridge ports .sp If set and iface is a bridge, consider these bridge ports (by default, all ports which have designated_bridge=root_id) .RE .PP \fBOCF_RESKEY_weight_base\fR = integer [1000] .RS 4 Weight of 1Gbps .sp Relative weight of 1Gbps in interface speed\&. Can be used to tune how big attribute value will be\&. .RE .PP \fBOCF_RESKEY_dampen\fR = integer [5] .RS 4 Dampening interval .sp The time to wait (dampening) for further changes to occur\&. .RE .PP \fBOCF_RESKEY_debug\fR = string [false] .RS 4 Verbose logging .sp Log more verbosely\&. .RE .SH "AUTHOR" .PP \fBAndrew Beekhof\fR <\&andrew@beekhof\&.net\&> .RS 4 Author. .RE