Am Tag der Erstinstallation ist die Netzwerkdokumentation vollständig; mit der ersten Änderung beginnt sie zu veralten. Nach einigen Jahren bleiben eine Visio-Zeichnung, der niemand traut, und Wissen der Art „diesen Port kannte der frühere Systemadministrator“. Im Folgenden beschreiben wir, was ein lebendiger Dokumentationssatz für ein Unternehmensnetzwerk enthalten sollte, wo diese Informationen geführt werden und wie sie durch Abgleich mit den Geräten aktuell bleiben.
Die betrieblichen Kosten fehlender Dokumentation
Bezahlt wird vor allem in der Krise. Herauszufinden, welche Gebäude von einem ausgefallenen Uplink betroffen sind, welchem Gerät an welchem Port eine Adresse bei einem IP-Konflikt gehört oder welche Leitungsnummer man für die Störungsmeldung beim Provider braucht, kann länger dauern als die Störung selbst. Es gibt auch weniger sichtbare Kosten:
- Engineering-Zeit, die vor jeder Änderung für die erneute Erkundung des Ist-Zustands aufgewendet wird
- Unerwartete Ausfälle durch das Löschen eines vermeintlich ungenutzten VLANs oder IP-Blocks
- Längere Einarbeitungszeit für neue Teammitglieder oder externe Dienstleister
- Netzsegmente und Sicherheitsgrenzen lassen sich bei einem Audit nicht nachweisen
Ziel ist nicht, alles zu dokumentieren. Die für Betrieb und Änderungsentscheidungen nötigen Mindestinformationen werden zuverlässig geführt. Eine unzuverlässige Dokumentation ist gefährlicher als gar keine, weil sie einer falschen Entscheidung Sicherheit verleiht. Ein falscher Eintrag führt stillschweigend in die Irre.
Minimaler Dokumentensatz: Topologie, IPAM, VLAN, Portzuordnung
Für ein mittelgroßes Unternehmensnetzwerk folgen hier der Mindestsatz und die betriebliche Frage, die jedes Teil beantwortet:
| Dokument | Inhalt | Beantwortete Frage |
|---|---|---|
| Physische Topologie (L1) | Schränke, Geräte, Glasfaser- und Kupferverbindungen | Wohin führt dieses Kabel? |
| Logische Topologie (L2/L3) | VLANs, Trunks, STP-Root, Subnetze, Routing | Welchen Weg nimmt der Verkehr? |
| IP-Adressplan (IPAM) | Präfix, Gateway, DHCP-Bereich, Zweck, Verantwortlicher | Ist diese Adresse frei, wem gehört sie? |
| VLAN-Liste | VLAN-ID, Name, Subnetz, betroffene Switches | Wo wird dieses VLAN genutzt? |
| Portzuordnung | Switchport, Patchfeld, Anschlussdose, angeschlossenes Gerät | Was ist an diesem Port angeschlossen? |
| Leitungs- und Anschlussinformationen | Provider, Leitungsnummer, Bandbreite, Supportkontakt | Wem melde ich die Störung? |
Zu diesem Satz kommen zwei ergänzende Aufzeichnungen: das Geräteinventar (Modell, Seriennummer, Softwareversion, Supportvertrag) und die Verwaltungszugangsdaten (Verwaltungs-IP, Out-of-Band-Weg, Port am Konsolenserver). Passwörter und gemeinsame Schlüssel gehören nicht in den Dokumentensatz, sondern in den Passworttresor; im Dokument steht nur der Name des Tresoreintrags. Ein mögliches Bild ist ein Enable-Passwort im Klartext in einer Tabelle im freigegebenen Ordner. Das ist keine Dokumentation, sondern eine Sicherheitslücke. Verknüpfen Sie die Geräte der Netzwerktopologie mit den Aufzeichnungen zu IT-Asset-Inventar und Datenklassifizierung des Unternehmens, damit Verantwortlichkeit und Kritikalität nachvollziehbar sind.
Das Design von VLAN- und Adressplan ist ein eigenes Thema; hier konzentrieren wir uns darauf, den bestehenden Plan zu erfassen. Zur Designseite siehe den Beitrag VLAN-Design im Unternehmensnetzwerk.
Physische und logische Topologiediagramme
Hauptgrund für unlesbare Diagramme ist der Versuch, alles auf eine Seite zu bringen. Trennen Sie die Diagramme nach Schichten:
- Campus-/Standortansicht: Gebäude, Serverräume und die Backbone-Verbindungen dazwischen; WAN- und Internetanschlüsse.
- Physische Ansicht: Geräte je Schrank, Uplink-Portnummern, Glasfaser-/Kupfertyp, Port-Channel-Mitglieder.
- L2-Ansicht: Trunks und die von ihnen geführten VLANs, STP-Root-Bridge und Backup-Root, MLAG-/Stack-Beziehungen.
- L3-Ansicht: Subnetze, Gateways (SVI, virtuelle IP von HSRP/VRRP), Bereiche der Routingprotokolle, VRFs und Firewall-Übergänge.
Jedes Diagramm sollte Versionsdatum, Verantwortlichen und Quelldaten haben. Häufig wechselnde Details wie Portnummern und IP-Adressen nicht von Hand ins Diagramm zu schreiben, sondern aus dem Source-of-Truth-System zu übernehmen, verlangsamt das Veralten des Diagramms. Werden auf der physischen Seite Kabel- und Portbeschriftungen nicht nach einem Standardschema angebracht, stimmt die Portzuordnung nie mit der Realität überein; eine praktikable Methode beschreibt der Beitrag Kabel- und Portbeschriftung nach TIA-606.
IPAM und DCIM: Source-of-Truth-Ansatz mit NetBox
Dokumentation auf Basis von Tabellen und Zeichnungen funktioniert in kleinen Netzwerken, kann aber keine Beziehungen abbilden. Auf welcher Schnittstelle eine IP-Adresse liegt und über welches Kabel diese Schnittstelle zu welchem Patchfeld führt, sehen Sie nicht in einem einzigen Datensatz. Open-Source-IPAM/DCIM-Werkzeuge wie NetBox halten diese Beziehungen als Datenmodell fest: Standort, Schrank, Gerät, Schnittstelle, Kabel, Präfix, IP-Adresse, VLAN und Leitung sind miteinander verknüpfte Objekte. Dieser Ansatz heißt „Source of Truth“. Hier wird der Sollzustand des Netzwerks definiert, und Geräte und Diagramme werden damit abgeglichen.
| Kriterium | Tabelle + Zeichnung | SoT nach Art von NetBox |
|---|---|---|
| Einrichtung und Einarbeitung | Sofort startklar | Installation und Einarbeitung in das Datenmodell nötig |
| Objektbeziehungen | Manuell, unverbunden | Im Datenmodell, abfragbar |
| Konfliktprüfung | Keine oder manuell | Für Präfixe und IPs integriert |
| Automatisierung | Eingeschränkt | Lesen und Schreiben über REST-API |
| Visuelle Topologie | Stark | Begrenzt; Plugin oder separates Werkzeug |
In der Praxis bestehen beide Ansätze nebeneinander: die Daten (IP, VLAN, Port, Kabel) in NetBox, übergeordnete Architekturdiagramme im Zeichenwerkzeug. Die Datenerfassung in NetBox beginnt meist mit einem Massenimport aus vorhandenen Tabellen; danach wird jede neue Änderung zuerst in NetBox eingetragen. Über die REST-API können Monitoring- oder Konfigurationssicherungswerkzeuge ihre Geräteliste von hier beziehen:
curl -s -H "Authorization: Token $NETBOX_TOKEN" \
-H "Accept: application/json" \
"https://netbox.corp.local/api/dcim/interfaces/?device=sw-b1-k2-01&limit=100"
Der Header Token im Beispiel ist das klassische API-Token-Format von NetBox; neuere Versionen bieten auch ein anderes Token-Format und den Header Bearer, prüfen Sie die REST-API-Dokumentation Ihrer Version. Steht diese Anbindung, ist es keine eigene Aufgabe mehr, Geräte in die Konfigurationssicherung mit Oxidized oder ins Monitoring-System aufzunehmen. Ein Gerät, das nicht im Inventar steht, wird weder gesichert noch überwacht. Das ist der stärkste Anreiz, das Inventar zu pflegen.
Dokumentation am Gerät prüfen: LLDP/CDP- und ARP/MAC-Tabellen
Der zuverlässigste Weg, Unterschiede zwischen Dokumentation und Realität zu finden, ist, die Information direkt vom Gerät zu holen. Unter Cisco IOS/IOS XE sind dies die ersten Befehle an der Konsole:
show cdp neighbors detail ! Cisco-Nachbarn, Port und IP
show lldp neighbors detail ! alle LLDP-fähigen Nachbarn
show interfaces status ! Portstatus, VLAN, Geschwindigkeit, Beschreibung
show interfaces trunk ! Trunks und erlaubte VLANs
show vlan brief ! VLANs und Access-Ports
show mac address-table interface GigabitEthernet1/0/12
show ip arp 10.20.30.45 ! IP-MAC-Zuordnung auf dem L3-Gerät
Verbindungen zwischen Switches werden über LLDP/CDP geprüft: Die Nachbarschaftstabelle muss exakt mit den Uplink-Portnummern in der Dokumentation übereinstimmen. Bei Endgeräten erfolgt die Zuordnung in zwei Stufen: Die ARP-Tabelle auf dem L3-Gerät verknüpft die IP-Adresse mit der MAC-Adresse, die MAC-Tabelle am Access-Switch die MAC-Adresse mit dem Port. Erscheint die MAC an einem Trunk-Port, ist das Gerät nicht an diesem Switch. Die Kette setzt sich am nachgelagerten Switch fort.
Manuell ist dieser Abgleich mühsam. Ein einfaches Python-Skript, das die Geräteausgabe abruft und mit den Verkabelungs- und Schnittstellendatensätzen in der NetBox-API vergleicht, liefert die Unterschiede als Bericht. Werden die Portbeschreibungen (description) in einem Standardformat geschrieben, erleichtert das die Zuordnung erheblich; „test“, „neu“ oder eine leere Beschreibung sind das erste Zeichen dafür, dass die Dokumentation vor Ort zusammengebrochen ist.
Prozess zur Aktualisierung und Verantwortlichkeit
Aktuell hält die Dokumentation nicht das Werkzeug, sondern der Prozess. Ein funktionierendes Modell hat vier Bestandteile:
- Verantwortlichkeit: Jeder Dokumentationsbestandteil (IPAM, Portzuordnung, Diagramme) hat einen namentlich benannten Verantwortlichen. Der Verantwortliche trägt nicht alles selbst ein; er ist für die Richtigkeit verantwortlich.
- Verknüpfung mit Änderungen: Ein Änderungseintrag wird nicht geschlossen, bevor die Dokumentation aktualisiert ist. Der Änderungsplan enthält eine Zeile „zu aktualisierende Dokumentation“; für die Durchführung enthält die Vorlage im Beitrag Planung von Wartungsfenstern im Netzwerk diese Zeile.
- Automatische Erfassung: Informationen, die sich automatisch vom Gerät abrufen lassen (Seriennummer, Version, Schnittstellenstatus, LLDP-Nachbarn), werden nicht manuell eingegeben; sie werden regelmäßig erfasst und mit der SoT abgeglichen.
- Regelmäßiges Audit: In festen Abständen erfolgt eine Stichprobenprüfung vor Ort: Zufällig ausgewählte Ports, Kabel und IPs werden mit der Dokumentation abgeglichen.
Die Hauptquelle für Abweichungen sind kleine Notfalländerungen vor Ort: nachts das VLAN eines Ports ändern, eine vorübergehende statische Route hinzufügen. Wird dafür kein leichtgewichtiger Erfassungsweg (Kurzformular oder Ticketvorlage) definiert, häufen sich die Abweichungen. Die „vorübergehende“ Änderung wird dauerhaft.
Checkliste für das Dokumentationsaudit
- Ist jeder Bestandteil des minimalen Dokumentensatzes vorhanden und ein Verantwortlicher definiert?
- Stehen in den Diagrammen Versionsdatum und Quelldaten; liegt die letzte Aktualisierung nach der letzten Änderung?
- Stimmen die Präfixe im IPAM mit der Routingtabelle und den SVIs auf den L3-Geräten überein?
- Ist jedes VLAN der VLAN-Liste auf den Geräten definiert; gibt es auf den Geräten definierte VLANs, die nicht in der Liste stehen?
- Stimmen die LLDP/CDP-Nachbarschaften exakt mit den dokumentierten Verbindungen zwischen den Switches überein?
- Stimmt bei einer zufälligen Stichprobe von Ports das angeschlossene Gerät mit der Portzuordnung überein?
- Sind für jede WAN- und Internetleitung Leitungsnummer, Supportkontakt des Providers und Vertragsdaten aktuell?
- Sind alle Geräte im Inventar vom Monitoring und von der Konfigurationssicherung erfasst?
- Werden Passwörter im Passworttresor statt in der Dokumentation aufbewahrt?
Für die Erkundung des bestehenden Netzwerks, die Erstellung des Dokumentensatzes und den Plan für den Umstieg auf ein Source-of-Truth-Modell ist unsere Leistung Netzwerkberatung für Unternehmen der Ausgangspunkt; um die regelmäßige Prüfung der Dokumentation an den Wartungszyklus zu koppeln, unsere Leistung Netzwerkwartung, Monitoring und regelmäßige Prüfung.
Häufig gestellte Fragen
Muss für die Netzwerkdokumentation NetBox verwendet werden?
Nein. In kleinen Netzwerken können gut gepflegte Tabellen und Diagramme ausreichen. Mit wachsender Zahl von Geräten, Ports und IPs verringert ein Source-of-Truth-Werkzeug, das die Beziehungen zwischen Objekten abbildet und eine API bietet, den Aufwand für manuelle Synchronisation deutlich.
Wie oft sollte die Dokumentation aktualisiert werden?
Bei jeder Änderung. Ein Änderungseintrag wird nicht geschlossen, ohne dass die Dokumentation aktualisiert ist. Zusätzlich erfolgen regelmäßige Abgleiche mit automatisch von den Geräten erfassten Daten und periodische Stichprobenprüfungen vor Ort.
Wie finde ich heraus, an welchem Port eine IP-Adresse angeschlossen ist?
Ermitteln Sie auf dem L3-Gerät aus der ARP-Tabelle die MAC-Adresse zur IP-Adresse und suchen Sie dann in der MAC-Adresstabelle der Access-Switches den Port, an dem diese MAC gelernt wurde. Erscheint die MAC an einem Trunk-Port, setzt sich die Kette an einem nachgelagerten Switch fort.
Dürfen Passwörter in der Netzwerkdokumentation stehen?
Nein. Passwörter und gemeinsame Schlüssel werden in einem Passworttresor mit kontrolliertem Zugriff aufbewahrt; in der Dokumentation steht nur der Name oder die Referenz des betreffenden Tresoreintrags.