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