docs: synchronize documentation across all languages

- Add mcp.md to: bg, fa, ru, tr, zh, ar - Add index.md to Bulgarian (bg) - Add 24 missing German (de) documentation files Translations for all supported languages now complete.
2026-05-17 16:29:28 +03:00
parent a5d34c001a
commit c95bc4cd44
32 changed files with 4574 additions and 0 deletions
@@ -0,0 +1,199 @@
+# Backup & Wiederherstellung
+
+## Online Snapshots
+
+BaraDB unterstützt Online-Snapshots ohne Server-Stopp. Der Snapshot erfasst eine
+konsistente Point-in-Time-Ansicht mittels MVCC.
+
+### Snapshot erstellen
+
+```nim
+import barabadb/core/backup
+
+var bm = newBackupManager()
+bm.createSnapshot("/backup/baradb_2025-01-15")
+```
+
+### Via CLI
+
+```bash
+./build/baradadb --snapshot --output=/backup/snapshot.db
+```
+
+### Via HTTP API
+
+```bash
+curl -X POST http://localhost:9470/api/backup \
+  -H "Content-Type: application/json" \
+  -d '{"destination": "/backup/snapshot.db"}'
+```
+
+### Automatisierte Backups
+
+Cron für geplante Backups verwenden:
+
+```bash
+# Daily snapshot at 2 AM
+0 2 * * * /usr/local/bin/baradadb --snapshot --output=/backup/baradb_$(date +\%Y\%m\%d).db
+
+# Letzte 7 Tage behalten
+find /backup -name "baradb_*.db" -mtime +7 -delete
+```
+
+## Point-in-Time Recovery (PITR)
+
+BaraDB verwendet das Write-Ahead Log (WAL) für Point-in-Time Recovery.
+
+### WAL-Archivierung
+
+Kontinuierliche WAL-Archivierung aktivieren:
+
+```bash
+BARADB_WAL_ARCHIVE_DIR=/backup/wal \
+BARADB_WAL_ARCHIVE_INTERVAL_MS=60000 \
+./build/baradadb
+```
+
+### Wiederherstellung von Checkpoint + WAL
+
+```bash
+# Von Snapshot wiederherstellen
+./build/baradadb --recover \
+  --checkpoint=/backup/snapshot.db \
+  --wal-dir=/backup/wal
+
+# Wiederherstellung zu spezifischem LSN
+./build/baradadb --recover \
+  --checkpoint=/backup/snapshot.db \
+  --wal-dir=/backup/wal \
+  --target-lsn=15420
+
+# Wiederherstellung zu spezifischer Zeit
+./build/baradadb --recover \
+  --checkpoint=/backup/snapshot.db \
+  --wal-dir=/backup/wal \
+  --target-time="2025-01-15T10:30:00Z"
+```
+
+### Wiederherstellung via SQL
+
+Sie können auch direkt via BaraQL wiederherstellen:
+
+```sql
+RECOVER TO TIMESTAMP '2026-05-07T12:00:00';
+```
+
+### Inkrementelle Backups
+
+Inkrementelle Backups kopieren nur geänderte SSTables:
+
+```bash
+./build/baradadb --backup-incremental \
+  --last-backup=/backup/previous \
+  --output=/backup/incremental_$(date +%Y%m%d)
+```
+
+## Replikation als Backup
+
+Für kontinuierlichen Schutz, Streaming-Replikation verwenden:
+
+### Primary
+
+```bash
+BARADB_REPLICATION_ENABLED=true \
+BARADB_REPLICATION_MODE=async \
+./build/baradadb
+```
+
+### Replica
+
+```bash
+BARADB_REPLICATION_ENABLED=true \
+BARADB_REPLICATION_PRIMARY=primary:9472 \
+./build/baradadb
+```
+
+## Disaster Recovery
+
+### Wiederherstellungsverfahren
+
+#### Szenario 1: Einzelne Dateikorruption
+
+```bash
+# Korrupte SSTable aus Logs identifizieren
+# Spezifische SSTable aus Backup wiederherstellen
+cp /backup/sstables/000012.sst ./data/sstables/
+
+# Index neu aufbauen
+./build/baradadb --rebuild-index
+```
+
+#### Szenario 2: Kompletter Datenverlust
+
+```bash
+# 1. Neuesten Snapshot wiederherstellen
+cp /backup/snapshot.db ./data/
+
+# 2. WAL replay
+./build/baradadb --recover --wal-dir=/backup/wal
+
+# 3. Verifizieren
+curl http://localhost:9470/health
+```
+
+#### Szenario 3: Cluster-Knoten-Ausfall
+
+```bash
+# Für Raft-Cluster, einfach neuen Knoten starten
+BARADB_RAFT_NODE_ID=newnode \
+BARADB_RAFT_PEERS=node1:9001,node2:9001 \
+./build/baradadb
+
+# Der neue Knoten wird über Raft-Log-Replikation aufholen
+```
+
+## Backup-Verifizierung
+
+Backups immer verifizieren:
+
+```bash
+# In temporäres Verzeichnis wiederherstellen
+./build/baradadb --recover \
+  --checkpoint=/backup/snapshot.db \
+  --data-dir=/tmp/verify_data
+
+# Konsistenzprüfung ausführen
+curl http://localhost:9470/api/admin/check
+```
+
+## Speicheranforderungen
+
+| Backup-Typ | Größe | Häufigkeit | Aufbewahrung |
+|-------------|------|-----------|--------------|
+| Full snapshot | ~1× Datengröße | Täglich | 7 Tage |
+| Inkrementell | ~0.1× Datengröße | Stündlich | 24 Stunden |
+| WAL-Archiv | ~0.05× Datengröße / Tag | Kontinuierlich | 30 Tage |
+
+## Best Practices
+
+1. **Restores regelmäßig testen** — Ein Backup das Sie nicht wiederherstellen können ist wertlos
+2. **Backups außerhalb speichern** — S3, GCS oder Azure Blob verwenden
+3. **Backups verschlüsseln** — `gpg` oder OS-Level-Verschlüsselung verwenden
+4. **Backup-Jobs überwachen** — Bei fehlgeschlagenen Backups alarmieren
+5. **RTO/RPO dokumentieren** — Ihre Wiederherstellungszeit und Punktziele kennen
+
+### Cloud-Backup-Upload
+
+```bash
+# Zu S3 hochladen
+aws s3 cp /backup/snapshot.db s3://my-bucket/baradb/
+
+# Zu GCS hochladen
+gsutil cp /backup/snapshot.db gs://my-bucket/baradb/
+
+# Zu Azure hochladen
+az storage blob upload \
+  --container-name backups \
+  --file /backup/snapshot.db \
+  --name baradb/snapshot.db
+```