ESXi 8: Default-Gateway setzen

Gilt für ESXi 8.x, Standard TCP/IP-Stack (Management). Beispielnetz: 10.10.8.0/21, Gateway 10.10.15.254.

Problem

Ein ESXi-Host lässt sich nicht ins vCenter einbinden oder verliert die Verbindung, weil kein (oder ein falsches) Default-Gateway gesetzt ist. In der Routingtabelle erscheint nur die direkt verbundene Route ohne default.

~ # esxcli network ip route ipv4 list
Network    Netmask        Gateway       Interface  Source
---------  -------------  ------------  ---------  ------
10.10.8.0  255.255.248.0  0.0.0.0       vmk0       MANUAL

Lösung

Aktuelle Routen prüfen
```
esxcli network ip route ipv4 list
```

Default-Route setzen (Standard-Stack):

esxcli network ip route ipv4 add --network default --gateway 10.10.15.254

Alternativ gleichwertig:

esxcli network ip route ipv4 add --network 0.0.0.0/0 --gateway 10.10.15.254

Ergebnis kontrollieren

esxcli network ip route ipv4 list
esxcfg-route -l

Erwartete Ausgabe:

Network    Netmask        Gateway       Interface  Source
---------  -------------  ------------  ---------  ------
default    0.0.0.0        10.10.15.254  vmk0       MANUAL
10.10.8.0  255.255.248.0  0.0.0.0       vmk0       MANUAL

Verbindung testen
```
vmkping 10.10.15.254
```
Bei mehreren VMkernel-Ports im selben Subnetz kann das Interface erzwungen werden:
```
vmkping -I vmk0 10.10.15.254
```

Hinweis: Das Setzen der Default-Route über esxcli ist persistent. Nach Reboots kann jedoch der in einem Subnetz bevorzugte VMkernel-Port wechseln (niedrigste vmk-Nummer). Achte darauf, dass der gewünschte Management-vmk im Subnetz die niedrigste Nummer hat oder nur dieser das Tag Management trägt.

Falsche Default-Route zuerst entfernen (optional)

Falls bereits eine falsche Default-Route existiert, diese erst löschen und dann korrekt setzen:

# Beispiel: alte Default-Route entfernen
esxcli network ip route ipv4 remove --network default --gateway <ALT_GW>

# korrekte Default-Route hinzufügen
esxcli network ip route ipv4 add --network default --gateway 10.10.15.254

Legacy-Befehl (gleiches Ergebnis):

esxcfg-route -a default 10.10.15.254

Mehrere VMkernel-Ports im selben Subnetz

Wenn mehrere VMkernel-Ports im gleichen L3-Netz existieren, nutzt ESXi den niedrigsten vmk für den Gateway-Traffic. Bei Bedarf Management-Tags prüfen/anpassen:

esxcli network ip interface list
esxcli network ip interface ipv4 get
esxcli network ip interface tag list

# Beispiele:
esxcli network ip interface tag add --interface-name=vmk0 --tag=Management
esxcli network ip interface tag remove --interface-name=vmkX --tag=Management

Spezielle TCP/IP-Stacks (optional)

vMotion, Provisioning und NFS haben eigene TCP/IP-Stacks mit eigenen Gateways. Nur anpassen, wenn diese Workloads betroffen sind:

# Routen im vMotion-Stack anzeigen
esxcli network ip route ipv4 list --netstack=vmotion

# Default-Gateway im vMotion-Stack setzen
esxcli network ip route ipv4 add --netstack=vmotion --network default --gateway 10.10.15.254

Fehlerbilder, die auf fehlendes Gateway hindeuten

Host lässt sich im vCenter nicht hinzufügen oder bleibt im Status „Not responding“.
DNS-Auflösung funktioniert, aber Verbindungen zu externen Netzen schlagen fehl.
esxcli network ip route ipv4 list zeigt keine default-Route.

Risiko- und Durchführungs-Hinweise

Achtung: Änderungen an Routing und VMkernel-Ports können die Management-Konnektivität unterbrechen. Wenn möglich, lokal an der ESXi-Shell (DCUI/Remote-Console) arbeiten oder Out-of-Band-Zugriff bereit halten.