aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMicah Anderson <micah@riseup.net>2007-11-24 22:20:46 +0000
committerMicah Anderson <micah@riseup.net>2007-11-24 22:20:46 +0000
commit929a6bda9ab797ef04d46c559ed068e03dacf330 (patch)
treed876715e6ee81c62634454ab8dd0cba43d3ff1fe
parentf11befa73ab463cf0994d173438d65c5ab320545 (diff)
downloadbackupninja-929a6bda9ab797ef04d46c559ed068e03dacf330.tar.gz
backupninja-929a6bda9ab797ef04d46c559ed068e03dacf330.tar.bz2
actually include the example file
-rw-r--r--examples/Makefile.am2
-rw-r--r--examples/example.maildir53
2 files changed, 54 insertions, 1 deletions
diff --git a/examples/Makefile.am b/examples/Makefile.am
index 8669e86..a2ffbb2 100644
--- a/examples/Makefile.am
+++ b/examples/Makefile.am
@@ -1,7 +1,7 @@
EXAMPLES = example.dup example.ldap example.makecd example.mysql \
example.pgsql example.rdiff example.sh example.rsync \
- example.svn example.sys example.trac
+ example.svn example.sys example.trac example.maildir
EXTRA_DIST = $(EXAMPLES)
diff --git a/examples/example.maildir b/examples/example.maildir
new file mode 100644
index 0000000..d837cac
--- /dev/null
+++ b/examples/example.maildir
@@ -0,0 +1,53 @@
+##
+## This is an example maildir configuration file.
+##
+## The maildir handler slowly creates a backup of each user's
+## maildir to a remote server. It is designed to be run with
+## low overhead in terms of CPU and bandwidth, so it runs pretty
+## slow. Hardlinking is used to save storage space. The actual
+## maildir is stored within each snapshot directory.
+##
+## The basic algorithm is to rsync each maildir individually,
+## and to use hard links for retaining historical data.
+##
+## We handle each maildir individually because it becomes very
+## unweldy to hardlink and rsync many hundreds of thousands
+## of files at once. It is much faster to take on smaller
+## chunks at a time.
+##
+## Any maildir which is deleted from the source will be moved to
+## "deleted" directory in the destination. It is up to you to
+## periodically remove this directory or old maildirs in it.
+## The defaults are useful in most cases, just make sure
+## to configure the source and destination information
+
+when = everyday at 21:00
+
+## each users maildir will contain these files:
+## daily.1, daily.2, daily.3, daily.4, daily.5, weekly.1, weekly.2,
+## weekly.3, monthly.1
+## if keepdaily is 5, keepweekly is 3, and keepmonthly is 1
+keepdaily = 5
+keepweekly = 3
+keepmonthly = 1
+
+# directory which contains all the maildirs
+# this directory is expected to have subdirectories lettered a-z and
+# in each letter subdirectory are the users Maildirs which start with
+# those letters
+srcdir = /maildir/riseup.net
+
+# put the backups under this directory
+destdir = /crypta/maildir/riseup.net
+desthost = kakapo-pn
+
+# For the backup rotation to work, destuser must be able to run
+# arbitrary bash commands on the desthost.
+destuser = backer
+
+# remove any maildirs from backup which might have been deleted
+remove = yes
+
+# use a ssh-mux to reuse connections, see the following article
+# http://www.debian-administration.org/articles/290 for an example
+multiconnection = notset