Kannst du ein Borg-Repository wiederherstellen, nachdem sein Cache-Verzeichnis verloren gegangen ist?

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.

In der Regel ja. Borg kann den lokalen Cache-Zustand aus dem Repository wiederherstellen, allerdings kann der erste Vorgang langsamer sein und erfordert weiterhin den Repository-Schlüssel und die Passphrase.

Die Entscheidung ist relevant, wenn ein Client-Datenträger ausfällt oder sein Borg-Cache-Verzeichnis gelöscht wird, während das Repository intakt bleibt. Die beiden konkurrierenden Zustände sind ein wiederherstellbarer lokaler Cache und ein fehlender Verschlüsselungsschlüssel oder fehlende Zugangsdaten beziehungsweise ein beschädigtes Repository. Beginnen Sie mit einer gespeicherten Konfiguration und entbehrlichen Daten, beobachten Sie jeweils nur einen Zweig und brechen Sie ab, wenn der Test das Risiko von Datenverlust, Berechtigungsproblemen oder Nichtverfügbarkeit erhöht.

Bedingungen für die Entscheidung zur Verwendung eines Borg-Repositorys ohne lokalen Cache festlegen

Dokumentieren Sie die Umgebung, bevor Sie etwas ändern: Software- und Firmwareversionen, Geräteidentitäten, Einhänge- oder Netzwerkpfad, freien Speicherplatz, Berechtigungen und das beobachtbare Symptom. Die Ausgangsdokumentation muss genügend Details enthalten, um den Fall nachzustellen, in dem ein Client-Datenträger ausfällt oder sein Borg-Cache-Verzeichnis gelöscht wird, während das Repository intakt bleibt.

Der erste Kandidat ist ein lokaler Cache, der wiederhergestellt werden kann. Der zweite sind ein fehlender Verschlüsselungsschlüssel oder fehlende Zugangsdaten beziehungsweise ein beschädigtes Repository. Der aktuelle Borg-Cache-Speicherort definiert den im Test verwendeten Mechanismus oder die Befehlsgrenze; er ersetzt nicht die Beobachtung auf diesem konkreten Heimserver.

Legen Sie vor dem Unterscheidungstest die Annahmebedingung und die Abbruchbedingung fest. Ein erfolgreiches Ergebnis muss die von einem Zweig vorhergesagten Belege verändern, während nicht damit zusammenhängende Dienste unverändert bleiben; bei einem Fehlschlag muss das System in den gespeicherten Zustand zurückversetzt werden, statt eine Kette spekulativer Fehlerbehebungen auszulösen.

Die Behauptung prüfen, ohne die ursprüngliche Anforderung abzusenken

Verwenden Sie diesen Unterscheidungstest: Repository beibehalten, Schlüssel bereitstellen, einen schreibgeschützten Listen- oder Info-Vorgang ausführen, dann den Neuaufbau des Caches zulassen und eine Canary-Datei extrahieren. Halten Sie Workload, Client, Pfad, Dateisatz und Zeitplanung konstant, damit sich das Ergebnis der geänderten Variable zuordnen lässt.

Verwenden Sie den Zustand des Borg-Clients, um das Feld auszuwählen, mit dem sich die Zweige tatsächlich unterscheiden lassen. Erfassen Sie anschließend den Zeitstempel, den Exit-Status, den Fehlertext, die Geräte- oder Snapshot-Identität, die Latenz, die übertragenen Bytes, die Berechtigungen und den Wiederherstellungsstatus. Ein erfolgreicher Befehlsabschluss reicht nicht aus, wenn die zu prüfende Behauptung die Identität, Dauerhaftigkeit oder den Anwendungsstatus betrifft.

Wiederholen Sie den Test nach einem Neustart, einer erneuten Verbindung, einem erneuten Einhängen oder mit kaltem Cache, sofern dieses Ereignis Teil der ursprünglichen Bedingung ist. Ist der erste Durchlauf destruktiv oder lässt sich die Umgebung nicht wiederherstellen, brechen Sie ab und reproduzieren Sie den Vorgang stattdessen auf einer entbehrlichen Kopie.

borg list /repo
borg extract /repo::archive path/to/canary

Ergebnisse „Bestanden“, „Fehlgeschlagen“ und „Ausnahme“ auswerten

BESTANDEN: Archive werden korrekt aufgelistet und eine Testwiederherstellung gelingt, nachdem der Cache neu aufgebaut wurde. Halten Sie die genaue Version, Identität und Arbeitslast fest, unter denen der Test bestanden wurde, damit die Schlussfolgerung bedingt bleibt und nicht als allgemeingültige Aussage verstanden wird.

FEHLGESCHLAGEN: Das Repository kann sich nicht authentifizieren, Prüfungen schlagen fehl oder Schlüssel waren nur auf dem verlorenen Client vorhanden. Ein Fehlschlag beweist nicht automatisch den gegenteiligen Fehlerzweig, wenn Netzwerk, Arbeitsspeicher, Berechtigungen oder Quellkonsistenz beide beeinflussen können; isolieren Sie diese gemeinsamen Abhängigkeiten, bevor Sie eskalieren.

