kelvin/warewulf
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Merge pull request #1392 from upsj/network-interface-documentation

Browse Source 
Improve network interface documentation
This commit is contained in:
Christian Goll
2024-09-17 09:21:05 +02:00
committed by GitHub
parent 82df96bf16 18ab25dc55
commit 563b1816a6
2 changed files with 11 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
userdocs/contents/nodeconfig.rst
View File

@@ -178,7 +178,7 @@ provide the network information as follows:
.. code-block:: console
# wwctl node set --netdev eth0 --hwaddr 11:22:33:44:55:66 --ipaddr 10.0.2.1 --netmask 255.255.252.0 n001
# wwctl node set --netdev eno1 --hwaddr 11:22:33:44:55:66 --ipaddr 10.0.2.1 --netmask 255.255.252.0 n001
Are you sure you want to modify 1 nodes(s): y
You can now see that the node contains configuration attributes for
@@ -212,7 +212,7 @@ container, kernel, and network:
n001 profile -- default
n001 default:type -- (ethernet)
n001 default:onboot -- --
n001 default:netdev -- eth0
n001 default:netdev -- eno1
n001 default:hwaddr -- 11:22:33:44:55:66
n001 default:ipaddr -- 10.0.2.1
n001 default:ipaddr6 -- --
@@ -227,8 +227,13 @@ container, kernel, and network:
# wwctl node list -a n001 | grep cluster
n001 cluster -- cluster01
.. note::
Due to the way network interface names are assigned by the Linux kernel and overwritten by udev
and systemd in the default warewulf configuration, the use of `eth0/1/...` as interface names can lead to issues.
We recommend the use of the original predictable names assigned to the interfaces (`eno1, ...`),
as otherwise an interface may remain unconfigured if its name conflicts with the name of an already existing interface during boot.
To configure a bonded (link aggreagtion) network interface the following commands can be used:
To configure a bonded (link aggregation) network interface the following commands can be used:
.. code-block:: console

6
userdocs/contents/overlays.rst
View File

@@ -46,9 +46,9 @@ network configurations for
* NetworkManager
* EL legacy network scripts
it also contains udev rules, which will set the interface name of the
first network device to ``eth0``. Before the ``systemd`` init is
called, the overlay loops through the scripts in
it also contains udev rules, which will set the interface names
based on the hardware addresses configured for the node.
Before the ``systemd`` init is called, the overlay loops through the scripts in
``/wwinit/warwulf/init.d/*`` which will setup
* Ipmi