obnam - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

obnam - Backups erstellen, wiederherstellen und bearbeiten

ZUSAMMENFASSUNG

obnam [--always-restore-setuid] [--no-always-restore-setuid] [--Kontrollpunkt=GRÖßE]
[--chunk-bag-size=GRÖßE] [--chunk-cache-size=GRÖßE] [--chunk-size=GRÖßE]
[--chunkids-pro-group=NUM] [--Kundenname=KUNDENNAME] [--komprimieren-mit=PROGRAMM]
[--config=FILE] [--dump-config] [--dump-setting-names] [--generate-manpage=TEMPLATE] [-h]
[--help] [--Hilf allen] [--list-config-files] [--Version] [--no-default-configs]
[--crash-limit=COUNTER] [--kritisches Alter=Alter] [--deduplizieren=MODE] [--dir-bag-size=GRÖßE]
[--dir-cache-größe=GRÖßE] [--dump-memory-profile=METHODE] [--dump-repo-file-metadata]
[--no-dump-repo-file-metadata] [--verschlüsseln-mit=VERSCHLÜSSELN-MIT] [--ausschließen=AUSSCHLIESSEN]
[--exclude-caches] [--no-exclude-caches] [--ausgeschlossen von=FILE] [--fsck-fix]
[--no-fsck-fix] [--fsck-ignore-chunks] [--no-fsck-ignore-chunks]
[--fsck-ignore-client=NAME/FUNKTION] [--fsck-nur-letzte-Generation] [--no-fsck-nur-letzte-generation]
[--fsck-rm-unbenutzt] [--no-fsck-rm-unused] [--fsck-skip-checksums]
[--no-fsck-skip-checksums] [--fsck-skip-dirs] [--no-fsck-skip-dirs] [--fsck-skip-files]
[--no-fsck-skip-files] [--fsck-skip-generationen] [--no-fsck-skip-generations]
[--fsck-skip-per-client-b-trees] [--no-fsck-skip-per-client-b-trees]
[--fsck-skip-shared-b-trees] [--no-fsck-skip-shared-b-trees] [--fuse-opt=FUSE]
[--Generation=GENERATION] [--gnupghome=HOMEDIR] [--idpath-bits=IDPATH-BITS]
[--idpath-Tiefe=IDPATH-TIEFE] [--idpath-skip=IDPATH-SKIP] [--enthalten=eNTHALTEN]
[--halten=HALTEN] [--Schlüsseldetails] [--no-key-details] [--keyid=SCHLÜSSELID] [--checkpoints verlassen]
[--no-leave-checkpoints] [--lock-timeout=TIMEOUT] [--Protokoll=FILE] [--log-keep=N]
[-Log-Ebene=LEVEL] [--log-max=GRÖßE] [--log-modus=MODE] [--lru-Größe=GRÖßE]
[--memory-dump-interval=SECONDS] [--Knotengröße=GRÖßE] [--ein-Dateisystem]
[--no-one-filesystem] [--Ausgabe=FILE] [--vorgeben] [--Probelauf] [--no-act] [--kein-so tun]
[--kein Trockenlauf] [--no-no-act] [--vortäuschen-Zeit=TIMESTAMP] [--pure-paramiko]
[--no-pure-paramiko] [--ruhig] [--Leise] [--keine Ruhe] [--no-silent] [-rURL]
[--Repository=URL] [--Repository-Format=FORMAT] [--Wurzel=URL] [--sftp-verzögerung=SFTP-VERZÖGERUNG]
[--kleine-dateien-in-btree] [--no-small-files-in-btree] [--ssh-Befehl=AUSFÜHRBAR]
[--ssh-host-keys-check=BEWERTUNG] [--ssh-key=DATEINAME] [--ssh-bekannte-hosts=DATEINAME]
[--strict-ssh-host-keys] [--no-strict-ssh-host-keys] [--symmetrische-Schlüsselbits=BITS]
[--testing-fail-matching=REGEXP] [--zu=TO] [--verfolgen=SPUR] [--Upload-Warteschlangengröße=GRÖßE]
[- ausführlich] [--no-verbose] [--überprüfen-zufällig=N] [--warn-Alter=Alter] [--schwach-zufällig]
[--no-weak-random]

obnam [Optionen] _sperren
obnam [Optionen] Add-Key [KLIENT-NAME/FUNKTION] ...
obnam [Optionen] sichern [DIRECTORY|URL] ...
obnam [Optionen] Client-Schlüssel
obnam [Optionen] Kunden
obnam [Optionen] unterschied [GENERATION1]GENERATION2
obnam [Optionen] Dump-Repo
obnam [Optionen] Kraftschluss
obnam [Optionen] vergessen [GENERATION] ...
obnam [Optionen] fsck
obnam [Optionen] Generationen
obnam [Optionen] Geniden
obnam [Optionen] Hilfe
obnam [Optionen] Hilf allen
obnam [Optionen] kdirstat [FILE] ...
obnam [Optionen] Listenfehler
obnam [Optionen] Listenformate
obnam [Optionen] Listentasten
obnam [Optionen] Liste-Toplevel
obnam [Optionen] ls [FILE] ...
obnam [Optionen] montieren [ROOT]
obnam [Optionen] Nagios-letztes-Backup-Alter
obnam [Optionen] Client entfernen [KLIENT-NAME/FUNKTION] ...
obnam [Optionen] Entfernen-Taste [KLIENT-NAME/FUNKTION] ...
obnam [Optionen] wiederherstellen [DIRECTORY] ...
obnam [Optionen] verifizieren [DIRECTORY] ...

