diff options
Diffstat (limited to 'Documentation/networking/bonding.txt')
-rw-r--r-- | Documentation/networking/bonding.txt | 43 |
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 |
175 | insmod or modprobe command, but are usually specified in either the | 175 | insmod 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 |
177 | distro-specific configuration file (some of which are detailed in the next | 177 | configuration file (some of which are detailed in the next section). |
178 | section). | ||
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 |
1023 | options in the ifcfg-bondX file, it is not necessary to add them to | 1022 | options in the ifcfg-bondX file, it is not necessary to add them to |
1024 | the system /etc/modules.conf or /etc/modprobe.conf configuration file. | 1023 | the system /etc/modules.d/*.conf configuration files. |
1025 | 1024 | ||
1026 | 3.2 Configuration with Initscripts Support | 1025 | 3.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 |
1101 | options via BONDING_OPTS, it is not necessary to edit /etc/modules.conf or | 1100 | options 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 |
1105 | BONDING_OPTS, it is necessary to edit /etc/modules.conf (or | 1103 | BONDING_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 | 1104 | your distro) to load the bonding module with your desired options when the |
1107 | with your desired options when the bond0 interface is brought up. The | 1105 | bond0 interface is brought up. The following lines in /etc/modprobe.d/*.conf |
1108 | following lines in /etc/modules.conf (or modprobe.conf) will load the | 1106 | will load the bonding module, and select its options: |
1109 | bonding module, and select its options: | ||
1110 | 1107 | ||
1111 | alias bond0 bonding | 1108 | alias bond0 bonding |
1112 | options bond0 mode=balance-alb miimon=100 | 1109 | options bond0 mode=balance-alb miimon=100 |
@@ -1152,7 +1149,7 @@ knowledge of bonding. One such distro is SuSE Linux Enterprise Server | |||
1152 | version 8. | 1149 | version 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 |
1155 | module parameters into /etc/modules.conf or /etc/modprobe.conf (as | 1152 | module parameters into a config file in /etc/modprobe.d/ (as |
1156 | appropriate for the installed distro), then add modprobe and/or | 1153 | appropriate for the installed distro), then add modprobe and/or |
1157 | ifenslave commands to the system's global init script. The name of | 1154 | ifenslave commands to the system's global init script. The name of |
1158 | the global init script differs; for sysconfig, it is | 1155 | the global init script differs; for sysconfig, it is |
@@ -1228,7 +1225,7 @@ network initialization scripts. | |||
1228 | specify a different name for each instance (the module loading system | 1225 | specify a different name for each instance (the module loading system |
1229 | requires that every loaded module, even multiple instances of the same | 1226 | requires that every loaded module, even multiple instances of the same |
1230 | module, have a unique name). This is accomplished by supplying multiple | 1227 | module, have a unique name). This is accomplished by supplying multiple |
1231 | sets of bonding options in /etc/modprobe.conf, for example: | 1228 | sets of bonding options in /etc/modprobe.d/*.conf, for example: |
1232 | 1229 | ||
1233 | alias bond0 bonding | 1230 | alias bond0 bonding |
1234 | options bond0 -o bond0 mode=balance-rr miimon=100 | 1231 | options 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 |
1794 | associate physical devices directly with network interface names (so | 1791 | associate physical devices directly with network interface names (so |
1795 | that the same physical device always has the same "ethX" name), it may | 1792 | that the same physical device always has the same "ethX" name), it may |
1796 | be necessary to add some special logic to either /etc/modules.conf or | 1793 | be 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 | |||
1821 | bonding is loaded. This command is fully documented in the | 1818 | bonding is loaded. This command is fully documented in the |
1822 | modules.conf manual page. | 1819 | modules.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. |
1825 | an equivalent problem can occur. In this case, the following can be | 1822 | In this case, the following can be added to config files in |
1826 | added to modprobe.conf (or modprobe.conf.local, as appropriate), as | 1823 | /etc/modprobe.d/ as: |
1827 | follows (all on one line; it has been split here for clarity): | ||
1828 | 1824 | ||
1829 | install bonding /sbin/modprobe tg3; /sbin/modprobe e1000; | 1825 | install 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. |
1833 | performing the normal action, instead execute the provided command. | 1829 | Full documentation on this can be found in the modprobe.d and modprobe |
1834 | This command loads the device drivers in the order needed, then calls | 1830 | manual pages. |
1835 | modprobe with --ignore-install to cause the normal action to then take | ||
1836 | place. Full documentation on this can be found in the modprobe.conf | ||
1837 | and modprobe manual pages. | ||
1838 | 1831 | ||
1839 | 8.3. Painfully Slow Or No Failed Link Detection By Miimon | 1832 | 8.3. Painfully Slow Or No Failed Link Detection By Miimon |
1840 | --------------------------------------------------------- | 1833 | --------------------------------------------------------- |