X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=bup.git;a=blobdiff_plain;f=README.md;h=e5d0f7315392d02b8e8545885fa39be3e8e24af2;hp=ad320dffa125f1b3be55d3e850fd844cb2bd84df;hb=e4ada8c5f7ba1b8273fa8edcda226fe526647e7b;hpb=1ac1aa05017832ee731461aa382d89d0847c582c diff --git a/README.md b/README.md index ad320df..e5d0f73 100644 --- a/README.md +++ b/README.md @@ -152,7 +152,7 @@ From source may fail. Running something like this before "make test" should sidestep the problem: - cd "$(/bin/pwd)" + cd "$(pwd -P)" - You can install bup via "make install", and override the default destination with DESTDIR and PREFIX. @@ -246,9 +246,19 @@ Using bup bup index /etc bup save -r SERVERNAME:path/to/remote-bup-dir -n local-etc /etc - - Restore a backup from a remote server. (FAIL: unfortunately, - unlike "bup join", "bup restore" does not yet support remote - restores. See both "bup join" and "Things that are stupid" below.) + - Make a remote backup to ~/.bup on SERVER: + + bup index /etc + bup save -r SERVER: -n local-etc /etc + + - See what saves are available in ~/.bup on SERVER: + + bup ls -r SERVER: + + - Restore the remote backup to ./dest: + + bup restore -r SERVER: -C ./dest local-etc/latest/etc + ls -l dest/etc - Defend your backups from death rays (OK fine, more likely from the occasional bad disk block). This writes parity information @@ -288,11 +298,12 @@ Using bup GIT_DIR=~/.bup git log local-etc - - Make a backup on a remote server: + - Save a tar archive to a remote server (without tar -z to facilitate + deduplication): tar -cvf - /etc | bup split -r SERVERNAME: -n local-etc -vv - - Try restoring the remote backup tarball: + - Restore the archive: bup join -r SERVERNAME: local-etc | tar -tf - @@ -430,16 +441,6 @@ Things that are stupid for now but which we'll fix later Help with any of these problems, or others, is very welcome. Join the mailing list (see below) if you'd like to help. - - 'bup restore' can't pull directly from a remote server. - - So in one sense "save -r" is a dead-end right now. Obviously you - can use "ssh SERVER bup restore -C ./dest..." to create a tree you - can transfer elsewhere via rsync/tar/whatever, but that's *lame*. - - Until we fix it, you may be able to mount the remote BUP_DIR via - sshfs and then restore "normally", though that hasn't been - officially tested. - - 'bup save' and 'bup restore' have immature metadata support. On the plus side, they actually do have support now, but it's new,