X-Git-Url: https://git.stderr.nl/gitweb?p=matthijs%2Fupstream%2Fbackupninja.git;a=blobdiff_plain;f=README;h=04eda2f3210427f4c9132a35a82ad4adb1698db9;hp=9e2f2e6e0c6fa71077e4ccc6b6c8979a00ac536d;hb=2108cf46462afa167631a9377c7aed4d95f0c69f;hpb=773c194279bb6e1ca91de76b82fe94c6e2ff624a diff --git a/README b/README index 9e2f2e6..04eda2f 100644 --- a/README +++ b/README @@ -80,8 +80,9 @@ For example: 90-runthislast.rdiff Typically, you will put a '.rdiff' config file last, so that any -database dumps you make are included in the filesystem backup. -Configurations files which begin with 0 (zero) are skipped. +database dumps you make are included in the filesystem backup. +Configurations files with names beginning with 0 (zero) or ending with +.disabled (preferred method) are skipped. Unless otherwise specified, the config file format is "ini style." @@ -181,6 +182,16 @@ blank by hitting return. The included helper program "ninjahelper" will walk you through creating an rdiff-backup configuration, and will set up the ssh keys for you. + +Amazon Simple Storage Service (S3) +================================== + +Duplicity can store backups on Amazon S3 buckets, taking care of encryption. +Since it performs incremental backups it minimizes the number of request per +operation therefore reducing the costs. The boto Python interface to Amazon +Web Services is needed to use duplicity with S3 (Debian package: python-boto). + + INSTALLATION ============ @@ -205,6 +216,7 @@ Installation: # tar xvzf backupninja.tar.gz # cd backupninja # mv backupninja /usr/sbin/backupninja + # mv ninjahelper /usr/sbin/ninjahelper # mv etc/logrotate.d/backupninja /etc/logrotate.d/backupninja # mv etc/cron.d/backupninja /etc/cron.d/backupninja # mkdir /etc/backup.d/ @@ -216,17 +228,19 @@ VSERVERS ======== If you are using Linux-Vservers (http://linux-vserver.org/) there are some -special capabilities that different handlers have to make vserver backups easier. +special capabilities that different handlers have to make vserver +backups easier. + Set the variable "vservers" to be "yes" in /etc/backupninja.conf and see the example configuration files for each handler to configure the vserver specific variables. -Additional vserver variables that can be configured in /etc/backupninja.conf. but -probably don't need to be changed: +Additional vserver variables that can be configured in /etc/backupninja.conf, +but they probably don't need to be changed: VSERVERINFO (default: /usr/sbin/vserver-info) VSERVER (default: /usr/sbin/vserver) -VROOTDIR (default: `$VSERVERINFO info SYSINFO |grep vserver-Rootdir | awk '{print $2}'; fi`) +VROOTDIR (default: `$VSERVERINFO info SYSINFO |grep vserver-Rootdir | awk '{print $2}'`) NINJAHELPER =========== @@ -249,6 +263,11 @@ To add an additional 'wizard' to ninjahelper, follow these steps: ... do work here ... } -(3) check the examples of the included helpers to see how they are - written. The dialog functions are defined in easydialog.sh. +(3) look at the existing helpers to see how they are written. Try to re-use + functions, such as the dialog functions that are defined in easydialog.sh, + or the vserver functions defined in lib/vserver. +(4) test, re-test, and test again. Try to break the helper by going backwards, + try to think like someone who has no idea how to configure your handler + would think, try to make your helper as simple as possible. Walk like a cat, + become your shadow, don't let your senses betray you.