X-Git-Url: https://arthur.barton.de/gitweb/?a=blobdiff_plain;f=README.md;h=24a5e81ccf6f1693dc3098d8ac7366a04b323141;hb=cad619e5eaace4b576ed6c9dc21d76cdb6bfec13;hp=bd0cc97496eebe42e0da61637f8acd843af655fb;hpb=94d8b31274a8fd63653f4bba12998d1d567fde98;p=bup.git diff --git a/README.md b/README.md index bd0cc97..24a5e81 100644 --- a/README.md +++ b/README.md @@ -102,12 +102,13 @@ From source apt-get build-dep bup - Otherwise try this (substitute python2.5-dev if you have an older - system): + Otherwise try this (substitute python2.5-dev or python2.6-dev if + you have an older system): - apt-get install python2.6-dev python-fuse + apt-get install python2.7-dev python-fuse apt-get install python-pyxattr python-pylibacl apt-get install linux-libc-dev + apt-get install acl attr apt-get install python-tornado # optional On CentOS (for CentOS 6, at least), this should be sufficient (run @@ -136,8 +137,13 @@ From source make test - (The tests should pass. If they don't pass for you, stop here and send - an email to bup-list@googlegroups.com.) + The tests should pass. If they don't pass for you, stop here and + send an email to bup-list@googlegroups.com. Though if there are + symbolic links along the current working directory path, the tests + may fail. Running something like this before "make test" should + sidestep the problem: + + cd "$(/bin/pwd)" - You can install bup via "make install", and override the default destination with DESTDIR and PREFIX. @@ -148,6 +154,12 @@ From source make install DESTDIR=/opt/bup PREFIX='' + - The Python executable that bup will use is chosen by ./configure, + which will search for a reasonable version unless PYTHON is set in + the environment, in which case, bup will use that path. You can + see which Python executable was chosen by looking at the + configure output, or examining cmd/python-cmd.sh, and you can + change the selection by re-running ./configure. From binary packages -------------------- @@ -161,6 +173,10 @@ Binary packages of bup are known to be built for the following OSes: - pkgsrc (NetBSD, Dragonfly, and others) http://pkgsrc.se/sysutils/bup http://cvsweb.netbsd.org/bsdweb.cgi/pkgsrc/sysutils/bup/ + - Arch Linux: + https://www.archlinux.org/packages/?sort=&q=bup + - Fedora: + https://apps.fedoraproject.org/packages/bup Using bup @@ -212,14 +228,14 @@ Using bup bup restore -C ./dest-2 local-etc/2013-11-23-11195/etc - - Make a backup on a remote server (which must already have the 'bup' command - somewhere in the server's PATH (see /etc/profile, etc/environment, - ~/.profile, or ~/.bashrc), and be accessible via ssh. - Make sure to replace SERVERNAME with the actual hostname of your server): + - Make a backup to a remote server which must already have the 'bup' command + somewhere in its PATH (see /etc/profile, etc/environment, ~/.profile, or + ~/.bashrc), and be accessible via ssh. + Make sure to replace SERVERNAME with the actual hostname of your server: - ssh SERVERNAME bup init + bup init -r SERVERNAME:path/to/remote-bup-dir bup index /etc - bup save -r SERVERNAME: -n local-etc /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 @@ -352,8 +368,8 @@ python. Basically, 'bup split' reads the data on stdin (or from files specified on the command line), breaks it into chunks using a rolling checksum (similar to -rsync), and saves those chunks into a new git packfile. There is one git -packfile per backup. +rsync), and saves those chunks into a new git packfile. There is at least one +git packfile per backup. When deciding whether to write a particular chunk into the new packfile, bup first checks all the other packfiles that exist to see if they already have that