bonding Module Directives bonding Module Directives

Before finalizing the settings for the bonding module, it is a good idea to test which settings work best. To do this, open a shell prompt as root and type:

tail -f /var/log/messages

Open another shell prompt and use the /sbin/insmod command to load the bonding module with different parameters while observing the kernel messages for errors.

The /sbin/insmod command is issued in the following format:

 /sbin/insmod bond<N><parameter=value>

Replace <N> with the number for the bonding interface. Replace <parameter=value> with a space separated list of desired parameters for the interface.

Once satisfied with the performance of the bonding interface (and verifying that there are no errors), add the appropriate bonding module parameters to ifcfg-bond<N> (where <N> is the number of the interface). These parameters are set as BONDING_OPTS="<parameters>". For more information, refer to Section 14.2.3, “Channel Bonding Interfaces”.

The following is a list of available parameters for the bonding module:


It is essential that either the arp_interval and arp_ip_target or miimon parameters are specified. Failure to due so can cause degradation of network performance in the event a link fails.

Refer to the following file for more information (note that you must have the kernel-doc package installed to read this file):

 /usr/share/doc/kernel-doc-<kernel-version>/Documentation/networking/ bonding.txt 

for detailed instructions regarding bonding interfaces.

Note: This documentation is provided {and copyrighted} by Red Hat®, Inc. and is released via the Open Publication License. The copyright holder has added the further requirement that Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder. The CentOS project redistributes these original works (in their unmodified form) as a reference for CentOS-5 because CentOS-5 is built from publicly available, open source SRPMS. The documentation is unmodified to be compliant with upstream distribution policy. Neither CentOS-5 nor the CentOS Project are in any way affiliated with or sponsored by Red Hat®, Inc.