Werkwijze Voor: beheerders, gebruikers

Netwerkproblemen oplossen

Symptomen van IP-pools, publieke adressen, hostbridge-netwerken, reverse DNS en uitgaande mail, met oorzaak en oplossing.

Elk onderdeel noemt een symptoom, de oorzaak en wat u moet doen. Bericht-id's verwijzen naar het onderdeel in de foutcodes.

Geen adres voor een server

Oorzaak. De pool heeft geen vrij IPv4-adres of IPv6-blok meer (error.ip_pool.exhausted). Adressen die zijn toegewezen, gereserveerd of in quarantaine staan, tellen niet als vrij. De server kan ook geen netwerkadapter hebben op het netwerk van de pool (error.ip_pool.no_nic), of de adapter heeft al een primair adres in deze pool (error.ip_pool.primary_exists).

Oplossing.

  1. Lees de vrije adressen van de pool: kyvernon ip-pools available <pool>.
  2. Lees wat de server heeft: kyvernon addresses list <vm>.
  3. Geef adressen vrij die niet meer worden gebruikt, of vergroot de bereiken van de pool: kyvernon ip-pools update <pool> --range <first>-<last>.
  4. Voeg voor een server zonder geschikte adapter er een toe op het netwerk van de pool in de hardware-instellingen van de virtuele machine.

Adres in gebruik of in quarantaine

Oorzaak. Een andere aanroeper nam het adres tussen het tonen en het toewijzen (error.ip_pool.address_in_use), of het adres is onlangs vrijgegeven en blijft 14 dagen in quarantaine, tenzij de pool een andere periode instelt (error.ip_pool.address_quarantined).

Oplossing. Toon de vrije adressen opnieuw met kyvernon ip-pools available <pool> en kies een ander adres, of wijs toe zonder een adres te noemen om het eerste vrije te nemen. kyvernon ip-pools allocations <pool> toont wanneer een quarantaine eindigt.

Netwerkadapter zonder backing

Oorzaak. Een netwerkadapter is verbonden met een netwerk zonder hostbridge, en kan daarom niet aan een bridge worden gekoppeld wanneer de virtuele machine start (error.nic_network_unwired). De console toont zo'n netwerk met de backing Niet gekoppeld.

Oplossing.

  1. Geef het netwerk een bridge: kyvernon network update <id> --body-file network.json, met een backing die de bridge noemt.
  2. Of verbind de adapter met een netwerk dat een bridge heeft.
  3. Schakel de virtuele machine opnieuw in.

Proxymodus geweigerd

Oorzaak. De uplinkmodus proxy vraagt een Open vSwitch-bridge en de naam van de uplink-interface. De interface ontbreekt, heeft de naam van de bridge, of het netwerk is een quarantainenetwerk of een Linux-bridge (error.network.proxy_uplink).

Oplossing. Stel "uplink": {"mode": "proxy", "interface": "eno1"} in op een Open vSwitch-netwerk, met de echte naam van de hostinterface, of gebruik de modus bridged.

Publiek adres antwoordt niet

Oorzaak. Het adres is toegewezen, maar het verkeer komt niet aan. Veelvoorkomende redenen: de bridge of het VLAN op de host past niet bij het netwerk, de provider accepteert in brugmodus het MAC-adres van de gast niet, of de gast heeft het adres niet geconfigureerd. Alleen het primaire IPv4-adres komt via DHCP; extra adressen en het IPv6-blok configureert u in de gast.

Oplossing.

  1. Controleer de bridge, het VLAN en de MTU op de host: kyvernon host network-health <host>. Een andere status dan ok noemt wat afwijkt.
  2. Lees de adressen van de server: kyvernon addresses list <vm>, en vergelijk ze met de configuratie in de gast.
  3. Als de provider MAC-adressen filtert, zet u de uplink in de modus proxy, zoals beschreven in IP-pools.
  4. Een netwerkadapter die verzendt vanaf een adres dat hij niet heeft gekregen, wordt door poortbeveiliging geblokkeerd; wijs het adres eerst aan de adapter toe.

Netwerk kan niet worden verwijderd

Oorzaak. Een virtuele machine heeft nog een netwerkadapter op het netwerk. Het verzoek mislukt met een preconditiefout en noemt de virtuele machines.

Oplossing. Verbind die adapters met een ander netwerk of verwijder ze, en verwijder het netwerk daarna opnieuw: kyvernon network delete <id>.

IP-pool kan niet worden verwijderd of gewijzigd

Oorzaak. De pool heeft nog toewijzingen (error.ip_pool.in_use), een bereik overlapt met het bereik van een andere pool op hetzelfde netwerk (error.ip_pool.overlap), of het IPv6-prefix en de bloklengte kunnen niet veranderen zolang er blokken zijn toegewezen of in quarantaine staan (error.ip_pool.ipv6_layout_in_use).

Oplossing. Geef de adressen vrij met kyvernon addresses release <vm> of kyvernon ip-pools free <pool> <address>, wacht tot de quarantaine eindigt en wijzig de pool daarna. Vergelijk de bereiken van beide pools met kyvernon ip-pools get <pool>.

Reverse DNS blijft op verzocht staan

Oorzaak. In handmatige modus blijft een naam opgeslagen als verzocht totdat een operator hem bevestigt. In automatische modus kan de DNS-provider hem weigeren: geen reverse zone bevat het adres (error.rdns.no_zone), de naam wordt niet naar het adres omgezet (error.rdns.not_forward_confirmed), of de provider accepteerde de wijziging niet (error.rdns.provider_failed).

Oplossing. Pas de naam toe bij de provider en voer dan kyvernon ip-pools ptr-applied <pool> <address> uit; of wijs hem af met een reden: kyvernon ip-pools ptr-rejected <pool> <address> --reason <text>. Maak bij de andere oorzaken eerst het forward-record van de naam aan, of herhaal het verzoek later. Zie Reverse DNS.

Uitgaande mail geblokkeerd

Oorzaak. De pool blokkeert uitgaande TCP-poort 25: IPv4 is standaard toegestaan en IPv6 geblokkeerd, en een server kan afzonderlijk worden gedeblokkeerd.

Oplossing. Een operator leest en wijzigt de status: kyvernon addresses smtp <vm>, en kyvernon addresses smtp <vm> --unblock --reason <text>. De wijziging wordt als gebeurtenis vastgelegd.

Oorzaak. Logische OVN-netwerken zijn niet ingeschakeld (geen [ovn] in controller.toml), de controller heeft de verbinding met de OVN-Northbound-database verloren, of de host heeft de logische poort niet gebonden: ovn-controller op de host is niet verbonden met de Southbound-database, of aan een voorwaarde op de host is niet voldaan.

Oplossing.

  1. Lees de realisatie met GET /v1/network/realization. connected moet true zijn en realizedGeneration gelijk aan modelGeneration; onder hosts moet de host van de virtuele machine applied: true melden en de poort meetellen in portsInstalled. preconditions noemt wat de host mist.
  2. Voer op de host sudo bash deploy/server1/ovn-doctor.sh host uit; op de controllerhost sudo bash deploy/server1/ovn-doctor.sh central. Elke regel met FAIL noemt de stap die opnieuw moet.
  3. Wanneer de gebeurtenis NetworkNorthboundLostEvent de nieuwste netwerkgebeurtenis is, start de Northbound-database opnieuw; de controller maakt opnieuw verbinding en schrijft elk segment en elke poort opnieuw.

Versie 0.1. Laatst gewijzigd: 2026-11-13