X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=README;h=13c89bf05e6bf62b7afefdc58ef6f1ede49f0145;hb=91f3eb464817461dea895b180f7f79d67289ff21;hp=7830fe266747278e65d2e861eb046c904e0c8b88;hpb=cc8aa6a27a68a8d8df9c29a937ac435883abfc8f;p=matthijs%2Fupstream%2Fbackupninja.git diff --git a/README b/README index 7830fe2..13c89bf 100644 --- a/README +++ b/README @@ -13,27 +13,38 @@ coordinate many different backup utilities. Features: - easy to read ini style configuration files. - - secure, remote, incremental filesytem backup (via rdiff-backup). - incremental data is compressed. permissions are retained even - with an unpriviledged backup user. - - backup of mysql databases (via mysqlhotcopy and mysqldump). - - backup of ldap databases (via slapcat and ldapsearch). - - passwords are never sent via the command line to helper programs. - you can drop in scripts to handle new types of backups. - backup actions can be scheduled - you can choose when status report emails are mailed to you (always, on warning, on error, never). + - console-based wizard (ninjahelper) makes it easy to create + backup action configuration files. + - passwords are never sent via the command line to helper programs. + - works with Linux-Vservers (http://linux-vserver.org/) +Backup types: + - secure, remote, incremental filesytem backup (via rdiff-backup). + incremental data is compressed. permissions are retained even + with an unpriviledged backup user. + - backup of mysql databases (via mysqlhotcopy and mysqldump). + - backup of ldap databases (via slapcat and ldapsearch). + - basic system and hardware info + - encrypted remote backups (via duplicity). + - backup of subversion repositories. + The following options are available: -h, --help This usage message -d, --debug Run in debug mode, where all log messages are output to the current shell. -f, --conffile FILE Use FILE for the main configuration instead of /etc/backupninja.conf --t, --test Run in test mode, no actions are actually taken. --n, --now Perform actions now, instead of when they - might be scheduled. - +-t, --test Test run mode. This will test if the backup could run, without actually + preforming any backups. For example, it will attempt to authenticate + or test that ssh keys are set correctly. +-n, --now Perform actions now, instead of when they might be scheduled. + No output will be created unless also run with -d. +--run FILE Runs the specified action FILE (e.g. one of the /etc/backup.d/ files). + Also puts backupninja in debug mode. CONFIGURATION FILES =================== @@ -49,9 +60,11 @@ file in /etc/backup.d according to the file's suffix: .sh -- run this file as a shell script. .rdiff -- this is a configuration for rdiff-backup .maildir -- this is a configuration to backup maildirs + .dup -- this is a configuration for duplicity .mysql -- mysql backup configuration .ldap -- ldap backup configuration .sys -- general system reports + .svn -- subversion repository backups Support for additional configuration types can be added by dropping bash scripts with the name of the suffix into /usr/share/backupninja. @@ -169,10 +182,7 @@ Requirements: apt-get install bash gawk Recommended: - apt-get install rdiff-backup gzip - -Suggested: - apt-get install sfdisk discover + apt-get install rdiff-backup gzip hwinfo Files: /usr/sbin/backupninja -- main script @@ -194,3 +204,21 @@ Installation: # mkdir /etc/backup.d/ # mv etc/backupninja.conf /etc/backupninja.conf # mv handlers /usr/share/backupninja + + +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. +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: + +VSERVERINFO (default: /usr/sbin/vserver-info) +VSERVER (default: /usr/sbin/vserver) +VROOTDIR (default: `$VSERVERINFO info SYSINFO |grep vserver-Rootdir | awk '{print $2}'; fi`) +