diff --git a/static/docs/v4.5.x/_sources/contents/nodeconfig.rst.txt b/static/docs/v4.5.x/_sources/contents/nodeconfig.rst.txt index 539b4aef..f39fa942 100644 --- a/static/docs/v4.5.x/_sources/contents/nodeconfig.rst.txt +++ b/static/docs/v4.5.x/_sources/contents/nodeconfig.rst.txt @@ -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 diff --git a/static/docs/v4.5.x/_sources/contents/overlays.rst.txt b/static/docs/v4.5.x/_sources/contents/overlays.rst.txt index 528e3172..a24aa563 100644 --- a/static/docs/v4.5.x/_sources/contents/overlays.rst.txt +++ b/static/docs/v4.5.x/_sources/contents/overlays.rst.txt @@ -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 diff --git a/static/docs/v4.5.x/contents/nodeconfig.html b/static/docs/v4.5.x/contents/nodeconfig.html index 0ee772bd..bdb0d8d2 100644 --- a/static/docs/v4.5.x/contents/nodeconfig.html +++ b/static/docs/v4.5.x/contents/nodeconfig.html @@ -282,7 +282,7 @@
To configure the network, we have to pick a network device name and provide the network information as follows:
-# 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
@@ -314,7 +314,7 @@ Configuring the Node’s Networkn001 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 -- --
@@ -330,7 +330,14 @@ Configuring the Node’s Networkn001 cluster -- cluster01
To configure a bonded (link aggreagtion) network interface the following commands can be used:
+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 aggregation) network interface the following commands can be used: