ChangeLog

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