Journal / Infrastruktur

IT-Dokumentation, mit der ein zweites Team arbeiten kann

Welche Angaben zu Systemen, Datenwegen, Zugängen und Wiederherstellung eine nachvollziehbare Betreuung und einen geplanten Betreiberwechsel unterstützen.

KI-unterstützter Text · KI-Illustration

Die Person, die eine Umgebung eingerichtet hat, kennt oft viele Zusammenhänge aus der täglichen Arbeit. Ein zweites Team besitzt dieses Wissen zunächst nicht. Für eine Übergabe muss deshalb erkennbar sein, welche Systeme zusammengehören und wie sie betreut werden sollen.

In der Beratung und Systemarchitektur betrachten wir Dokumentation als Teil des Betriebs. Sie soll Entscheidungen und Arbeitswege verständlich machen und bei einer Änderung mitgeführt werden können.

01 / Infrastruktur

Mit Diensten und Verantwortlichen beginnen.

Eine Geräteliste ist ein möglicher Ausgangspunkt. Für die Betreuung wird zusätzlich benötigt, welche Aufgabe ein Gerät oder Dienst erfüllt. Ein Server kann mehrere Anwendungen bereitstellen, die wiederum auf Speicher, Namensauflösung oder externe Gegenstellen angewiesen sind.

Für wichtige Dienste werden daher Zweck, Standort und Abhängigkeiten festgehalten. Ebenso wichtig ist die Zuordnung der Verantwortlichen: Wer nutzt den Dienst fachlich, wer betreut ihn technisch und wer darf Änderungen freigeben? Diese Übersicht hilft bei einer geplanten Übergabe ebenso wie bei einer ungeklärten Störung.

02 / Infrastruktur

Die tatsächlichen Datenwege darstellen.

Ein Netzplan zeigt die vorgesehenen Verbindungen und die beteiligten Bereiche. Ergänzende Beschreibungen erklären, weshalb ein Weg benötigt wird. Bei einem VPN gehört beispielsweise dazu, welche Netze verbunden sind und welche Dienste die Verbindung nutzen.

Die Dokumentation der Netzwerke und Firewalls sollte zur tatsächlich betriebenen Konfiguration passen. Nach einer Änderung werden daher sowohl die technische Einstellung als auch die zugehörige Beschreibung überprüft. Ein veralteter Plan kann sonst gerade dort irreführen, wo er Orientierung geben soll.

03 / Infrastruktur

Zugänge beschreiben und Geheimnisse geeignet verwalten.

Ein Team muss wissen, welche Verwaltungszugänge existieren und wie die zuständige Person sie erhalten kann. Dafür werden Zweck, Berechtigung und verantwortliche Stelle beschrieben. Passwörter, private Schlüssel und andere Geheimnisse gehören in eine dafür geeignete Verwaltung mit geregeltem Zugriff.

Für eine Übergabe werden auch Wiederherstellungs- und Notfallzugänge betrachtet. Ist die benötigte Stelle unter den angenommenen Ausfallbedingungen erreichbar? Wer kann eine Freigabe erteilen? Die allgemeine Dokumentation verweist auf den vorgesehenen Weg, ohne die Geheimnisse breit zu vervielfältigen.

04 / Infrastruktur

Wiederanlauf und Änderungen praktisch erklären.

Ein Ablauf beschreibt seine Voraussetzungen, die Reihenfolge der Arbeitsschritte und das erwartete Ergebnis. Beim Wiederanlauf gehören beispielsweise der benötigte Sicherungsstand, der Zugriff auf Schlüssel und die anschließende Funktionsprüfung dazu. Verweise auf die beteiligten Systeme halten die Beschreibung mit der Bestandsübersicht zusammen.

Bei Änderungen wird festgehalten, was angepasst wurde und welche Prüfung erfolgt ist. Dafür braucht es einen für die Organisation passenden Umfang. Ein kurzer, konsequent gepflegter Änderungsnachweis ist im Alltag oft hilfreicher als eine sehr ausführliche Beschreibung, für deren Aktualisierung niemand verantwortlich ist.

05 / Infrastruktur

Die Übergabe durch einen zweiten Blick prüfen.

Ein geeignetes anderes Teammitglied kann anhand der Dokumentation einen vereinbarten Vorgang nachvollziehen. Dabei werden unklare Begriffe, fehlende Voraussetzungen und stillschweigend vorausgesetztes Wissen sichtbar. Die Prüfung erfolgt abgestimmt und ohne unkontrollierte Eingriffe in den laufenden Betrieb.

Auch bei der Betreuung einer Praxisumgebung lässt sich auf diesem Weg erkennen, ob technische Aufgaben übertragbar sind. Dokumentation unterstützt damit die Kontinuität des Betriebs und die Möglichkeit, Zuständigkeiten später bewusst zu verändern.

Vom Gedanken zum Projekt

Welche Fragen ergeben sich daraus für Ihre Umgebung? Eine konkrete Planung beginnt mit Ihrem Bestand und Ihren Anforderungen.

Passende Disziplin entdecken
Let’s think forward

Ihre nächste Frage.
Unser nächster Dialog.

Vorhaben besprechen