Eine Netzwerkdokumentation beantwortet drei Fragen: Was gibt es? Wie hängt es zusammen? Wer kommt wo hinein? Sie ist kein Selbstzweck. Sie verkürzt die Fehlersuche, macht Erweiterungen planbar und sorgt dafür, dass ein neuer Mitarbeiter oder Dienstleister nicht bei null anfängt.
Was in die Dokumentation gehört
- IP-Plan: welche Netze es gibt, welche Adressbereiche, welche festen Adressen vergeben sind (Drucker, Server, Kameras)
- VLANs und Netze: Name, Zweck und welche Geräte hineingehören, etwa Büro, Gäste, Kameras, Telefonie
- Geräte: Router, Firewall, Switches, Access Points, Server und NAS mit Modell, Standort, Seriennummer und Firmware-Stand
- Verkabelung: welche Netzwerkdose an welchem Patchfeld-Port und welchem Switch-Port hängt
- Internetanschluss: Anbieter, Vertragsnummer, Hotline, feste IP-Adresse falls vorhanden
- Zugänge und Zuständigkeiten: wer welches Gerät verwaltet und wo die Zugangsdaten liegen – nicht die Passwörter selbst
- Besonderheiten: Portfreigaben, VPN-Zugänge, Regeln, die jemand bewusst eingerichtet hat, mit Begründung
Physisch und logisch
Eine Dokumentation hat zwei Ebenen. Die physische beschreibt, was wo steht und wie es verkabelt ist: Schrank, Patchfeld, Switch-Ports, Dosen in den Räumen. Die logische beschreibt, wie das Netz aufgebaut ist: Netze, Adressen, Regeln, wer mit wem sprechen darf. Fehlt die physische Ebene, sucht man bei einem Ausfall das richtige Kabel. Fehlt die logische, versteht man nicht, warum ein Gerät ein anderes nicht erreicht.
Womit dokumentieren?
Tabelle oder Wiki: Für kleine Netze ausreichend, wenn sie gepflegt werden. Schwäche: Zusammenhänge zwischen Geräten, Ports und Netzen muss man im Kopf behalten.
NetBox: Das verbreitete Open-Source-Werkzeug für IP-Adressverwaltung und Infrastruktur. Es bildet Geräte, Ports, Kabel und Netze als zusammenhängendes Modell ab und lässt sich automatisiert befüllen. Für größere Netze sehr stark, für ein kleines Büro oft mehr als nötig.
Hersteller-Oberflächen: Systeme wie UniFi zeigen Topologie, Geräte, Ports und Netze bereits live an. Das ersetzt keine Dokumentation, weil Begründungen, Verträge und Zuständigkeiten fehlen, nimmt aber viel Erfassungsarbeit ab. Ergänzt um ein kurzes Dokument mit dem Rest ist das für viele kleine Betriebe die pragmatischste Lösung.
So bleibt sie aktuell
Die beste Dokumentation ist wertlos, wenn sie den Stand von vor zwei Jahren zeigt. Drei Gewohnheiten helfen:
- Änderungen sofort eintragen, nicht „später gesammelt“
- Einmal im Jahr gegen die Wirklichkeit prüfen: Stimmen Geräte, Firmware, Ports?
- Kabel und Ports physisch beschriften, mit denselben Namen wie in der Dokumentation
Wie wir es machen
Bei jeder Installation übergeben wir eine Dokumentation der Anlage: Netze, Geräte, Verkabelung und wo welche Zugänge hinterlegt sind. Zugangsdaten verwalten wir getrennt in einem Passwortmanager. Wenn wir ein Netzwerk betreuen, pflegen wir die Dokumentation bei jeder Änderung mit.