BESCHREIBUNG

obnam erstellt, wiederherstellt, manipuliert und anderweitig mit Backups umgeht. Es kann speichern
Backups auf einer lokalen Festplatte oder auf einem Server über sftp. Jede Backup-Generation sieht aus wie ein
frischer Snapshot, ist aber wirklich inkrementell: Der Benutzer muss sich keine Sorgen machen, ob es sich um einen
vollständige Sicherung oder nicht. Es werden nur geänderte Daten gesichert, und wenn bereits ein Datenblock vorhanden ist
in einer anderen Datei gesichert werden, werden diese Daten wiederverwendet.

Der Ort, an dem gesicherte Daten abgelegt werden, wird als Backup-Repository bezeichnet. Ein Repository
kann beispielsweise ein Verzeichnis auf einem sftp-Server oder ein Verzeichnis auf einer USB-Festplatte sein. EIN
Ein einzelnes Repository kann Backups von mehreren Clients enthalten. Ihre Daten werden sich vermischen
als würden sie separate Repositorys verwenden, aber wenn ein Client eine Datei sichert, werden die anderen
kann die Daten weiterverwenden.

obnam Befehlszeilensyntax besteht aus a Befehl möglicherweise gefolgt von Argumenten. Die
Befehle sind unten aufgeführt.

· Sicherungskopie macht eine neue Sicherung. Wenn es zum ersten Mal ausgeführt wird, wird danach ein vollständiges Backup erstellt
das eine inkrementelle.

· wiederherstellen ist das Gegenteil einer Sicherung. Es kopiert gesicherte Daten aus dem Backup
Repository in ein Zielverzeichnis. Sie können alles in einer Generation wiederherstellen, oder
nur ausgewählte Dateien.

· Kunden listet die Clients auf, die im Repository gesichert werden.

· Generationen listet jede Backup-Generation für einen bestimmten Client auf, plus einige Metadaten
über die Generation.

· Geniden listet die Kennung für jede Backup-Generation für einen bestimmten Client auf. Nein
andere Informationen werden angezeigt. Dies kann für die Skripterstellung nützlich sein.

· ls listet den Inhalt einer bestimmten Generation auf, ähnlich wie ls -lar.

· kdirstat listet den Inhalt einer bestimmten Generation in einem kompatiblen Format auf
an. Nach der Installation können Sie HEIC-Dateien mit der kdirstat Cache-Dateiformat, das dann verwendet werden kann, um die
Inhalt eines Backups.

· überprüfen vergleicht Daten im Backup mit tatsächlichen Benutzerdaten und stellt sicher, dass dies der Fall ist
identisch. Es ist am nützlichsten, sofort nach einem Backup zu starten, um zu überprüfen, ob es
hat tatsächlich funktioniert. Es kann jederzeit ausgeführt werden, aber wenn sich die Benutzerdaten geändert haben,
Die Überprüfung schlägt fehl, obwohl die Sicherung in Ordnung ist.

· vergessen entfernt nicht mehr benötigte Backup-Generationen, damit sie nicht verwendet werden
Festplattenplatz. Beachten Sie, dass die Daten nach dem Entfernen einer Backup-Generation nicht mehr gespeichert werden können
mehr restauriert. Sie können entweder die zu entfernenden Generationen angeben, indem Sie sie auflisten
in der Befehlszeile, oder verwenden Sie die --halten Option zum Angeben einer Richtlinie für das, was beibehalten werden soll
(alles andere wird entfernt).

· fsck prüft die interne Konsistenz des Backup-Repositorys. Es bestätigt, dass
alle Clients, Generationen, Verzeichnisse, Dateien und alle Dateiinhalte existieren noch in
das Backup-Repository. Die Ausführung kann sehr lange dauern.

· Kraftschluss entfernt eine Sperrdatei für einen Client im Repository. Du solltest nur
erzwingen Sie eine Sperre, wenn Sie sicher sind, dass niemand auf die Daten dieses Clients zugreift
Repository. Ein baumelndes Schloss kann beispielsweise passieren, wenn obnam sein Netzwerk verliert
Verbindung zum Backup-Repository.

· Client-Schlüssel listet den Verschlüsselungsschlüssel auf, der jedem Client zugeordnet ist.

· Listentasten listet die Schlüssel auf, die auf das Repository zugreifen können und welche oberste Ebene
Verzeichnisse, auf die jeder Schlüssel zugreifen kann. Einige der Toplevel-Verzeichnisse werden geteilt
zwischen Clients, andere sind spezifisch für einen Client.

· Liste-Toplevel ist wie Listentasten, listet aber die obersten Ebenen auf und auf welche Tasten zugreifen können
Them.

