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