Kanban-Board: Backup & Restore

Kurzanleitung zur Sicherung und Wiederherstellung des Mängel-Boards XKR Mängel & Baustellen.

Skript: /usr/local/sbin/kanban-backup.sh
Backup-Ordner: /var/backups/kanban/
Ausführen als: root

Was gesichert wird

Komponente Pfad Hinweis
Kanban-Karten data/kanban/XKR-Maengel/*.json unversioniert – dieses Backup ist die einzige Sicherung!
Seitentext data/pages/auto/xkr/xkr-r/maengel.txt Board + Detail-Abschnitte
User-CSS conf/userstyle.css Spaltenbreite, Schriftgröße
Plugin-Script lib/plugins/kanban/script.js enthält den „undefined„-Fix

1. Backup erstellen

/usr/local/sbin/kanban-backup.sh backup

Legt ein Archiv kanban-backup-JJJJMMTT-HHMMSS.tar.gz an. Die letzten 14 Backups werden behalten, ältere automatisch gelöscht.

Sinnvoll vor jedem Plugin-Update und nach größeren Änderungen am Board oder an der Seite.

2. Backups auflisten

/usr/local/sbin/kanban-backup.sh list

Zeigt alle vorhandenen Archive (neuestes oben) mit Datum und Größe.

3. Zurückspielen (Restore)

/usr/local/sbin/kanban-backup.sh restore <pfad-zum-archiv>

Beispiel: 

/usr/local/sbin/kanban-backup.sh restore \
    /var/backups/kanban/kanban-backup-20260623-113550.tar.gz

Ablauf:

  1. fragt zur Sicherheit nach – ja eingeben zum Fortfahren
  2. sichert automatisch den aktuellen Stand, bevor überschrieben wird (ein versehentlicher Restore ist damit nicht endgültig)
  3. spielt die Daten zurück
  4. setzt die Dateirechte wieder auf www-data:www-data
  5. leert den DokuWiki-Cache

4. Nach jedem Restore im Browser ausführen

Wichtig – sonst zeigt der Browser alte Stände von Board, CSS oder Script:

Danach die Board-Seite mit Strg+F5 hart neu laden.

Typischer Ablauf bei einem Plugin-Update

  1. Vorher sichern: /usr/local/sbin/kanban-backup.sh backup
  2. Plugin aktualisieren.
  3. Prüfen, ob der „undefined“-Fix in script.js noch vorhanden ist (Zeile $target.append(„<br>“ + cleanedNote);).
  4. Falls vom Update überschrieben → nur die eine Datei aus dem Archiv zurückholen: 
    tar -xzf /var/backups/kanban/<archiv>.tar.gz -C /var/www lib/plugins/kanban/script.js
  5. JS-Cache leeren (URL oben), Board-Seite mit Strg+F5 neu laden.

Hinweise

Restore ist „alles oder nichts„. Das Skript spielt immer das komplette Archiv zurück (alle vier Komponenten). Hast du zwischen Backup und Restore Karten verschoben, wären diese danach auf dem alten Stand. Soll nur das Plugin-Script zurück (z. B. nach einem Update), nutze den tar -xzf …-Einzeiler oben statt des Voll-Restores.

Letzte Aktualisierung: 23.06.2026