Backup
Diese Seite beschreibt, wie das Modul Backup Konfigurationen sichert, was es am Zielgerät braucht und wo seine Grenzen liegen.
Was das Modul leistet, steht auf der Modulseite.
Stand: November 2026, COD 3.8.6
Inhalt der Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Überblick
| Merkmal | Wert |
|---|---|
| Zweck | Zeitgesteuerte Sicherung von Konfigurationen und MariaDB-Datenbanken. Versionen, Vergleich als Diff, Download |
| Unterstützte Systeme | Geräte und Server mit SSH oder SFTP: Switches, Router, Firewalls, Linux- und BSD-Systeme, Embedded-Geräte. Datenbanken: MariaDB |
| Vorlagentypen | Download (Datei oder Ordner per SFTP), Command (Ausgabe eines Befehls), MariaDB-Dump |
| Verbindung und Richtung | Der Backup-Dienst baut die Verbindung zum Gerät auf, per SSH oder SFTP. Auf Wunsch über einen Jump-Host |
| Dienst | Paket cod-acb mit eigener Ablage und eigenem Hostregister. Läuft auf dem COD-Server oder auf einem eigenen Modul-Server |
| Zugangsdaten | Benutzer und Passwort je Host. Jump-Host mit Benutzer und Passwort. Für MariaDB-Dump zusätzlich der Datenbank-Zugang. |
| Rechte am Ziel | Leserecht auf die gesicherten Dateien und Befehle |
| Wiederherstellung | COD spielt keine Sicherung zurück |
Voraussetzungen
Am Zielgerät
| Voraussetzung | Warum |
|---|---|
| SSH- oder SFTP-Server eingeschaltet | Alle Vorlagentypen setzen SSH voraus |
| Erreichbar vom Backup-Dienst oder vom Jump-Host | Der Backup-Dienst baut die Verbindung auf |
| Eigener Benutzer für COD mit Leserecht auf die Dateien oder Befehle | Nachvollziehbarkeit und kleine Rechte |
| SSH-Zugang auf die Quelladresse des Backup-Dienstes beschränkt | Kleine Angriffsfläche |
| Feste Management-Adresse | Der Hosteintrag in COD ist eine Kopie und ändert sich nicht von selbst |
| Hostname am Gerät gleich „Server Name“ in COD, wenn „Check Server Name“ eingeschaltet ist | Die Namensprüfung vergleicht beide |
| Zeitabgleich per NTP, empfohlen | Zeitstempel der Sicherungen passen zu Protokollen und Zeitplänen |
Für einen vollständigen Export brauchen manche Router volle Rechte. Prüfen Sie am Gerät, ob das Leserecht für den gewählten Befehl reicht.
In COD
- Modul Backup am Mandanten freigeschaltet und für den Standort ausgerollt.
- Rolle mit Recht auf das Modul Backup.
- Mail-Einstellung der Backup-Instanz, wenn Sie Fehlermails wollen. Der Backup-Dienst braucht dann einen Weg zu Ihrem Mailserver.
Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.
Einrichtung
- Das Manager-Konto schaltet das Modul frei: „Admin Area > Tenant > Modules“. Danach ab- und wieder anmelden. Details unter Module freischalten.
- Rollen Sie das Modul aus: „Admin Area > Module Rollout“, Modul Backup, Standort wählen, dann „Install“, „Connect“, „Configure“ und „Apply“. Details unter Module ausrollen.
- Richten Sie die Mail der Backup-Instanz ein, damit fehlgeschlagene Läufe gemeldet werden.
- Legen Sie eine Vorlage an. Wählen Sie den Typ (Download, Command oder MariaDB-Dump), tragen Sie Pfad oder Befehl ein und legen Sie Verschlüsselung und Aufbewahrung fest.
- Legen Sie den Host an: Adresse, Port, Benutzer, Passwort, Vorlage, bei Bedarf Jump-Host. Eine Firewall aus dem Inventar wird mit einem Klick zum Backup-Host. COD füllt die Felder dann einmalig vor.
- Tragen Sie den Zeitplan (Cron) am Host ein. Er bestimmt die Startzeit.
- Starten Sie einen ersten Lauf mit „Execute Now“. Prüfen Sie Status und Inhalt des Stands.
- Staffeln Sie die Startzeiten, wenn viele Hosts dasselbe Ziel oder denselben Jump-Host nutzen.
Technische Details
Vorlagentypen
| Typ | Was gesichert wird | Hinweis |
|---|---|---|
| Download | Eine Datei oder ein Ordner per SFTP. Auswahl im Ordner optional über einen regulären Ausdruck (Regex) | Ordner kommen als ZIP, Diff bis auf die einzelne Datei |
| Command | Die Ausgabe eines Befehls auf dem Host | Für Geräte, deren Konfiguration ein Befehl ausgibt |
| MariaDB-Dump | Eine MariaDB-Datenbank | Belegt ist MariaDB. Andere Datenbanksysteme sagen wir nicht zu |
Pfade und Befehle werden wörtlich verwendet. Platzhalter wie Variablen für den Hostnamen ersetzt COD nicht.
MariaDB-Dump
Den Dump erzeugt der Backup-Dienst selbst. Er verbindet sich dafür direkt mit dem eingetragenen MariaDB-Server. Wie jede Vorlage setzt auch der MariaDB-Dump einen SSH-Zugang zum Host voraus. Planen Sie beide Freigaben ein.
Zeitplan und Start
- Die Startzeit bestimmt der Cron am Host.
- „Execute Now“ startet einzelne oder viele Hosts außerhalb des Zeitplans.
- Je Lauf baut der Backup-Dienst eine SSH-Sitzung auf, gegebenenfalls über den Jump-Host.
Status und Fehlermeldung
- Status, Fehler und letzte Läufe stehen in der Übersicht des Moduls und auf dem Home-Dashboard.
- Ein fehlgeschlagener Lauf setzt den Host auf den Status „ERROR“.
- Ist die Mail der Backup-Instanz eingerichtet, verschickt der Backup-Dienst zusätzlich eine Fehlermail. Sie ist eine Betriebshilfe, keine Alarmierung.
- Änderungen im Backup-Dienst stehen im Audit der Admin Area, mit dem handelnden Benutzer.
Verschlüsselung und Aufbewahrung
| Einstellung | Gilt | Hinweis |
|---|---|---|
| Verschlüsselung | je Vorlage | Gilt für die Stände in der Ablage des Backup-Dienstes. Ordner-Backups sind ausgenommen |
| Aufbewahrung | je Vorlage | Nach Anzahl oder nach Alter in Tagen. Ist die Grenze erreicht, löscht COD die ältesten Stände |
Ablage, Vergleich und Download
- Jede Backup-Instanz legt ihre Stände in einer eigenen Ablage auf ihrem Host ab.
- Der Vergleich zeigt zwei Stände als Diff, wahlweise nur die Unterschiede oder den Volltext.
- Sie laden einen Stand als Datei herunter, einen Ordner als ZIP.
- Eine automatische Auslagerung gibt es nicht. Die frühere Auslagerung per SCP ist seit COD 3.7.11 entfernt.
- Die Ablage gehört in Ihre reguläre Datensicherung. Die vollständige Liste erhalten Sie im Projekt.
Hostregister
Das Modul führt ein eigenes Hostregister. Ein Hosteintrag ist eine Kopie und nicht mit dem Asset verbunden. Ändern Sie Adresse oder Passwort im Inventar, kommt das im Backup nicht an.
Backup-Instanzen und Standorte
| Aufbau | Wann |
|---|---|
| Eine Backup-Instanz je Standort | Getrennte Hostregister und Ablagen je Standort |
| Eine Backup-Instanz für mehrere Standorte | Mehrere Standorte teilen Hostregister und Ablage |
| Mehrere Instanzen auf einem Host | Ein Modul-Server bedient mehrere Standorte mit je eigener Instanz |
Welche Aufbauform passt, steht unter Aufbauformen.
Bekannte Grenzen
| Grenze | Was Sie tun können |
|---|---|
| Alles läuft über SSH. Geräte ohne SSH oder SFTP lassen sich nicht direkt sichern | Klären Sie einen Umweg mit Ihrem Partner. Wo das Gerät es anbietet, schalten Sie SSH ein |
| Keine Platzhalter in Pfad und Befehl | Legen Sie feste Pfade fest, bei Bedarf eine eigene Vorlage je Gerätegruppe |
| Das Feld „Script“ wird nicht ausgeführt | Bauen Sie nicht auf Vor-Skripte in COD. Vorbereitende Schritte richten Sie am Gerät selbst ein |
| Ordner mit führendem Punkt werden beim Download übersprungen | Prüfen Sie nach dem ersten Lauf, ob alle erwarteten Dateien im Stand sind |
| Ein unlesbarer Unterordner bricht den ganzen Download ab, auch mit Regex | Geben Sie dem Benutzer Leserecht auf den ganzen Ordner oder sichern Sie nur lesbare Pfade |
| Viele gleichzeitige SSH-Sitzungen gegen dasselbe Ziel oder denselben Jump-Host scheitern an dessen Sitzungsgrenze | Staffeln Sie die Startzeiten |
| Hosteinträge sind Kopien, nicht mit dem Asset verbunden | Ziehen Sie Adresse und Passwort im Backup nach, wenn sie sich am Gerät ändern |
| „Check Server Name“ verlangt gleiche Namen | Halten Sie Hostname am Gerät und „Server Name“ gleich oder schalten Sie die Prüfung aus |
| Verschlüsselung gilt nicht für Ordner-Backups | Schützen Sie den Host des Backup-Dienstes und seine Ablage |
| Keine Rückspielung | Laden Sie den Stand herunter und spielen Sie ihn mit den Werkzeugen des Herstellers ein |
| Keine automatische Auslagerung seit COD 3.7.11 | Nehmen Sie die Ablage in die Datensicherung des Hosts auf |
| Die Fehlermail ist keine Alarmierung | Prüfen Sie den Status im Dashboard regelmäßig |
| Nur MariaDB als Datenbank belegt | Sichern Sie andere Datenbanken mit eigenen Werkzeugen |
| Anmeldung per SSH-Schlüssel | Klären Sie das im Projekt. |
Weiterführend
- Modulseite Backup
- Was Ihr Netz für Backup braucht
- Netzgeräte vorbereiten
- Namen und Adressen
- Aufbauformen
- Fehlerbilder
- Fragen zu den Modulen