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