Hypervisor
Diese Seite beschreibt, wie das Modul Hypervisor vCenter und ESXi anbindet, was es dort ändert und wo seine Grenzen liegen.
Was das Modul leistet, steht auf der Modulseite.
Stand: November 2026, COD 3.8.6
Inhalt der Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Überblick
| Merkmal | Wert |
|---|---|
| Zweck | Host-Netz lesen. Standard-vSwitches und Portgruppen anlegen, ändern und löschen. Abweichende Portgruppen-Namen je VLAN erkennen |
| Unterstützte Systeme | VMware vCenter und ESXi. Andere Hypervisoren wie Hyper-V oder KVM nicht |
| Schnittstelle | VMware-API über die Python-Bibliothek pyVmomi, per HTTPS |
| Verbindung und Richtung | Der Dienst cod-hypervisor auf dem COD-Server baut die Verbindung zu vCenter oder ESXi auf |
| Dienst | Läuft immer auf dem COD-Server, nie auf einem Modul-Server |
| Zugangsdaten | Hostname, Domain, Benutzer und Passwort je Verbindung. COD speichert die Verbindungen je Standort |
| Rechte am Ziel | Lesen für das Inventar. Für Änderungen Rechte am Host-Netz. Die Mindestrechte erhalten Sie im Projekt. |
| Verbindung zu anderen Modulen | Keine. Das Modul ist nicht mit Asset, Network oder Firewall verbunden |
Voraussetzungen
Auf dem COD-Server
- Paket
cod-hypervisorinstalliert. Es ist Teil voncod-all. - Der Dienst läuft auf demselben Host wie COD. COD spricht ihn nur lokal an.
- Der COD-Server erreicht vCenter oder die ESXi-Hosts per HTTPS.
Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.
In vCenter oder ESXi
- Eigenes Dienstkonto für COD, empfohlen. So bleiben Änderungen aus COD in vSphere nachvollziehbar.
- Leserecht auf Datacenter, Cluster, Hosts und Netze für das Inventar.
- Für Änderungen Rechte an vSwitches und Portgruppen der Hosts. Die Mindestrechte erhalten Sie im Projekt.
- Jeder ESXi-Host erscheint nur unter einem der angebundenen vCenter.
In COD
- Modul Hypervisor am Mandanten freigeschaltet.
- Rolle mit Recht auf das Modul Hypervisor.
Einrichtung
Der Rollout-Assistent deckt das Modul Hypervisor nicht ab. Den Dienst richten Sie auf dem COD-Server ein.
- Prüfen Sie auf dem COD-Server, ob der Dienst läuft:
systemctl status cod-hypervisor. Details unter TACACS+ und Hypervisor von Hand. - Das Manager-Konto schaltet das Modul frei: „Admin Area > Tenant > Modules“. Danach ab- und wieder anmelden.
- Wählen Sie in der Kopfzeile den Standort.
- Legen Sie im Modul Hypervisor unter „Connections“ eine Verbindung an: Hostname, Domain, Benutzer, Passwort.
- Prüfen Sie das Inventar. Es zeigt Datacenter, Cluster, Hosts, vSwitches und Portgruppen.
- Ändern Sie Portgruppen zuerst unter „Port Groups“ mit Dry Run. Erst wenn das Ergebnis stimmt, schreiben Sie auf die Hosts.
Für weitere vCenter legen Sie je vCenter eine eigene Verbindung an.
Technische Details
Anbindung
COD spricht vCenter und ESXi über die VMware-API an, mit der Python-Bibliothek pyVmomi über HTTPS. Die Zugangsdaten geben Sie nicht bei jedem Aufruf ein. COD speichert jede Verbindung mit Hostname, Domain, Benutzer und Passwort je Standort. Wer das Modul an einem Standort nutzt, arbeitet mit den Verbindungen dieses Standorts.
Inventar
| Ebene | Was COD zeigt |
|---|---|
| Datacenter, Cluster, Host | Objektbaum aus vCenter, nur lesend |
| vSwitch | Standard-vSwitches je Host, mit aktiven, Standby- und ungenutzten NICs und Sicherheitseinstellungen |
| Portgruppe | Name und VLAN-ID |
| Physische NICs | pNICs je Host |
Der Hypervisor-Baum gehört zu den Quellen der globalen Suche.
Funktionen
| Funktion | Wo | Dry Run |
|---|---|---|
| vSwitch anlegen, je Host mit gewählten physischen NICs als Uplink | Assistent unter „Structure“ | nein, schreibt sofort |
| Portgruppe anlegen | Assistent unter „Structure“ | nein, schreibt sofort |
| Portgruppe anlegen, ändern, löschen | „Port Groups“ | ja, ab Werk eingeschaltet |
| Abweichende Portgruppen-Namen erkennen | Inventar | nicht nötig, nur lesend |
VLAN-IDs
| Wert | Bedeutung |
|---|---|
| 1 bis 4095 | VLAN-ID beim Anlegen einer Portgruppe |
| 0 im Inventar | Untagged |
| 4095 im Inventar | Trunk über alle VLANs |
Mehrere Hosts
Operationen nehmen eine Liste von Hosts an. Das Ergebnis weist Erfolg oder Fehler je Host aus. Prüfen Sie nach jeder Änderung die Hosts mit Fehler einzeln.
Abweichende Namen
COD meldet, wenn dieselbe VLAN-ID auf gleichnamigen vSwitches über Hosts hinweg unter verschiedenen Portgruppen-Namen geführt wird. Das ist ein häufiger Grund für fehlgeschlagene Migrationen von VMs.
NIC-Teaming
COD zeigt die Zuordnung der NICs je vSwitch. Beim Anlegen eines vSwitch wählen Sie die physischen NICs als Uplink. Lastverteilung und Sicherheitsrichtlinien stellen Sie weiter in vSphere ein.
Audit
Änderungen stehen im Audit der Admin Area, mit Typ, gesendeten und zurückgegebenen Daten, Zeitpunkt und Benutzer. Dry Runs und der Assistent unter „Structure“ erscheinen dort nicht.
Bekannte Grenzen
| Grenze | Was Sie tun können |
|---|---|
| Nur Standard-vSwitches, keine Distributed Switches | Verwalten Sie Distributed Switches weiter in vSphere |
| Keine VM-Steuerung, kein Lebenszyklus von VMs oder Hosts | Nutzen Sie dafür vSphere |
| Keine Verbindung zu Asset, Network oder Firewall | Pflegen Sie ESXi-Hosts bei Bedarf zusätzlich als Asset |
| Ein ESXi-Host unter zwei vCentern bricht den Abgleich | Binden Sie jeden ESXi-Host nur über ein vCenter an |
| Dry Run nur unter „Port Groups“ | Nutzen Sie den Assistenten unter „Structure“ nur mit Bedacht, etwa im Wartungsfenster |
| Der Assistent unter „Structure“ erscheint nicht im Audit | Dokumentieren Sie diese Änderungen selbst |
| Keine verschmolzene Sicht über mehrere vCenter | Arbeiten Sie je Verbindung |
| Lastverteilung und Sicherheitsrichtlinien nicht in COD | Stellen Sie sie in vSphere ein |
| Dienst nur auf dem COD-Server | Planen Sie den Weg vom COD-Server zu vCenter und ESXi ein |
| Mindestrechte in vCenter nicht dokumentiert | Die Mindestrechte erhalten Sie im Projekt. |
Weiterführend
- Modulseite Hypervisor
- Was Ihr Netz für Hypervisor braucht
- Aufbauformen
- Fehlerbilder
- Integrationen
- Fragen zu den Modulen