Netzwerkdokumentation: Vom Anschluss bis zum wichtigen Dienst
Wie ein übersichtlicher Netzwerkplan, Portangaben und nachvollziehbare Abhängigkeiten bei Änderungen und Störungen zusammenhelfen.
Ein Netzwerkdiagramm ist schnell gezeichnet. Im Alltag entscheidet jedoch die Verbindung zwischen Zeichnung und tatsächlicher Umgebung darüber, ob es hilft. Wenn der dargestellte Switch vor Ort anders beschriftet ist oder ein Uplink nicht nachvollzogen werden kann, beginnt die Suche trotz vorhandener Dokumentation erneut.
Zweck und Detailgrad festlegen
Eine Übersicht für die Standortanbindung braucht andere Details als eine Anleitung zur Fehlersuche an einem Arbeitsplatz. Trenne deshalb die Gesamtübersicht von den Detailinformationen. In der Übersicht genügen oft Standorte, zentrale Netzwerkgeräte, Übergänge und wichtige Dienste. Portbelegung und einzelne Anschlüsse können separat gepflegt werden.
Zu viele Details in einer Zeichnung machen Zusammenhänge schwer erkennbar. Zu wenige Details verschieben jede Frage zurück an die Person, die das Netz aufgebaut hat. Prüfe den gewählten Detailgrad an zwei Aufgaben: Kann eine neue Fachperson den Weg ins Internet nachvollziehen? Kann sie den Anschluss eines wichtigen Geräts eindeutig finden?
Physische und logische Verbindungen unterscheiden
Die physische Sicht beschreibt Geräte, Kabel, Ports und Standorte. Die logische Sicht zeigt beispielsweise Netzsegmente, Routing-Übergänge und die Zuordnung wichtiger Dienste. Beide Sichten hängen zusammen, sind aber nicht dasselbe. Eine einzelne Leitung kann mehrere logisch getrennte Netze transportieren.
Beschrifte deshalb Verbindungen nach ihrem Zweck. Eine Linie zwischen zwei Geräten sagt noch nicht, welche Ports gemeint sind oder welche Rolle die Verbindung hat. Ungeprüfte Verbindungen sollten als solche erkennbar bleiben.
Eindeutige Bezeichnungen durchhalten
Verwende in Zeichnungen, Geräteinventar und Portlisten dieselben Kennungen. Für einen Switch können Name, Standort, interne Kennung und relevante Management-Informationen hinterlegt werden. Für eine Leitung sind die beiden Endpunkte wichtig. Bei Anschlüssen über Patchfelder sollten auch die dazwischenliegenden Bezeichnungen nachvollziehbar sein.
Eine Beschreibung wie «Switch im Büro» wird bei mehreren Etagen schnell mehrdeutig. Eine kurze Benennungsregel hilft, ohne jeden Namen mit allen technischen Eigenschaften zu überladen.
Abhängigkeiten ergänzen
Dokumentiere bei wichtigen Diensten, welche Netzwerkverbindungen sie benötigen. Dazu können etwa Standortanbindung, Namensauflösung oder ein bestimmter Netzbereich gehören. Beschreibe dabei bestätigte Zusammenhänge. Eine vermutete Abhängigkeit sollte nicht wie eine geprüfte Tatsache dargestellt werden.
Diese Angaben unterstützen die Planung einer Änderung. Sie sind jedoch kein Ersatz für eine technische Prüfung vor dem Eingriff: Eine Dokumentation kann veraltet oder unvollständig sein.
Änderungen gemeinsam nachführen
Wird ein Anschluss umgesteckt, müssen gegebenenfalls Portliste, Gerätezuordnung und Übersicht angepasst werden. Lege fest, welche Dokumente für welche Information verbindlich sind. Mehrere unabhängig gepflegte Kopien derselben Portbelegung führen sonst zu widersprüchlichen Angaben.
Checkliste vor der nächsten Netzwerkänderung
– Betroffene Geräte eindeutig identifizieren.
– Physische Endpunkte und relevante Ports prüfen.
– Logische Netze und Übergänge nachvollziehen.
– Bestätigte Abhängigkeiten wichtiger Dienste berücksichtigen.
– Unbekannte Verbindungen vor der Änderung klären.
– Nach Abschluss die tatsächlich umgesetzte Verbindung dokumentieren.
Eine brauchbare Netzwerkdokumentation muss nicht jedes Detail in einem einzigen Plan zeigen. Sie muss von der Übersicht zuverlässig zu den Angaben führen, die für die konkrete Aufgabe benötigt werden.