2 Release Notes for Bacula 2.2.10
4 Bacula code: Total files = 498 Total lines = 167,596 (*.h *.c *.in)
5 82 new files, 41,221 new lines of code, 208,380 lines of change from 2.0.3
7 This Director and Storage daemon must be upgraded at the same time,
8 but they should be compatible with all 2.0.x File daemons, unless you
9 use some of the new features that affect the FD. In other words, you should
10 not have to upgrade all your File daemons when you upgrade. There is
11 no database upgrade needed from version 2.0.x to 2.2.0.
13 ================ Warning !!!!!! ==========================
14 As of Version 2.2.10-b4, the Win32 FD should not descend into
15 any reparse point directory or reparse mount points unless the
16 specified directory is explicitly mentioned at the top level of
17 FileSet (as with Unix). A file that is linked to another file will
18 be backed up, much like Unix hardlinked files. If you want
19 reparse directories backed up, you must explicitly include them
22 Beta Release Version 2.2.10-b4
24 kes Enhance a couple of SD debug messages.
25 kes Tweak unload flag setting and ensure it is set during swap.
27 ebl Fix #1091 about bad output in estimate command.
29 kes Modify autochanger locking to attempt to avoid race
31 kes Make sure device not busy before doing label command.
32 kes Display open() errors except when polling. Previously too
33 many were suppressed. This should fix bug #1070.
34 kes Fix Win32 reparse points. Bacula will not recurse into any
35 reparse point directory, including mount points, unless the
36 directory is explicitly mentioned at the top level (same as
37 with Unix). A file that is linked to another file will be
38 backed up -- much as Unix does for hardlinked files.
41 kes Remove double quotes from ChangeLog and ReleaseNotes
42 kes Remove StorageId test when pruning and recycling (Eric's changes).
43 kes Remove old form of locking when getting volumes -- causes deadlock.
45 kes Fix buffer overruns detected by Coverity.
47 Beta Release Version 2.2.10-b3
49 kes Implement --without-qwt
50 kes Fix layout of restore tree dialog
51 kes Add configure bat QWT libraries, so that bat can be built
52 with or without the QWT libaries.
54 kes Apply batfix bat cleanup patch from Riccardo.
55 kes Make sure we unload the right slot when swapping.
57 kes Improve SD reserve debug code.
58 kes Testing an improvement to free up volumes no longer in use.
60 Beta Release Version 2.2.10-b2
62 kes Rework SD acquire for read to handle autochanger Volume
64 kes Implement regression that explicitly tests swapping a Volume
65 from one drive to another.
66 kes Enhance disk-changer to detect most error conditions.
67 kes Fix SD code so that it properly swaps a Volume between drives.
70 kes Prevent a Volume that is being swapped from being freed from
71 the volume list. This will most likely fix, at least partially,
73 kes Fix strippath so that it does not get a buffer overrun and crash FD.
75 kes Make inability to change owner/group when creating a dir only a
76 warning rather than an error.
78 ebl Fix SQL query in migration code
80 kes Force unload of volume when wrong volume mounted in SD.
82 kes Fix bat seg fault at termination.
83 kes Add Bacula generated version to bat about box.
86 Version 2.2.10-b1 is primarily a Storage daemon reservations system
87 enhancement to 2.2.9-beta
89 kes Permit multiple simultaneous restores -- experiment.
91 kes Backport development stream SD reservation system changes.
95 kes Move final volume swapping code to DCR method and
96 call it from acquire_for_read().
97 kes When wrong volume is mounted during read, unload_autochanger.
99 kes Stop searching for Volumes in SD askdir if DIR returns the
100 same volume name twice in a row.
102 kes Tweak the swap Volume from one drive to another code so that
103 it now seems to work.
104 kes Resolve several problems with recycling that broke the new
105 code (these problems are in 2.2.9 as well).
106 kes Remove the volume lock when calling the sysop code.
107 kes Don't mark a reserved volume with no writers as unused otherwise
110 kes Rework class structures for VOLRES, DCR, and DEVICE to make
111 the method names a bit more logical, and for more logically
112 handling the responsibilities.
114 kes Remove redundant code in terminating the scheduler that just
115 causes a seg fault in many cases.
116 kes Cleanup releasing a volume and make it a DCR method.
117 kes Improve algorithm for detecting pre-reserved volume and
120 kes Tweak volume swapping code so it works.
121 kes Correct name overloading in mount.c
122 kes Replace released flag in VOLRES with reserved and add access
123 methods for the VOLRES class.
124 kes Prevent volume from being released while being swapped.
125 kes Refactor parts of stored/mount.c
127 ebl Add sanity checks for VolWriteTime and VolReadTime
128 ebl Take care of bad clock changes while computing VolWriteTime
129 and VolReadTime. This should fix or limit #1066
130 kes Correct error string numbers in dird/catreq.c
131 kes Restructure reserving, acquiring, and mounting volumes. Calls to
132 autochanger are deferred for mount.c -- simplifes the code.
134 kes Do not prune any running job. It just fails the job.
135 kes Lock the volumes when changing dev->reserved_device and marking
136 the volume unused otherwise the device can get reserved by
137 another job before the volume is released, thus blocking it.
140 Version 2.2.9 is a bug fix to version 2.2.8:
141 - Close bat console windows first to eliminate error message
143 - Remove useless code in Scheduler that causes seg fault on
145 - Correct some SD catalog request error messages.
146 - Don't allow pruning of any running job.
147 - Turn off code in read_record that causes a seg fault in the SD
148 when reading past an EOS_LABEL.
149 - Turn off unloading the autochanger in reserve.c as it just
151 - Lock volumes when unreserving a device.
152 - Do not mark volume unused when recycling.
153 - Fix bug #1068 fixes a SD crash when using Virtual autochanger.
154 - Generate correct JobMedia records during spooling/despooling when
155 running concurrent jobs. Thanks to Tom Ivar Helbekkmo
156 <tih@hamartun.priv.no> for excellent analysis and testing.
157 - *Massive* commit of all fixes and back ports to create 2.2.9
158 Mostly SD reservations enhancements.
159 - Fix Win32 FD backup/restore memory leak due to improper termination
160 of BackupRead/Write. This fixes bug# 1038.
161 - Fixes a StorageId problem with volumes after migration.
162 - Implements autostart scripts for Debian
163 - Fix mtx-changer.in for broken Debian mt program.
164 - Apply doc fix from bug #1062.
165 - Resolve crash and improper restore wx-console Win32 restore
166 GUI. Fixes bug #1065.
167 - Update Win32 wxWidgets to latest version.
168 - Attempt to do correct handling of Win32 mount points. Should
170 - Add const to AIX prototype for initgroups()
171 - Undo bug #1047 heap overrun fix as it is not correct.
172 - Fix to the JobMedia patch, which introduced a new problem.
173 - Fix creating first JobMedia record during Migration to include
174 proper index. This caused slow restores of migrated jobs.
175 - Fix bug #1047, do not strip paths on symbolic links.
176 - Set catalog backup database and user name from values specified on
177 the ./configure line.
178 - Apply patch to correct bug #1031, about wrong pool source information
181 Version 2.2.8 is a bug fix to version 2.2.7:
182 - It fixes bugs: 1036, 1033(doc), 1028, 1040, 1045(doc), 1030,
183 1042(partially), and possibly bugs 1018 and 1032.
184 Bugs 1018 and 1032 involve problems with multiple-drive autochangers,
185 and are difficult to reproduce.
186 See the ChangeLog for more details.
188 Version 2.2.7 has several new features and several important bug fixes
190 - It fixes bugs: 1009, 1022, 1024, 1019, 1012, 1021, 1020
191 1007, 1008. For more details, please see the technotes-2.1 file.
192 - Fixed a seg fault reported by Frank Sweetser that depended on
193 exact path lengths, but the problem was in bsnprintf.c
194 - Double quoting include filenames (@xxx) in Bacula conf files is now
195 possible, thanks to a patch by Michael Stapelberg.
196 - You can pipe input to include filenames (@|prog) by using a vertical
197 bar, thanks to the above patch.
198 - A daylight savings time bug in the Win32 bsmpt was fixed by a patch from
200 - Marc Cousins submitted a patch that permits building the PostgreSQL
201 driver with version 8.3.
202 - The configure option --archivedir has been changed to --with-archivedir
204 Version 2.2.6 is a minor bug fix release to version 2.2.5
205 - It fixes bugs: #1003, 942, 982, 990(response only), 991,
207 - Fix bat crash wen it cannot connect to Director.
208 - Fix joblist failure bug in bat.
210 Version 2.2.5 is a major bug fix release to version 2.2.4
211 - It fixes the following bugs: #961, 962, 963, 969, 968, 960,
212 964, (possibly 935 and 903), 953, 953, 967, 966, 965, 954,
213 957, 908, 958, and 955.
214 - It also improves listing performance problems in bat pointed
215 out by Chris Howells.
217 Version 2.2.4 is a minor bug fix release to version 2.2.3
218 - Possible fix for authorization problems bug #953.
219 - Possible fix for bug #908.
220 - Add waits to multiple exit detection code to try to force pid
221 file to always be deleted.
222 - Restore good dev.tar.gz to rescue set appropriate binary property.
224 - Fix seg fault in error exit of acquire_for_read after unsuccessfully
225 trying to switch drives by checking for blocking before unblocking.
227 - Cancel storage daemon in all cases where FD reports error. This
228 should fix virtually all cases of bug #920 and will ensure that Devices
229 are released as soon as possible.
230 - Fix error message that was clobbered when Dir tells SD it does not
231 have write permission on Volume. This should fix a minor point
232 in bug #942, but not the main problem.
233 - Fix migration code to get correct Volume name with multiple volumes
234 by skipping |. Fixes bug #936.
235 - Implement patch supplied by Landon to fix bug #944 where using
236 TLS with bconsole uses 99+% of the CPU.
237 - Fix bug #946 about 'bacula-dir -t' which doesn't works
239 - Using 'm' in bconsole will show messages as in prior versions
240 and not memory usage.
242 - Note, you need GTK >= 2.10 to be able to link the Tray Monitor
245 Version 2.2.3 is a critical bug fix release to version 2.2.2
246 - Fix bug #935, and possibly also bug #903 where files were not
247 restored. MediaId was not properly set in JobMedia record after
248 a Volume change. This bug is known to affect all versions from
249 2.0.0 on, and probably versions prior to that. A detailed analysis
250 of the bug can be found at:
252 http://www.bacula.org/downloads/bug-395.txt
254 - Add ./configure search in qwt-qt4 for qwt package
255 - Apply Martin Simmons patch that should turn off the new API usage
256 when batch insert is turned off allowing building on older
258 - Note, you need GTK >= 2.10 to be able to link the Tray Monitor
261 Version 2.2.2 is a minor bug fix release to 2.2.1
262 - Detect if new PosgreSQL batch insert API is present.
263 - Correct incorrect mempool call causing Director crash on older
264 systems that do not have va_copy().
265 - Update spec files for 2.2.1 release
267 Version 2.2.1 is mainly a minor bug fix release to version 2.2.0,
268 the main changes since 2.2.0 are:
269 - Fixed bugs #921, 930, and 923.
270 - More portable timezone offset in bsmtp thaks to Attila Fülöp.
271 - Fix several bat issues.
272 - Use GTK+ calls instead of egg files in tray-monitor.
273 - Win32 service routines rewritten
274 - Updated projects file
275 Please see the ChangeLog for details.
277 Notes on 2.2.0 release follow:
279 Areas requiring caution or testing:
280 - You must have the thread safe version of MySQL client libraries loaded
281 to build with MySQL enabled.
282 - Volumes are pruned only when absolutely necessary -- this may cause
283 your database to grow compared to prior Bacula versions.
284 - Solaris door and even port files are no longer restored (equivalent
285 to what we do with sockets).
286 - SQLite is no longer supported for Solaris -- it fails too often with
287 bus errors. SQLite3 should work on Solaris.
288 - The default setting for SQLite3 is now 'PRAGMA synchronous=OFF'.
289 This makes it run 30 times faster, but increases the possiblity
290 of a corrupted database if your server shuts down unexpectedly.
291 The default behavior can be changed in src/version.h
292 - Restore on Win32, and in particular on Vista is untested. Please
293 test before relying on it. It should backup and restore reparse
295 - Win32 servers are untested, and very likely not to work.
297 The major new features are:
298 - Much faster insertion of attributes (somewhere around 10 times),
299 many thanks to Eric Bollengier and Marc Cousin.
300 - First release of bat (Bacula Administration Tool). Note to build
301 bat you must explicitly enable it on the ./configure line, you
302 must have the Qt4 version 4.2 or later libraries loaded, the qwt
303 (Qt Graphics) package loaded, and qmake and the other Qt4 tools
304 must be available. Most of the implementation was done by Dirk Bartley.
305 - Red/Black restore in memory tree (500 times faster loading).
306 - The Regex Where code to allow easier relocation of restored files
308 - Socket level heartbeat for all connections (untested).
309 - posix_fadvise() use in the FD to improve performance reduces
310 swapping due to opening/reading lots of files. Win32 equivalent
312 - Much improved Volume reservation code that should eliminate most
313 conflicts experienced in multiple drive autochangers.
314 - Simpler locking in the SD in the reservation system.
315 - Detection of file size/date change during backup if enabled.
316 - New Recycle Pool feature -- thanks to Eric.
317 - Efficient implementation of very large include/exclude lists.
318 - Volumes are no longer pruned during 'status dir'
319 - Pruning is now more efficient, and if a Volume is purged,
320 during pruning, it is immediately discovered.
321 - License is now GPL v2 without modifications, fix a few copyright
322 mistakes made when adding FSFE copyright notice.
324 New ./configure options:
325 - --enable-bwx-console
330 - --enable-batch-insert
332 New bconsole commands:
338 - .pwd (in restore tree)
339 - restoreclient (keyword)
340 - backupclient (keyword)
341 - regexwhere (keyword)
342 - update jobid (new command)
343 - recyclepool (keyword)
346 - Heartbeat Interval (bconsole.conf)
347 - Heartbeat Interval (bacula-dir.conf in Director, Client, Storage)
348 - TLS Allowed CN (bacula-dir.conf in Client)
349 - Regex Where (bacula-dir.conf in Job)
350 - Strip Prefix (bacula-dir.conf in Job)
351 - Add Prefix (bacula-dir.conf in Job)
352 - Add Suffex (bacula-dir.conf in Job)
353 - Recycle Pool (bacula-dir.conf in Pool)
354 - FailJobOnError (bacula-dir.conf in RunScript)
355 - CheckFileChanges (bacula-dir.conf in FileSet)
356 - StripPath (bacula-dir.conf in FileSet)
358 Other features or bug fixes:
359 - Fixed bugs: 916, 910, 917, 914, 906, 907,
360 842, 830, 893, 861, 888, 886, 807, 877, 872
361 885, 887, 864, 874, 882, 881, 863, 859,
362 856, 854, 845, 847, 846, 809, 772,
363 822, 825, 824, 808, 802, 797, 798, 795, 789, 791,
364 788, 780, 763, 782, 612, 767, 775, 621, 772, 764,
365 766, 621, 761, 755, 750, 741, 747, 742, 744, and 743.
366 - Configure bat with --enable-bat. Define qwt libraries with
367 --with-qwt=<dir>. See Installation chapter of manual for details.
368 - Create a depkgs-qt package that has both Qt4 and qwt, which are
369 needed to build bat. Most modern Linux systems will have both
370 these packages in the distro.
371 - Storage overrides delete all previous storage definitions instead
373 - One should be able to mount and unmount removable devices if the
374 Device resource has Removeable Media set and the mount and unmount
375 directives are defined.
376 - ./configure will do a better job of searching for qwt libraries.
377 - The Win32 version can no longer be shutdown from the tray monitor.
378 Use the command line or the Services panne.
379 - Keep prune_volumes() from pruning the whole Scratch pool.
380 - More debug output in status storage.
381 - Correct moving a Scratch volume from pool to pool (some
382 critical columns were lost).
383 - Different locking in reservations and despooling systems,
384 which means more micro-locking and less macro-locking, which
385 should give a lot more concurrency at the expense of slightly
386 (<0.1%) more overhead due to more locking/unlocking, but
387 concurrent jobs should run much faster.
388 - Additional drive reservation algorithm that should solve a lot of
389 the problems experienced with multiple drive autochangers.
390 - Storage daemon status command enhanced to more clearly show Volume,
391 pool and media type when a job is waiting.
392 - Made bsmtp work with more strict SMTP servers.
393 - Detect doubly freed buffers in smartall.c
394 - wx-console renamed to bwx-console (Fedora request)
395 - gnome-console renamed to bgnome-console (Fedora request)
396 - Migration preserves original job's FileSetId
397 - Spooling implemented for migration jobs.
398 - Config files can be read through a pipe, by specifying a leading |
399 in front of the configuration path/filename.
400 - New memory command (bconsole) that will print the current Director's
401 memory usage, and an in use buffer dump.
402 - Console name changed from *Console* to -Console- to accomodate Win32
403 filename restrictions.
404 - Corrected the Win32 ftruncate bug.
405 - Additional version information added to Job reports.
406 - New -8 option for bsmtp to specify UTF-8 encoding type.
407 - bsmtp will no longer add < > to target (from, to, cc) if there
408 is already a < in the target.
409 - Prefer Mounted Volumes extended to mean a volume that is being
410 mounted by another job.
411 - Runscript timing set to same as version 1.38.11
412 - New TLS Allowed CN directive(s) permitted.
413 - New bconsole 'exec' command to run external script/command.
414 - Turn on FreeBSD/OpenBSD code to set EOT model on tape.
415 - Drop from root done before database is opened.
416 - Database user and name can be configured with:
417 --with-db-name=name --with-db-user=user
418 - Turn on wait_for_drive in mtx-changer script.
419 - Rework how bar codes are handled in mtx-changer script.
420 This appears to have been an unreported bug.
421 - Updated nagios plugin supplied by Christian Masopust
422 - Better restricted console ACL checking.
423 - New Client Connect Wait directive in Storage daemon so that
424 users can configure how long SD waits for FD connection.
425 - Bacula will no longer permit pruning of the currently running
426 job (note, if other jobs are running, they may be pruned).
427 - Sockets are no longer restored.
428 - dbcheck works in 300K chunks so will typically run faster.
429 - Include/Exclude lists can now be efficiently handled for quite
430 large sizes -- tens of thousands of entries.
431 - Several memory leaks in migration and database usage were fixed.
432 - New console keyword restoreclient, which specifies the client to
433 which the restore will be sent. The client keyword specifies
434 the backup client. The restoreclient keyword is optional if it is
435 not specified, the backup client will also be the restore client.
436 - The disk file size is now checked to ensure that it agrees with the
437 catalog value before Bacula will append to the disk (same as tape