dsnap-sync: update documentation to comply with v0.6.5
* english README.md * german README.md Signed-off-by: Ralf Zerres <ralf.zerres@networkx.de>
This commit is contained in:
Ralf Zerres
50
README.md
50
README.md
@@ -306,6 +306,34 @@ An open-source implementation can be found at
|
||||
|
||||
## Restore
|
||||
|
||||
### From Snapshot
|
||||
|
||||
When `dsnap-sync` did save the data using a native btrfs method
|
||||
(`btrfs-snapshot` or `btrfs-clone`), data will be stored in a snapper compatible
|
||||
directory structure on the target.
|
||||
|
||||
The structure may look like:
|
||||
|
||||
* └ backups
|
||||
* └ @\<server-name\>
|
||||
* └ \<subvol-name\>
|
||||
* └ \<subvol-id\>
|
||||
* ├ \.snapshot\>
|
||||
* └ info.xml
|
||||
|
||||
To restore the data, you may either use `snapper` methods or copy back
|
||||
the needed files using standard OS tools.
|
||||
|
||||
* using snapper
|
||||
You may use `snapper diff <id1>..<id2> [files]` to compare the differences
|
||||
between the given suvol-id's.
|
||||
You may use `snapper rollback <id> ` to restore all data from the given \<id\>
|
||||
|
||||
* using OS tools
|
||||
Use your favorit file-manager and change into the directory storing your
|
||||
target backup subvol-id. The snapshots are stored in **read-only** mode.
|
||||
Data are presented flat file and can be copied to any desired destination.
|
||||
|
||||
### From Tape
|
||||
|
||||
When `dsnap-sync` did save the data with method `btrfs-archive`, you will find
|
||||
@@ -313,22 +341,22 @@ the corresponding data in a snapper compatible directory structure on the tape.
|
||||
|
||||
The structure may look like:
|
||||
|
||||
> └── backups
|
||||
> └── @<server-name>
|
||||
> └── archive-<subvol-name>
|
||||
> └── <subvol-id>
|
||||
> ├── <subvol-id>_full.btrfs
|
||||
> └── info.xml
|
||||
* └ backups
|
||||
* └ @\<server-name\>
|
||||
* └ archive-\<subvol-name\>
|
||||
* └ \<subvol-id\>
|
||||
* ├ \<subvol-id\>_full.btrfs
|
||||
* └ info.xml
|
||||
|
||||
The file `info.xml` provide the metadata corresponding to the snapshot.
|
||||
The file `info.xml` provides the metadata corresponding to the snapshot.
|
||||
The data of the snapshot is stored in the file `<subvol-id>_full.btrfs`.
|
||||
This file has to be decrypted with btrfs tool `btrfs-send` to a btrfs
|
||||
restore directory:
|
||||
|
||||
cd /target_btrfs_path
|
||||
cp /path_to_tape_root/backups/@<server-name>/archive-<subvol-name>/<subvol-id>_full.btrfs .
|
||||
cat <subvol-id>_full.btrfs | btrfs receive -v .
|
||||
rm <subvol-id>_full.btrfs
|
||||
cd /target_btrfs_path
|
||||
cp /path_to_tape_root/backups/@<server-name>/archive-<subvol-name>/<subvol-id>_full.btrfs .
|
||||
cat <subvol-id>_full.btrfs | btrfs receive -v .
|
||||
rm <subvol-id>_full.btrfs
|
||||
|
||||
Please consult btrfs-send man-page for further info.
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
<!-- dsnap-sync README.md -->
|
||||
<!-- version: 0.5.9 -->
|
||||
<!-- version: 0.6.5 -->
|
||||
|
||||
# dsnap-sync
|
||||
|
||||
@@ -7,7 +7,6 @@
|
||||
<span>English</span> |
|
||||
<a href="../..">Englisch</a>
|
||||
<!-- a href="../spanish">Spanisch</a> | -->
|
||||
<a href="lang/german">Deutsch</a>
|
||||
</p>
|
||||
|
||||
## Über
|
||||
@@ -333,6 +332,66 @@ dann mit den gewohnten Betriebssystem Tools. Eine Open-Source Implementierung
|
||||
finden Sie z.B. unter
|
||||
[LinearTapeFileSystem](https://github.com/LinearTapeFileSystem/ltfs).
|
||||
|
||||
## Rücksicherung (restore)
|
||||
|
||||
### Dateisystem (target)
|
||||
|
||||
Wurden Daten mit einer nativen btrfs Methode (`btrfs-snapshot`,
|
||||
`btrfs-clone`) gesichert, befinden sie sich in einer `snapper` kompatiblen
|
||||
Verzeichnisstruktur auf dem gewählten Target.
|
||||
|
||||
Diese Struktur könnte so aussehen:
|
||||
|
||||
* └ backups
|
||||
* └ @\<server-name\>
|
||||
* └ \<subvol-name\>
|
||||
* └ \<subvol-id\>
|
||||
* ├ \.snapshot\>
|
||||
* └ info.xml
|
||||
|
||||
Um Daten zurückzusichern, können Sie entweder native `snapper` Methoden verwenden,
|
||||
oder auf Betriebssystem Programme zurückgreifen.
|
||||
|
||||
* native snapper Methoden
|
||||
|
||||
Verwenden Sie `snapper diff <id1>..<id2> [Dateien]`, um Unterschiede in den
|
||||
gewählten subvol-id's aufzuzeigen.
|
||||
Verwenden Sie `snapper rollback <id>`, um alle Daten der Sicherung (\<subvol-id\>)
|
||||
an den Ursprungsort zurückzusichern.
|
||||
|
||||
* Betriebssystem Programme
|
||||
|
||||
Verwenden Sie Ihren bevorzugten Datei-Manager und wechseln Sie in das
|
||||
Verzeichnis, in dem sich die Daten des gewünschten Backups (\<subvol-id\>)
|
||||
befinden. Die Daten wurden als **read-only** Snapshot gesichert.
|
||||
Sie können von hier aus in jedes gewünsche Zielverzeichnis kopiert werden.
|
||||
|
||||
### Band-Sicherung (tape)
|
||||
|
||||
Wurden Daten mit der Methode `btrfs-archive` gesichert, speichert `dsnap-sync`
|
||||
diese in einer `snapper` kompatiblen Datei-Struktur auf dem Band.
|
||||
|
||||
Dies Struktur könnte so aussehen:
|
||||
|
||||
* └ backups
|
||||
* └ @\<server-name\>
|
||||
* └ archive-\<subvol-name\>
|
||||
* └ \<subvol-id\>
|
||||
* ├ \<subvol-id\>_full.btrfs
|
||||
* └ info.xml
|
||||
|
||||
In der Datei `info.xml` werden die Metadaten zum Snapshot gespeichert.
|
||||
Die Bewegungsdaten des snapshots befinden sich in der Datei `\<subvol-id\>_full.btrfs`.
|
||||
Diese Datei muss mit dem btrfs programm `btrfs-send` auf ein btrfs Verzeichnis zurück
|
||||
geschrieben werden:
|
||||
|
||||
cd /target_btrfs_path
|
||||
cp /path_to_tape_root/backups/@<server-name>/archive-<subvol-name>/<subvol-id>_full.btrfs .
|
||||
cat <subvol-id>_full.btrfs | btrfs receive -v .
|
||||
rm <subvol-id>_full.btrfs
|
||||
|
||||
Die man-page zu `btrfs-send` enthält weiterführende Informationen.
|
||||
|
||||
## Mitarbeit
|
||||
|
||||
Hilfe ist sehr willkommen! Gerne könnt Ihr das Projekt forken und PR's einreichen,
|
||||
|
||||
Reference in New Issue
Block a user