· Add-Key fügt dem Repository einen Verschlüsselungsschlüssel hinzu. Standardmäßig wird der Schlüssel hinzugefügt
nur zu den freigegebenen Toplevel-Verzeichnissen, aber es kann auch zu bestimmten hinzugefügt werden
Clients: Listen Sie die Namen der Clients in der Befehlszeile auf. Der Schlüssel wird mit gegeben
--keyid Möglichkeit. Wer Zugriff auf den dem Schlüssel entsprechenden geheimen Schlüssel hat
id kann auf das Backup-Repository zugreifen (die freigegebenen Toplevel plus die angegebenen Clients).

· Schlüssel entfernen entfernt einen Schlüssel aus den freigegebenen Toplevel-Verzeichnissen sowie aus allen Clients
in der Befehlszeile angegeben.

· nagios-letztes-backup-alter ist eine Prüfung, die mit einer Rückgabe ungleich Null beendet wird, wenn ein Backup-Alter
eine bestimmte Schwelle überschreitet. Es eignet sich als Check-Plugin für Nagios.
Schwellenwerte können gegeben werden --warn-Alter und --kritisches Alter Optionen.

· diff vergleicht zwei Generationen und listet Dateien auf, die sich zwischen ihnen unterscheiden. Jeder Ausgang
Zeile wird entweder ein Pluszeichen (+) für hinzugefügte Dateien vorangestellt, ein Minus
Zeichen (-) für entfernte Dateien oder ein Sternchen (*) für Dateien, die
geändert. Wenn nur eine Generations-ID in der Befehlszeile angegeben wird, die
Generation wird mit ihrem direkten Vorgänger verglichen. Wenn zwei IDs waren
angegeben, werden alle Änderungen zwischen diesen beiden Generationen aufgelistet.

· montieren macht das Backup-Repository über ein schreibgeschütztes FUSE-Dateisystem verfügbar. Jeder
Die Backup-Generierung ist als Unterverzeichnis sichtbar, das nach der Generations-ID benannt ist.
Dies bedeutet, dass Sie die gesicherten Daten mit normalen Tools wie Ihrer GUI-Datei anzeigen können
-Manager oder Befehlszeilentools wie ls(1) diff(1) und cp(1). Du kannst nicht machen
neue Backups mit dem Unterbefehl mount, aber Sie können Daten einfach wiederherstellen.

Sie benötigen die FUSE-Dienstprogramme und die Berechtigung, FUSE zu verwenden, um dies zu tun
Arbeit. Die Details variieren je nach Betriebssystem; Installieren Sie in Debian die
Paket Sicherung und füge dich hinzu Sicherung Gruppe (evtl. müssen Sie sich ab- und wieder abmelden
wieder in).

Making Sicherungen
Wenn Sie ein Backup ausführen, obnam lädt Daten in das Backup-Repository hoch. Die Daten sind aufgeteilt
in Chunks, und wenn bereits ein Chunk im Backup-Repository vorhanden ist, wird er nicht hochgeladen
wieder. Dies erlaubt obnam um mit Dateien umzugehen, die seit dem geändert oder umbenannt wurden
vorherigen Backup-Lauf. Es ermöglicht auch mehreren Backup-Clients, das Hochladen derselben zu vermeiden
Daten. Wenn zum Beispiel jeder im Büro eine Kopie der gleichen Verkaufsbroschüren hat,
nur eine Kopie muss im Backup-Repository gespeichert werden.

Jeder Backup-Lauf ist ein Generation. Außerdem, obnam machen Kontrollpunkt Generationen
hin und wieder. Diese sind genau wie normale Generationen, werden aber nicht garantiert
eine vollständige Momentaufnahme der Live-Daten sein. Wenn der Backup-Lauf im
Mitte, kann der nächste Backup-Lauf vom letzten Kontrollpunkt aus fortgesetzt werden, ohne dass dies erforderlich ist
von vorne anfangen.

Wenn ein Backup-Lauf ein Backup-Root-Verzeichnis löscht, behalten die älteren Generationen es weiterhin:
An den alten Generationen ändert sich nichts, nur weil es eine neue gibt. Wenn die Wurzel war
versehentlich gelöscht, kann es wieder hinzugefügt werden und der nächste Backup-Lauf wird das vorhandene wieder verwenden
Daten im Backup-Repository und sichert nur die Datei-Metadaten (Dateinamen,
Berechtigungen usw.).

Überprüfen Sicherungen
Was nützt ein Backup-System, auf das Sie sich nicht verlassen können? Wie kann man sich auf etwas verlassen, was man nicht kann?
Prüfung? Die obnam überprüfen Der Befehl überprüft, ob die Daten im Backup-Repository mit den tatsächlichen übereinstimmen
Benutzerdaten. Es ruft eine oder mehrere Dateien aus dem Repository ab und vergleicht sie mit den
Benutzerdaten. Dies ist im Wesentlichen dasselbe wie eine Wiederherstellung durchzuführen und dann wiederhergestellte Dateien zu vergleichen
mit den Originaldateien mit CMP(1), aber einfacher zu bedienen.

Standardmäßig erfolgt die Überprüfung für alle Dateien. Sie können auch angeben, welche Dateien
überprüft, indem Sie sie in der Befehlszeile auflisten. Sie sollten die vollständigen Pfade zum
Dateien, nicht relativ zum aktuellen Verzeichnis.

