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