CCU-Sicherung¶

Die Homematic(IP) Local-Integration bietet zwei Sicherungsmechanismen: einen Backup Agent, der in das Home Assistant-Sicherungssystem integriert ist, und eine manuelle Sicherungsschaltfläche für CCU-Systemsicherungen bei Bedarf.

CCU-Systemsicherungen sind nur für OpenCCU (ehemals RaspberryMatic) verfügbar, einschließlich der OpenCCU Home Assistant App. Auf CCU2, CCU3, Debmatic, piVCCU und Homegear werden Sicherungsschaltfläche und Backup Agent nicht angeboten. Siehe die Backend-Funktionsmatrix.

Backup Agent¶

Die Integration registriert einen LocalBackupAgent, der als Sicherungsspeicherort in der Home Assistant-Sicherungsoberfläche erscheint (Settings → System → Backups). Pro CCU-Konfigurationseintrag wird ein Agent registriert, sodass Multi-CCU-Setups separate Agents erhalten.

Funktionsweise¶

Wenn eine Home Assistant-Sicherung erstellt und die CCU als Speicherort ausgewählt wird:

1. Der Agent erstellt zunächst eine CCU-Systemsicherung (.sbk-Datei), indem er über ein ReGa-Skript eine vollständige Sicherung von der CCU anfordert
2. Die CCU-Sicherung wird heruntergeladen und im konfigurierten Sicherungsverzeichnis gespeichert
3. Die HA-Sicherung (.tar-Datei) wird im selben Verzeichnis abgelegt
4. Eine Metadaten-Datei (*_meta.json) verknüpft die HA-Sicherung mit der zugehörigen CCU-Sicherung

Das bedeutet, dass jede auf der CCU gespeicherte HA-Sicherung von einer passenden CCU-Systemsicherung begleitet wird, was einen vollständigen Wiederherstellungspunkt für beide Systeme ergibt.

Ausfallsicherheit¶

• CCU nicht erreichbar: Ist die CCU beim Ausführen der HA-Sicherung nicht erreichbar, wird die HA-Sicherung ohne CCU-Sicherung gespeichert (eine Warnung wird protokolliert)
• CCU-Sicherung fehlgeschlagen: Schlägt die CCU-Sicherung aus irgendeinem Grund fehl, wird die HA-Sicherung normal fortgesetzt — Fehler bei der CCU-Sicherung blockieren niemals HA-Sicherungen
• Metadaten-Konsistenz: Können Metadaten nicht gespeichert werden, wird eine bereits erstellte CCU-Sicherung automatisch bereinigt
• Bereinigung verwaister Dateien: Beim Auflisten von Sicherungen werden Metadaten-Dateien ohne zugehörige .tar-Datei automatisch entfernt

Sicherungen verwalten¶

Die gesamte Sicherungsverwaltung erfolgt über die Standard-Sicherungsoberfläche von Home Assistant:

Sicherungsschaltfläche¶

Die Integration erstellt eine "Sicherung erstellen"-Taste auf dem CCU-Gerät. Durch Betätigung wird eine eigenständige CCU-Systemsicherung (.sbk-Datei) bei Bedarf erstellt — unabhängig vom HA-Sicherungssystem.

Die Taste wird nur für OpenCCU-Backends angelegt und ist verfügbar, solange die CCU erreichbar ist. Die resultierende Sicherungsdatei wird im konfigurierten Sicherungsverzeichnis gespeichert.

Sicherungsverzeichnis¶

Sowohl der Backup Agent als auch die Sicherungsschaltfläche speichern Dateien in:

<ha-config>/homematicip_local/backup/

Dieses Verzeichnis wird automatisch erstellt, wenn die erste Sicherung durchgeführt wird. Es enthält:

CCU-Sicherungs-Service¶

Die Integration stellt außerdem einen homematicip_local.create_ccu_backup-Service zur Verwendung in Automationen bereit:

service: homematicip_local.create_ccu_backup
data:
  entry_id: "your_config_entry_id"

Dieser erstellt und lädt eine CCU-Systemsicherung herunter, identisch zum Betätigen der Sicherungsschaltfläche.

Wiederherstellung¶

Wann eine Wiederherstellung erforderlich ist¶

Eine CCU-Wiederherstellung ist erforderlich, wenn:

• Die CCU-Hardware ausgetauscht oder auf Werkseinstellungen zurückgesetzt wurde
• Ein Firmware-Update Geräte- oder Konfigurationsprobleme verursacht hat
• Gerätekopplungen, Programme oder Systemvariablen verloren gegangen sind
• Eine Migration auf eine neue CCU durchgeführt wird

Wiederherstellung über Home Assistant¶

Auf der CCU gespeicherte Home Assistant-Sicherungen enthalten sowohl die HA-Sicherung (.tar) als auch die CCU-Systemsicherung (.sbk). Zur Wiederherstellung:

1. Zu Settings -> System -> Backups navigieren
2. Die gewünschte Sicherung auswählen
3. Dem Home Assistant-Wiederherstellungsassistenten folgen, um die HA-Sicherung wiederherzustellen
4. Die zugehörige CCU-Sicherung (.sbk-Datei) im Sicherungsverzeichnis suchen:

   <ha-config>/homematicip_local/backup/
   

5. Die CCU-Sicherung separat über das CCU-WebUI wiederherstellen (siehe unten)

Die Home Assistant-Wiederherstellung stellt die CCU nicht automatisch wieder her. Die CCU muss unabhängig über ihre .sbk-Datei wiederhergestellt werden.

Wiederherstellung über das CCU-WebUI¶

1. Das CCU-WebUI im Browser öffnen (z. B. http://<ccu-ip>)
2. Zu Einstellungen -> Sicherheit -> Systemsicherung navigieren
3. Auf Wiederherstellen klicken und die .sbk-Datei aus dem Sicherungsverzeichnis auswählen
4. Die Wiederherstellung bestätigen und warten, bis die CCU neu gestartet ist
5. Nach dem Neustart die Homematic(IP) Local-Integration in Home Assistant neu starten

Überprüfung nach der Wiederherstellung¶

Nach der Wiederherstellung überprüfen, ob das System korrekt funktioniert:

• Sicherstellen, dass alle Geräte in Home Assistant angezeigt werden und aktuelle Zustände aufweisen
• Bestätigen, dass Gerätekopplungen intakt sind (Geräte reagieren auf Befehle)
• Überprüfen, ob CCU-Programme und Systemvariablen im CCU-WebUI vorhanden sind
• Das Integrationsprotokoll auf Verbindungsfehler oder fehlende Geräte prüfen

Wenn die Wiederherstellung fehlschlägt¶

• CCU startet nach der Wiederherstellung nicht: Einen Werksreset auf der CCU durchführen und dann die Wiederherstellung mit einer anderen .sbk-Datei erneut versuchen
• Geräte fehlen nach der Wiederherstellung: Die betroffenen Geräte erneut mit der CCU koppeln. Geräte-DataPoints erscheinen automatisch wieder in Home Assistant
• Integration kann keine Verbindung herstellen: Die Integration neu starten. Falls sich die CCU-IP-Adresse geändert hat, die Integrationskonfiguration unter Settings -> Devices & Services aktualisieren
• Sicherungsdatei beschädigt: Eine ältere .sbk-Datei aus dem Sicherungsverzeichnis verwenden. Regelmäßige Sicherungen (über den Backup Agent oder Automationen) stellen sicher, dass immer eine aktuelle, funktionierende Sicherung verfügbar ist