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