BACKUP
BACKUP
Mit BACKUP können Sie Sicherungen Ihrer Mandanten-Daten erstellen.
Ein Backup ist ein pg_dump-Dump im PostgreSQL Custom-Format (-Fc) der Mandanten-Datenbank (Datei *.dump). Damit können Sie im Notfall Daten wiederherstellen (z.B. wenn etwas versehentlich gelöscht wurde oder ein Update schief lief).
- Vor größeren Änderungen (z.B. Massenimport, große Umstrukturierung)
- Vor Updates / Wartung
- Regelmäßig (am besten automatisch, siehe unten)
- Es wird per
pg_dump -Fcein Custom-Format-Dump der aktuellen Mandanten-PostgreSQL-Datenbank erstellt (keine Datei-Kopie). - Die Dump-Datei (
<db>-dd.MM.yyyy-backup.dump) wird im Mandanten-Verzeichnis unterbackups/abgelegt. - Optional läuft das automatisch über AUTOMATE (Backup-Task
BACKUP_DB).
1) Backup manuell erstellen
- Öffnen Sie Admin → Backup (
/settings/admin/backup). - Klicken Sie auf „Backup erstellen“.
- Das neue Backup erscheint in der Liste mit Zeitstempel und Größe.
2) Automatisches Backup einstellen
- Auf der Backup-Seite finden Sie den Bereich „Einstellungen“.
- Aktivieren Sie automatisches Backup und wählen Sie das Intervall (z.B. täglich).
- Optional: Aufbewahrungszeit / max. Anzahl an Backups.
- Speichern.
> Damit das automatische Backup wirklich läuft, muss das Plugin AUTOMATE aktiv sein und nicht pausiert.
3) Altes Backup löschen
- In der Backup-Liste den entsprechenden Eintrag wählen.
- „Löschen“ klicken.
- Bestätigen.
> Tipp: Behalten Sie mindestens mehrere Generationen (z.B. „letzte 7 Tage“), wenn Speicher kein Problem ist.
4) Backup wiederherstellen (Notfall)
Ein Restore ist ein manueller Ops-Schritt: Es existiert aktuell kein UI-Endpoint für Restore (der pg_restore-Restore ist im Code implementiert — BackupService.restoreFromBackup — aber nicht über die Oberfläche erreichbar). Der Betreiber/Hoster fährt so:
-
Anwendung stoppen.
-
Gewünschten Dump aus
backups/auswählen (<db>-dd.MM.yyyy-backup.dump). -
Dump per
pg_restorein die Mandanten-Datenbank zurückspielen (Zugangsdaten der Mandanten-DB, siehe DB-Config):pg_restore -h <db_host> -p <db_port> -U <db_admin_user> -d <tenant_db> -c -F c "<tenant>.allesda.app/backups/<datei>.dump"-c: vorhandene Objekte vor dem Restore droppen (clobber),-F c: Custom-Format-Dump deklarieren. -
Anwendung neu starten.
> Vorher: flyway_schema_history des Dumps prüfen (Versionen müssen zum Ziel-Schema passen) — siehe Abschnitt „Schema-Version & UUID-Migration (V44/V41/V45)".
Wenn Sie sich unsicher sind, wenden Sie sich an Ihren Administrator.
„Backup klappt nicht“
- Prüfen Sie, ob das System Schreibrechte im Backup-Verzeichnis hat.
- Ist genügend Plattenplatz frei?
- Bei automatischem Backup: Ist AUTOMATE aktiviert und läuft der Task?
„Wo liegen die Backups?“
- Im Mandanten-Verzeichnis unter
backups/.
„Wie groß sind Backups?“
- Ungefähr in der Größenordnung der Datenbank selbst (Custom-Format, binär) – das wächst mit Anzahl Verträge, Tickets, Inventar usw.
Tenant-Admin (Plugin BACKUP, /settings/admin/backup):
GET /settings/admin/backup– Übersicht / ListePOST /settings/admin/backup/settings– Einstellungen speichern (max. Anzahl Backups)POST /settings/admin/backup/create– Backup jetzt erstellen (pg_dump -Fc)POST /settings/admin/backup/delete– Backup löschen- Kein Restore-Endpoint – Restore nur manuell per
pg_restore(siehe Abschnitt 4)
Superadmin (Backup-Transfer, /app-admin/backup-transfer):
GET /app-admin/backup-transfer– Konfigurationen + StatusPOST /app-admin/backup-transfer/{id}/run– Backup ausführen:pg_dump -Fcder Superadmin-DB + aller Tenant-DBs → verschlüsseltes ZIP → SFTP (nur Transfer/Rotation, kein Restore)POST /app-admin/backup-transfer/run-all– alle aktiven Konfigurationen ausführen
Verzeichnis:
<tenant-root>/backups(Dumps:*.dump)
Die UUID-Migration (Milestone 10) verändert das Datenbank-Schema irreversibel:
- V44 (Tenant-DBs) entfernt die Legacy-
id-Spalten und die dazugehörigen Sequenzen endgültig (Cutover auf UUID-PK). Die Migration ist irreversibel — es gibt kein Schema-Rollback. - V41 (Superadmin-DB) ist dagegen Dual-Column und rollbacksicher: die Legacy-
id-Spalten bleiben erhalten (Legacy-Drop kommt als Folge-Migration im nächsten Release), ein JAR-Rollback auf eine v6.0.x-Version funktioniert. - V45 (Tenant-DBs) droppt die Legacy-Drift-Spalten
key/valueintenant_settingund hebt die NOT-NULL-Constraints aufticket_comment.author/contentauf — ebenfalls irreversibel, Backup vor M10-Deployment erforderlich. - Pflicht vor Deployment der Cutover/M10-Version: Voll-Backup der Superadmin-DB und aller Tenant-DBs (z.B.
pg_dump -Fc, siehe Backup-Abschnitt bzw.How-To/DEPLOY.md). - Vor jedem Restore:
flyway_schema_historydes Dumps prüfen und die Versionen mit dem Ziel-Schema abgleichen (z.B. Dump in eine Test-DB instanziieren undSELECT version, script FROM flyway_schema_history ORDER BY versionvergleichen). - Keine Restore-Richtung Post-V44 → ältere App: Ein Dump, der nach V44 (Cutover-Version, Tenant-DBs) erzeugt wurde, kann nie in eine ältere App-Version (vor Cutover) zurückgespielt werden.
- JAR-Rollback über die V44-Grenze (Tenant-DBs) ist nicht unterstützt; die Superadmin-DB (V41) bleibt dagegen Dual-Column und rollbacksicher.
- BACKUP sichert die Daten der eigenen Instanz. Andere Mandanten haben ihre eigenen Backups.
- Ein Backup ersetzt keine externe Sicherung (z.B. auf ein anderes Medium). Wer ganz sicher gehen will, kopiert die Backup-Dateien zusätzlich an einen anderen Ort.