Die Ausgabe listet Dateien auf, bei denen die Überprüfung aus irgendeinem Grund fehlschlägt. Wenn Sie alles überprüfen,
es ist wahrscheinlich, dass sich einige Dateien (z. B. übergeordnete Verzeichnisse von Backup-Root) geändert haben
ohne dass es ein Problem ist. Beachten Sie, dass Sie den gesamten Pfad zum
zu überprüfende Dateien oder Verzeichnisse, nicht relativ zum Backup-Stammverzeichnis. Du musst noch
Geben Sie mindestens einen der Backup-Roots auf der Befehlszeile oder über das . an --Wurzel Option so
obnam findet das Dateisystem, falls es sich um ein Remote-Dateisystem handelt.

URL Syntax
Immer wenn obnam eine URL akzeptiert, kann dies entweder ein lokaler Pfadname oder ein . sein Sftp URL. Ein sftp
URL hat die folgende Form:

sftp: //[Benutzer@]Domain[:port ]/Weg

woher Domain ist ein normaler Internet-Domain-Name für einen Server, Benutzer ist dein Benutzername darauf
Server, port ist eine optionale Portnummer und Weg ist ein serverseitiger Pfadname. Mögen
bzr(1), aber im Gegensatz zum sftp-URL-Standard ist der Pfadname absolut, es sei denn, er beginnt mit
/~/ In diesem Fall ist es relativ zum Home-Verzeichnis des Benutzers auf dem Server.

Beispiele für URLs finden Sie im Abschnitt BEISPIEL.

Sie können verwenden Sftp URLs für das Repository oder die Live-Daten (root), aber beachten Sie, dass aufgrund von
Einschränkungen des Protokolls und seine Implementierung im paramiko Bibliothek, einige Dinge
funktioniert nicht sehr gut für den Zugriff auf Live-Daten über Sftp. Am wichtigsten ist die Handhabung
von Hardlinks ist eher suboptimal. Für den Live-Datenzugriff sollten Sie die URL nicht beenden
mit /~/ und sollte in diesem speziellen Fall am Ende einen Punkt anhängen.

Generation Spezifikationen
Wenn Sie nicht die neueste Generation verwenden, müssen Sie angeben, welche Sie benötigen. Dies
wird mit dem fertig --Generation Option, die eine Generationsspezifikation als
Streit. Die Spezifikation ist entweder das Wort neueste, also die neueste Generation
(auch die Standardeinstellung) oder eine Zahl. Siehe die Generationen Befehl, um zu sehen, was Generationen sind
verfügbar sind und welche Nummern sie haben.

Rückgabepolitik für Aufbewahrung und Entfernen Sicherungskopie Generationen
Das vergessen Befehl kann einer Richtlinie folgen, um einige Backups automatisch zu behalten und andere zu entfernen
Generationen. Die Richtlinie wird mit dem . festgelegt --halten=POLITIK .

POLITIK ist eine durch Kommas getrennte Liste von Regeln. Jede Regel besteht aus einer Zählung und einem Zeitraum.
Die Zeiträume sind h, d, w, m und y, für Stunde, Tag, Woche, Monat und Jahr.

Eine Politik von 30d bedeutet, das neueste Backup für jeden Tag aufzubewahren, an dem ein Backup erstellt wurde, und
Bewahren Sie die letzten 30 solcher Backups auf. Jedes Backup, das einer Richtlinienregel entspricht, wird aufbewahrt, und alle
Backups dazwischen werden entfernt, ebenso wie alle Backups, die älter als das älteste aufbewahrte Backup sind.

Nehmen wir als Beispiel an, dass Backups stündlich zu jeder vollen Stunde erstellt werden: um 00:00, 01:00, 02:00,
und so weiter, bis 23:00 Uhr. Wenn die vergessen Befehl wird um 23:15 Uhr ausgeführt, mit der oben genannten Richtlinie, it
behält die an jedem Tag um 23:00 erstellte Sicherung bei und entfernt alle anderen Sicherungen an diesem Tag.
Es entfernt auch Backups, die älter als 30 Tage sind.

Wenn Backups jeden zweiten Tag, mittags, vergessen würde die letzten 30 Backups behalten, oder 60
Tage Backups mit der oben genannten Richtlinie.

Beachten Sie, dass obnam nur Zeitstempel im Backup-Repository überprüft und sich nicht darum kümmert.
wie die aktuelle Uhrzeit ist. Dies bedeutet, dass die
vorhandene werden nicht automatisch entfernt. Im Wesentlichen gibt obnam die aktuelle Uhrzeit vor
ist kurz nach der letzten Sicherung, wenn vergessen es läuft.

Die Regeln können in beliebiger Reihenfolge angegeben werden, werden jedoch nach Zeiträumen aufsteigend sortiert
vor angewendet. (Es ist ein Fehler, zwei Regeln für denselben Zeitraum anzugeben.) Ein Backup
Generation wird beibehalten, wenn sie einer Regel entspricht.

Nehmen Sie beispielsweise die gleiche Backup-Häufigkeit wie oben an, aber eine Richtlinie von 30d,52w. Dies
speichert das neueste tägliche Backup für jeden Tag dreißig Tage lang, und die neueste wöchentlich
52 Wochen Backup. Da die stündlichen Backups täglich entfernt werden, bevor sie ein
Chance, durch eine wöchentliche Regel gerettet zu werden, der Effekt ist, dass das 23:00-Uhr-Backup für jeden
Tag wird für einen Monat gespeichert, und das 23:00-Backup an Sonntagen wird für ein Jahr gespeichert.

