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