121 lines
4.6 KiB
Markdown
121 lines
4.6 KiB
Markdown
# Archiv-Konsolidierung ([konsolidierung.sh](http://konsolidierung.sh))
|
||
|
||
## Zweck
|
||
|
||
Das Skript ergänzt ein rsync-/rclone-Backup mit Archiv-Ordner um eine automatische
|
||
Lösch- bzw. Verdichtungs-Strategie. Aus den pro Backup-Lauf entstandenen Archiv-Ordnern
|
||
|
||
```
|
||
Archiv/
|
||
├── 2026-07-01-06/
|
||
├── 2026-07-15-14/
|
||
├── 2026-08-03-14/
|
||
└── ...
|
||
```
|
||
|
||
werden automatisch verdichtete Strukturen:
|
||
|
||
1. **Monatsordner**: Alle Tages-Ordner (`JJJJ-MM-TT-HH`) eines abgelaufenen Monats
|
||
werden zu einem Ordner `JJJJ-MM` zusammengefasst.
|
||
2. **Jahresordner**: Monatsordner, die älter als `RETAIN_MONTHS` (Standard: 3) Monate
|
||
sind, werden zu einem Ordner `JJJJ` zusammengefasst.
|
||
|
||
Der aktuelle Monat und die jüngsten Monatsordner bleiben unverändert bestehen.
|
||
|
||
## Konsolidierungsregel
|
||
|
||
Beim Zusammenführen mehrerer Ordner gilt: **Die aktuellste Version einer Datei bleibt**
|
||
**erhalten**, ältere Varianten werden überschrieben. Dateien, die nur in älteren Läufen
|
||
vorlagen (z. B. weil sie zwischenzeitlich im Produktiv-Bestand gelöscht und deshalb
|
||
archiviert wurden), bleiben unangetastet erhalten – das Skript löscht beim Merge
|
||
niemals etwas im Ziel, es überschreibt nur.
|
||
|
||
Das bedeutet für den Lebenszyklus einer Datei:
|
||
|
||
|
||
| Situation | Ergebnis nach Konsolidierung |
|
||
| ---------------------------------------- | ------------------------------------------ |
|
||
| Datei in mehreren Läufen unverändert | eine Kopie (neueste Version) |
|
||
| Datei zwischen Läufen verändert | letzte Version, ältere Varianten entfallen |
|
||
| Datei gelöscht und ins Archiv verschoben | bleibt dauerhaft erhalten |
|
||
| Datei nie archiviert | nicht betroffen |
|
||
|
||
|
||
## Nutzung
|
||
|
||
```bash
|
||
bash konsolidierung.sh [-n] <archiv-verzeichnis>
|
||
```
|
||
|
||
|
||
| Option | Bedeutung |
|
||
| ---------------------- | ------------------------------------------------------------ |
|
||
| `-n` | Dry-Run: zeigt nur an, was passieren würde, verändert nichts |
|
||
| `<archiv-verzeichnis>` | Pfad zum Archiv (Pflichtangabe) |
|
||
|
||
|
||
Beispiele:
|
||
|
||
```bash
|
||
bash konsolidierung.sh -n Archiv/ # Vorschau
|
||
bash konsolidierung.sh Archiv/ # ausführen
|
||
```
|
||
|
||
## Konfiguration
|
||
|
||
Die Variablen stehen am Anfang des Skripts:
|
||
|
||
- `RETAIN_MONTHS=3` – Monatsordner jünger als dieser Wert (in Monaten, bezogen auf
|
||
heute) bleiben als Monatsordner bestehen. Ältere wandern in den Jahresordner.
|
||
- `LOG_FILE=""` – leer lassen für reine Terminal-Ausgabe, oder einen Pfad setzen,
|
||
um alle Meldungen zusätzlich in ein Logfile zu schreiben (Append-Modus):
|
||
```bash
|
||
LOG_FILE="/var/log/konsolidierung.log"
|
||
```
|
||
|
||
## Logging
|
||
|
||
Jede verarbeitete Aktion wird mit Zeitstempel protokolliert:
|
||
|
||
```text
|
||
[2026-09-28 14:32:05] mv: /pfad/Archiv/2026-08-01-06 -> /pfad/Archiv/2026-08 (Grundordner fuer 2026-08)
|
||
[2026-09-28 14:32:07] merge: /pfad/Archiv/2026-08-03-14 -> /pfad/Archiv/2026-08
|
||
```
|
||
|
||
Bei gesetztem `LOG_FILE` landen dieselben Zeilen zusätzlich im Logfile. Da im
|
||
Append-Modus geschrieben wird, eignet sich das Log als lückenlose Historie der
|
||
Konsolidierungen.
|
||
|
||
## Wann und wie oft laufen lassen?
|
||
|
||
Das Skript kann **beliebig oft** laufen, idealerweise täglich direkt im Anschluss an
|
||
den Backup-Sync. Es ist idempotent:
|
||
|
||
- Ordner des aktuellen Monats werden nie angefasst; erst nach Monatswechsel werden
|
||
die Ordner des Vormonats zusammengefasst.
|
||
- Ein erneuter Lauf ohne neue abgelaufene Monate bewirkt schlicht nichts.
|
||
- Wird ein Lauf unterbrochen, setzt der nächste Lauf die Zusammenführung fort
|
||
(Restordner werden in den bereits bestehenden Monats-/Jahresordner weiter gemergt).
|
||
|
||
Einbindung in die tägliche Backup-Routine, z. B. per Cron:
|
||
|
||
```cron
|
||
30 2 * * * /pfad/backup-sync.sh && /pfad/konsolidierung.sh /pfad/Archiv
|
||
```
|
||
|
||
## Sicherheitshinweise
|
||
|
||
- **Erst testen**: vor dem ersten echten Lauf `bash konsolidierung.sh -n Archiv/`
|
||
ausführen und die Ausgabe prüfen.
|
||
- Ordner, die nicht dem Namensmuster `JJJJ-MM-TT-HH` bzw. `JJJJ-MM` entsprechen,
|
||
werden ignoriert und nie verändert.
|
||
- Da beim Merge kopiert (`cp -a`, erhält Rechte und Zeitstempel) und erst danach
|
||
gelöscht wird, ist ein Abbruch unkritisch; es können nur Restkopien entstehen,
|
||
die der nächste Lauf aufräumt.
|
||
- Das Skript sollte nicht gleichzeitig mit dem Backup-Sync auf dasselbe Archiv
|
||
laufen (einfach sequenziell aufrufen).
|
||
|
||
## Voraussetzungen
|
||
|
||
- Linux mit Bash (nutzt `date -d`, `mapfile`, assoziative Arrays).
|
||
- Das Archiv-Verzeichnis muss für den ausführenden Nutzer schreibbar sein. |