|
|
| (26 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| {{DISPLAYTITLE:duply}}
| | '''duply''' - [[Inkrementell]]e [[verschlüsselt]]e [[Backup]]s |
| '''duply''' - Inkrementelle verschlüsselte Backups erstellen | |
|
| |
|
| == Beschreibung == | | == Beschreibung == |
| duply ist ein Shell-Frontend für duplicity, das die Verwendung vereinfacht, indem Einstellungen für jedes Backup in Profilen verwaltet werden. Es unterstützt die Ausführung von mehreren Befehlen als Stapelverarbeitung. Damit sind einzeilige cron-Einträge möglich und der Benutzer kann Skripte verwenden, die vor oder nach dem Backup ausgeführt werden. Alle duplicity-Backends werden unterstützt. Der frühere Name von duply war ftplicity.
| | ; Frontend für [[duplicity]] |
| | Shell-Frontend für [[duplicity]] |
| | * Verwendung vereinfachen |
| | * Einstellungen in Profilen verwalten |
| | * Stapelverarbeitung |
| | ** Es unterstützt die Ausführung von mehreren Befehlen als Stapelverarbeitung |
| | ** Damit sind einzeilige cron-Einträge möglich und der Benutzer kann Skripte verwenden, die vor oder nach dem Backup ausgeführt werden |
| | * Alle duplicity-Backends werden unterstützt |
|
| |
|
| ; Vereinfacht die Ausführung von Duplicity | | ; Vereinfacht die Ausführung von Duplicity |
| * Frontend für [[duplicity]]
| | Frontend für [[duplicity]] |
| * Backups können lokal oder einem anderen System gespeichert werden | | * Backups können lokal oder einem anderen System gespeichert werden |
| * Cron oder Kommandozeile | | * Cron oder Kommandozeile |
| Zeile 17: |
Zeile 23: |
|
| |
|
| Für jeden Sicherungsauftrag wird ein Konfigurationsprofil erstellt | | Für jeden Sicherungsauftrag wird ein Konfigurationsprofil erstellt |
| * Profilordner
| | |
| | | ; Profilordner |
| | <syntaxhighlight lang="bash" highlight="1" line copy> |
| | ~/.duply/<profile> |
| | </syntaxhighlight> |
|
| |
|
| ; Hinweis | | ; Hinweis |
| : Wenn der Ordner '/etc/duply' existiert, werden die Profile für den Superuser Benutzer root dort gesucht und erstellt werden. | | : Wenn der Ordner '/etc/duply' existiert, werden die Profile für den Superuser Benutzer root dort gesucht und erstellt werden |
|
| |
|
| ; Protokolle | | ; Protokolle |
| * ftp
| | {| class="wikitable options big" |
| * ssh
| | ! Protokoll !! Beschreibung |
| * s3
| |
| * rsync
| |
| * cifs
| |
| * webdav
| |
| * http
| |
| | |
| == Installation ==
| |
| # apt install duply
| |
| | |
| == Konfiguration ==
| |
| === Kryptografie ===
| |
| siehe [[GnuPG#Schl.C3.BCssel_erstellen|GnuPG:Schlüssel erstellen]]
| |
| | |
| === Profile ===
| |
| * Indicated by a path or a profile name (<profile>), which is resolved to '~/.duply/<profile>' (~ expands to environment variable $HOME).
| |
| * Superuser root can place profiles under '/etc/duply'. Simply create the folder manually before running duply as superuser.
| |
| | |
| ; Note
| |
| : Already existing profiles in root's home folder will cease to work unless they are moved to the new location manually.
| |
| | |
| ; Example 1
| |
| duply humbug backup
| |
| | |
| Alternatively a _path_ might be used e.g. useful for quick testing, restoring or exotic locations. Shell expansion should work as usual.
| |
| | |
| ; Hint
| |
| :The path must contain at least one path separator '/', e.g. './test' instead of only 'test'.
| |
| | |
| ; Example 2
| |
| : duply ~/.duply/humbug backup
| |
| | |
| ==== Profil erstellen ====
| |
| # duply <backupname> create
| |
| | |
| Ein duply-Profil wird im Home-Verzeichnis des Benutzers unter '''~/.duply/''' angelegt und besteht aus den folgenden Dateien:
| |
| * gpg-key.asc (nur wenn ein gpg-key exportiert wurde)
| |
| * conf
| |
| * pre und post
| |
| * exclude
| |
| | |
| === Konfiguration ===
| |
| ==== Kryptografie einrichten====
| |
| =====Voraussetzung=====
| |
| Key-ID und das Passwort des GnuPG-Keys müssen dafür hinterlegt werden
| |
| GnuPG_KEY='_GnuPG_KEY_ID_'
| |
| GnuPG_PW='_GnuPG_PASSWORD_'
| |
| | |
| =====Key-ID anzeigen lassen=====
| |
| ; Private-Key
| |
| # gpg --list-secret-keys --keyid-format LONG
| |
| gpg: "Trust-DB" wird überprüft
| |
| gpg: marginals needed: 3 completes needed: 1 trust model: pgp
| |
| gpg: Tiefe: 0 gültig: 1 signiert: 0 Vertrauen: 0-, 0q, 0n, 0m, 0f, 1u
| |
| gpg: nächste "Trust-DB"-Pflichtüberprüfung am 2021-11-04
| |
| /root/.gnupg/pubring.kbx
| |
| ------------------------
| |
| sec rsa4096/F47E1B7450082D11 2020-11-04 [SC] [verfällt: 2021-11-04]
| |
| 60E3D3C9ED78CE4A40322BBAF47E1B7450082D11
| |
| uid [ ultimativ ] Robert Quies (Es grünt so grün, wenn Spaniens Blüten blühn.) <raqju@web.de>
| |
| ssb rsa4096/B2E20485FF7FC772 2020-11-04 [E] [verfällt: 2021-11-04]
| |
| | |
| # gpg --list-keys --keyid-format LONG
| |
| /root/.gnupg/pubring.kbx
| |
| ------------------------
| |
| pub rsa4096/F47E1B7450082D11 2020-11-04 [SC] [verfällt: 2021-11-04]
| |
| 60E3D3C9ED78CE4A40322BBAF47E1B7450082D11
| |
| uid [ ultimativ ] Robert Quies (Es grünt so grün, wenn Spaniens Blüten blühn.) <raqju@web.de>
| |
| sub rsa4096/B2E20485FF7FC772 2020-11-04 [E] [verfällt: 2021-11-04]
| |
| | |
| ====Kompression und Kryptografie ====
| |
| ; GnuPG_OPTS
| |
| Optionen zur Kompression und Art der Kryptografie
| |
| * '''bzip2''' komprimiert
| |
| * '''A'''dvanced '''E'''ncryption '''S'''tandard, auch Rijndael-Algorithmus mit einer Schlüssellänge von '''256''' werden
| |
| | |
| GnuPG_OPTS='--compress-algo=bzip2 --personal-cipher-preferences AES256'
| |
| | |
| ==== Prüfen der GnuPG-Key und GnuPG-Passphrase ====
| |
| ; De-/Aktivieren der Überprüfung GnuPG-Key und GnuPG-Passphrase
| |
| * duply prüft vor jeder Aktion ob der GnuPG-Key gültig ist und die Passphrase korrekt ist.
| |
| * Dies kann durch die Option '''GnuPG_TEST='disabled'''' unterbunden werden.
| |
| | |
| ; Aktiviert
| |
| GnuPG_TEST='disabled'
| |
| | |
| ; Deaktiviert
| |
| # GnuPG_TEST='disabled'
| |
| | |
| ==== Ziel und Quelle des Backups ====
| |
| ; Allgemeine Syntax des hosts
| |
| scheme://[user:password@]host[:port]/[/]path
| |
| | |
| ; Protokolle und Syntax zur Datenübertragung
| |
| * duply versteht alle gängigen Protokolle zur Datenübertragung
| |
| * In der conf-Datei befindet sich meistens eine Liste der wichtigsten unterstützten Protokolle und deren Syntax
| |
| | |
| file://[/absolute_]path
| |
| ftp[s]://user[:password]@other.host[:port]/some_dir
| |
| hsi://user[:password]@other.host/some_dir
| |
| cf+<nowiki>https://container_name</nowiki>
| |
| imap[s]://user[:password]@host.com[/from_address_prefix]
| |
| rsync://user[:password]@other.host[:port]::/module/some_dir
| |
| rsync over ssh (only keyauth)
| |
| rsync://user@other.host[:port]/relative_path
| |
| rsync://user@other.host[:port]//absolute_path
| |
| for the s3 user/password are AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY
| |
| s3://[user:password]@host/bucket_name[/prefix]
| |
| s3+https://[user:password]@bucket_name[/prefix]
| |
| scp and sftp are aliases for the ssh backend
| |
| ssh://user<nowiki></nowiki></nowiki>[:password]@other.host[:port]/some_dir
| |
| tahoe://alias/directory
| |
| webdav[s]://user[:password]@other.host/some_dir
| |
| | |
| ; Hinweis
| |
| : Sonderzeichen müssen [https://de.wikipedia.org/wiki/URL-Encoding urlencoded] eingetragen werden, außer bei den Parametern '''TARGET_USER, TARGET_PASS'''
| |
| | |
| ; Ziel des Backups
| |
| TARGET='scheme://user[:password]@host[:port]/[/]path'
| |
| | |
| * Es soll das Protokoll '''ssh''' zur Datenübertragung genutzt werden.
| |
| * Username: '''user'''
| |
| * Passwort: '''KohlIstKrempe969'''
| |
| * Host: '''foxtom.net'''
| |
| * Port: '''22'''
| |
| * Pfad: '''home/user/backup_PC1'''
| |
| | |
| TARGET='<nowiki>ssh://user:KohlIstKrempe969@foxtom.net:22/home/user/backup_PC1</nowiki>'
| |
| | |
| ; Quelle des Backups
| |
| Root-Verzeichnis für das Backup setzen
| |
| SOURCE=
| |
| | |
| Soll ein Backup aus mehreren Unterordnern von '''/''' bestehen (Bsp.: /etc /var /home sollen gesichert werden), so muss die SOURCE Variable auf '''/''' gesetzt werden.''
| |
| SOURCE='/'
| |
| | |
| In der Regel wird SOURCE='/' gesetzt.
| |
| | |
| Dateien, die in die Sicherung aufgenommen oder von ihr ausgeschlossen werden, werden in der Datei [[Backup:duply#exclude|'''exclude''']] angegeben.
| |
| | |
| ==== Maximales Alter eines Backups ====
| |
| ; Hinweis
| |
| : ''duply'' löscht keine Backups, sofern man es nicht anfordert
| |
| | |
| Mit '''MAX_AGE''' wird das maximale Alter von Backups bestimmt.
| |
| Das älteste Backup soll maximal ein Jahr alt sein.
| |
| MAX_AGE=1Y
| |
| | |
| ====Anzahl der vollständigen Backups ====
| |
| Mit '''MAX_FULL_BACKUPS''' kann bestimmt werden, wie viele Full-Backups duply maximal behält.
| |
| | |
| Es sollen fünf sein.
| |
| MAX_FULL_BACKUPS=5
| |
| | |
| ==== Maximales Alter der vollständigen Backups ====
| |
| Alternativ kann mit '''MAX_FULLBKP_AGE''' spezifiert werden, wie alt ein Full-Backup sein darf, bevor ein neues Full-Backup erstellt wird.
| |
| | |
| Es soll zwei Wochen alt sein.
| |
| MAX_FULLBKP_AGE=2W
| |
| DUPL_PARAMS="$DUPL_PARAMS --full-if-older-than $MAX_FULLBKP_AGE"
| |
| | |
| ==== Größe der Backup-Pakete ====
| |
| Um den durch eventuelle Übertragungsfehler entstehenden Zeitverlust einzuschränken, teilt duply standardmäßig seine Backups in 25 MB große Dateien. Mit '''VOLSIZE''' kann die Größe der erstellten Backup-Pakete geändert werden.
| |
| | |
| Der gewünschte Wert hängt von verschieden Faktoren ab.
| |
| * Übertragungsgeschwindigkeit
| |
| * Systembelastung
| |
| * Netzwerkbelastung
| |
| | |
| Vor-/Nachteile
| |
| * Vorteil kleine Pakete
| |
| * Vorteil große Pakete
| |
| * Nachteil kleine Pakete
| |
| * Nachteil große Pakete
| |
| | |
| ;Beispiel
| |
| Backup-Pakete sollen 10 MB groß sein
| |
| VOLSIZE=10
| |
| DUPL_PARAMS="$DUPL_PARAMS --volsize $VOLSIZE"
| |
| | |
| ==== Asynchrone Uploads ====
| |
| Asynchrone Uploads erlauben das Erstellen neuer Archive, bevor bereits erstellte auf den Server geladen wurden.
| |
| * Schnelleres Backup
| |
| * Hohe System- und hohe Netzlast
| |
| | |
| Asynchrone Uploads aktivieren
| |
| DUPL_PARAMS="$DUPL_PARAMS --asynchronous-upload"
| |
| | |
| === Dateien ===
| |
| ; Profile folder
| |
| {| class="wikitable sortable options" | |
| |- | | |- |
| ! Option !! Beschreibung
| | | [[ftp]] || |
| |- | | |- |
| | /etc/duply || | | | [[ssh]] || |
| |- | | |- |
| | ~/.duply/<profile> || | | | [[s3]] || |
| |}
| |
| | |
| ; Profile files
| |
| {| class="wikitable sortable options"
| |
| |-
| |
| ! Option !! Beschreibung
| |
| |- | | |- |
| | conf || profile configuration file | | | [[rsync]] || |
| |- | | |- |
| | pre,post || pre/post scripts (see above for details) | | | [[cifs]] || |
| |- | | |- |
| | gpgkey.*.asc || exported GnuPG key files | | | [[webdav]] || |
| |- | | |- |
| | exclude ||a globbing list of included or excluded files/folders (see "duplicity manpage", section FILE SELECTION) | | | [[http]] || |
| |} | | |} |
|
| |
|
| == Anwendung == | | == Installation == |
| ; Erstmalige Verwendung (Profilerstellung)
| | <syntaxhighlight lang="bash" highlight="1" line copy> |
| duply <Profil> erstellen
| | sudo apt install duply |
| | </syntaxhighlight> |
|
| |
|
| ; Verwendung im Einzel- oder Batch-Modus
| | === Dateien === |
| duply <profile> <Befehl>[[_|+|-]<Befehl>[_|+|-]...] [<Optionen> ...]
| | ; /usr/bin/ |
| | | duply |
| ; Für Stapel können die bedingten Trennzeichen auch als Pseudo-Befehle geschrieben werden und(+), oder(-)
| |
| * siehe BEISPIELE
| |
| * siehe SEPARATORS
| |
| | |
| Nicht duply-Optionen werden an duplicity weitergegeben
| |
| * siehe OPTIONS
| |
| | |
| ; Alle conf-Parameter können stattdessen auch in der Umgebung definiert werden
| |
| | |
| ==== Anwendung ====
| |
| '''GnuPG_KEY='C676563899DE35FA''''
| |
| '''GnuPG_PW='NerzManta9''''
| |
| '''GnuPG_OPTS='--compress-algo=bzip2 --personal-cipher-preferences AES256''''
| |
| '''GnuPG_TEST='disabled''''
| |
| '''TARGET='<nowiki>ssh://user:KohlIstKrempe969@foxtom.net:22/home/user/backup_PC1</nowiki>''''
| |
| '''SOURCE='/''''
| |
| '''MAX_AGE=1Y'''
| |
| '''MAX_FULL_BACKUPS=5'''
| |
| '''MAX_FULLBKP_AGE=2W'''
| |
| '''DUPL_PARAMS="$DUPL_PARAMS --full-if-older-than $MAX_FULLBKP_AGE"'''
| |
| '''VOLSIZE=10'''
| |
| '''DUPL_PARAMS="$DUPL_PARAMS --volsize $VOLSIZE"'''
| |
| | |
| === Pre- und Post-Skripte ===
| |
| * Das pre-Skript wird direkt vor dem Backup ausgeführt, das post-Skript direkt nach dem Backup.
| |
| * Mit diesen Skripten können beispielsweise Snapshots von LVM-Volumes oder Dumps von SQL Datenbanken gemacht und in das Backup einbezogen werden.
| |
| * Die files <tt>pre</tt> und <tt>post</tt> müssen im jeweiligen duply Verzeichnis liegen (Bsp.: /home/user/.duply/backup/) und ausführbar sein.
| |
| * Werden die pre/post Scripte nicht wie erhofft ausgeführt (beispielsweise bei den Sicherchungs-Methoden "full/incr"), können diese explizit angegeben werden: <tt>pre_incr_post</tt>
| |
| | |
| ; Beispiel
| |
| Hier ein Beispiel für ein PRE/POST Skript welches vor dem Backup einen SQL-Dump aller Datenbanken erstellt und diesen nach dem Backup wieder löscht.
| |
| | |
| ; pre-Datei
| |
| /usr/bin/mysqldump --all-databases -u root -ppw > /tmp/sqldump-$(date '+%F')
| |
| | |
| ; post-Datei
| |
| /bin/rm /tmp/sqldump-$(date '+%F')
| |
| | |
| ; PRE/POST SCRIPTS
| |
| Useful internal duply variables are exported to the scripts
| |
| | |
| PROFILE, CONFDIR, SOURCE, TARGET_URL_<PROT|HOSTPATH|USER|PASS>,
| |
| GnuPG_<KEYS_ENC|KEY_SIGN|PW>, CMD_ERR, RUN_START,
| |
| CMD_<PREV|NEXT> (previous/next command),
| |
| CND_<PREV|NEXT> (condition before/after)
| |
| | |
| The CMD_* variables were introduced to allow different actions according to the command the scripts were attached to e.g. 'pre_bkp_post_pre_verify_post' will call the pre script two times, with CMD_NEXT variable set to 'bkp' on the first and to 'verify' on the second run. CMD_ERR holds the exit code of the CMD_PREV .
| |
| | |
| ===exclude===
| |
| * duply arbeitet standardmäßig mit einer Whitelist.
| |
| * Um gewisse Verzeichnisse oder Dateien von einem Backup zu inkludieren muss die Datei <tt>exclude</tt> im duply Verzeichnis erstellt werden.
| |
| * Die Syntax erlaubt das Hinzufügen von Verzeichnissen und Dateien mit einem <tt>+ /pfad/zur/datei</tt>.
| |
| * Um ein Verzeichnis zu exkludieren muss in der <tt>exclude</tt> ein <tt>- /pfad/zum/Verzeichnis</tt> eingefügt werden.
| |
| * Zudem erlaubt duply die Verwendung von Wildcards.
| |
| * Die hier dargestellte <tt>exclude</tt> Datei sichert die Verzeichnisse <tt>/etc/, /root/, /var/www/</tt> und exkludiert alle anderen Verzeichnisse.
| |
| + /etc/
| |
| + /root/
| |
| + /var/www/
| |
| - **
| |
| | |
| === Argumente ===
| |
| * duply bietet eine Vielzahl von Kommandozeilenparametern für die Sicherung und Wiederherstellung von Daten.
| |
| * Die gesamte Liste ist in der Manpage von duply zu finden.
| |
| * Beim Einsatz von mehreren Parameter werden diese durch einen Unterstrich ('''_''') getrennt.
| |
| * Mit <tt>/usr/bin/duply /root/.duply/test full_verify_purge --force</tt> wird ein volles Backup erstellt, verifiziert und alte Backups gelöscht.
| |
| * Backups welche die <tt>MAX_AGE</tt> überschritten haben werden mit <tt>purge</tt> angezeigt und durch die zusätzliche Option <tt>--force</tt> gelöscht.
| |
| * Der Befehl <tt>/usr/bin/duply /root/.duply/test incr</tt> führt ein inkrementelles Backup aus.
| |
| | |
| ===cronjob===
| |
| * Bei duply handelt es sich nicht um einen Dienst (Daemon), sondern um ein Skript, das beispielsweise regelmäßig via Cron ausgeführt werden kann.
| |
| | |
| ; Beispiel | |
| 0 0 * * 7 /usr/bin/duply /root/.duply/test full_verify_purge --force
| |
| 0 0 * * 1-6 /usr/bin/duply /root/.duply/test incr
| |
| | |
| * In dieser Konfiguration wird Sonntags um 0:00 ein Full-Backup erstellt und alte Backups gelöscht.
| |
| * Montag bis Samstag wird jeden Tag ein inkrementelles Backup durchgeführt.
| |
| * Neue cronjobs können mit '''crontab -e''' erstellt werden.
| |
| * Kommandos und Konfigurationsdateien müssen mit absolutem Pfad angegeben werden.
| |
| | |
| === Beispiele ===
| |
| ==== Profil erstellen ====
| |
| $ '''duply humbug create
| |
| don't forget to edit this new conf file
| |
| | |
| ==== backup 'humbug' now ====
| |
| $ '''duply humbug backup'''
| |
| | |
| ==== available backup sets ====
| |
| list available backup sets of profile 'humbug'
| |
| $ '''duply humbug status'''
| |
| | |
| ==== outdated backups ====
| |
| ; list and delete outdated backups of 'humbug'
| |
| | |
| $ '''duply humbug purge --force'''
| |
| | |
| ==== restore ====
| |
| ; restore latest backup of 'humbug' to /mnt/restore
| |
| $ '''duply humbug restore /mnt/restore'''
| |
| | |
| ; restore /etc/passwd of 'humbug' from 4 days ago to /root/pw
| |
| $ '''duply humbug fetch etc/passwd /root/pw 4D'''
| |
| $ '''(see "duplicity manpage", section TIME FORMATS)'''
| |
| | |
| ==== a one line batch job on 'humbug' for cron execution ====
| |
| $ '''duply humbug backup_verify_purge --force'''
| |
| | |
| ==== batch job to run a full backup with pre/post scripts ====
| |
| $ '''duply humbug pre_full_post''' | |
|
| |
|
| === Problembehebung ===
| | ; /usr/share |
| ==== Volume was signed by key ''X'' not ''Y'' ====
| | /doc/duply/ |
| ==== OSError: Socket is closed ====
| | README |
| ssh: Exception (client): Signature verification (ssh-rsa) failed.
| | README.Debian |
| ssh: Traceback (most recent call last):
| | TODO |
| ssh: File "/usr/local/lib/python3.10/dist-packages/paramiko/transport.py", line 2130, in run
| | changelog.Debian.gz |
| ssh: self.kex_engine.parse_next(ptype, m)
| | changelog.gz |
| ssh: File "/usr/local/lib/python3.10/dist-packages/paramiko/kex_curve25519.py", line 64, in parse_next
| | copyright |
| ssh: return self._parse_kexecdh_reply(m)
| | systemd-unit.examples |
| ssh: File "/usr/local/lib/python3.10/dist-packages/paramiko/kex_curve25519.py", line 130, in _parse_kexecdh_reply
| | HOWTO.txt |
| ssh: self.transport._verify_key(peer_host_key_bytes, sig)
| | systemd-unit.examples/system/ |
| ssh: File "/usr/local/lib/python3.10/dist-packages/paramiko/transport.py", line 1942, in _verify_key
| | duply-backup@.service |
| ssh: raise SSHException(
| | duply-backup@.timer |
| ssh: paramiko.ssh_exception.SSHException: Signature verification (ssh-rsa) failed.
| | duply-cleanup@.service |
| ssh:
| | duply-cleanup@.timer |
| Attempt of put Nr. 1 failed. OSError: Socket is closed
| | duply-verify@.service |
| | duply-verify@.timer |
| | notify-failed-backup@.service |
| | systemd-unit.examples/user/ |
| | duply-backup@.service |
| | duply-backup@.timer |
| | duply-cleanup@.service |
| | duply-cleanup@.timer |
| | duply-verify@.service |
| | duply-verify@.timer |
| | notify-failed-backup@.service |
| | man/man1/ |
| | duply.1.gz |
|
| |
|
| == Aufruf == | | == Aufruf == |
| === Argumente === | | === Argumente === |
| === Optionen === | | === Optionen === |
| {| class="wikitable sortable options" | | {| class="wikitable options" |
| |- | | |- |
| ! Option !! Beschreibung | | ! Option !! Beschreibung |
| Zeile 394: |
Zeile 110: |
| | usage || || get usage help text | | | usage || || get usage help text |
| |- | | |- |
| | and/or/groupIn/groupOut || || pseudo commands used in batches (see SEPARATORS above) | | | and/or/groupIn/groupOut || || pseudo commands used in batches (see SEPARATORS above) |
| |- | | |- |
| | create || || creates a configuration profile | | | create || || creates a configuration profile |
| Zeile 424: |
Zeile 140: |
| | purgeFull || [<max_full_backups>] [--force] || list outdated backup files ($MAX_FULL_BACKUPS being the number of full backups and associated incrementals to keep, counting in reverse chronological order) [use --force to actually delete these files] | | | purgeFull || [<max_full_backups>] [--force] || list outdated backup files ($MAX_FULL_BACKUPS being the number of full backups and associated incrementals to keep, counting in reverse chronological order) [use --force to actually delete these files] |
| |- | | |- |
| | purgeIncr || [<max_fulls_with_incrs>] [--force] || list outdated incremental backups ($MAX_FULLS_WITH_INCRS being the number of full backups which associated incrementals will be kept, counting in reverse chronological order) [use --force to actually delete these files] | | | purgeIncr || [<max_fulls_with_incrs>] [--force] || list outdated incremental backups ($MAX_FULLS_WITH_INCRS being the number of full backups which associated incrementals will be kept, counting in reverse chronological order) [use --force to actually delete these files] |
| |- | | |- |
| | purgeAuto || [--force] || convenience batch wrapper for all purge commands above. purge, purgeFull, purgeIncr are added if their conf vars were set. e.g. | | | purgeAuto || [--force] || convenience batch wrapper for all purge commands above |
| | * purge, purgeFull, purgeIncr are added if their conf vars were set |
| | * e.g |
| MAX_AGE=1Y | | MAX_AGE=1Y |
| MAX_FULL_BACKUPS=6 | | MAX_FULL_BACKUPS=6 |
| MAX_FULLS_WITH_INCR=3 | | MAX_FULLS_WITH_INCR=3 |
| in profile conf file would result in | | in profile conf file would result in |
| [purge_purgeFull_purgeIncr]
| | [purge_purgeFull_purgeIncr] |
| |- | | |- |
| | cleanup || [--force] || list broken backup chain files archives (e.g. after unfinished run) [use --force to actually delete these files] | | | cleanup || [--force] || list broken backup chain files archives (e.g |
| | * after unfinished run) [use --force to actually delete these files] |
| |- | | |- |
| | changelog || || print changelog / todo list | | | changelog || || print changelog / todo list |
| |- | | |- |
| | txt2man || || feature for package maintainers - create a manpage based on the usage output. download txt2man from https://mvertes.free.fr/, put it in the PATH and run 'duply txt2man' to create a man page. | | | txt2man || || feature for package maintainers - create a manpage based on the usage output |
| | * download txt2man from https://mvertes.free.fr/, put it in the PATH and run 'duply txt2man' to create a man page |
| |- | | |- |
| | version || || show version information of duply and needed programs | | | version || || show version information of duply and needed programs |
| Zeile 445: |
Zeile 165: |
| === Rückgabewert === | | === Rückgabewert === |
|
| |
|
| === SEPARATORS ===
| |
| {| class="wikitable sortable options"
| |
| |-
| |
| ! Option !! !! Beschreibung
| |
| |-
| |
| | _ || underscore || neutral separator
| |
| |-
| |
| | + || plus sign, _and_ conditional AND || the next command will only be executed if the previous succeeded
| |
| |-
| |
| | - || minus sign, _or_ conditional OR || the next command will only be executed if the previous failed
| |
| |-
| |
| | [ ] || square brackets, _groupIn_/_groupOut_ || enables grouping of commands
| |
| |}
| |
|
| |
| ; Beispiel
| |
| 'pre+[bkp-verify]_post'
| |
| translates to
| |
| 'pre_and_groupIn_bkp_or_verify_groupOut_post'
| |
|
| |
| === TIME FORMATS ===
| |
| For all time related parameters like age, max_age und weitere Refer to the duplicity manpage for all available formats.
| |
| ; Beispiele
| |
| {| class="wikitable sortable options"
| |
| |-
| |
| ! Option !! Beschreibung
| |
| |-
| |
| | 2002-01-25T07:00:00+02:00 || full date time format string
| |
| |-
| |
| | 2002/3/5 || date string YYYY/MM/DD
| |
| |-
| |
| | 12D || interval, 12 days ago
| |
| |-
| |
| | 1h78m || interval, 1 hour 78 minutes ago
| |
| |}
| |
|
| |
| == Sicherheit ==
| |
| ; Kopieren Sie den ''gesamten'' Profilordner nach der ersten Sicherung an einen sicheren Ort
| |
| * Er enthält alles, was für die Wiederherstellung Ihrer Backups benötigt wird (in doppelter Hinsicht).
| |
|
| |
| Achten Sie auf (möglicherweise später hinzugefügte) externe Dateien wie Credentials oder Auth-Dateien (beispielsweise netrc, .megarc, ssh-Schlüssel) oder Umgebungsvariablen (beispielsweise DPBX_ACCESS_TOKEN).
| |
|
| |
| Es ist ratsam, diese im Profilordner zu platzieren, wenn dies überhaupt möglich ist. beispielsweise im Falle eines 'multi://' Ziels sollte die config .json Datei Env vars zur conf Datei der Duply Profile hinzugefügt werden.
| |
|
| |
| Halten Sie den Zugriff auf diese Dateien beschränkt, da sie Informationen (gpg-Schlüssel, Passphrasen und weitere) für den Zugriff und die Änderung Ihrer Backups enthalten.
| |
|
| |
| ; Zusammenfassung
| |
| * Versuchen Sie eine Wiederherstellung von einem anderen Rechner aus, um sicherzustellen, dass Sie wirklich alles haben, was Sie für die Wiederherstellung benötigen.
| |
| * Wiederholen Sie diese Schritte nach _allen_ Konfigurationsänderungen. Einige Konfigurationsoptionen sind für die Wiederherstellung entscheidend.
| |
|
| |
|
| | <noinclude> |
|
| |
|
| <noinclude>
| |
| == Anhang == | | == Anhang == |
| === Siehe auch === | | === Siehe auch === |
| Zeile 515: |
Zeile 187: |
| # [https://duply.net/ duply.net] | | # [https://duply.net/ duply.net] |
|
| |
|
| [[Kategorie:Linux/Backup]] | | [[Kategorie:duply]] |
| | |
| | {{DISPLAYTITLE:duply}} |
| | |
| </noinclude> | | </noinclude> |
| | [[Kategorie:Linux/Befehl]] |