Wenn Sie stattdessen eine Richtlinie von 72h, 30d, 52w, obnam würde die letzten 72 stündlichen Backups behalten,
und das letzte Backup jedes Kalendertages für 30 Tage und das letzte Backup jedes Kalenders
Woche für 52 Wochen. Wenn die Backup-Häufigkeit einmal pro Tag war, obnam würde das Backup behalten
jeder Kalenderstunde, für die ein Backup erstellt wurde, für 72 solcher Backups. Mit anderen Worten,
es würde effektiv die letzten 72 täglichen Backups behalten.

Klingt verwirrend? Denken Sie nur daran, wie verwirrt der Entwickler war, als er den Code schrieb.

Wenn keine Richtlinie angegeben ist, vergessen werde alles behalten.

Eine typische Richtlinie könnte sein: 72 Stunden, 7 Tage, 5 Wochen, 12 Minuten, was bedeutet: Behalten Sie die letzten 72 stündlichen Backups, die
letzten 7 täglichen Backups, den letzten 5 wöchentlichen Backups und den letzten 12 monatlichen Backups. Wenn die
Backups werden systematisch stündlich ausgeführt, dies bedeutet, dass stündliche Backups aufbewahrt werden
für drei Tage, tägliche Backups für eine Woche, wöchentliche Backups für einen Monat und monatliche Backups
für ein Jahr.

Die Funktionsweise der Richtlinie ist etwas kompliziert. Lauf vergessen an. Nach der Installation können Sie HEIC-Dateien mit der --vorgeben Option zu
Stellen Sie sicher, dass Sie die richtigen entfernen.

Die richtigen Verschlüsselung
obnam kann alle Daten verschlüsseln, die es in das Backup-Repository schreibt. Es verwendet gpg(1) zu tun
die Verschlüsselung. Sie müssen ein Schlüsselpaar erstellen mit gpg --gen-key (oder verwenden Sie ein vorhandenes
eins), und dann erzähle obnam darüber mit dem --verschlüsseln-mit Möglichkeit. Sie können optional
Verwenden Sie ein separates Home-Verzeichnis mit dem --gnupghome Möglichkeit. Standardmäßig ist die Standardeinstellung
Verzeichnis für gpg(1) werden verwendet.

Konfiguration Dateien
obnam sucht an verschiedenen Orten nach Konfigurationsdateien. Siehe den Abschnitt DATEIEN
für eine Liste. Alle diese Dateien zusammen werden als eine große Datei mit dem Inhalt aller behandelt
Dateien verkettet.

Die Dateien liegen im INI-Format vor und nur die [Konfiguration] Abschnitt verwendet wird (alle anderen Abschnitte sind
ignoriert).

Die langen Namen von Optionen werden als Schlüssel für Konfigurationsvariablen verwendet. Jede Einstellung, die
kann über die Befehlszeile eingestellt werden kann in einer Konfigurationsdatei eingestellt werden, in der [Konfiguration]
.

Zum Beispiel die Optionen in der folgenden Befehlszeile:

obnam --repository=/backup --exclude='.wav$' Backup

könnte durch die folgende Konfigurationsdatei ersetzt werden:

[Konfiguration]
Repository: /backup
ausschließen: .wav$

(Du kannst entweder verwenden foo=Wert or foo: Wert Syntax in den Dateien.)

Das einzig Ungewöhnliche an den Dateien ist die Art und Weise, wie die Optionen, die oft verwendet werden können, sind
ausgedrückt. Alle Werte werden in eine einzige logische Zeile geschrieben, getrennt durch Kommas (und
optional auch Leerzeichen). Zum Beispiel:

[Konfiguration]
ausschließen = foo, bar, \.mp3$

Das obige hat drei Werte für die ausschließen Option: alle Dateien, die die Wörter enthalten foo or
Bar irgendwo im vollqualifizierten Pfadnamen oder Dateien, deren Namen mit einem Punkt enden und
mp3 (weil die Ausschlüsse reguläre Ausdrücke sind).

Eine lange logische Zeile kann in mehrere physische aufgeteilt werden, indem eine neue Zeile bei beginnt
Leerraum und Einrücken der Fortsetzungszeilen:

[Konfiguration]
ausschließen = foo,
Bar,
\.mp3$

Das obige Beispiel fügt drei Ausschlussmuster hinzu.

Mehrere Kunden und Sperrung
obnam unterstützt die gemeinsame Nutzung eines Repositorys durch mehrere Clients. Die Kunden können das teilen
Dateiinhalt (Chunks), so dass, wenn Client A eine große Datei sichert und Client B die
dieselbe Datei, dann muss B die große Datei nicht ein zweites Mal in das Repository hochladen.
Damit dies ohne Verwirrung funktioniert, verwenden die Clients ein einfaches Sperrprotokoll, das es ermöglicht
jeweils nur ein Client, um die gemeinsam genutzten Datenstrukturen zu ändern. Schlösser verhindern nicht
gleichzeitiger schreibgeschützter Zugriff: Dies ermöglicht Ihnen die Wiederherstellung, während jemand anderes es ist
sichern.

