MAN page from openSUSE Tumbleweed wicked-0.6.45-1.1.i586.rpm

IFCFG-BONDING

Section: Network configuration (5)
Updated: January 2014
Index

NAME

ifcfg-bonding - interface bonding configuration

SYNOPSIS

/etc/sysconfig/network/ifcfg-*

Bonding Interfaces

To setup a bonding interface you need a configuration file ifcfg-bond<X> withthe usual network settings. But you must add additional variables

BONDING_MASTER: must be set to 'yes' to identify this interface as a bonding interface
BONDING_SLAVE_<X>: here you specify the interface name representing the slave network interfaces.
Note also: Bonding slave interfaces are reserved for the bonding and are notusable for any another purposes (unlike e.g. interfaces used for VLANs) andthe bonding master manages the slaves itself, e.g. it sets the MAC addresson the slaves by default. To configure this accordingly, set BOOTPROTO=nonein the ifcfg file of each slave interfaces to avoid any IP or link-layersetup on these interfaces. Wicked will apply the link settings(e.g. for fail_over_mode=active) at enslave time.
BONDING_MODULE_OPTS: contains bonding options. Here you can set interface timeouts or working modes('mode=active-backup' for backup mode). For additional information take a lookinto the documentation mentioned at the bottom.Note, that this options are not passed as parameters to the bonding kernelmodule any more, but set via sysfs interface. This variable will be renamedin the feature.

Example

Example for a bonding interface on eth0 and eth1 using the backup mode

ifcfg-bond0

   STARTMODE='onboot'   BOOTPROTO='static'   IPADDR='192.168.0.1/24'   BONDING_MASTER='yes'   BONDING_SLAVE_0='eth0'   BONDING_SLAVE_1='eth1'   BONDING_MODULE_OPTS='mode=active-backup miimon=100'

ifcfg-eth0

   STARTMODE='hotplug'   BOOTPROTO='none'   #ETHTOOL_OPTIONS='wol g'

ifcfg-eth1

   STARTMODE='hotplug'   BOOTPROTO='none'   #ETHTOOL_OPTIONS='wol g'

Note, that the slaves are configured with BOOTPROTO='none', what avoidslink set UP and IP configuration of the slaves. Further also STARTMODE='hotplug',allowing that some (all) of the slaves are allowed to be missed at boot time.The hotplug slaves will be added to the bond as soon as are become available(udev BUS based persistent name rule or manual ifup bond0 is required).Wicked waits for the slaves, but when there is no slave availableat bonding start time (boot time), the bonding creation will fail and alsowicked will report an error.

Additional Information

For additional and more general information take a look intohttp://www.linuxfoundation.org/collaborate/workgroups/networking/bondingor/usr/src/linux/Documentation/networking/bonding.txt.Maybe you need to install the kernel sources to get this additionaldocumentation.

The configuration of routes for this kind of interface does not differ fromordinary interfaces. Seeman routesfor details.

COPYRIGHT

BUGS

Please report bugs at <https://bugzilla.novell.com/index.cgi>

AUTHOR

Wilken Gottwalt -- original bonding man page

This document was created byman2html,using the manual pages.