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