From 22eae7cd90be60a790234d2cd6e00524cc101f06 Mon Sep 17 00:00:00 2001 From: Tobias Ribizel Date: Sun, 15 Sep 2024 01:23:04 +0200 Subject: [PATCH 1/3] Remove mentions of eth0 Signed-off-by: Tobias Ribizel --- userdocs/contents/overlays.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/userdocs/contents/overlays.rst b/userdocs/contents/overlays.rst index 528e3172..a24aa563 100644 --- a/userdocs/contents/overlays.rst +++ b/userdocs/contents/overlays.rst @@ -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 From 2175bc4ddf1458da9aa0c7ca1b7e0aae8f6f4f45 Mon Sep 17 00:00:00 2001 From: Tobias Ribizel Date: Sun, 15 Sep 2024 01:23:51 +0200 Subject: [PATCH 2/3] Add note about eth0 usage Signed-off-by: Tobias Ribizel --- userdocs/contents/nodeconfig.rst | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/userdocs/contents/nodeconfig.rst b/userdocs/contents/nodeconfig.rst index 539b4aef..aaf17e9f 100644 --- a/userdocs/contents/nodeconfig.rst +++ b/userdocs/contents/nodeconfig.rst @@ -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,12 @@ 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 From 18ab25dc55f98df74da7bccae4f0b87752f28ca2 Mon Sep 17 00:00:00 2001 From: Tobias Ribizel Date: Tue, 17 Sep 2024 09:12:00 +0200 Subject: [PATCH 3/3] use rst note --- userdocs/contents/nodeconfig.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/userdocs/contents/nodeconfig.rst b/userdocs/contents/nodeconfig.rst index aaf17e9f..f39fa942 100644 --- a/userdocs/contents/nodeconfig.rst +++ b/userdocs/contents/nodeconfig.rst @@ -227,10 +227,11 @@ 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. +.. 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: