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