Manchmal greift eine schreibgeschützte Operation gleichzeitig auf eine Datenstruktur zu
wird modifiziert. Dies kann zu einem Absturz führen. Es führt nicht zu beschädigten Daten, oder
falsche Wiederherstellungen. Möglicherweise müssen Sie den schreibgeschützten Vorgang jedoch neu starten, nachdem ein
Absturz.

OPTIONAL

--always-restore-setuid
setuid/setgid-Bits in wiederhergestellten Dateien wiederherstellen, auch wenn keine Root- oder gesicherte Datei
hatte einen anderen Besitzer als der Benutzer, der die Wiederherstellung ausführte

--no-always-restore-setuid
Gegenteil von --always-restore-setuid

--Kundenname=KUNDENNAME
Name des Clients (standardmäßig Hostname)

--komprimieren-mit=PROGRAMM
Verwenden Sie PROGRAM, um das Repository mit (einer von keiner, entleeren) zu komprimieren

--kritisches Alter=Alter
für nagios-last-backup-age: maximales Alter (standardmäßig in Stunden) für das neueste
Backup vor Statis ist kritisch. Akzeptiert einen Zeicheneinheitsbezeichner (s,m,h,d für
Sekunden, Minuten, Stunden und Tage.

--dump-repo-file-metadata
Dump-Metadaten über Dateien?

--no-dump-repo-file-metadata
Gegenteil von --dump-repo-file-metadata

--generate-manpage=TEMPLATE
UNTERDRÜCKENHILFE

--Generation=GENERATION
welche Generation soll wiederherstellen

-h, --help
Diese Hilfemeldung anzeigen und beenden

--halten=HALTEN
Richtlinien für Generationen, die beim Vergessen aufbewahrt werden sollen

--lock-timeout=TIMEOUT
Wenn Sie das Backup-Repository sperren, warten Sie TIMEOUT Sekunden, bis eine vorhandene Sperre
geh weg bevor du aufgibst

--Ausgabe=FILE
Ausgabe in DATEI schreiben, anstatt in die Standardausgabe

--vorgeben, --Probelauf, --no-act
eigentlich nichts ändern (funktioniert nur mit Backup, Vergessen und Wiederherstellen, und
darf nur annähernd reales Verhalten simulieren)

--kein-so tun, --kein Trockenlauf, --no-no-act
Gegenteil von --pretend

--ruhig, --Leise
sei still: zeige nur Fehlermeldungen, keine Fortschrittsaktualisierungen

--keine Ruhe, --no-silent
Gegenteil von --ruhig

-r, --Repository=URL
Name des Backup-Repositorys (kann Pfadname oder unterstützte URL sein)

--Repository-Format=FORMAT
Verwenden Sie FORMAT für neue Repositorys; einer von "6", "grün-albatros"

--zu=TO
wo wiederherstellen oder FUSE mounten; für Wiederherstellungen, muss leer sein oder darf nicht existieren

- ausführlich
sei ausführlich: erzähle dem Benutzer mehr von dem, was vor sich geht, und vergewissere dich im Allgemeinen, dass der Benutzer
ist sich bewusst was passiert oder zumindest dass etwas passiert und macht auch
Stellen Sie sicher, dass ihr Bildschirm häufig aktualisiert wird und dass Änderungen vorgenommen werden
die ganze Zeit, damit sie sich nicht langweilen und tatsächlich frustriert sind
von so vielen Updates abgelenkt, dass sie in die Wüste Gobi ziehen werden, um
lebe unter einem Felsen

--no-verbose
Gegenteil von --verbose

--überprüfen-zufällig=N
Überprüfen Sie zufällig N Dateien aus dem Backup (Standard ist Null, was alles bedeutet)

--Version
Versionsnummer des Programms anzeigen und beenden

--warn-Alter=Alter
für nagios-last-backup-age: maximales Alter (standardmäßig in Stunden) für das neueste
Backup, bevor der Status Warnung ist. Akzeptiert einen Zeicheneinheitsbezeichner (s,m,h,d für
Sekunden, Minuten, Stunden und Tage.

Backing up
--Kontrollpunkt=GRÖßE
Mache einen Kontrollpunkt nach einer bestimmten GRÖSSE

--deduplizieren=MODE
doppelte Daten in gesicherten Daten finden und nur einmal speichern; drei Modi sind
verfügbar: niemals deduplizieren, überprüfen, dass keine Hash-Kollisionen auftreten, oder (die
Ausfall) fatalistisch das Risiko von Kollisionen in Kauf nehmen

--ausschließen=AUSSCHLIESSEN
regulärer Ausdruck für Pfadnamen, die vom Backup ausgeschlossen werden sollen (kann mehrfach verwendet werden
mal)

--exclude-caches
Verzeichnisse (und deren Unterverzeichnisse) ausschließen, die eine CACHEDIR.TAG-Datei enthalten (siehe
http://www.brynosaurus.com/cachedir/spec.html für das, was es enthalten muss, und
http://liw.fi/cachedir/ für ein Hilfswerkzeug)

--no-exclude-caches
Gegenteil von --exclude-caches

--ausgeschlossen von=FILE
Ausschlussmuster aus DATEI lesen

--enthalten=eNTHALTEN
regulärer Ausdruck für Pfadnamen, die aus der Sicherung eingeschlossen werden sollen, auch wenn er mit einem übereinstimmt
Ausschlussregel (kann mehrfach verwendet werden)

--checkpoints verlassen
Checkpoint-Generationen am Ende eines erfolgreichen Backup-Laufs verlassen

--no-leave-checkpoints
Gegenteil von --leave-checkpoints

--ein-Dateisystem
Verzeichnisse (und deren Unterverzeichnisse) ausschließen, die sich in einem anderen Dateisystem befinden

--no-one-filesystem
Gegenteil von --one-file-system

--Wurzel=URL
was soll gesichert werden?

--kleine-dateien-in-btree
dies ist nur aus Gründen der Abwärtskompatibilität verfügbar; Verwenden Sie es nicht und entfernen Sie es
aus Ihrer Konfiguration

--no-small-files-in-btree
Gegenteil von --small-files-in-btree

Konfiguration Dateien und Einstellungen
--config=FILE
FILE zu Konfigurationsdateien hinzufügen

--dump-config
die gesamte aktuelle Konfiguration ausschreiben

--dump-setting-names
UNTERDRÜCKENHILFE

--Hilf allen
alle Optionen anzeigen

--list-config-files
UNTERDRÜCKENHILFE

--no-default-configs
Liste der zu lesenden Konfigurationsdateien löschen

Entwicklung of Obnam selbst
--crash-limit=COUNTER
das Programm künstlich zum Absturz bringen, nachdem COUNTER-Dateien in das Repository geschrieben wurden; Dies
ist nützlich für Crash-Tests der Anwendung und sollte nicht wirklich aktiviert werden
verwenden; zum Deaktivieren auf 0 setzen (standardmäßig deaktiviert)

--vortäuschen-Zeit=TIMESTAMP
so tun, als wäre es TIMESTAMP (JJJJ-MM-TT HH:MM:SS); das ist nur zum testen sinnvoll
Zwecke

--sftp-verzögerung=SFTP-VERZÖGERUNG
fügen Sie allen SFTP-Übertragungen eine künstliche Verzögerung (in Millisekunden) hinzu

--testing-fail-matching=REGEXP
Entwicklungstest-Helfer: Simulieren von Fehlern während des Backups für Dateien, die übereinstimmen
die angegebenen regulären Ausdrücke

--verfolgen=SPUR
zu Dateinamenmustern hinzufügen, für die die Protokollierung des Trace-Debuggings erfolgt

Verschlüsselung
--verschlüsseln-mit=VERSCHLÜSSELN-MIT
PGP-Schlüssel zum Verschlüsseln von Daten im Backup-Repository

--gnupghome=HOMEDIR
Home-Verzeichnis für GPG

--Schlüsseldetails
zusätzliche Benutzer-IDs für alle Schlüssel anzeigen

--no-key-details
Gegenteil von --key-details

--keyid=SCHLÜSSELID
PGP-Schlüssel-ID zum Hinzufügen/Entfernen zum Backup-Repository

--symmetrische-Schlüsselbits=BITS
Größe des symmetrischen Schlüssels in Bits

--schwach-zufällig
Verwenden Sie /dev/urandom anstelle von /dev/random, um symmetrische Schlüssel zu generieren

--no-weak-random
Gegenteil von --weak-random

Integrität Überprüfung (fsc)
--fsck-fix
sollte fsck versuchen, Probleme zu beheben? Impliziert --fsck-rm-unused

--no-fsck-fix
Gegenteil von --fsck-fix

--fsck-ignore-chunks
Ignorieren Sie Chunks, wenn Sie die Integrität des Repositorys überprüfen (angenommen, alle Chunks existieren und sind
Korrekt)

--no-fsck-ignore-chunks
Gegenteil von --fsck-ignore-chunks

--fsck-ignore-client=NAME/FUNKTION
Repository-Daten nicht auf cient NAME prüfen

--fsck-nur-letzte-Generation
nur die letzte Generation für jeden Client prüfen

--no-fsck-nur-letzte-generation
Gegenteil von --fsck-last-generation-only

--fsck-rm-unbenutzt
sollte fsck ungenutzte Chunks entfernen?

--no-fsck-rm-unused
Gegenteil von --fsck-rm-unused

--fsck-skip-checksums
Prüfsummen von Dateien nicht prüfen

--no-fsck-skip-checksums
Gegenteil von --fsck-skip-checksums

--fsck-skip-dirs
Überprüfe nichts über Verzeichnisse und deren Dateien

--no-fsck-skip-dirs
Gegenteil von --fsck-skip-dirs

--fsck-skip-files
Überprüfe nichts über Dateien

--no-fsck-skip-files
Gegenteil von --fsck-skip-files

--fsck-skip-generationen
überprüfen Sie keine Generationen

--no-fsck-skip-generations
Gegenteil von --fsck-skip-generations

--fsck-skip-per-client-b-trees
B-Bäume pro Client nicht überprüfen

--no-fsck-skip-per-client-b-trees
Gegenteil von --fsck-skip-per-client-b-trees

--fsck-skip-shared-b-trees
nicht freigegebene B-Bäume ankreuzen

--no-fsck-skip-shared-b-trees
Gegenteil von --fsck-skip-shared-b-trees

Protokollierung
--Protokoll=FILE
Log-Einträge in DATEI schreiben (Standard ist, überhaupt keine Log-Dateien zu schreiben); "syslog" verwenden
um in das Systemprotokoll zu protokollieren, "stderr" um die Standardfehlerausgabe zu loggen oder "none" um
Protokollierung deaktivieren

--log-keep=N
Bewahre die letzten N Protokolle auf (10)

-Log-Ebene=LEVEL
log auf LEVEL, entweder debug, info, warning, error, Critical, Fatal (Standard: info)

--log-max=GRÖßE
Rotieren von Protokollen, die größer als SIZE sind, null für nie (Standard: 0)

--log-modus=MODE
Berechtigungen für neue Protokolldateien auf MODE setzen (oktal; Standard 0600)

Montage mit FUSE
--fuse-opt=FUSE
Optionen, um direkt an Fuse zu übergeben

Leistung
--dump-memory-profile=METHODE
Erstellen Sie Speicher-Profiling-Dumps mit METHOD, die eine der folgenden sind: none, simple oder meliae
(Standard: einfach)

--memory-dump-interval=SECONDS
Machen Sie Speicher-Profiling-Dumps im Abstand von mindestens SEKUNDEN

Leistung Tweaking
--chunk-size=GRÖßE
Größe der gesicherten Dateidatenblöcke

--chunkids-pro-group=NUM
NUM Block-IDs pro Gruppe verschlüsseln

--idpath-bits=IDPATH-BITS
Größe der Chunk-ID-Ebene

--idpath-Tiefe=IDPATH-TIEFE
Tiefe der Chunk-ID-Zuordnung

--idpath-skip=IDPATH-SKIP
Chunk-ID-Mapping niedrigste Bits überspringen

--lru-Größe=GRÖßE
Größe des LRU-Cache für B-Baum-Knoten

--Knotengröße=GRÖßE
Größe der B-Baum-Knoten auf der Festplatte; betrifft nur neue B-Bäume, daher müssen Sie möglicherweise a . löschen
Client oder Repository, um dies für vorhandene Repositorys zu ändern

--Upload-Warteschlangengröße=GRÖßE
Länge der Upload-Warteschlange für B-Baum-Knoten

Dokumente Format grün-albatros
--chunk-bag-size=GRÖßE
ungefähre maximale Größe der Tasche, die viele große Gegenstände kombiniert

--chunk-cache-size=GRÖßE
Größe des In-Memory-Cache für Dateidaten-Chunk-Objekte

--dir-bag-size=GRÖßE
ungefähre maximale Größe von Taschen, die viele DIR-Objekte kombinieren

--dir-cache-größe=GRÖßE
Größe des In-Memory-Cache für DIR-Objekte

SSH / SFTP
--pure-paramiko
benutze nicht openssh, auch wenn es verfügbar ist, verwende stattdessen nur paramiko

--no-pure-paramiko
Gegenteil von --pure-paramiko

--ssh-Befehl=AUSFÜHRBAR
alternative ausführbare Datei anstelle von "ssh" (vollständiger Pfad ist erlaubt, nein
Argumente können hinzugefügt werden)

--ssh-host-keys-check=BEWERTUNG
Wenn "ja", muss der ssh-Hostschlüssel bekannt und korrekt sein, damit er akzeptiert wird.
Wenn "nein", ist dies nicht erforderlich. Bei "fragen" wird der Benutzer interaktiv aufgefordert, zu akzeptieren
neue Gastgeber. Der Standard ("ssh-config") ist auf die Einstellungen des Basiswerts angewiesen
SSH-Client

--ssh-key=DATEINAME
Verwenden Sie FILENAME als privaten ssh-RSA-Schlüssel für den sftp-Zugriff (standardmäßig werden Schlüssel verwendet
ssh-agent bekannt)

--ssh-bekannte-hosts=DATEINAME
Dateiname der bekannten Hosts-Datei des Benutzers

--strict-ssh-host-keys
VERALTET, verwenden Sie stattdessen --ssh-host-keys-check

--no-strict-ssh-host-keys
Gegenteil von --strict-ssh-host-keys

Option Werte
Das GRÖßE Wert in den oben genannten Optionen gibt eine Größe in Byte an, mit optional
Suffixe zur Angabe von Kilobyte (k), Kibibyte (Ki), Megabyte (M), Mebibyte (Mi),
Gigabyte (G), Gibibyte (Gi), Terabyte (T), Tibibyte (Ti). Die Suffixe sind Groß-/Kleinschreibung
unempfindlich.

EXIT STATUS

obnam wird mit Null beendet, wenn alles gut gelaufen ist, und anderenfalls ungleich Null.

obnam wird die Umgebung, die es von seinem Elternteil erhält, ohne Änderung weitergeben. Es tut
befolgt keine ungewöhnlichen Umgebungsvariablen, aber es befolgt die üblichen, wenn es ausgeführt wird
externe Programme, Erstellen von temporären Dateien usw.

Verwenden Sie obnam online mit den onworks.net-Diensten