Document creating of bonded network interfaces

Signed-off-by: Dietmar Rieder <[email protected]>
JasonYangShadow · Feb 6, 2024 · 3a9654b · 3a9654b
1 parent 3e73a79
commit 3a9654b
Show file tree

Hide file tree

Showing 3 changed files with 14 additions and 0 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- ability to create bonded network interfaces
 - ipxe script to boot node from local disk.
 - Option to change the `ipmitool` escape character
 - New documentation for the hostlist syntax. #611

diff --git a/CONTRIBUTORS.md b/CONTRIBUTORS.md
@@ -30,3 +30,4 @@
 * Arnaud LECOMTE <[email protected]>
 * Ryan Novosielski <[email protected]>
 * Andreas Skau <[email protected]> @buzh
+* Dietmar Rieder <[email protected]>
diff --git a/userdocs/contents/nodeconfig.rst b/userdocs/contents/nodeconfig.rst
@@ -230,6 +230,18 @@ container, kernel, and network:
   # wwctl node list -a n001 | grep cluster
   n001                 cluster            --           cluster01
 
+
+To configure a bonded (link aggreagtion) network interface the following commands can be used:
+
+.. code-block:: console
+
+  # wwctl node set --netname=bond0_member_1 --netdev=eth2 --type=bond-slave n001
+  # wwctl node set --netname=bond0_member_2 --netdev=eth3 --type=bond-slave n001
+  # wwctl node set --netname=bond0 --netdev=bond0 --onboot=true --type=bond --ipaddr 10.0.3.1 --netmask=255.255.255.0 --mtu=9000 n001
+
+Note: the netnames of the member interterfaces need to match the "netname" of the bonded interface until the first "_" (in the example bond0)
+
+
 Node Discovery
 --------------