Docs

BACKUP

Dokumentation

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 -Fc ein 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 unter backups/ abgelegt.
  • Optional läuft das automatisch über AUTOMATE (Backup-Task BACKUP_DB).

1) Backup manuell erstellen

  1. Öffnen Sie Admin → Backup (/settings/admin/backup).
  2. Klicken Sie auf „Backup erstellen“.
  3. Das neue Backup erscheint in der Liste mit Zeitstempel und Größe.

2) Automatisches Backup einstellen

  1. Auf der Backup-Seite finden Sie den Bereich „Einstellungen“.
  2. Aktivieren Sie automatisches Backup und wählen Sie das Intervall (z.B. täglich).
  3. Optional: Aufbewahrungszeit / max. Anzahl an Backups.
  4. Speichern.

> Damit das automatische Backup wirklich läuft, muss das Plugin AUTOMATE aktiv sein und nicht pausiert.

3) Altes Backup löschen

  1. In der Backup-Liste den entsprechenden Eintrag wählen.
  2. „Löschen“ klicken.
  3. 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:

  1. Anwendung stoppen.

  2. Gewünschten Dump aus backups/ auswählen (<db>-dd.MM.yyyy-backup.dump).

  3. Dump per pg_restore in 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.

  4. 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 / Liste
  • POST /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 + Status
  • POST /app-admin/backup-transfer/{id}/run – Backup ausführen: pg_dump -Fc der 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/value in tenant_setting und hebt die NOT-NULL-Constraints auf ticket_comment.author/content auf — 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_history des Dumps prüfen und die Versionen mit dem Ziel-Schema abgleichen (z.B. Dump in eine Test-DB instanziieren und SELECT version, script FROM flyway_schema_history ORDER BY version vergleichen).
  • 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.