# ESXi 8: Default-Gateway setzen

<main id="bkmrk-gilt-f%C3%BCr-esxi-8.x%2C-s"><header>Gilt für ESXi 8.x, Standard TCP/IP-Stack (Management). Beispielnetz: 10.10.8.0/21, Gateway 10.10.15.254.

</header><section>## 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
```

</section><section>## Lösung

1. **Aktuelle Routen prüfen**```
    esxcli network ip route ipv4 list
    ```
2. **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
    ```
3. **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
    ```
4. **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
    ```

<div class="success">**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.</div></section><section>## 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
```

</section><section>## 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
```

</section><section>## 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
```

</section><section>## 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.

</section><section>## Risiko- und Durchführungs-Hinweise

<div class="warning">**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.</div></section>---

<footer class="meta">Zuletzt aktualisiert: <time datetime="2025-11-01">01.11.2025</time></footer></main>