From 8e41518a0363c11d741fc484bbf932698ad851c1 Mon Sep 17 00:00:00 2001 From: Thomas Moraine Date: Wed, 12 Nov 2025 08:39:43 +0100 Subject: [PATCH] docs(networking.md): warn users to reboot hosts after renaming nics This change is meant to prevent errors when trying to get interface flags ('no such device'). Signed-off-by: Thomas Moraine --- docs/networking/networking.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/networking/networking.md b/docs/networking/networking.md index 6bc92c51..4acfdb6c 100644 --- a/docs/networking/networking.md +++ b/docs/networking/networking.md @@ -126,6 +126,11 @@ If for some reason the NIC order between hosts doesn't match up, you can fix it These commands are meant to be done on non-active interfaces. Typically this will be done directly after install, before even joining a pool. ::: +:::warning +Always reboot the host after applying these changes. +Using the commands below without rebooting can cause errors, as many system components will still be tied to the old interface names. +::: + ``` interface-rename --help ``` @@ -142,10 +147,10 @@ ifconfig eth4 down ifconfig eth8 down ``` -The most common use will be an update statement like the following: -``` -interface-rename --update eth4=00:24:81:80:19:63 eth8=00:24:81:7f:cf:8b -``` +The most common use will be an update statement like: + +`interface-rename --update eth4=00:24:81:80:19:63 eth8=00:24:81:7f:cf:8b` + This example will set the mac-address for eth4 & eth8, switching them in the process. The XAPI database needs the old PIFs removed. First list your PIFs for the affected NICs: