[Bug 1011418] New: alias bondN bonding not required for bonding configuration

[bugzilla at redhat.com]

https://bugzilla.redhat.com/show_bug.cgi?id=1011418

            Bug ID: 1011418
           Summary: alias bondN bonding not required for bonding
                    configuration
           Product: Fedora Documentation
           Version: devel
         Component: system-administrator's-guide
          Assignee: swadeley at redhat.com
          Reporter: john.haxby at oracle.com
        QA Contact: docs-qa at lists.fedoraproject.org
                CC: swadeley at redhat.com



Description of problem:

In the F18 System Administrators Guide (and shouldn't that have an apostrophe
after the 's'?), §8.2.3 it says:

-----------------------
For a channel bonding interface to be valid, the kernel module must be loaded.
To ensure that the module is loaded when the channel bonding interface is
brought up, create a new file as root named bonding.conf in the
/etc/modprobe.d/ directory. Note that you can name this file anything you like
as long as it ends with a .conf extension. Insert the following line in this
new file:

alias bondN bonding

Replace N with the interface number, such as 0. For each configured channel
bonding interface, there must be a corresponding entry in your new
/etc/modprobe.d/bonding.conf file. 
------------------------

This is not true.   The network scripts in /etc/sysconfig/network-scripts
define the function install_bonding_driver which is called whenever a bonding
slave or master is detected.

Version-Release number of selected component (if applicable): F18


How reproducible: Always


Steps to Reproduce:
1. Configure a bond

2. Miss out the step that adds "alias bondN bonding" to a modprobe conf file

3. Notice that bonding actually works (NetworkManager notwithstanding)

Actual results: works as expected when ignoring the documentation


Expected results: works as expected when not ignoring the documentation


Additional info:

The install_bonding_driver has been around for a while, but the final piece of
code to make it reliable comes from, I think,

* Mon Aug 15 2011 Petr Lautrbach <plautrba at redhat.com> 9.03.24-1
...
- make sure the bond exists when we bring up the slaves. (#694501)

(commit id 3de0e06afda2e572d0952941498446fdda7f3f42)

-- 
You are receiving this mail because:
You are the QA Contact for the bug.