Borg-Backup-Migrationsanleitung: Ein Repository auf einen neuen Speicher verschieben

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Am sichersten ist es, Schreibprozesse anzuhalten, je nach Version mit einer geeigneten Methode zu kopieren oder zu übertragen, das Ziel zu prüfen und die Umstellung mit einer Rückfalloption vorzunehmen. Behandeln Sie dies als Abfolge überprüfbarer Kontrollpunkte, nicht als einzelnen Befehl.

Bei einem BorgBackup-Repository auf lokalem, NAS- oder per SSH erreichbarem Speicher besteht das praktische Risiko darin, ein Borg-Repository verschieben zu müssen, ohne eine geteilte oder unbemerkt unvollständige Kopie zu erzeugen. Dokumentieren Sie die aktuelle Identität und den Wiederherstellungspunkt, beginnen Sie mit der am wenigsten invasiven Unterscheidungsprüfung, werten Sie bestandene und fehlgeschlagene Prüfungen aus, bevor Sie eine weitere Variable ändern, und brechen Sie ab, wenn der Speicher instabil wird oder die einzige wiederherstellbare Kopie gefährdet wäre. Der folgende Ablauf ist erst abgeschlossen, wenn die ursprüngliche Arbeitslast erfolgreich ausgeführt wurde oder die Beweislage eine Eskalation erforderlich macht.

Die Rahmenbedingungen des Repositorys vor dem Kopieren dokumentieren

Notieren Sie die Borg-Version, die Repository-URL, die Repository-ID, den Verschlüsselungsmodus, den Speicherort des Schlüssels, das Verfahren zur Wiederherstellung der Passphrase, die Archivliste, die Größe, den freien Speicherplatz, die Nur-Anhängen-Einstellungen sowie alle Clients und Automatisierungsaufträge, die Schreibzugriff haben. Das Repository lässt sich nicht allein anhand eines lokalen Caches wiederherstellen. Bei verschlüsselten Repositorys kann außerdem Schlüsselmaterial erforderlich sein, das außerhalb des Zielsystems gespeichert ist.

Der ZimaSpace-Artikel zumLeitfaden zur Wiederherstellung eines verlorenen Borg-Caches unterscheidet zwischen wiederherstellbarem Cache-Status und fehlenden Schlüsseln oder Repository-Schäden. Führen Sie diese Prüfung vor der Migration durch, damit ein Schlüsselproblem nicht erst auffällt, wenn der alte Speicher bereits verloren ist.

Entscheiden Sie, ob es sich um eine bytegetreue Verlagerung desselben Repositorys oder um eine Übertragung in ein neu initialisiertes Repository handelt. Welche Methoden verfügbar sind, hängt von der Borg-Version und dem Format ab. Vermischen Sie keine Befehlsbeispiele für Borg 1 und Borg 2 und gehen Sie nicht davon aus, dass sich die Repository-Identität ändern sollte.

Schreibprozesse anhalten und einen konsistenten Quellstand erstellen

Deaktivieren Sie Timer, Cronjobs, Container und Remote-Clients und prüfen Sie anschließend, dass kein Borg-Prozess und keine Repository-Sperre aktiv ist. Führen Sie vor dem Kopieren borg list und ein geeignetes borg check aus. Schlägt die Prüfung der Quelle fehl, bewahren Sie diese auf und untersuchen Sie die Ursache, statt den unsicheren Zustand auf das Ziel zu übertragen.

Eine Diskussion auf Super User hebt das Risiko hervor, einaktives Repository mit rsync zu kopieren, während sich ein dedupliziertes Borg-Repository ändert. Die sichere Regel lautet, ein ruhendes Repository zu kopieren oder einen Dateisystem-Snapshot zu verwenden, der erstellt wurde, nachdem alle Borg-Schreibprozesse beendet wurden. So gehören Indizes, Segmente, Nonce-Status und Daten zu einem einzigen Zeitpunkt.

Lassen Sie Sicherungszeitpläne deaktiviert, bis die Validierung des Ziels abgeschlossen ist. Ist die Ausfallzeit zu lang, erstellen Sie eine erste Kopie, während das Repository inaktiv ist, stoppen Sie die Schreibvorgänge und führen Sie anschließend eine abschließende Synchronisierung durch. Lassen Sie während der Umstellung niemals zu, dass Quelle und Ziel unabhängig voneinander Sicherungen annehmen.

Mit einer von Ihrer Borg-Version unterstützten Methode kopieren

Bewahren Sie bei einer Verlagerung desselben Repositorys mit einem geeigneten lokalen oder Remote-Kopierwerkzeug alle Dateien, Berechtigungen, das Verhalten bei Sparse-Dateien und die Eigentümerschaft. Prüfen Sie das Fehlerprotokoll. Kopieren Sie das Repository-Stammverzeichnis als Einheit, nicht einzelne Archive oder scheinbar große Datenverzeichnisse. Lassen Sie die Quelle nach der abschließenden Synchronisierung unverändert.

Verwenden Sie bei einem neuen Repository oder einer Formatmigration die Transferfunktion nur, wenn sie von den installierten Borg-Versionen und dem Verschlüsselungsplan unterstützt wird. Eine Antwort auf Server Fault beschreibt den Transfer von Borg-Repositories als Repository-zu-Repository-Übertragung im Zusammenhang mit Borg 2, die nicht mit einer Borg-1-Dateisystemkopie austauschbar ist.

Stellen Sie das Ziel nach dem Kopieren zunächst schreibgeschützt für Clients bereit. Sind Repository-ID, Schlüsselzugriff, Berechtigungen oder Format unerwartet, stoppen Sie den Vorgang und korrigieren Sie das Ziel; führen Sie keine „Initialisierung“ über die kopierten Daten aus und keine Reparatur, um die Erkennung zu erzwingen.

Single board computer zimaboard2

Archive überprüfen, Clients umstellen und Rollback-Möglichkeit beibehalten

Führen Sie am Ziel Borg list, info sowie die passenden Repository- und Archivprüfungen aus. Extrahieren Sie Canary-Dateien aus einem aktuellen und einem älteren Archiv in ein separates Verzeichnis und vergleichen Sie anschließend Inhalte, Metadaten und Berechtigungen. Testen Sie mit derselben Borg-Binärdatei und demselben Remote-Pfad, die auch die Automatisierung verwenden wird.

Stellen Sie einen Client auf die neue URL um, löschen oder erstellen Sie nur den Cache-Zustand neu, den Borg als erforderlich ausweist, und erstellen Sie ein kleines Testarchiv. Stellen Sie Daten aus diesem Archiv wieder her und bestätigen Sie, dass die Bereinigung und Kompaktierung weiterhin deaktiviert bleiben, bis alle Clients den neuen Speicherort verwenden.

Der Umstieg ist abgeschlossen, wenn der Archivbestand übereinstimmt, die Prüfungen erfolgreich sind, zwei Wiederherstellungen nutzbar sind und nach einem Neustart oder Neustart des Schedulers eine neue Sicherung erfolgreich erstellt wurde. Lassen Sie die Quelle mindestens einen normalen Zyklus lang schreibgeschützt; löschen Sie sie erst nach Ablauf der Rollback-Frist oder eskalieren Sie den Vorgang, wenn die Prüfungen auf Quelle und Ziel unterschiedliche Ergebnisse liefern.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.