Scroll to navigation

OCF_HEARTBEAT_IFACE() OCF_HEARTBEAT_IFACE()

NAME

ocf_heartbeat_iface-bridge - Manages Bridge network interfaces.

SYNOPSIS

iface-bridge [start | stop | status | monitor | meta-data | validate-all]

DESCRIPTION

This resource manages Bridge network interfaces. It can add, remove, configure bridges and spanning-tree.

SUPPORTED PARAMETERS

bridge_name
Define the name of the bridge (max 15 charaters).
(unique, required, string, no default)
bridge_slaves
Define the list of interfaces, space separated, to add to the bridge. The list can be empty.
(unique, optional, string, no default)
bridge_ageing
Set the ethernet (MAC) address ageing time in seconds.
(optional, integer, no default)
port_hairpin
Set hairpin forwarding mode. A list of ports that should have hairpin enabled can be specified using the following Example: eth0 eth1
(optional, string, no default)
stp
Enable or disable Spanning Tree Protocol on the bridge.
(optional, boolean, default false)
stp_bridgeprio
Set the bridge's priority to defined value. The priority value is a number between 0 and 65535), and has no dimension. Lower priority values are preferred. The bridge with the lowest priority will be elected as root bridge.
(optional, integer, no default)
stp_fd
Set the bridge forward delay (in seconds).
(optional, integer, default 0)
stp_maxage
Set the bridge maximum message age (in seconds).
(optional, integer, no default)
stp_hello
Set the bridge hello time (in seconds).
(optional, integer, no default)
stp_pathcost
Set the port cost. This is a dimensionless metric. A list of port/cost can be specified using the following format: slave cost slave cost. Example: eth0 100 eth1 1000
(optional, string, no default)
stp_portprio
Set the port priority. This is a number between 0 and 63. brctl man page reports a value between 0 and 255, but tests show a limit of 63 on a live system. This metric is used in the designated port and root port selection algorithms. A list of port/priority can be specified using the following format: slave cost slave cost. Example: eth0 10 eth1 60
(optional, string, no default)
multicast_router
Enable or disable multicast routing on the bridge.
(optional, boolean, default 1)
multicast_snooping
Enable or disable multicast snooping on the bridge.
(optional, boolean, default 1)
multicast_port_router
Enable or disable a port from the multicast router. Kernel enables all port by default. A list of port can be specified using the following format: slave 0|1 slave 0|1. Example: eth0 1 eth1 0
(optional, string, no default)

SUPPORTED ACTIONS

This resource agent supports the following actions (operations):
start
Starts the resource. Suggested minimum timeout: 30s.
stop
Stops the resource. Suggested minimum timeout: 20s.
status
Performs a status check. Suggested minimum timeout: 20s. Suggested interval: 10s.
monitor
Performs a detailed status check. Suggested minimum timeout: 20s. Suggested interval: 10s.
meta-data
Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.
validate-all
Performs a validation of the resource configuration. Suggested minimum timeout: 20s.

EXAMPLE CRM SHELL

The following is an example configuration for a iface-bridge resource using the crm(8) shell:
primitive p_iface-bridge ocf:heartbeat:iface-bridge \
  params \
    bridge_name= string \
  op monitor timeout="20s" depth="0" interval="10s" 

EXAMPLE PCS

The following is an example configuration for a iface-bridge resource using pcs(8)
pcs resource create p_iface-bridge ocf:heartbeat:iface-bridge \
  bridge_name= string \
  op monitor timeout="20s" depth="0" interval="10s" 

SEE ALSO

http://clusterlabs.org/

AUTHOR

ClusterLabs contributors (see the resource agent source for information about individual authors)