ChangeLog

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