ChangeLog

   1 version 0.9.7 -- UNRELEASED
   2     backupninja changes
   3          . fix bug in reportspace, thanks Dan Garthwaite
   4
   5 version 0.9.6 -- July 21, 2008
   6     backupninja changes
   7          . fix bug in cstream definition, thanks Jamie McClelland
   8          . Allow the entire backup run to be halted by an action, thanks to
   9            Matthew Palmer (Closes: #455836)
  10          . Fixed tr construct reporting a warning (Closes: #452669)
  11     lib changes
  12         vserver:
  13          . added vservers_running function
  14         tools
  15          . mktemp is now required to run backupninja, removed less secure
  16            fall-back if mktemp did not exist on the system
  17     handler changes
  18         dup:
  19          . General cleanup
  20          . Better support for new duplicity (>= 0.4.4) command line syntax:
  21            run remove-older-than when $keep is not set to yes (Closes: #458816),
  22            and run "duplicity cleanup" before any other duplicity command; both
  23            only trigger a warning on failure, since they should not stop backups
  24            from being done. Also migrated full/incremental backup switch to the
  25            new syntax.
  26          . Support every duplicity-supported transport with new configuration
  27            option desturl (Closes: #483712, #346040, Trac#2).
  28          . Actually allow to backup only VServers, by relaxing $include test.
  29          . Set secure permissions on tmpdir when creating it.
  30         ldap:
  31          . support HDB backend just as the BDB one, and make message clearer
  32            when no supported backend is found (Closes: #476910)
  33         rdiff:
  34          . Fixed ignore_version default value missing
  35          . Add patch from Matthew Palmer to rdiff handler to incorporate sshoptions
  36            into options via remote-schema not already specified (Closes: #424639)
  37         wget:
  38          . New handler from rhatto designed to incrementally pull content from
  39            a website to a local folder, based on the rsync handler
  40         maildir:
  41          . fixed bug where maildirs that start with a number were skipped
  42          . make maildir helper look in every subdirectory of the source directory for
  43            maildirs, rather than just looking in the directories [a-zA-Z0-9], thanks
  44            for the patch from chris@cenolan.com (Trac#43).
  45          . make deleted maildirs record the date they were deleted
  46          . add destid_file configuration option to enable you to specify an alternate
  47            ssh public key authentication file (defaulting to /root/.ssh/id_rsa)
  48         pgsql, mysql, svn, sys:
  49          . use new vservers_running function from lib/vserver (factorization++)
  50         sys:
  51          . update for 2.6 kernels: use /proc/kallsyms instead of /proc/ksyms
  52            (Closes: Trac#39)
  53          . support selection of VServers to run on, in the same way as in the
  54            dup handler, with the new vsnames configuration option ; (Closes: Trac#45)
  55          . add support for capturing the package debconf selection states using
  56            debconf-get-selections
  57          . fixed catifexec function to actually work, also now passes the arguments
  58            given to catifexec() to the called command (Thanks John Hallam!)
  59          . Added more robust software RAID information capture by running mdadm
  60            -Q --detail /dev/md?* because some people may have empty mdadm.conf files
  61            (Thanks to John Hallam).
  62         trac:
  63          . stop failing on all the trac backups if just one fails, this means
  64            removing the temporary trac backup directories if they fail
  65         makecd
  66          . updated handler for new toolset (genisoimage and wodim)
  67
  68 version 0.9.5 -- December 2, 2007
  69     backupninja changes
  70          . Fixed checks on configuration files permissions, since the patch
  71            applied to fix #370396 broke this, especially for configuration files
  72            created with permissions 000 by an older ninjahelper version.
  73          . Enhanced portability for other platforms
  74          . Added quoting because it was needed to prevent shell expansion, broking the
  75            toint function sometimes (Closes: Trac#11)
  76          . Fixed reportspace option (Closes: Trac#10)
  77          . Fixed ldap handler not recognizing database suffix (Closes: Trac#28)
  78     handler changes
  79         dup:
  80          . Support duplicity >= 0.4.3 invocation syntax (--ssh-command option
  81            is not supported anymore) (Closes: #447425)
  82          . New tmpdir configuration option, very useful in case duplicity tends
  83            to fill up /tmp.
  84         ldap:
  85          . Fixed shell command quoting issues, missing 'then' clauses, cleaned up
  86            compress=yes to be less redundant and not create empty uncompressed
  87            file (Closes: #394935)
  88          . Fixed ninjahelper to properly set compress option, standardized on yes/no
  89            instead of on/off
  90          . Fixed problem that caused combination of slapcat and compress to not work
  91            together (Closes: Trac#29)
  92          . Applied patch from romain.tartiere@healthgrid.org to fix the SSL/TLS options
  93            to be correct, also set TLS to be the default over SSL (Closes: Trac#13)
  94         maildir:
  95          . Added an examples file (Closes: Trac#23)
  96          . Applied patch from Anarcat that fixes the cp/mkdir calls to not use GNU
  97            coreutils options, as well as some bashisms (Closes: Trac#24)
  98          . Fix test mode (Closes: Trac#25)
  99         mysql:
 100          . Fixed case where odd combination of configuration options caused sqldump
 101            backups to get overwritten with an empty file (Closes: #402679)
 102          . Added 'nodata' option to enable you to specify tables that you want to omit
 103            the data from a backup, but still backup the table structure. This is very
 104            useful in cases where tables contain large amounts of cache data. See the
 105            example.mysql for options, thanks Daniel Bonniot (Closes: #408829)
 106          . Enhance code for selecting databases by asking MySQL not to give us the
 107            header (-N), to not draw pretty boxes around the output (-B), send the query
 108            via -e instead of a pipe and ensure MySQL listens to -B. Thanks to
 109            Matthew Palmer (Closes: #452039).
 110         pgsql:
 111          . Support configuring PGSQLUSER for real, and document it a bit; this
 112            broken support actually prevented pgsql handler to work for VServers
 113            (Closes: #396578)
 114         rdiff-backup:
 115          . Added cstream support to allow for bandwidth limiting
 116          . Handle "keep = yes" to disable old backups removal (Closes: #424633)
 117          . Add configuration option to allow you to disable the version check
 118            as in some instances this may be an ok scenario (Closes: #424632)
 119          . Added local destination support to helper (Closes: Trac#4)
 120          . Allow exclude-only configurations (Closes: Trac#21)
 121         rub/rsync
 122          . Fixed typo in rub handler that caused it to not work
 123          . Changed to use lib/vserver code
 124          . Fixed fsck error
 125          . Fixed integer comparison (Closes: Trac#3)
 126          . Renamed handler to 'rsync', replaces outdated rub handler
 127          . updated examples/Makefile.am and handlers/Makefile.am to include
 128            rsnap/rsync (Closes: #440554)
 129          . Added example.rsync configuration file
 130         sys:
 131          . Fixed typo breaking things for VServers.
 132          . Fix bug when vrootdir is on its own partition (Closes: #395928)
 133          . Better sfdisk error and output handling: should now properly warn
 134            when it does not manage to backup a partition table, and shut up when
 135            it succeeds (Closes: #396632)
 136          . Added option to not use sfdisk at all, useful for vserver/xen instances
 137            that produce warnings about no harddisks found (Closes: #404071)
 138          . Fixed example in example.sys to detail the __star__ in partitionsfile and
 139            note why its necessary (Closes: #409192)
 140          . Force C locale for sfdisk to ensure english words are found in grep
 141          . Make directory where output is placed configurable, and create the parent dir
 142            if it doesn't exist (Closes: Trac#1)
 143     ninjareport
 144          . Added first draft of method to aggregate reports from many servers into
 145            one email. Requires logtail, rsync, configuration of reporthost,
 146            reportdirectory and reportuser in backupninja.conf. Configure cron to
 147            run once a day, and individual backupninjas not to report by email their
 148            status, then enjoy one email report from all hosts, rather than multiple
 149     fixed 'make install' bug that failed if /etc/backup.d already existed
 150     changed spaces to tabs in Makefile.am
 151     updated redhat spec file (thanks Adam Monsen)
 152
 153 version 0.9.4 -- October 6th, 2006
 154     backupninja changes
 155          . Fixed bug in toint(), and thus isnow(), which caused it
 156            to not work when run from cron.
 157          . Recursively ignore subdirs in /etc/backup.d (Closes: #361102)
 158          . Add admingroup option to configuration to allow a group that can
 159            read/write configurations (instead of only allowing root). Checks
 160            and complains about group-readable files only when the group differs
 161            from the one in the configuration file (default is root as before).
 162            Thanks to Martin Krafft for the patch (Closes: #370396).
 163          . When determining which backup actions to make, find now follows
 164            symlinks for $configdirectory
 165          . Changed order of -s to mail for compatibility
 166          . fixed permission stat call so it uses the --format supported by
 167            coreutils (Closes: #382747)
 168          . Added disk space report option (thanks Adam Kosmin)
 169     handler changes
 170         Added tar handler:
 171          . create tarballs
 172         Added rsnap handler:
 173          . rotated rsync snapshops
 174          . code from paulv@bikkel.org
 175         Added rub handler:
 176          . alternative to rsnap
 177          . code from rhatto@riseup.net
 178         mysql:
 179          . Fixed improper use of $vuserhome (Closes: #351083)
 180          . Fixed erroneous removal of tmpfile when it didn't exit
 181          . Fixed inversed vsname emptiness check
 182          . Fixed su quote usage to be more posixy
 183          . Compress for sqldumps now happens in-line to save some disk space (Closes: #370778)
 184          . Fixed --defaults-file now as --defaults-extra-file (thanks rhatto)
 185         pgsql:
 186          . Fixed inversed vsname emptiness check
 187          . Fixed su quote usage to be more posixy
 188          . Fixed shell expansion, thanks Thomas Kotzian (Closes: #363297)
 189          . postgres user UID is now the one from inside the vserver if necessary
 190          . Compress now happens in-line to save some disk space (Closes: #370778)
 191          . $PGSQLUSER is used instead of hardcoding user 'postgres' (although this is the default)
 192         svn:
 193          . Fixed inversed vsname emptiness check
 194         rdiff:
 195          . Symlink and globbing support in include/exclude/vsinclude
 196            clarification: globbing is fully supported again, whereas no attempt
 197            is done to dereference symlinks anymore, due to incompatibilities
 198            between various readlink versions in this field.
 199          . Removed overzealous vsnames check
 200          . Now works if testconnect=no and if $test is not defined.
 201          . add $sshoptions config parameter in [dest] section of config so
 202            connections to ports other than 22 can be made by adding the
 203            following to the top of the handler config:
 204            options = --remote-schema 'ssh -p REMOTE-PORT -C %s rdiff-backup
 205            --server'
 206         dup:
 207          . Symlink and globbing support in include/exclude/vsinclude
 208            clarification: globbing is fully supported again, whereas no attempt
 209            is done to dereference symlinks anymore, due to incompatibilities
 210            between various readlink versions in this field.
 211          . Removed over zealous vsnames check
 212          . Does not pretend anymore that duplicity can work without
 213            any passphrase
 214          . Support duplicity 0.4.2 (with Debian patches applied; upstream's
 215            0.4.3 will integrate them); documented how to write sftp-compatible
 216            sshoptions (Closes: #388543)
 217          . Now forbid to (try to) include /.
 218         sys:
 219          . Many more system checks were added, (thanks to Petr Klíma)
 220          . Added warning if no devices were found (thanks Ranier Zocholl)
 221          . Enhanced debian package selections to include purged packages (thanks
 222            Tom Hoover)
 223          . Removed warning about vserver not running (thanks anarcat)
 224         ldap:
 225          . Compress now happens in-line to save some disk space (Closes: #370778)
 226         makecd:
 227          . Added nicelevel option (thanks rhatto)
 228         trac:
 229          . fixed problem when src was set to the trac repo directly (Closes: #382737)
 230     lib changes
 231         vserver:
 232          . init_vservers: fixed Debian bug #351083 (improper readlink syntax)
 233          . found_vservers: escaped special grep repetition character +
 234          . forced mktemp to use a template with a name to be more compatible with
 235            different versions of mktemp, thanks anarcat
 236     ninjahelper changes
 237          . Recursively ignore subdirs in /etc/backup.d (Closes: #361102)
 238          . Fix configdirectory error that forced you to use /etc/backup.d, thanks anarcat
 239          . When determining which backup actions to list, find now follows
 240            symlinks for $configdirectory
 241          . Stop checking helpers perms: both "make install" and distros packages
 242            install them with appropriate permissions, it's overzealous to check
 243            this at runtime, and is more complicated to do with current
 244            admingroup option.
 245         dup.helper:
 246          . Fix: signing was enabled with symmetric encryption.
 247     changed cron permissions to 644
 248     changed /etc/backup.d permissions to 0770 (for admingroup)
 249     minor documentation fixes
 250     improved RPM build process allowing 'make rpm-package' and 'make
 251     srpm-package' targets, also fixes permissions on man directories,
 252     cleans up RPM-related files during distclean, and adds default
 253     EDITOR for "autogen.sh -f" if none is set. (thanks Robert Napier)
 254
 255 version 0.9.3 -- February 1st, 2006
 256     autotools fixes
 257     backupninja changes
 258         backupninja.conf
 259          . added (commented out) the various default paths to
 260            programs such as PGSQLDUMP, so that users can figure
 261            out more easily they can customize them
 262         code refactor:
 263          . now uses vservers lib to initialize vservers support
 264     handler changes
 265         duplicity, mysql, pgsql, rdiff, svn, sys: start to use (at different
 266            degrees) new lib/vserver functionality
 267         mysql:
 268          . fixed no user defaults file processing
 269         duplicity:
 270          . fixed (again...) globbing in include and exclude options (Debian bug
 271            #348022, follow-up to #338796)
 272          . warn if vsnames or vsinclude is enabled while vservers support is
 273            disabled in backupninja.conf
 274          . now works when multiple vservers names are given (separated by space)
 275            in vsnames config variable
 276         rdiff
 277          . fixed globbing bug in include, exclude and vsinclude options
 278          . it's now possible to choose exactly which vservers should be
 279            backed-up, as it already was with duplicity handler, with the
 280            "vsnames" configuration setting
 281     ninjahelper changes
 282         rdiff.helper:
 283          . fixed errors in create remote dir
 284          . code formatting cleanup (three spaces indent)
 285          . fixed bug which caused only first include/exclude dir to
 286            have "include = "
 287          . fixed globbing bug with exclude
 288         ninjahelper:
 289          . now reports error if the helper script has a syntax error or bombs out.
 290          . code formatting cleanup (three spaces indent)
 291     lib changes
 292         vserver:
 293          . init_vservers: improved VROOTDIR detection
 294          . init_vservers: test in a stricter way the real vservers availability
 295          . init_vservers: canonicalize VROOTDIR (since duplicity et al.
 296            don't follow symlinks)
 297          . init_vservers: warn if vservers are enabled but no vserver is found
 298          . new function: vservers_exist
 299     known bugs:
 300         easydialog:
 301          . formDisplay does not return exit status.
 302
 303 version 0.9.2 -- December 29, 2005
 304     backupninja changes
 305         fixed broken toint() which caused when "everyday" problems
 306         backupninja.conf.5 updated to include "when" and "vservers"
 307         code refactor:
 308             . moved to lib/ some code that has to be shared between
 309               backupninja and ninjahelper
 310     handler changes
 311         trac:
 312             . mkdir subdirectory problem fixed
 313         duplicity:
 314             . globbing support fixed in include and exclude options
 315             . different signing and encrypting key support added
 316             . fixed erroneous comments in example.dup about the way
 317               GnuPG-related options are used
 318         mysql:
 319             . handler vserver bugs fixed and debug output enhanced
 320     ninjahelper(s) changes
 321         vserver-related functions added to lib/vservers.in
 322         added man/ninjahelper.1 man page
 323         makecd:
 324             . was missing in Makefile.am/.in
 325         rdiff-backup:
 326             . used to expand '*' in default source directories
 327             . the "Cancel" buttons used to have a weird behaviour
 328             . updated to include Vserver selection
 329         pgsql:
 330             . forbid the user to choose an empty database set
 331             . "Cancel" button now does what it is meant to do
 332         mysql:
 333             . enhanced for vserver support
 334             . now able to select databases and dump directory
 335         duplicity:
 336             . new handler added (with Vserver support)
 337
 338 version 0.9.1 -- November 05 2005
 339     rearranged source so that it is relocatable with autotools
 340         (thanks to Petr Klíma petr.klima@madeta-group.cz)
 341     fixed many bugs in rdiff helper
 342     rdiff handler does not require 'label' (for real this time?)
 343     added makecd ninjahelper
 344         (thanks to Stefani stefani@riseup.net)
 345     made ninjahelper create files with mode 600 rather than 000
 346     changed subversion handler to use svnadmin hotcopy instead of
 347             the unsupported hot-copy.py script, which was moved in Debian
 348     update rdiff ninjahelper
 349             now detects and auto-install rdiff-backup on the remote
 350             machine if possible, also tests the remote backup directory
 351             and offers to create it if it doesn't exist
 352
 353 version 0.9 -- October 19 2005
 354     *** IMPORTANT CHANGE, UPGRADE AT ONCE ***
 355      fixed insecure temporary file creation
 356     *****************************************
 357     removed erroneous magic file marker in pgsql handler
 358     fixed incorrect find positional
 359     changed direct grep of /etc/passwd to getent passwd.
 360     rdiff helper has much better information on failed ssh attempt
 361         (patch from cmccallum@thecsl.org).
 362     rdiff handler now supports remote source and local dest.
 363         (patch from cmccallum@thecsl.org).
 364     man pages are greatly improved.
 365
 366 version 0.8 -- September 15 2005
 367     added pgsql (PostgreSQL) handler, with vservers support.
 368     added vservers support to duplicity handler
 369         Note: the configuration is a bit different than the rdiff
 370         handler's one, but the default behavior is the same:
 371         have a look at example.dup.
 372     improved README
 373     documented .disabled method.
 374     corrected VROOTDIR default value.
 375     added ninjahelper to the install instructions.
 376     improved rdiff, dup and sys handlers' vservers support
 377         prevent vserver-debiantools' $VROOTDIR/ARCHIVES directory
 378         to be seen as a vserver
 379     changes to sys handler
 380         make use of configurable $VSERVERINFO instead of hard-coded vserver-info.
 381         fixed dpkg existence test inside vserver.
 382         fixed $nodpkg use.
 383     changes to pgsql handler
 384         now checks if the specified vserver is running.
 385         now checks if $PGSQLDUMP/$PGSQLDUMPALL are available where needed.
 386         now checks if "postgres" user exists on the host/vserver.
 387     changes to ninjahelper
 388         check_perms() does not die anymore on group/world readable
 389         helper scripts (now consistent with the "helper scripts
 390         must not be group or world writable!" error msg).
 391     xedit action now tries $EDITOR, then /etc/alternatives/editor,
 392         then nano, vim and vi, and aborts if none of these exists.
 393     added helper for pgsql handler.
 394     rdiff handler now does not require 'label'
 395     changes to mysql and svn handlers' vservers support
 396         these handlers now check if the source vserver is running
 397     added 'ignores' for mysql handler. (thanks Daniel.Bonniot@inria.fr)
 398
 399 version 0.7 -- July 26 2005
 400     added ninjahelper: a dialog based wizard for creating backupninja configs.
 401     considerably improved and changed the log file output.
 402     you can now disable actions with .disabled (this is new preferred method).
 403     added makecd handler and example.makecd for backing up to cd/dvd (thanks stef).
 404     fixed bug when specifying multiple 'when' options.
 405
 406 version 0.6 -- June 16 2005
 407     ldap handler has new options: backup method to use (ldapsearch or
 408         slapcat), restart, passwordfile and binddn. Default backup method
 409         is set to ldapsearch as this is safer
 410     ******************************************************************
 411     NOTE: to get the previous default behavior with the ldap handler,
 412     you must set "method = slapcat". The new default is ldapsearch.
 413     ******************************************************************
 414     implemented fix so that the main script will echo fatal errors rather
 415         than being silent about them, this means an error message every hour
 416         if there is a major configuration problem (not a handler problem)
 417     added vserver support to main script and to the handlers: mysql, svn, sys, rdiff
 418     changes to duplicity handler (thanks intrigeri!):
 419         "keep = yes" now disables file cleaning on desthost
 420         added "sign" option for backups signing
 421         added "encryptkey" option to specify the gpg key to use
 422         split config into [source], [gpg] and [dest] sections
 423         added "nicelevel" option
 424         added "testconnect" option
 425         added "sshoptions" option (will be passed to ssh/scp)
 426         added "bandwidthlimit" option
 427     example.dup example config file for duplicity handler
 428     added trac (http://trac.edgewall.com/) environment handler (thanks Charles Lepple!)
 429     added configfile option to mysql handler
 430         the default is /etc/mysql/debian.cnf. with this,
 431         sqldump doesn't need dbusername. (hotcopy still does).
 432     fixed bug in mysql handler which caused some passwords to not work.
 433         (.my.cnf files now have double quotes around password)
 434     can now pass options to hwinfo and sfdisk in sys handler.
 435
 436 version 0.5 -- April 12 2005
 437     rdiff handler works when remote sshd has a banner
 438     rdiff handler supports local dest
 439     logfile is created if it doesn't exist
 440     added "when = hourly"
 441     added optional 'nicelevel' to rdiff handler
 442     fixed bug where actions were not run in numeric order.
 443     improved 'when' parsing.
 444
 445 version 0.4.4 -- March 18 2005
 446     results of handlers are now read line by line.
 447     changes to rdiff handler: added "options", and "keep" is
 448         not necessarily days now (ie, it will pass straight through to
 449         rdiff-backup if the keep has a unit on it, otherwise it adds the 'D').
 450     added dup handler (still pretty beta)
 451     added maildir handler (very specialized handler)
 452     added --run option (runs the specified action file)
 453     improved sys handler, now uses hwinfo
 454     added subversion hotbackup handler, svn.
 455     added PATH to cron.d file, which fixes file not found errors.
 456
 457 version 0.4.2 -- Jan 6 2005
 458     fixed bug which caused a report email to be sent even if no actions were run.
 459     fixed bug where multiple handler status messages were ignored
 460     added status in the subject line of report emails
 461
 462 version 0.4.1 -- Jan 3 2005
 463     added $usecolors and now more conservative about when colors are echoed.
 464     fixed major bug, 'when' actually works now.
 465     replaced debug function with debug, info, warning, error, fatal.
 466     added --now option to force all actions to be performed now.
 467
 468 version 0.4 -- Dec 26 2004
 469     added "when" option, so that all configs can specify when
 470         they are to be run.
 471     added reportsuccess and reportwarning config options
 472     added .sys handler (hardware, packages, partitions).
 473
 474 version 0.3.4 -- Dec 8 2004
 475     fixed numerical variable quoting compatibility with older wc
 476     fixed stderr redirect bug
 477     some comments in example.rdiff
 478
 479 version 0.3.3 -- Nov 10 2004
 480     '*' (asterisk) works now in rdiff config files
 481     works now with gawk as well as mawk
 482     many bug fixes to ldap handler
 483     paths to helper scripts can be configured in global config
 484     does not require /usr/bin/stat
 485
 486 version 0.3.2 -- Sept 29 2004
 487     handler scripts are no longer executable (to comply with debian policy)
 488     handler error and warning messages are sent with the notify email
 489
 490 version 0.3.1 -- Sept 5 2004
 491     added ldap handler
 492     moved sh support to a handler script
 493     add test mode, where no action is taken.
 494     added --help
 495     force only root can read /etc/backup.d/*
 496     fixed missing equals symbols in example.rdiff
 497     changed backupninja executable to be /usr/sbin rather than /usr/bin
 498
 499 version 0.3 -- Oct 20 2004
 500     ** IMPORTANT ** all config files are now ini style, not apache style
 501     rewrote all scripts in bash for portability
 502     added drop-in backupninja lib directory (/usr/share/backupninja)
 503     all scripts are now run as root
 504
 505 version 0.2 -- Oct 14 2004
 506     move distribution folder ./cron.d to ./etc/cron.d
 507     fixed bug: removed printr of excludes (!)
 508     added support for changing the user/group in rdiff sources.
 509     added support for .mysql config files.
 510
 511 version 0.1 -- Oct 8 2004
 512     initial release
 513