Ausgewählte (wichtige) Paramter für die Subcomands =¶

Diese Liste hier ist nicht umfassend, bietet aber einen kurzen Überblick über alle Funktionen.

Parameter für das automatische Löschen von Snapshots¶

Ein Beispiel direkt aus der englischen Doku: Bei täglichen Backups über 100 Jahre würde der Befehl:

restic -r /PFAD/ZUM/BACKUP forget --keep-daily 7 --keep-weekly 5 --keep-monthly 12 --keep-yearly 75 --prune 

Die letzten sieben Backups, dann die vier Wochen davor (die erste Woche ist bereits durch den Tag bestimmt), dann 11 oder 12 am letzten Tag des Monates (in Abhängigkeit der Ausführungsdatums), und daraufhin noch 75 Jahre einen pro Jahr. Der Rest würde gelöscht werden.

Repository erstellen¶

Durch den Befehl init wird im angegebenen Backupordnerpfad ein neues Repository erstellt und ein Passwort zur Eingabe abgefragt.

1. Local:

   restic init -r /PFAD/ZUM/BACKUPORDNER 

2. SFTP

   restic -r sftp:user@host:/PFAD/ZUM/BACKUPORDNER init 

3. rclone

   restic -r rclone:REMOTE-NAME:/PFAD/AUF/REMOTE/BACKUPORDNER init 

4. Weitere ausführliche Beispiele können unter https://restic.readthedocs.io/en/latest/030_preparing_a_new_repo.html 🇬🇧 abgerufen werden. (Z.B. für Amazon S3, Rest-Server, Backblaze B2 usw. )

Backup erstellen¶

Ein Backup kann ganz einfach mithilfe des folgenden Befehls erstellt werden:

restic -r /PFAD/ZUM/BACKUPORDNER backup /home /root 

Hierbei ist anzumerken, dass /home und /root die zu speichernden Ornder sind. Es lassen sich viel mehr hinzufügen.

Mit einem zusätzlichen --verbose sieht man mehr Details beim Backup erstellen.

Beim erstmaligen Ausführen von backup erfolgt eine Meldung, weil noch kein Snapshot vorhanden ist mit welchem die Daten verglichen werden könnten.

Es können auch durch das Anhängen von den Parametern --files-from /PFAD/ZUR/DATEI/include.txt (Achtung --files-from OHNE = ) oder --exclude-file=/PFAD/ZUR/DATEI/exclude.txt spezifischere Angaben gemacht werden, was oder was nicht gesichert werden soll. Eine gute Übersicht findet sich auch hier bei https://restic.readthedocs.io/en/latest/040_backup.html 🇬🇧.

Das ganze sieht dann zum Beispiel für ein eingerichtetes rclone so aus (die Textdateien können natürlich auch anders heißen):

restic -r rclone:BackupWebdav:ORDNERNAME backup --verbose --files-from /PFAD/ZUR/DATEI/include.txt --exclude-file=/PFAD/ZUR/DATEI/exclude.txt 

Der Inhalt einer exclude.txt könnte wie folgt aussehen, absolute Pfade verwenden:

1
2
3
4
5
6

#ignoriert hier alle ISO-Dateien
*.iso
#ignoriert das Verzeichnis Videos, samt Unterverzeichnisse
home/user/Videos/
#ignoriert das Verzeichnis Trash
home/user/.local/share/Trash/

Snapshots/Sicherungen anzeigen¶

Die vorhandenen Backups bzw. Snapshots können so aufgelistet werden:

restic -r /PFAD/ZUM/BACKUPORDNER snapshots 

Hier werden die vorhandenen Backups/Snapshosts aufgelistet, die angegebene IDs können dann z.B. zur Wiederherstellung oder zur Überprüfung verwendet werden.

Ein Ausgabebeispiel dazu:

enter password for repository: 
repository 0e566285 opened successfully, password is correct
ID        Time                 Host          Tags        Paths
------------------------------------------------------------------------------
88a5b52c  2020-12-22 15:14:51  test                      /home/test/.config
                                                         /home/test/.putty
                                                         /home/test/.vnc
                                                         /home/test/Dokumente

8f27e3ab  2020-12-23 14:08:35  test                      /home/test/.config
                                                         /home/test/.putty
                                                         /home/test/.vnc
                                                         /home/test/Dokumente
                                                       
 
------------------------------------------------------------------------------
2 snapshots

Backup einspielen¶

Mit dem folgenden Befehl wird ein Snapshot mit der ID 8f27e3ab nach /old/ zurückgespielt:

restic -r /PFAD/ZUM/BACKUPORDNER restore 8f27e3ab --target /old 

Mounten eines Backups¶

Mit dem Folgenden Befehl wird ein Backup gemounted wie ein USB-Stick. Allerdings ohne Schreibrechte, es können nur Daten gelesen oder kopiert, aber nicht verändert werden. Es ist so möglich, sich durch alle vorhandenen Snapshots zu bewegen.

mkdir /mnt/backup
restic -r /PFAD/ZUM/BACKUPORDNER mount /mnt/backup 

Weitere nützliche Beispiele¶

1. Snapshots vergleichen:

   restic -r /PFAD/ZUM/BACKUP/ORDNER diff SNAPSHOTID1 SNAPSHOTID2 

2. Alle Snapshots anschauen, welche /home auf dem Host melcoox beinhalten:

   restic -r /PFAD/ZUM/BACKUP snaphosts --path=`/home` --host melcoox 

3. Index prüfen:

   restic -r /PFAD/ZUM/BACKUP check 

4. Index und Inhalt prüfen (Wer --read-data durch --read-data-subset=X/Y austauscht prüft den X-ten Teil von Y teilen. (Wobei gilt: X<=Y)

   restic -r /PFAD/ZUM/BACKUP check --read-data 

5. Snapshot vergessen und Daten löschen:

   restic -r /PFAD/ZUM/BACKUP forget 564684b --prune 

6. Schlüssel Optionen (list = anzeigen, add = Hinzufügen, remove = Entfernen, passwd = Password ändern) :

   restic -r /PFAD/ZUM/BACKUP key list