Zum Inhalt springen
FM-Connect Chat

Hallo! Ich bin Ihr FM-Connect Chat-Assistent. Wie kann ich Ihnen helfen?

FM-Solutionmaker: Gemeinsam Facility Management neu denken

Software-, Konfigurations- und Quellcodedokumentation

Facility Management: TGA » Leistungen » Anweisende Dokumentation » Software-, Konfigurations- und Quellcodedokumentation

Moderne TGA lässt sich nicht mehr allein mit Plänen betreiben

Technische Gebäudeausrüstung enthält zunehmend softwaredefinierte Funktionen. Gebäudeautomation, Brandfallsteuerungen, Zutritt, Beleuchtungssteuerung, Energiemanagement, Frequenzumrichter oder digitale Kälteanlagen besitzen Parameter und Konfigurationen, die für die reale Funktion genauso wichtig sein können wie das physische Schaltbild.

Die bestehende Präsentation der Microsite zählt Parametrierungen und Softwarestände bereits ausdrücklich zur TGA-Dokumentation. Auch die planungsbegleitende FM-Seite nennt für Gebäudeautomation Datenpunktlisten, Busstrukturen und Programmierhandbücher.

Eine eigene Seite sollte den digitalen Anlagenzustand systematisch absichern.

Software-, Konfigurations- und Quellcodedokumentation für die TGA: Systeme nachvollziehbar dokumentieren

Ausführbaren Zustand dokumentieren

Ein PDF-Ausdruck von Parametern kann für eine Übersicht hilfreich sein, ersetzt aber nicht zwingend den tatsächlich wieder einspielbaren Systemstand.

Für softwarebasierte TGA sollte mindestens nachvollziehbar sein:

  • System beziehungsweise Steuerung,

  • Software-/Firmwareversion,

  • freigegebener Konfigurationsstand,

  • Zeitpunkt der Freigabe,

  • verantwortlicher Integrator,

  • zugehörige Engineeringdateien.

Quell- und Projektdateien unterscheiden

Je nach System existieren unterschiedliche Ebenen:

Programmcode, Engineeringprojekt, Bibliotheken, Kompilat, Parameterexport oder Gerätekonfiguration.

Damit lässt sich unnötiger Hersteller- oder Integrator-Lock-in reduzieren.

Der Betreiber sollte bereits bei Beschaffung definieren, welche davon er benötigt, um das System später:

  • wiederherzustellen,

  • anzupassen,

  • durch einen anderen qualifizierten Anbieter bearbeiten zu lassen.

Zugangsinformationen kontrolliert verwalten

Technische Dokumentation kann auch Informationen zu Benutzerkonten, Servicezugängen oder Zertifikaten benötigen.

Diese Daten gehören jedoch nicht ungeschützt in eine allgemein zugängliche Dokumentenablage.

ISO 19650-5 behandelt security-minded information management und damit den kontrollierten Umgang mit sensiblen Informationen über Assets und Systeme.

Daraus folgt eine klare Trennung zwischen:

allgemein verfügbarer Betriebsdokumentation und besonders geschützten technischen Zugangsinformationen.

Konfigurationsbackup nach Changes aktualisieren

Wird eine Regelstrategie geändert, genügt es nicht, lediglich ein Änderungsprotokoll anzulegen.

Der freigegebene Backupstand muss anschließend ebenfalls den neuen Zustand repräsentieren.

Sonst würde ein Restore später auf eine veraltete Funktionsversion zurücksetzen.

Abhängigkeiten dokumentieren

Eine Automationsfunktion kann abhängig sein von:

Betriebssystem, Datenbankversion, Controllerfirmware, Gateway und spezieller Engineeringsoftware.

Solche Kompatibilitäten sind besonders bei langfristigem TGA-Betrieb wichtig, weil Gebäudetechnik oft wesentlich länger genutzt wird als typische IT-Systeme.

Lizenzinformationen berücksichtigen

Ein vollständiges Projektarchiv ohne lauffähige Lizenz kann praktisch wertlos sein.

Für Wiederherstellung oder Dienstleisterwechsel können relevant sein:

  • Lizenztyp,

  • Lizenzinhaber,

  • Dongle oder Schlüssel,

  • Supportvertrag,

  • Ablaufdatum.

Freigabestand eindeutig markieren

Mehrere Dateien wie:

Projekt_final,

Projekt_final_neu,

Projekt_final_2

sind kein professionelles Versionsmanagement.

Der Betreiber benötigt genau einen eindeutig gekennzeichneten produktiven Referenzstand sowie archivierte Vorgängerstände.

Restore praktisch prüfen

Für kritische Systeme sollte gelegentlich nachgewiesen werden, dass Engineeringdaten tatsächlich lesbar und gegebenenfalls wiederherstellbar sind.

Damit wird Dokumentation nicht nur abgelegt, sondern ihre Nutzbarkeit verifiziert.

Den digitalen Anlagenzustand genauso ernst nehmen wie den physischen

Die zentrale Frage lautet:

Besitzen wir diejenigen Software-, Konfigurations-, Lizenz- und Engineeringinformationen, die notwendig wären, um die heutige reale Anlagenfunktion nach einem Defekt oder Dienstleisterwechsel wiederherzustellen beziehungsweise kontrolliert zu verändern?

Damit wird digitale TGA-Dokumentation zu einem wesentlichen Bestandteil technischer Resilienz.