aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/networking/bonding.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/networking/bonding.txt')
-rw-r--r--Documentation/networking/bonding.txt43
1 files changed, 18 insertions, 25 deletions
diff --git a/Documentation/networking/bonding.txt b/Documentation/networking/bonding.txt
index 080ad26690ae..d5e869814040 100644
--- a/Documentation/networking/bonding.txt
+++ b/Documentation/networking/bonding.txt
@@ -173,9 +173,8 @@ bonding module at load time, or are specified via sysfs.
173 173
174 Module options may be given as command line arguments to the 174 Module options may be given as command line arguments to the
175insmod or modprobe command, but are usually specified in either the 175insmod or modprobe command, but are usually specified in either the
176/etc/modules.conf or /etc/modprobe.conf configuration file, or in a 176/etc/modrobe.d/*.conf configuration files, or in a distro-specific
177distro-specific configuration file (some of which are detailed in the next 177configuration file (some of which are detailed in the next section).
178section).
179 178
180 Details on bonding support for sysfs is provided in the 179 Details on bonding support for sysfs is provided in the
181"Configuring Bonding Manually via Sysfs" section, below. 180"Configuring Bonding Manually via Sysfs" section, below.
@@ -1021,7 +1020,7 @@ ifcfg-bondX files.
1021 1020
1022 Because the sysconfig scripts supply the bonding module 1021 Because the sysconfig scripts supply the bonding module
1023options in the ifcfg-bondX file, it is not necessary to add them to 1022options in the ifcfg-bondX file, it is not necessary to add them to
1024the system /etc/modules.conf or /etc/modprobe.conf configuration file. 1023the system /etc/modules.d/*.conf configuration files.
1025 1024
10263.2 Configuration with Initscripts Support 10253.2 Configuration with Initscripts Support
1027------------------------------------------ 1026------------------------------------------
@@ -1098,15 +1097,13 @@ queried targets, e.g.,
1098 arp_ip_target=+192.168.1.1 arp_ip_target=+192.168.1.2 1097 arp_ip_target=+192.168.1.1 arp_ip_target=+192.168.1.2
1099 1098
1100 is the proper syntax to specify multiple targets. When specifying 1099 is the proper syntax to specify multiple targets. When specifying
1101options via BONDING_OPTS, it is not necessary to edit /etc/modules.conf or 1100options via BONDING_OPTS, it is not necessary to edit /etc/modprobe.d/*.conf.
1102/etc/modprobe.conf.
1103 1101
1104 For even older versions of initscripts that do not support 1102 For even older versions of initscripts that do not support
1105BONDING_OPTS, it is necessary to edit /etc/modules.conf (or 1103BONDING_OPTS, it is necessary to edit /etc/modprobe.d/*.conf, depending upon
1106/etc/modprobe.conf, depending upon your distro) to load the bonding module 1104your distro) to load the bonding module with your desired options when the
1107with your desired options when the bond0 interface is brought up. The 1105bond0 interface is brought up. The following lines in /etc/modprobe.d/*.conf
1108following lines in /etc/modules.conf (or modprobe.conf) will load the 1106will load the bonding module, and select its options:
1109bonding module, and select its options:
1110 1107
1111alias bond0 bonding 1108alias bond0 bonding
1112options bond0 mode=balance-alb miimon=100 1109options bond0 mode=balance-alb miimon=100
@@ -1152,7 +1149,7 @@ knowledge of bonding. One such distro is SuSE Linux Enterprise Server
1152version 8. 1149version 8.
1153 1150
1154 The general method for these systems is to place the bonding 1151 The general method for these systems is to place the bonding
1155module parameters into /etc/modules.conf or /etc/modprobe.conf (as 1152module parameters into a config file in /etc/modprobe.d/ (as
1156appropriate for the installed distro), then add modprobe and/or 1153appropriate for the installed distro), then add modprobe and/or
1157ifenslave commands to the system's global init script. The name of 1154ifenslave commands to the system's global init script. The name of
1158the global init script differs; for sysconfig, it is 1155the global init script differs; for sysconfig, it is
@@ -1228,7 +1225,7 @@ network initialization scripts.
1228specify a different name for each instance (the module loading system 1225specify a different name for each instance (the module loading system
1229requires that every loaded module, even multiple instances of the same 1226requires that every loaded module, even multiple instances of the same
1230module, have a unique name). This is accomplished by supplying multiple 1227module, have a unique name). This is accomplished by supplying multiple
1231sets of bonding options in /etc/modprobe.conf, for example: 1228sets of bonding options in /etc/modprobe.d/*.conf, for example:
1232 1229
1233alias bond0 bonding 1230alias bond0 bonding
1234options bond0 -o bond0 mode=balance-rr miimon=100 1231options bond0 -o bond0 mode=balance-rr miimon=100
@@ -1793,8 +1790,8 @@ route additions may cause trouble.
1793 On systems with network configuration scripts that do not 1790 On systems with network configuration scripts that do not
1794associate physical devices directly with network interface names (so 1791associate physical devices directly with network interface names (so
1795that the same physical device always has the same "ethX" name), it may 1792that the same physical device always has the same "ethX" name), it may
1796be necessary to add some special logic to either /etc/modules.conf or 1793be necessary to add some special logic to config files in
1797/etc/modprobe.conf (depending upon which is installed on the system). 1794/etc/modprobe.d/.
1798 1795
1799 For example, given a modules.conf containing the following: 1796 For example, given a modules.conf containing the following:
1800 1797
@@ -1821,20 +1818,16 @@ add above bonding e1000 tg3
1821bonding is loaded. This command is fully documented in the 1818bonding is loaded. This command is fully documented in the
1822modules.conf manual page. 1819modules.conf manual page.
1823 1820
1824 On systems utilizing modprobe.conf (or modprobe.conf.local), 1821 On systems utilizing modprobe an equivalent problem can occur.
1825an equivalent problem can occur. In this case, the following can be 1822In this case, the following can be added to config files in
1826added to modprobe.conf (or modprobe.conf.local, as appropriate), as 1823/etc/modprobe.d/ as:
1827follows (all on one line; it has been split here for clarity):
1828 1824
1829install bonding /sbin/modprobe tg3; /sbin/modprobe e1000; 1825install bonding /sbin/modprobe tg3; /sbin/modprobe e1000;
1830 /sbin/modprobe --ignore-install bonding 1826 /sbin/modprobe --ignore-install bonding
1831 1827
1832 This will, when loading the bonding module, rather than 1828 This will load tg3 and e1000 modules before loading the bonding one.
1833performing the normal action, instead execute the provided command. 1829Full documentation on this can be found in the modprobe.d and modprobe
1834This command loads the device drivers in the order needed, then calls 1830manual pages.
1835modprobe with --ignore-install to cause the normal action to then take
1836place. Full documentation on this can be found in the modprobe.conf
1837and modprobe manual pages.
1838 1831
18398.3. Painfully Slow Or No Failed Link Detection By Miimon 18328.3. Painfully Slow Or No Failed Link Detection By Miimon
1840--------------------------------------------------------- 1833---------------------------------------------------------