[networking-guide] master: Creating Multiple Bonds (9868b2f)

[stephenw at fedoraproject.org]

Repository : http://git.fedorahosted.org/cgit/docs/networking-guide.git

On branch  : master

>---------------------------------------------------------------

commit 9868b2f64ce1eabe81dfbc9cb98c2dfc5a224cf0
Author: Stephen Wadeley <swadeley at redhat.com>
Date:   Wed Sep 3 22:08:22 2014 +0200

    Creating Multiple Bonds


>---------------------------------------------------------------

 en-US/Configure_Network_Bonding.xml |   48 +++++++++++++++++++++++++++++++++++
 1 files changed, 48 insertions(+), 0 deletions(-)

diff --git a/en-US/Configure_Network_Bonding.xml b/en-US/Configure_Network_Bonding.xml
index a437c6d..e7aa73a 100644
--- a/en-US/Configure_Network_Bonding.xml
+++ b/en-US/Configure_Network_Bonding.xml
@@ -444,6 +444,54 @@ Then when complete, bring up all the slaves, which will bring up the bond (provi
    </para>
  </section>
 
+
+
+      <section id="sec-Creating_Multiple_Bonds">
+      <title>Creating Multiple Bonds</title>
+      <para>
+        In &MAJOROSVER;, for each bond a channel bonding interface is created including the <command>BONDING_OPTS</command> directive. This configuration method is used so that multiple bonding devices can have different configurations. To create multiple channel bonding interfaces, proceed as follows:
+
+        <itemizedlist>
+          <listitem>
+            <para>
+              Create multiple <filename>ifcfg-bond<replaceable>N</replaceable></filename> files with the <command>BONDING_OPTS</command> directive; this directive will cause the network scripts to create the bond interfaces as required.
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              Create, or edit existing, interface configuration files to be bonded and include the <command>SLAVE</command> directive.
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              Assign the interfaces to be bonded, the slave interfaces, to the channel bonding interfaces by means of the <command>MASTER</command> directive.
+            </para>
+          </listitem>
+        </itemizedlist>
+      </para>
+        
+      <example id="ex-Example-multiple-bondN_interface_configuration_files">
+        <title>Example multiple ifcfg-bondN interface configuration files</title>
+
+              <para>
+        The following is an example of a channel bonding interface configuration file:
+        <programlisting>DEVICE=bondN
+NAME=bondN
+TYPE=Bond
+IPADDR=192.168.1.1
+NETMASK=255.255.255.0
+ONBOOT=yes
+BOOTPROTO=none
+BONDING_OPTS="<replaceable>bonding parameters separated by spaces</replaceable>"</programlisting>
+</para>
+      <para>
+        In this example, replace <replaceable>N</replaceable> with the number for the bond interface. For example, to create two bonds create two configuration files, <filename>ifcfg-bond0</filename> and <filename>ifcfg-bond1</filename>, with appropriate <systemitem class="protocol">IP</systemitem> addresses.
+      </para>
+      </example>
+
+      <para>
+        Create the interfaces to be bonded as per <xref linkend="ex-Example_Slave_Interface_Configuration_File" /> and assign them to the bond interfaces as required using the <command>MASTER=bond<replaceable>N</replaceable></command> directive. For example, continuing on from the example above, if two interfaces per bond are required, then for two bonds create four interface configuration files and assign the first two using <command>MASTER=bond<replaceable>0</replaceable></command> and the next two using <command>MASTER=bond<replaceable>1</replaceable></command>.</para>
+      </section>
  </section>
 
  <section