[ewg] [PATCH] ofed-docs: bonding related documentation

Moni Shoua monis at Voltaire.COM
Thu May 29 08:33:31 PDT 2008


Hi,
Please apply to docs git under ofed_1_3 branch.
The content of the patch is related to changes in 
ib-bonding 
thanks
 MoniS

-----------------------------------------------------

diff --git a/ib-bonding.txt b/ib-bonding.txt
index 5d7b744..350f11b 100644
--- a/ib-bonding.txt
+++ b/ib-bonding.txt
@@ -6,9 +6,10 @@ IB Bonding
 3. How to work with interface configuration scripts
 3.1 Configuration with initscripts support
 3.1.1 Writing network scripts under Redhat-AS4 (Update 4, 5 or 6)
-3.1.2 Writing network scripts under Redhhat-EL5 (Update 1)
+3.1.2 Writing network scripts under Redhhat-EL5
 3.2 Configuration with sysconfig support
 3.2.1 Writing network scripts under SLES-10
+3.3 Configuring Ethernet slaves
 
 1. Introduction
 -------------------------------------------------------------------------------
@@ -29,12 +30,10 @@ manage and control the driver operation.
    ib1 will be used as slaves. Child interfaces are allowed.
  --miimon: the MII monitoring interval in mSec. Default is 100
 * Deleting a bonding network interface
- --stop: unenslave slaves and delete a specific bonding network interface 
-         (use with --bond-name)
+ --stop: unenslave slaves and delete a specific bonding network interface (use with --bond-name)
  --stop-all: unenslave slaves and delete all bonding network interfaces
 * Querying a bonding network interface
- --status: show the status of a specific bonding network interface 
-           (use with --bond-name)
+ --status: show the status of a specific bonding network interface (use with --bond-name)
  --status-all: show the status of all bonding network interfaces
  
 Examples:
@@ -43,8 +42,7 @@ Examples:
 	ib-bond --bond-ip 192.186.10.100 --slaves ib0,ib2
 * To bring up bond1 with ib0.f1f1 1and ib1.f1f1 as slaves with non default
   netmask
-	ib-bond --bond-name bond1 --bond-ip 192.186.10.100/25 
-	        --slaves ib0.f1f1,ib1.f1f1
+	ib-bond --bond-name bond1 --bond-ip 192.186.10.100/25 --slaves ib0.f1f1,ib1.f1f1
 * To query the status of bond1
 	ib-bond --bond-name bond1 --status
 * To query the status of all bonding interfaces
@@ -66,8 +64,7 @@ create the bonding configuration (depend
 3.1 Configuration with initscripts support
 ------------------------------------------
 Note: This feature is available only for Redhat-AS4 (Update 4, Update 5 or
-Update 6) and
-      for Redhat-EL5 and above.
+Update 6) and for Redhat-EL5 and above.
 
 3.1.1 Writing network scripts under Redhat-AS4 (Update 4, 5 or 6)
 -----------------------------------------------------------------
@@ -92,8 +89,7 @@ SLAVE=yes
 MASTER=<bond name>
 TYPE=InfiniBand
 
-Example: the script for ib0 (slave) would be named 
-         /etc/sysconfig/network-scripts/ifcfg-ib0
+Example: the script for ib0 (slave) would be named /etc/sysconfig/network-scripts/ifcfg-ib0
 with the following text in the file:
 
 DEVICE=ib0
@@ -107,8 +103,8 @@ TYPE=InfiniBand
 After the configuration is saved, restart the network service by running:
 /etc/init.d/network restart
 
-3.1.2 Writing network scripts under Redhhat-EL5 (Update 1)
-----------------------------------------------------------
+3.1.2 Writing network scripts under Redhhat-EL5
+-----------------------------------------------
 Follow the instructions in 3.1.1 (Writing network scripts under Redhat-AS4)
 with the following changes:
 * In the bondX (master) script - the line TYPE=Bonding is not needed.
@@ -129,8 +125,8 @@ interface.
 ----------------------------------------
 Note: This feature is available only for SLES-10 and above.
 
-3.2.1 Writing network scripts under SLES-10
--------------------------------------------
+3.2.1 Writing network scripts under SLES-10 SP1
+-----------------------------------------------
 * In the master (bond) interface script add the lins:
 
 BONDING_MASTER=yes
@@ -161,3 +157,19 @@ PRE_DOWN_SCRIPT=/etc/sysconfig/network/u
 
 After the configuration is saved, restart the network service by running:
 /etc/init.d/network restart
+
+3.3 Configuring Ethernet slaves
+-------------------------------
+It is not possible to have a mix of Ethernt slaves and IPoIB slaves under the
+same bonding master. It is possible however that a bonding master of Ethernet
+slaves and a bonding master of IPoIB slaves will co-exist in one machne.
+To configure Ethernet slaves under a bonding master use the same instructions
+as for IPoIB slaves (according  to the OS) with one exception. When working
+under Redhat-AS4 do the following when configuring a bonding  master with
+Ethernet slaves
+
+- In the master configuration file add the line
+SLAVEDEV=1
+- In the slave configuration file leave the line
+TYPE=InfiniBand
+
diff --git a/ipoib_release_notes.txt b/ipoib_release_notes.txt
index c05b9a5..1d3d3d6 100755
--- a/ipoib_release_notes.txt
+++ b/ipoib_release_notes.txt
@@ -277,3 +277,6 @@ Notes:
 - Kernel Oops during "port up/down test" (bug 1040)
 - Restart the stack during iperf 2.0.4 ver2.0.4 in client side cause to kernel 
   panic (bug 985)
+- Bonding: Enable build for SLES10 SP2
+- Bonding: Fix  issue in using the bonding module for Ethernet slaves (see
+  documentation for details)



More information about the ewg mailing list