This tutorial will be migrating to the full Obnam manual, at http://code.liw.fi/obnam/manual/. This version is no longer updated, see the link for the current version.
It is easiest to install Obnam on a Debian system. If you're running
wheezy or a later release, Obnam is included. For
add the following line to your
deb http://code.liw.fi/debian squeeze main
Then run the following commands as root:
apt-get install obnam
The commands will complain that the PGP key used to sign the archive is not known to apt. You can either ignore this, or add the key from http://code.liw.fi/apt.asc to your key.
For other systems, you need to install from sources. See the
file for instructions.
Obnam does not require a configuration file, and you can configure
everything using command line options. You can, however, use a
configuration file: save it as
make it have content like this:
[config] repository = sftp://your.server/home/youruser/backups/ log = /home/liw/obnam.log
The examples below assume you have created a configuration file, so that options do not need to be repeated every time.
You probably want to enable the
log setting, so that if there is
a problem, you can find out all the information available to fix it
from the log file.
Your first backup will be pretty big, and will take a long time. A long backup may crash, but that is not a problem: Obnam makes a checkpoint every one hundred megabytes or so.
obnam backup $HOME
When you've made your initial, full backup (possibly in stages), you can back up any changes simply by running Obnam again:
obnam backup $HOME
This will back up all new files, and any changed files. It will also record which files have been deleted since the previous backup.
You can run Obnam as often as you like. Only the changes from the previous run are backed up.
You can backup multiple clients to a single repository by providing the option --client-name= when running the program. Backup sets will be kept separate, but data deduplication will happen across all the sets.
Eventually your backup repository will grow so big you'll want to remove some old generations. The Obnam operation is called forget:
obnam forget --keep=30d
This would keep one backup from each of the last thirty calendar days, counting from the newest backup (not current time). If you've backed up several times during a day, only the latest generation from that day is kept.
Any data that is part of a generation that is to be kept will remain in the repository. Any data that exists only in those generations that is to be forgotten gets removed.
You will hopefully never need this, but the whole point of having backups is to restore data in case of a disaster.
obnam restore --to=/var/tmp/my-recovery $HOME
The above command will restore your entire home directory to
/var/tmp/my-recovery, from the latest backup generation.
If you only need some particular directory or file, you can
specify that instead:
obnam restore --to=/var/tmp/my-recover $HOME/Archive/receipts
If you can't remember the name of the file you need, use
obnam ls > /var/tmp/my-recovery.list
This will output the contents of the backup generation, in a format
ls -lAR. Save it into a file and browse that.
(It's a fairly slow command, so it's comfortable to save to a file.)
Obnam can use the GnuPG program to encrypt the backup. To enable this, you need to have or create a PGP key, and then configure Obnam to use it:
[config] encrypt-with = CAFEBABE
CAFEBABE is the key identifier for your key,
as reported by GnuPG. You need to have
gpg-agent or equivalent
software configured, for now, because Obnam has no way to ask for
or configure the passphrase.
After this, Obnam will automatically encrypt and decrypt data.
Note that if you encrypt your backups, you'll want to back up your GPG key in some other way. You can't restore any files from the obnam backup without it, so you can't rely on the same obnam backup to back up the GPG key itself. Back up your passphrase-encrypted GPG key somewhere else, and make sure you have a passphrase strong enough to stand up to offline brute-force attacks. Remember that if you lose access to your GPG key, your entire backup becomes useless.
If you enable encryption after making backups, you need to start over with a new repository. You can't mix encrypted and unencrypted backups in the same repository.
(There are a bunch of Obnam commands for administering encryption. You won't need them, unless you share the same repository with several machines. In that case, you should read the manual page.)
Best of luck.
See status for ways to get support, should you need anything.