add Chris Nolan to Authors for the maildir directory fix, and add

[matthijs/upstream/backupninja.git] / README

diff --git a/README b/README
index 9e2f2e6e0c6fa71077e4ccc6b6c8979a00ac536d..04eda2f3210427f4c9132a35a82ad4adb1698db9 100644 (file)
--- 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.