2 Release Notes for Bacula 2.4.3
4 Bacula code: Total files = 500 Total lines = 188,945 (*.h *.c *.in)
7 ================== Warning !!!!!! ==========================
8 As of Version 2.4.0, the Win32 FD should not descend into
9 any reparse point directory or reparse mount points unless the
10 specified directory is explicitly mentioned at the top level of
11 FileSet (as with Unix). A file that is linked to another file will
12 be backed up, much like Unix hardlinked files. If you want
13 reparse directories backed up, you must explicitly include them
15 ==============================================================
18 This is a bug fix to version 2.4.2. All daemons are compatible
19 with other 2.4.x versions.
22 1159, 1162. 1149, 1128, 1143, 1140, 1129
25 - Apply 2.4.2-cancel-non-running-jobs.patch to be able to cancel
26 a non created job faster.
27 - This should correct bug #1159 where Migration does not properly
28 respect the Migration Low Bytes directive.
29 - Fix typo in configure.in that breaks --with-db-password option
30 - This code should fix the race condition that leads to a Director
31 crash at job end time when the job list is updated. This was reported
33 - Remove all double quotes from SQLite creating script and
34 replace by single quotes as suggested by John Huttley.
35 - Fix SQL case problem that may cause the failure of DiskToCatalog
37 - Copy missing storage name into edit buffer. As far as I can tell
38 this never caused a bug.
39 - Remove catalog dependency for bcopy
40 - Modify catalog scripts to have an easier packaging integration,
41 using default variables.
42 Make difference between SQLite3 and SQLite in db_get_type()
43 - Attempt to fix bug #1128 InChanger flag cleared during Migration
44 job when reading from one autochanger and writing to another.
45 - Add more information to SD acquire.c INFO messages.
46 - Fix NULL Volume name error when reading and the drive must
48 - Fix a Verify InitCatalog problem where in certain cases
49 a garbage filename may be entered in the verification database. This
51 - Add space after version before date in bat about dialog.
52 - Fix seg fault in Dir during estimate command with no level value
53 given. This fixes bug #1140.
54 - Add message to migration job when the target job is already migrated.
55 This closes bug #1129.
58 ==============================================================
61 This is an important bug fix release since version 2.4.1.
64 1034, 1125, 1118, 1124, 1107, 1129, 1126
68 - When a migration job actually runs, re-check the Job record
69 and skip if the job is already migrated. This should
70 significantly reduce the problems with bug #1129.
71 - Break the do_swapping into do_unload, do_swapping, and
72 do_load. It is much more logical that way.
73 - Implement a set_dcr_from_vol subroutine in acquire.c for
74 reading volumes. This allows the dcr to be refreshed after being
75 zapped when the wrong volume is mounted. This should fix bug #1126 -
76 - During multiple tape restore, bacula
77 does not ask for physical tape change, but rereads same tape
78 - Apply patch submitted for bug #1107 with a small modification.
79 This fixes a bug where bcopy copied too many records.
80 - Make some tweaks to bsmtp based on patch submitted in bug #1124.
82 - Make the default bat restore Pool be Any. This fixes bug #1118.
83 - Fix bug #1125 which reports a SD crash at the end of a tape
84 during restore. It was a debug statement that should not be
86 - Fix #1034 by setting big timeout on mysql connections
87 - Do partial integration of the Win32 bat build created by Eric.
88 - Ensure that SD tried to mount a volume not in an autochanger
89 at least once before asking for operator intervention.
90 - Fix a pthreads bug in the Win32 pthreads emulation code affects only
91 version 2.5.x and above.
94 =================================================================
99 1103, 1100, 1105, 1094, 1109, 1106, 1101, 1102, 1112
103 - Clear in-use bit on vol when unused while swapping.
104 - Remove sleep at end of ./bacula
105 - Clear hash packet for hardlinked files correctly. This corrects
106 a long standing bug where hardlinked files selected individually
107 would occasionally not be restored.
108 - Apply Eric's patch to ensure that autoprune does not return
109 a Volume not in the autochanger unless requested to do so.
110 - Correct bat restore display of multiple drives. This fixes
112 - Do find_a_volume() each time an unload is done. This
113 fixes the failure of maxvol2-test.
114 - Use Qmsg() in job.c watchdog callback.
115 - Release main control rwlock if ABORTing.
116 - Make watchdog connect timeout queue messages rather than sending
117 directly to avoid lock conflicts with the real thread.
118 - Remove const char that causes problems with Python, which has
119 older 'incorrect' headers.
120 - Add const char in dbd.c to avoid compiler warnings.
121 - Fix mtx-changer to detect both versions of Ubuntu (Debian)
122 mt. This fixes bug #1116.
123 - Fix failure of 2drive-concurrent-test. Always read label;
124 clear_unload() only after drive is defined in acquire_for_read().
125 - Generally clean up the manual tape loading code. The main
126 conceptial change is that when a volume is marked to be unloaded,
127 its volume name is retained, and it is only marked as unloaded
128 when either the autoloader says it is unloaded or another tape
129 is read on that drive.
130 - Fix a recycling problem with two autochangers reported in bug
131 #1106. This may also (unlikely) fix a second recycling bug as
133 - Fix a SD lock volumes deadlock problem reported in bug #1100.
134 - Fix format problem in bscan output reported in bug #1105.
135 - Copy more data when restarting a job so that run
136 overrides are kept. This should fix bug #1094.
137 - Backport updates to jobq.c where possible.
138 - Fix bug where SD did not ask operator if the device could not
139 be opened. Reported by Eric.
140 - Add dbuser to DIR conf file (replaces user).
141 - Add --with-db-password to ./configure
142 - Fix regress to handle db_password.
143 - Fix a couple of pedantic compiler warnings.
144 - Fix bug when starting a restore on a storage that doesn't
145 have the requested MediaType.
146 - More work on word alignments -- eliminate all ints from
147 the configuration routines.
148 - Fix bug reported by Scott Barninger where the bacula script
149 refers to scripts in the wrong directory. Needed to meet the
150 requirements of recent FHS location changes.
151 - Fix word alignment problem on non-Intel 64 bit machines
152 such as Solaris. This should fix bug #1097 -- bus error in SD.
153 - Add missing win32/patches/wxWidgets.patch to 2.4 repository.
155 =====================
158 This Director and Storage daemon must be upgraded at the same time,
159 but they should be compatible with all 2.0.x File daemons, unless you
160 use some of the new features that affect the FD. In other words, you should
161 not have to upgrade all your File daemons when you upgrade. There is
162 no database upgrade needed from version 2.0.x to 2.2.0 nor from version
163 2.2.x to version 2.4.0
165 This release consists mainly of a number of bug fixes since 2.2.x
166 but most importantly, a rewrite of significant portions of the
167 Storage daemon reservation and autochanger code. This rewritten
168 code is simpler, more stable, and works much better, particularly
169 with multiple drive autochangers than the prior code did. That
170 said, there are still a number of issues to be resolved. Note,
171 the new code has not been tested in manual volume mount situations.
174 1095, 1086, 1091, 1070, 1041, 1083, 1078, 1066, 1068, 1038
175 1062, 1065, 1046, 1047, 1031
178 - You can now build bat without the QWT libraries. Use
179 --without-qwt as a ./configure option.
181 Release Version 2.4.0
182 - Update version to 2.4.0 to reflect the magnitude of the SD changes.
183 - Make sure to clear JS_WaitMedia when operator mounts a Volume.
184 This fixes bug #1095.
185 - Add create_postgresql_database.sql to Win32 installer. Should
186 fix problem reported by Juilio Monteiro.
187 - Get correct slot when auto unloading a device. This fixes bug
189 - Fix possible seg fault if SQL error.
190 - Fix renaming a Volume, which used the wrong Volume name.
191 - If operator has rewind tape, print warning, release tape and
192 try once more. If tape is positioned somewhere, something went
193 wrong, so mark the tape in error and try once more. Previously
194 this error was fatal, now it produces an error message.
195 - Ensure correct volume name displayed during restore
196 - Fix a few more Coverity reported problems.
197 - Fix #1091 about bad output in estimate command.
198 - Modify autochanger locking to attempt to avoid race
200 - Make sure device not busy before doing label command.
201 - Display open() errors except when polling. Previously too
202 many were suppressed. This should fix bug #1070.
203 - Fix Win32 reparse points. Bacula will not recurse into any
204 reparse point directory, including mount points, unless the
205 directory is explicitly mentioned at the top level (same as
206 with Unix). A file that is linked to another file will be
207 backed up -- much as Unix does for hardlinked files.
208 This fixes bug #1041.
209 - Remove StorageId test when pruning and recycling (Eric's changes).
210 - Fix buffer overruns detected by Coverity.
211 - Implement --without-qwt
212 - Fix layout of restore tree dialog
213 - Add configure bat QWT libraries, so that bat can be built
214 with or without the QWT libaries.
215 - Implement regression that explicitly tests swapping a Volume
216 from one drive to another.
217 - Enhance disk-changer to detect most error conditions.
218 - Fix SD code so that it properly swaps a Volume between drives.
219 This fixes bug #1083.
220 - Prevent a Volume that is being swapped from being freed from
221 the volume list. This will most likely fix, at least partially,
223 - Fix strippath so that it does not get a buffer overrun and crash FD.
224 This fixes bug #1078.
225 - Make inability to change owner/group when creating a dir only a
226 warning rather than an error.
227 - Fix SQL query in migration code
228 - Fix bat seg fault at termination.
229 - Add Bacula generated version to bat about box.
230 - Backport development stream SD reservation system changes.
231 - When wrong volume is mounted during read, unload_autochanger.
232 - Stop searching for Volumes in SD askdir if DIR returns the
233 same volume name twice in a row.
234 - Rework class structures for VOLRES, DCR, and DEVICE to make
235 the method names a bit more logical, and for more logically
236 handling the responsibilities.
237 - Remove redundant code in terminating the scheduler that just
238 causes a seg fault in many cases.
239 - Improve algorithm for detecting pre-reserved volume and
241 - Prevent volume from being released while being swapped.
242 - Refactor parts of stored/mount.c
243 - Add sanity checks for VolWriteTime and VolReadTime
244 - Take care of bad clock changes while computing VolWriteTime
245 and VolReadTime. This should fix or limit #1066
246 - Correct error string numbers in dird/catreq.c
247 - Restructure reserving, acquiring, and mounting volumes. Calls to
248 autochanger are deferred for mount.c -- simplifes the code.
249 - Do not prune any running job. It just fails the job.
250 - Lock the volumes when changing dev->reserved_device and marking
251 the volume unused otherwise the device can get reserved by
252 another job before the volume is released, thus blocking it.
253 - Correct some SD catalog request error messages.
254 - Turn off code in read_record that causes a seg fault in the SD
255 when reading past an EOS_LABEL.
256 - Turn off unloading the autochanger in reserve.c as it just
258 - Lock volumes when unreserving a device.
259 - Do not mark volume unused when recycling.
260 - Fix bug #1068 fixes a SD crash when using Virtual autochanger.
261 - Generate correct JobMedia records during spooling/despooling when
262 running concurrent jobs. Thanks to Tom Ivar Helbekkmo
263 <tih@hamartun.priv.no> for excellent analysis and testing.
264 - *Massive* commit of all fixes and back ports to create 2.2.9
265 Mostly SD reservations enhancements.
266 - Fix Win32 FD backup/restore memory leak due to improper termination
267 of BackupRead/Write. This fixes bug# 1038.
268 - Fixes a StorageId problem with volumes after migration.
269 - Implements autostart scripts for Debian
270 - Fix mtx-changer.in for broken Debian mt program.
271 - Apply doc fix from bug #1062.
272 - Resolve crash and improper restore wx-console Win32 restore
273 GUI. Fixes bug #1065.
274 - Update Win32 wxWidgets to latest version.
275 - Attempt to do correct handling of Win32 mount points. Should
277 - Add const to AIX prototype for initgroups()
278 - Fix to the JobMedia patch, which introduced a new problem.
279 - Fix creating first JobMedia record during Migration to include
280 proper index. This caused slow restores of migrated jobs.
281 - Fix bug #1047, do not strip paths on symbolic links.
282 - Set catalog backup database and user name from values specified on
283 the ./configure line.
284 - Apply patch to correct bug #1031, about wrong pool source information
288 =========================================================================
290 Version 2.2.8 is a bug fix to version 2.2.7:
291 - It fixes bugs: 1036, 1033(doc), 1028, 1040, 1045(doc), 1030,
292 1042(partially), and possibly bugs 1018 and 1032.
293 Bugs 1018 and 1032 involve problems with multiple-drive autochangers,
294 and are difficult to reproduce.
295 See the ChangeLog for more details.
297 Version 2.2.7 has several new features and several important bug fixes
299 - It fixes bugs: 1009, 1022, 1024, 1019, 1012, 1021, 1020
300 1007, 1008. For more details, please see the technotes-2.1 file.
301 - Fixed a seg fault reported by Frank Sweetser that depended on
302 exact path lengths, but the problem was in bsnprintf.c
303 - Double quoting include filenames (@xxx) in Bacula conf files is now
304 possible, thanks to a patch by Michael Stapelberg.
305 - You can pipe input to include filenames (@|prog) by using a vertical
306 bar, thanks to the above patch.
307 - A daylight savings time bug in the Win32 bsmpt was fixed by a patch from
309 - Marc Cousins submitted a patch that permits building the PostgreSQL
310 driver with version 8.3.
311 - The configure option --archivedir has been changed to --with-archivedir
313 Version 2.2.6 is a minor bug fix release to version 2.2.5
314 - It fixes bugs: #1003, 942, 982, 990(response only), 991,
316 - Fix bat crash wen it cannot connect to Director.
317 - Fix joblist failure bug in bat.
319 Version 2.2.5 is a major bug fix release to version 2.2.4
320 - It fixes the following bugs: #961, 962, 963, 969, 968, 960,
321 964, (possibly 935 and 903), 953, 953, 967, 966, 965, 954,
322 957, 908, 958, and 955.
323 - It also improves listing performance problems in bat pointed
324 out by Chris Howells.
326 Version 2.2.4 is a minor bug fix release to version 2.2.3
327 - Possible fix for authorization problems bug #953.
328 - Possible fix for bug #908.
329 - Add waits to multiple exit detection code to try to force pid
330 file to always be deleted.
331 - Restore good dev.tar.gz to rescue set appropriate binary property.
333 - Fix seg fault in error exit of acquire_for_read after unsuccessfully
334 trying to switch drives by checking for blocking before unblocking.
336 - Cancel storage daemon in all cases where FD reports error. This
337 should fix virtually all cases of bug #920 and will ensure that Devices
338 are released as soon as possible.
339 - Fix error message that was clobbered when Dir tells SD it does not
340 have write permission on Volume. This should fix a minor point
341 in bug #942, but not the main problem.
342 - Fix migration code to get correct Volume name with multiple volumes
343 by skipping |. Fixes bug #936.
344 - Implement patch supplied by Landon to fix bug #944 where using
345 TLS with bconsole uses 99+% of the CPU.
346 - Fix bug #946 about 'bacula-dir -t' which doesn't works
348 - Using 'm' in bconsole will show messages as in prior versions
349 and not memory usage.
351 - Note, you need GTK >= 2.10 to be able to link the Tray Monitor
354 Version 2.2.3 is a critical bug fix release to version 2.2.2
355 - Fix bug #935, and possibly also bug #903 where files were not
356 restored. MediaId was not properly set in JobMedia record after
357 a Volume change. This bug is known to affect all versions from
358 2.0.0 on, and probably versions prior to that. A detailed analysis
359 of the bug can be found at:
361 http://www.bacula.org/downloads/bug-395.txt
363 - Add ./configure search in qwt-qt4 for qwt package
364 - Apply Martin Simmons patch that should turn off the new API usage
365 when batch insert is turned off allowing building on older
367 - Note, you need GTK >= 2.10 to be able to link the Tray Monitor
370 Version 2.2.2 is a minor bug fix release to 2.2.1
371 - Detect if new PosgreSQL batch insert API is present.
372 - Correct incorrect mempool call causing Director crash on older
373 systems that do not have va_copy().
374 - Update spec files for 2.2.1 release
376 Version 2.2.1 is mainly a minor bug fix release to version 2.2.0,
377 the main changes since 2.2.0 are:
378 - Fixed bugs #921, 930, and 923.
379 - More portable timezone offset in bsmtp thaks to Attila Fülöp.
380 - Fix several bat issues.
381 - Use GTK+ calls instead of egg files in tray-monitor.
382 - Win32 service routines rewritten
383 - Updated projects file
384 Please see the ChangeLog for details.
386 Notes on 2.2.0 release follow:
388 Areas requiring caution or testing:
389 - You must have the thread safe version of MySQL client libraries loaded
390 to build with MySQL enabled.
391 - Volumes are pruned only when absolutely necessary -- this may cause
392 your database to grow compared to prior Bacula versions.
393 - Solaris door and even port files are no longer restored (equivalent
394 to what we do with sockets).
395 - SQLite is no longer supported for Solaris -- it fails too often with
396 bus errors. SQLite3 should work on Solaris.
397 - The default setting for SQLite3 is now 'PRAGMA synchronous=OFF'.
398 This makes it run 30 times faster, but increases the possiblity
399 of a corrupted database if your server shuts down unexpectedly.
400 The default behavior can be changed in src/version.h
401 - Restore on Win32, and in particular on Vista is untested. Please
402 test before relying on it. It should backup and restore reparse
404 - Win32 servers are untested, and very likely not to work.
406 The major new features are:
407 - Much faster insertion of attributes (somewhere around 10 times),
408 many thanks to Eric Bollengier and Marc Cousin.
409 - First release of bat (Bacula Administration Tool). Note to build
410 bat you must explicitly enable it on the ./configure line, you
411 must have the Qt4 version 4.2 or later libraries loaded, the qwt
412 (Qt Graphics) package loaded, and qmake and the other Qt4 tools
413 must be available. Most of the implementation was done by Dirk Bartley.
414 - Red/Black restore in memory tree (500 times faster loading).
415 - The Regex Where code to allow easier relocation of restored files
417 - Socket level heartbeat for all connections (untested).
418 - posix_fadvise() use in the FD to improve performance reduces
419 swapping due to opening/reading lots of files. Win32 equivalent
421 - Much improved Volume reservation code that should eliminate most
422 conflicts experienced in multiple drive autochangers.
423 - Simpler locking in the SD in the reservation system.
424 - Detection of file size/date change during backup if enabled.
425 - New Recycle Pool feature -- thanks to Eric.
426 - Efficient implementation of very large include/exclude lists.
427 - Volumes are no longer pruned during 'status dir'
428 - Pruning is now more efficient, and if a Volume is purged,
429 during pruning, it is immediately discovered.
430 - License is now GPL v2 without modifications, fix a few copyright
431 mistakes made when adding FSFE copyright notice.
433 New ./configure options:
434 - --enable-bwx-console
439 - --enable-batch-insert
441 New bconsole commands:
447 - .pwd (in restore tree)
448 - restoreclient (keyword)
449 - backupclient (keyword)
450 - regexwhere (keyword)
451 - update jobid (new command)
452 - recyclepool (keyword)
455 - Heartbeat Interval (bconsole.conf)
456 - Heartbeat Interval (bacula-dir.conf in Director, Client, Storage)
457 - TLS Allowed CN (bacula-dir.conf in Client)
458 - Regex Where (bacula-dir.conf in Job)
459 - Strip Prefix (bacula-dir.conf in Job)
460 - Add Prefix (bacula-dir.conf in Job)
461 - Add Suffex (bacula-dir.conf in Job)
462 - Recycle Pool (bacula-dir.conf in Pool)
463 - FailJobOnError (bacula-dir.conf in RunScript)
464 - CheckFileChanges (bacula-dir.conf in FileSet)
465 - StripPath (bacula-dir.conf in FileSet)
467 Other features or bug fixes:
468 - Fixed bugs: 916, 910, 917, 914, 906, 907,
469 842, 830, 893, 861, 888, 886, 807, 877, 872
470 885, 887, 864, 874, 882, 881, 863, 859,
471 856, 854, 845, 847, 846, 809, 772,
472 822, 825, 824, 808, 802, 797, 798, 795, 789, 791,
473 788, 780, 763, 782, 612, 767, 775, 621, 772, 764,
474 766, 621, 761, 755, 750, 741, 747, 742, 744, and 743.
475 - Configure bat with --enable-bat. Define qwt libraries with
476 --with-qwt=<dir>. See Installation chapter of manual for details.
477 - Create a depkgs-qt package that has both Qt4 and qwt, which are
478 needed to build bat. Most modern Linux systems will have both
479 these packages in the distro.
480 - Storage overrides delete all previous storage definitions instead
482 - One should be able to mount and unmount removable devices if the
483 Device resource has Removeable Media set and the mount and unmount
484 directives are defined.
485 - ./configure will do a better job of searching for qwt libraries.
486 - The Win32 version can no longer be shutdown from the tray monitor.
487 Use the command line or the Services panne.
488 - Keep prune_volumes() from pruning the whole Scratch pool.
489 - More debug output in status storage.
490 - Correct moving a Scratch volume from pool to pool (some
491 critical columns were lost).
492 - Different locking in reservations and despooling systems,
493 which means more micro-locking and less macro-locking, which
494 should give a lot more concurrency at the expense of slightly
495 (<0.1%) more overhead due to more locking/unlocking, but
496 concurrent jobs should run much faster.
497 - Additional drive reservation algorithm that should solve a lot of
498 the problems experienced with multiple drive autochangers.
499 - Storage daemon status command enhanced to more clearly show Volume,
500 pool and media type when a job is waiting.
501 - Made bsmtp work with more strict SMTP servers.
502 - Detect doubly freed buffers in smartall.c
503 - wx-console renamed to bwx-console (Fedora request)
504 - gnome-console renamed to bgnome-console (Fedora request)
505 - Migration preserves original job's FileSetId
506 - Spooling implemented for migration jobs.
507 - Config files can be read through a pipe, by specifying a leading |
508 in front of the configuration path/filename.
509 - New memory command (bconsole) that will print the current Director's
510 memory usage, and an in use buffer dump.
511 - Console name changed from *Console* to -Console- to accomodate Win32
512 filename restrictions.
513 - Corrected the Win32 ftruncate bug.
514 - Additional version information added to Job reports.
515 - New -8 option for bsmtp to specify UTF-8 encoding type.
516 - bsmtp will no longer add < > to target (from, to, cc) if there
517 is already a < in the target.
518 - Prefer Mounted Volumes extended to mean a volume that is being
519 mounted by another job.
520 - Runscript timing set to same as version 1.38.11
521 - New TLS Allowed CN directive(s) permitted.
522 - New bconsole 'exec' command to run external script/command.
523 - Turn on FreeBSD/OpenBSD code to set EOT model on tape.
524 - Drop from root done before database is opened.
525 - Database user and name can be configured with:
526 --with-db-name=name --with-db-user=user
527 - Turn on wait_for_drive in mtx-changer script.
528 - Rework how bar codes are handled in mtx-changer script.
529 This appears to have been an unreported bug.
530 - Updated nagios plugin supplied by Christian Masopust
531 - Better restricted console ACL checking.
532 - New Client Connect Wait directive in Storage daemon so that
533 users can configure how long SD waits for FD connection.
534 - Bacula will no longer permit pruning of the currently running
535 job (note, if other jobs are running, they may be pruned).
536 - Sockets are no longer restored.
537 - dbcheck works in 300K chunks so will typically run faster.
538 - Include/Exclude lists can now be efficiently handled for quite
539 large sizes -- tens of thousands of entries.
540 - Several memory leaks in migration and database usage were fixed.
541 - New console keyword restoreclient, which specifies the client to
542 which the restore will be sent. The client keyword specifies
543 the backup client. The restoreclient keyword is optional if it is
544 not specified, the backup client will also be the restore client.
545 - The disk file size is now checked to ensure that it agrees with the
546 catalog value before Bacula will append to the disk (same as tape