AUSNAHME ODER MEHRDEUTIGES ERGEBNIS: Schreibvorgänge stoppen, Schlüssel wiederherstellen und vor einer Reparatur eine Kopie des Repositorys prüfen. Protokolle sichern und keine Reparatur-, Prune-, Lösch-, Neupartitionierungs- oder rekursiven Besitzänderungsbefehle ausführen, bis eine wiederherstellbare Kopie existiert.

Single board computer zimaboard2

Entscheidung unter der ursprünglichen Arbeitslast bestätigen

Führen Sie die zum beobachteten Fehlerzweig passende Maßnahme aus und wiederholen Sie anschließend die ursprüngliche Bedingung statt eines vereinfachten Ersatztests. Die Entscheidung gilt nur dann als bestätigt, wenn Archive korrekt aufgelistet werden und eine Testwiederherstellung gelingt, nachdem der Cache über zwei Zyklen oder den entsprechenden Neustart, Ruhezustand, die Unterbrechung oder den Lastwechsel hinweg neu aufgebaut wurde.

Nutzen Sie die Borg-Wartungsfenster, um den nächstgelegenen abhängigen Workflow zu prüfen, aber lassen Sie den ursprünglichen Auslöser unverändert. Nicht betroffene Datensätze, Freigaben, Container, Benutzer und Wiederherstellungspunkte müssen ihre bisherigen Zugriffsrechte und Zeitpläne beibehalten.

Die Abbruchgrenze ist eindeutig: Kann sich das Repository nicht authentifizieren, schlagen Prüfungen fehl oder waren Schlüssel nur auf dem verlorenen Client vorhanden, kehren Sie zur letzten verifizierten Konfiguration zurück, bewahren die Belege auf und eskalieren erst dann zu einem umfassenderen Plattform- oder Hardwaretest, wenn sich der Fehlerzweig reproduzieren lässt.

Wenn das gewünschte Ergebnis erreicht ist, vergleichen Sie es mit den unveränderlichen Sicherungsfenstern, damit die Lösung kein Risiko auf einen benachbarten Dienst verlagert. Ein erfolgreicher Test des Ziels ist trotzdem eine fehlgeschlagene Änderung, wenn dadurch ein neuer Fehler bei der Sicherung, Identität, Zeitüberschreitung oder Verfügbarkeit auftritt.

FAQ

Bei der Nutzung eines Borg-Repositorys ohne lokalen Cache betreffen die verbleibenden Suchanfragen meist die Frage, ob der Borg-Cache eine Sicherung der Repository-Daten ist, was separat gespeichert werden muss und ob ein Cache-Verlust ein Compact oder eine Reparatur auslösen sollte. Die folgenden Antworten behandeln diese Sonderfälle getrennt von der Hauptentscheidung.

Die Abnahmekriterien bleiben unverändert: Archive werden korrekt aufgelistet und eine Testdatei lässt sich nach dem Wiederaufbau des Caches wiederherstellen. Verändert eine Folgebedingung das Dateisystem, die Identität, den Netzwerkpfad oder die Anwendungsversion, wiederholen Sie nur die durch diese Änderung betroffene Unterscheidungsprüfung.

Weiten Sie das Experiment nicht weiter aus, wenn sich das Repository nicht authentifizieren kann, Prüfungen fehlschlagen oder sich die Schlüssel nur auf dem verlorenen Client befanden. Stoppen Sie in diesem Fall Schreibvorgänge, stellen Sie die Schlüssel wieder her und prüfen Sie eine Kopie des Repositorys vor der Reparatur. Sichern Sie die Belege, bevor Sie das Problem an die zuständige Person für Plattform, Speicher oder Hardware weitergeben.

Ist der Borg-Cache eine Sicherung der Repository-Daten?

Nein. Er beschleunigt Vorgänge und speichert den lokalen Zustand; die Archive im Repository bleiben die maßgebliche Sicherung.

Was muss separat gespeichert werden?

Verschlüsselungsschlüssel, Wiederherstellung der Passphrase, Repository-URL und Wiederherstellungsanweisungen.

Sollte ein Cache-Verlust ein Compact oder eine Reparatur auslösen?

Nein. Weisen Sie zuerst die Funktionsfähigkeit des Repositorys nach und bauen Sie den Cache wieder auf; Wartungsarbeiten sind eine separate Entscheidung.

Für die Nutzung eines Borg-Repositorys ohne lokalen Cache bleibt die praktische Antwort an Bedingungen geknüpft: Archive werden korrekt aufgelistet und eine Testdatei lässt sich nach dem Wiederaufbau des Caches wiederherstellen. Kann sich das Repository nicht authentifizieren, schlagen Prüfungen fehl oder befanden sich die Schlüssel nur auf dem verlorenen Client, stoppen Sie Schreibvorgänge, stellen Sie die Schlüssel wieder her und prüfen Sie eine Kopie des Repositorys vor der Reparatur. Ein Teilerfolg, der die ursprüngliche Arbeitslast nicht übersteht, ist keine Kompatibilität.

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.