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: unpromoted cost unpromoted 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: unpromoted cost unpromoted
           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: unpromoted 0|1
           unpromoted 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" OCF_CHECK_LEVEL="0" interval="10s"

SEE ALSO

       http://clusterlabs.org/

AUTHOR

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