Skip to content

Commit 8e41518

Browse files
committed
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 <[email protected]>
1 parent 5c02eab commit 8e41518

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

docs/networking/networking.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,11 @@ If for some reason the NIC order between hosts doesn't match up, you can fix it
126126
These commands are meant to be done on non-active interfaces. Typically this will be done directly after install, before even joining a pool.
127127
:::
128128

129+
:::warning
130+
Always reboot the host after applying these changes.
131+
Using the commands below without rebooting can cause errors, as many system components will still be tied to the old interface names.
132+
:::
133+
129134
```
130135
interface-rename --help
131136
```
@@ -142,10 +147,10 @@ ifconfig eth4 down
142147
ifconfig eth8 down
143148
```
144149

145-
The most common use will be an update statement like the following:
146-
```
147-
interface-rename --update eth4=00:24:81:80:19:63 eth8=00:24:81:7f:cf:8b
148-
```
150+
The most common use will be an update statement like:
151+
152+
`interface-rename --update eth4=00:24:81:80:19:63 eth8=00:24:81:7f:cf:8b`
153+
149154
This example will set the mac-address for eth4 & eth8, switching them in the process.
150155

151156
The XAPI database needs the old PIFs removed. First list your PIFs for the affected NICs:

0 commit comments

Comments
 (0)