Skip to content

Commit a4cc68e

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 <thomas.moraine@vates.tech>
1 parent 5c02eab commit a4cc68e

File tree

1 file changed

+10
-5
lines changed

1 file changed

+10
-5
lines changed

docs/networking/networking.md

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,12 @@ In a pool, all NICs across your hosts should match up exactly. So if your manage
123123
If for some reason the NIC order between hosts doesn't match up, you can fix it with the interface-rename command.
124124

125125
:::tip
126-
These commands are meant to be done on non-active interfaces. Typically this will be done directly after install, before even joining a pool.
126+
- These commands are meant to be done on non-active interfaces. Typically this will be done directly after install, before even joining a pool.
127+
:::
128+
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.
127132
:::
128133

129134
```
@@ -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)