]> git.sur5r.net Git - bacula/docs/blob - docs/home-page/news.txt
Update
[bacula/docs] / docs / home-page / news.txt
1 Kern;;;2007/9/29;;;20:30
2 I have found and fixed a serious data loss bug in Bacula.
3
4 This bug was very elusive and time consuming to track down.  It
5 turned out to be a race condition that can lose the last one or
6 two blocks of a Job, which can happen in rare cases only when
7 running multiple simultaneous jobs when a volume fills and one
8 Job finishes receiving the last data from the FD and at the same
9 time a second job detects the end of the Volume.  The bug was
10 introduced in version 2.0.0 and did not exist in version 1.38.x.
11 If the bug is triggered, the data is lost (not written to the
12 Volume), and it can occur for any backup job of any level under
13 the conditions noted above.
14
15 The bug is reported in the bugs database as bug #964, and just
16 this morning I found and tested a fix, which is attached as a patch
17 to the bug report.  The patch (2.2.4-lost-block.patch) is also
18 uploaded to the bacula-patches 2.2.x release area.  This bug may
19 also be part of the problems reported in bug #935 and possibly
20 #903.
21
22 Also in the bacula-patches 2.2.x area, you will find other
23 patches that fixes bugs #953, 966, 967, 965, 958, 908, and
24 955. Please refer to bugs.bacula.org for the details.
25
26 Though this bug quite serious (data loss), it should be rare.
27 However, we recommend everyone to apply the patch.
28 ;;;
29 Kern;;;2007/9/14;;;14:30 
30 Bacula version 2.2.4 Released 
31
32 This version of Bacula is a minor bug release to version 2.2.3.
33 It contains the following fixes:
34
35 - Possible fix for authorization problems bug #953.
36 - Possible fix for bug #908.
37 - Add waits to multiple exit detection code to try to force pid
38   file to always be deleted.
39 - Restore good dev.tar.gz to rescue set appropriate binary property.
40   This fixes bug #950.
41 - Fix seg fault in error exit of acquire_for_read after unsuccessfully
42   trying to switch drives by checking for blocking before unblocking.
43   Fixes bug #906.
44 - Cancel storage daemon in all cases where FD reports error. This
45   should fix virtually all cases of bug #920 and will ensure that Devices
46   are released as soon as possible.
47 - Fix error message that was clobbered when Dir tells SD it does not
48   have write permission on Volume.  This should fix a minor point
49   in bug #942, but not the main problem.
50 - Fix migration code to get correct Volume name with multiple volumes 
51   by skipping |.  Fixes bug #936.
52 - Implement patch supplied by Landon to fix bug #944 where using
53   TLS with bconsole uses 99+% of the CPU.
54 - Fix bug #946 about "bacula-dir -t" which doesn't works
55   as expected.
56 - Using "m" in bconsole will show messages as in prior versions
57   and not memory usage.
58
59 - Note, you need GTK >= 2.10 to be able to link the Tray Monitor
60   program.
61 ;;;
62 Kern;;;2007/9/9;;;14:30
63 I regret to announce that there is a rather serious bug in Bacula.
64
65 Bacula bug #935 reports that during a restore, a large number of files are 
66 missing and thus not restored.  This is really quite surprising because we 
67 have a fairly extensive regression test suite that explicitly tests for this 
68 kind of problem many times.
69
70 Despite our testing, there is indeed a bug in Bacula that has the following 
71 characteristics:
72
73 1. It happens only when multiple simultaneous Jobs are run (regardless of
74 whether or not data spooling is enabled), and happens only when the
75 Storage daemon is changing from one Volume to another  -- i.e. the
76 backups span multiple volumes, and it only happens for Jobs writing
77 to the same volume.
78
79 2. It has only been observed on disk based backup, but not on tape.
80
81 3. Under the right circumstances (timing), it could and probably does happen
82 on tape backups.
83
84 4. It seems to be timing dependent, and requires multiple clients to
85 reproduce, although under the right circumstances, it should be reproducible
86 with a single client doing multiple simultaneous backups.
87
88 5. Analysis indicates that it happens most often when the clients are slow
89 (e.g. doing Incremental backups).
90
91 6. It has been verified to exist in versions 2.0.x and 2.2.x.
92
93 7. It should also be in version 1.38, but could not be reproduced in testing,
94 perhaps due to timing considerations or the fact that the test FD daemons
95 were version 2.2.2.
96
97 8. The data is correctly stored on the Volume, but incorrect index (JobMedia)
98 records are stored in the database.  (the JobMedia record generated during
99 the Volume change contains the index of the new Volume rather than the
100 previous Volume).  This will be described in more detail below.
101
102 9. You can prevent the problem from occurring by either turning off multiple
103 simultaneous Jobs or by ensuring that while running multiple simultaneous
104 Jobs that those Jobs do not span Volumes.  E.g. you could manually mark
105 Volumes as full when they are sufficiently large.
106
107 10. If you are not running multiple simultaneous Jobs, you will not be
108 affected by this bug.
109
110 11. If you are running multiple simultaneous Jobs to tapes, I believe there is
111 a reasonable probability that this problem could show up when Jobs are split
112 across tapes.
113
114 12. If you are running multiple simultaneous Jobs to disks, I believe there is
115 a high probability that this problem will show up when Jobs are split across
116 disks Volumes.
117
118 13. The bug concerns only the Storage daemon so there is no need to update
119 the clients, though I do recommend updating the Director when installing
120 an updated Storage daemon.
121
122 I have uploaded patches to bug #935 (bugs.bacula.org) that will correct
123 version 2.2.0, 2.2.1, and 2.2.2.  The patch has been tested only on version
124 2.2.2 and passes all regression tests as well as the specific test that
125 reproduced the problem. 
126
127 The patch has now been confirmed to fix the problem reported, and Bacula
128 version 2.2.3 has been released to Source Forge.
129
130 For the technical details of the bug, please see: 
131
132   http://www.bacula.org/downloads/bug-935.txt
133
134 ;;;
135
136 Kern;;;2007/8/11;;;14:30
137
138 Bacula Version 2.2.0 has been released to Source Forge.         
139
140           Release Notes for Bacula 2.2.0 
141
142   Bacula code: Total files = 520 Total lines = 195,550 (*.h *.c *.in)
143   82 new files, 41,221 new lines of code, 208,380 lines of change from 2.0.3
144
145 This Director and Storage daemon must be upgraded at the same time,
146 but they should be compatible with all 2.0.x File daemons, unless you
147 use some of the new features that affect the FD.  In other words, you should
148 not have to upgrade all your File daemons when you upgrade. There is
149 no database upgrade needed from version 2.0.x to 2.2.0.
150
151 Areas requiring caution or testing:
152 - You must have the thread safe version of MySQL client libraries loaded
153   to build with MySQL enabled.
154 - Volumes are pruned only when absolutely necessary -- this may cause
155   your database to grow compared to prior Bacula versions.
156 - Solaris door and even port files are no longer restored (equivalent
157     to what we do with sockets).
158 - SQLite is no longer supported for Solaris -- it fails too often with
159   bus errors.  SQLite3 should work on Solaris.
160 - The default setting for SQLite3 is now 'PRAGMA synchronous=OFF'.
161   This makes it run 30 times faster, but increases the possiblity
162   of a corrupted database if your server shuts down unexpectedly.
163   The default behavior can be changed in src/version.h
164 - Restore on Win32, and in particular on Vista is untested. Please
165   test before relying on it.  It should backup and restore reparse
166   points.
167 - Win32 servers are untested, and very likely not to work.
168
169 The major new features are:
170 - Much faster insertion of attributes (somewhere around 10 times),
171   many thanks to Eric Bollengier and Marc Cousin. 
172 - First release of bat (Bacula Administration Tool).  Note to build
173   bat you must explicitly enable it on the ./configure line, you
174   must have the Qt4 version 4.2 or later libraries loaded, the qwt
175   (Qt Graphics) package loaded, and qmake and the other Qt4 tools 
176   must be available. Most of the implementation was done by Dirk Bartley.
177 - Red/Black restore in memory tree (500 times faster loading).
178 - The Regex Where code to allow easier relocation of restored files 
179   thanks to Eric.
180 - Socket level heartbeat for all connections (untested).
181 - posix_fadvise() use in the FD to improve performance reduces
182   swapping due to opening/reading lots of files. Win32 equivalent
183   implemented.
184 - Much improved Volume reservation code that should eliminate most
185   conflicts experienced in multiple drive autochangers.
186 - Simpler locking in the SD in the reservation system.
187 - Detection of file size/date change during backup if enabled.
188 - New Recycle Pool feature -- thanks to Eric.
189 - Efficient implementation of very large include/exclude lists.
190 - Volumes are no longer pruned during 'status dir'
191 - Pruning is now more efficient, and if a Volume is purged,
192   during pruning, it is immediately discovered.
193 - License is now GPL v2 without modifications, fix a few copyright
194   mistakes made when adding FSFE copyright notice.
195
196 New ./configure options:
197 - --enable-bwx-console    
198 - --enable-bat
199 - --with-qwt=
200 - --with-db-name=
201 - --with-db-user=
202 - --enable-batch-insert
203
204 New bconsole commands:
205 - exec
206 - memory
207 - update recyclepool
208 - .sql
209 - .api
210 - .pwd (in restore tree)
211 - restoreclient (keyword)
212 - backupclient  (keyword)
213 - regexwhere    (keyword)
214 - update jobid  (new command)
215 - recyclepool   (keyword) 
216
217 New directives:
218 - Heartbeat Interval (bconsole.conf)
219 - Heartbeat Interval (bacula-dir.conf in Director, Client, Storage)
220 - TLS Allowed CN     (bacula-dir.conf in Client)
221 - Regex Where        (bacula-dir.conf in Job)
222 - Strip Prefix       (bacula-dir.conf in Job)
223 - Add Prefix         (bacula-dir.conf in Job)
224 - Add Suffex         (bacula-dir.conf in Job)
225 - Recycle Pool       (bacula-dir.conf in Pool)
226 - FailJobOnError     (bacula-dir.conf in RunScript)
227 - CheckFileChanges   (bacula-dir.conf in FileSet)
228 - StripPath          (bacula-dir.conf in FileSet)
229
230 Other features or bug fixes:
231 - Fixed bugs: 916, 910, 917, 914, 906, 907, 
232   842, 830, 893, 861, 888, 886, 807, 877, 872
233   885, 887, 864, 874, 882, 881, 863, 859, 
234   856, 854, 845, 847, 846, 809, 772, 
235   822, 825, 824, 808, 802, 797, 798, 795, 789, 791, 
236   788, 780, 763, 782, 612, 767, 775, 621, 772, 764, 
237   766, 621, 761, 755, 750, 741, 747, 742, 744, and 743.
238 - Configure bat with --enable-bat. Define qwt libraries with
239   --with-qwt=<dir>. See Installation chapter of manual for details.
240 - Create a depkgs-qt package that has both Qt4 and qwt, which are
241   needed to build bat. Most modern Linux systems will have both
242   these packages in the distro.
243 - Storage overrides delete all previous storage definitions instead
244   of prepending.
245 - One should be able to mount and unmount removable devices if the
246   Device resource has Removeable Media set and the mount and unmount
247   directives are defined.
248 - ./configure will do a better job of searching for qwt libraries.
249 - The Win32 version can no longer be shutdown from the tray monitor.
250   Use the command line or the Services panne.
251 - Keep prune_volumes() from pruning the whole Scratch pool.
252 - More debug output in status storage.
253 - Correct moving a Scratch volume from pool to pool (some
254   critical columns were lost).
255 - Different locking in reservations and despooling systems,
256   which means more micro-locking and less macro-locking, which
257   should give a lot more concurrency at the expense of slightly
258   (<0.1%) more overhead due to more locking/unlocking, but     
259   concurrent jobs should run much faster.
260 - Additional drive reservation algorithm that should solve a lot of
261   the problems experienced with multiple drive autochangers.
262 - Storage daemon status command enhanced to more clearly show Volume,
263   pool and media type when a job is waiting.
264 - Made bsmtp work with more strict SMTP servers.
265 - Detect doubly freed buffers in smartall.c
266 - wx-console renamed to bwx-console (Fedora request)
267 - gnome-console renamed to bgnome-console (Fedora request)
268 - Migration preserves original job's FileSetId
269 - Spooling implemented for migration jobs.
270 - Config files can be read through a pipe, by specifying a leading |
271   in front of the configuration path/filename.
272 - New memory command (bconsole) that will print the current Director's
273   memory usage, and an in use buffer dump.
274 - Console name changed from *Console* to -Console- to accomodate Win32
275   filename restrictions.  
276 - Corrected the Win32 ftruncate bug.
277 - Additional version information added to Job reports.
278 - New -8 option for bsmtp to specify UTF-8 encoding type.
279 - bsmtp will no longer add < > to target (from, to, cc) if there
280   is already a < in the target.
281 - Prefer Mounted Volumes extended to mean a volume that is being
282   mounted by another job.
283 - Runscript timing set to same as version 1.38.11
284 - New TLS Allowed CN directive(s) permitted.
285 - New bconsole 'exec' command to run external script/command.
286 - Turn on FreeBSD/OpenBSD code to set EOT model on tape.
287 - Drop from root done before database is opened.
288 - Database user and name can be configured with:
289   --with-db-name=name --with-db-user=user
290 - Turn on wait_for_drive in mtx-changer script.
291 - Rework how bar codes are handled in mtx-changer script.
292   This appears to have been an unreported bug.
293 - Updated nagios plugin supplied by Christian Masopust
294 - Better restricted console ACL checking.
295 - New Client Connect Wait directive in Storage daemon so that
296   users can configure how long SD waits for FD connection.
297 - Bacula will no longer permit pruning of the currently running
298   job (note, if other jobs are running, they may be pruned).
299 - Sockets are no longer restored.
300 - dbcheck works in 300K chunks so will typically run faster.
301 - Include/Exclude lists can now be efficiently handled for quite
302   large sizes -- tens of thousands of entries.
303 - Several memory leaks in migration and database usage were fixed.
304 - New console keyword restoreclient, which specifies the client to
305   which the restore will be sent. The client keyword specifies 
306   the backup client. The restoreclient keyword is optional if it is
307   not specified, the backup client will also be the restore client.
308 - The disk file size is now checked to ensure that it agrees with the
309   catalog value before Bacula will append to the disk (same as tape
310   and DVD).
311
312 ;;;
313
314 Kern;;;2007/3/6;;;14:30
315
316 Bacula Version 2.0.3 has been released to Source Forge.
317 This is a bug fix release to version 2.0.2.  If you are upgrading from
318 a version older than 2.0.0, please be sure to read the important notes
319 below.
320
321 Also, please check the patches directory in the current SVN or the
322 patches release section on Source Forge for important bug fixes to   
323 this version.
324
325 5Mar07
326 kes  File migrate bug with Pool Occupancy using mediaid instead
327      of jobids.  Fixes bug #795.
328 kes  Fix orphaned buffers in filed backup and verify due to
329      crypto buffers not freed during errors.  Fixes bug #789.
330 04Mar07
331 kes  Add smartctl call to bacula-sd.conf as an example of getting
332      tape alert info.
333 02Mar07
334 kes  Add Client Connect Wait to Storage daemon to permit users to
335      modify the time the SD waits for a FD connection.
336 28Feb07 
337 kes  Apply Command ACL filter to JobId list in restore command.
338 kes  Correct typeo in var.c patch.
339 27Feb07
340 kes  Don't let Bacula prune File or Job records for the current Job.
341 kes  Fix variable substitution pad + inc bug reported (with patch)
342      in bug #791.
343 26Feb07
344 kes  Correct SQLite log table index as reported by Luca Berra.
345 24Feb07
346 ebl  Fix FIFO stuff, bacula tries to rewind the FIFO... Thanks to Andreas
347 22Feb07
348 kes  Fix a few places in lib/message.c where the open fd may
349      not be zeroed.
350 21Feb07
351 kes  Add LANG=C to autoconf/randpass so it works with languages other
352      than English.  Fixes bug #788.
353 20Feb07
354 ebl  Revert ClientRunBeforeJob as it was in 1.38.x
355      This fixes bug #780
356      You will not be able to generate Include/Exclude list any more.
357      If you want to use this, you can apply 
358      trunk/bacula/patches/testing/clientrunbeforejob_can_generate_include_exclude_list.patch
359 19Feb07
360 kes  Restore of sockets created false error messages because Bacula
361      no longer restores sockets, but the code was still trying to
362      set the attributes on a non-existent file. Reported by a user.
363 16Feb07
364 kes  Fix encryption deblocking bug, which caused some restored files
365      to be truncated. This fixes bug #763. This is a CRITICAL bug fix.
366 kes  Add FD event sequence order prepared by Eric -- for RunScripts.
367 kes  Fix 12am/pm bug as reported in bug #782.
368 15Feb07
369 kes  Add quick disconnect FD code from 2.1.4 to 2.0.3.  This code
370      causes the SD to release the FD as soon as the FD has sent
371      all the data to the SD. After that the SD will do any final
372      despooling (data and attributes) that are necessary. This
373      allows laptops to disconnect much quicker from the network 
374      after a backup.
375 13Feb07
376 kes  Apply Eric's ClientRunScriptAfter patch to 2.0 and 2.1.
377 11Feb07
378 kes  Optimize the use of the database a bit in the Status dir command.
379      Only open it when needed, ensure that if any previous database
380      was opened, it is closed.
381 10Feb07
382 kes  Modify dbcheck to handle orphaned JobMedia, Path, Filename,
383      and File records in 300K chunks to be more efficient. This
384      idea came from Juan Luis Frances (if I remember right).
385 09Feb07
386 kes  Update projects list.
387 08Feb07
388 kes  Fix dird/ua_cmds.c so that a cancel command checks if the
389      console is authorized to cancel the job.  This fixes bug 
390      #767.
391 kes  Modify SD so that the VolCatJobs medium record is updated
392      at the beginning of a Job rather than the end.  This
393      fixes bug #775 where exceeding MaxVolJobs caused jobs
394      to fail.
395 kes  Added a mutex around getting and setting Volume information
396      so that multiple simultaneous jobs will single thread.
397 07Feb07
398      Switch to using Subversion
399 kes  Remove src/pygtk-console/ from configure
400 06Feb07
401 kes  Delete src/lib/btree.c from win32 build, then add rblist.c
402      plus the entrypoints.
403 kes  Apply patch supplied that corrects debug print
404      in canceling jobs for max run time.  Supplied as
405      part of bug #621, which was previously fixed.
406 05Feb07
407 kes  Test on job_canceled() and sd_msg_thread_done inside
408      loop starting the message thread to avoid a race condition.
409      Fixes bug #771.
410 kes  Remove rl_catch_signal from console.c as it conflicted
411      with the header definition. Fixes bug #765.
412 ebl  Fixes bug #766 about RunsOnClient = Yes (case sensitive)
413 04Feb07
414 kes  Clarify some stored/acquire messages to indicate if the
415      problem is with read or append.
416 02Feb07
417 kes  Fix memory leak with storage ids in cats/sql_get.c
418 kes  Terminate watchdog earlier to avoid reference to released
419      memory -- reported by Jason Austin.
420 kes  Move closing the database from jobq.c to the director daemon
421      termination routine. This fixes memory leaks for shadow jobs
422      (i.e. migration jobs).
423 kes  Free up the unique jobid chain items in migrate.c.  This fixes
424      a memory leak problem.
425 kes  Convert some ugly looking for statements to use foreach_alist
426      in findlib/find.c.  This will facilitate converting the structures
427      to use dlist (for large include/exclude lists).
428 kes  Fix a bug in the btree.c and btree.h routines, then rename them
429      rblist and add them to be built in src/lib.  Include some new
430      methods written by Rudolf Cejka that make the code more readable
431      (hides some of the ugly casting).
432 26Jan07 (back port)
433 kes  Implement item #12 on project list -- quick release of FD by
434      the SD. This is noted in more detail above.
435
436 ;;;
437
438 Kern;;;2007/1/28;;;14:30
439
440 Bacula Version 2.0.2 released:
441 28Jan08
442 kes  Fix maxruntime bug #621.
443 27Jan07
444 kes  Get current main CVS .specs for RedHat, SuSE, Mandrake.
445 26Jan07
446 ebl  Implement the include JobID in spool file name project.
447 kes  Reorder projects file in order determined by Jan 2007 vote.
448 kes  Fix open of SQLite3 db where user does not have write permission
449      so that DIR does not crash. Fixes bug #761.
450 25Jan07
451 kes  Change 'Device not configured to autolabel' from INFO
452      to WARNING.
453 kes  Fix jobq.c to restart failed jobs when Reschedule Times = 0
454      which should restart an indefinite # of times.
455 kes  Fix configure --help to print --with-mysql[=DIR]. Same for
456      other DIR specifications.
457 23Jan07
458 rn   Fix msvc build problems. Fix bacula.dll exports for msvc build.
459      Fix path quoting in SQLite scripts.
460      Fix problems with SHGetFolderPath.
461 19Jan07
462 kes  Create patches/2.0.1-restart.patch. Fixes bug #755.
463 18Jan07
464 kes  Fix Job restart on error bug that promotes an Inc to a Full
465      backup.  This should fix bug #755.
466 kes  Add qt-console and first cut of code.
467
468 ;;;
469
470 Kern;;;2007/1/13;;;14:30
471
472 Bacula Version 2.0.1 has been released to Source Forge.
473 This is bug fix update to version 2.0.0 and contains
474 the following fixes:
475
476 -    Fix Bacula->Documentation link on Win32 to point to index.html
477      instead of bacula.html. Fixed bug #750.
478 -    Return JobId in db_get_job_record() when JobId==0. This should
479      fix bug #741.
480 -    Do not release source pointers when restarting a failed job.
481 -    Add dynamic dll entry point for SHGetFolderPath to Win32 code.
482      This *should* fix bug #747.
483 -    Modify winbacula.nsi to substitute with g bin_dir_cmd. Should fix
484      bug #742.
485 -    Modify USTORE constructor to set an empty store_source string, 
486      and don't copy the store_source string in a cancel.  Hopefully
487      this will fix Arno's seg fault, bug #744.
488 -    Add back code to disable conio in configure. Fixes bug #743.
489 -    Correct the Options scanner in the FD to correctly handle  
490      SHA1 option, which was eating the next option.  Reported by    
491      Sebastien Guilbaud.
492 -    Add code to indicate when the SD is spooling, spool wait, and 
493      despooling as requested by Alan Brown.
494
495 ;;;
496
497 Kern;;;2007/1/4;;;14:30
498
499 Bacula Version 2.0.0 has been released to Source Forge.
500
501 There is an English Press Kit, written by Dan Langille at:
502    
503    http://www.bacula.org/about/press/presskit200.html.en
504
505 and a German version, translated by Arno Lehmann at:
506
507    http://www.bacula.org/about/press/presskit200.html.de
508
509 ;;;
510    
511 Kern;;;2007/1/4;;;14:31
512
513           Release Notes for Bacula 2.0.0
514
515   Bacula code: Total files = 438 Total lines = 154,329 (*.h *.c *.in)
516
517 ==== IMPORTANT Catalog update required =====
518 - The database format has been updated from what was used in    
519   Bacula 1.38.x.  You must manually update your database before 
520   running Bacula 1.39.x or higher.  If you are using Bacula supplied
521   RPMs this is not necessary as the RPM does it automatically.
522   Please backup your previous version of the database before
523   running the update.  The update script will be automatically
524   installed in your scripts directory, or can also be found in
525   <bacula-source>/src/cats.  It is called:
526
527      ./update_bacula_tables
528
529   It is necessary to run it only once the first time you move to
530   a 2.0.0.  Upgrading the Bacula version thereafter does not
531   require updating the database again.  Depending on the size of
532   your database the script make take a bit of time, to run, but
533   in general, it should be very fast.
534
535 ==== IMPORTANT new Win32 install procedure =====
536   For Win32 migrations from versions prior to 1.39.0 nothing special
537   needs to be done to upgrade.  Everything should be taken care of
538   automatically.  The only thing not done is to delete the old C:\bacula
539   directory mostly out of paranoia.
540
541 ==== IMPORTANT miscellaneous ====
542 - The Gnome console program (gconsole) no longer functions as it
543   should.More importantly, in restore mode, the restore tree is
544   no longer shown in the left pane.  I suspect this is due to
545   incompatible changes in the GTK+ API, and hence have given up
546   on gnome and gtk+, as this has already happened several times
547   previously.  At some point there will be a new GUI console.
548 - The bacula-dir.conf directive Accept Any Volume has been
549   removed because it was never implemented. You must delete all
550   occurrence of this directive for the Director to run. The Storage
551   daemon will automatically accept any valid Volume that you mount.
552 - The --mandir ./configure option now points to the top level man
553   directory.  The man files will be installed under mandir/man8 and
554   mandir/man1 as appropriate.
555 - You *should* be able to use 1.38.x FDs with version 2.0.0 Director
556   and SD providing you do not use any of the new features (runscript,   
557   data encryption). It seems to work here, but we do not guarantee it.
558 - Your Director and SD must be simultaneously upgraded.
559 - The restore command no longer uses the MediaType as the primary method
560   of finding a suitable Storage device. Normally it will select the last
561   device used to write a Volume. If no storage device is defined, it
562   will use the old algorithm which selects the first Storage resource  
563   with the correct MediaType.
564 - The MD5/SHA1 hash codes kept in the database are now kept in a binary
565   format compatible with the rest of the world. If you are running verify 
566   jobs, you *must* do an InitCatalog or all files will show an MD5   
567   difference.  Also, authentication uses the new algorithm by
568   default, but *should* accept connections from older components (FD) using
569   the old non-compatible algorithm. This has been tested, but more
570   more testing is still needed.  
571 - A stock SuSE 10.1 kernel may crash when Bacula runs and accesses
572   the tape drive. Workaround, load the SuSE 10.1 version 2.6.16.21-0.25
573   kernel or later. The SuSE 10.2 Alpha 5 or later kernel also works.
574   This problem may also be present in certain Fedora FC5 kernels.
575 - If you have been using the data encryption feature of 1.39.x, please
576   be aware that certain combinations of encryption and other options
577   with version 1.39.0 through 1.39.26 created Volume data that cannot
578   be restored. We strongly recommend that anyone using encryption 
579   carefully review his/her backups and at a minium do a Full backup
580   with 1.39.28 of all encrypted data.  Robert Nelson has identified 
581   and fixed it as follows:
582      As of 1.39.27:
583         No filters = Works fine
584         Sparse = Works fine
585         Compression = Works fine
586         Encryption = Works fine
587         Sparse + Compression = Works fine
588
589         Sparse + Encryption = Restore broken
590         Sparse + Compression + Encryption = Restore broken
591         Compression + Encryption = Restore broken
592
593      As of 1.39.28:
594         Most combinations work, but some encrypted files are
595         not properly restored.
596
597      As of 1.39.30:
598         All combinations work fine except Sparse+Encryption.
599
600   Bottom line, if you are using data encryption, please test restoring
601   data to be sure it all works correctly.
602 - The current Volume format written by 1.39.22 is different from
603   the format written by previous versions. The two formats
604   are not compatible. Thus any DVDs written prior to 1.39.22 will
605   be unreadable by version 1.39.22.
606 - If you previously run a Bacula version prior to 1.39.30, the JobMedia
607   data may not be correct for disk Volumes. This can cause incorrect
608   seeking in versions after 1.39.30. If you experience what appears to
609   be data I/O or integrity errors during restores, please add the
610   following directive to your disk DEVICE resource in the Storage
611   daemon conf file:
612
613     Block Positioning = no
614
615   This will turn off all seek requests during restores and avoid
616   this problem.
617 - VSS for Windows clients is now enabled by default.
618 - Do not unload autochanger when doing "update slots"
619 - Implement mount command for autochanger, see manual.
620
621 New Features in 2.0.0:
622 - Turn on disk seek code for restores.
623 - There is a partial but reasonable translation of the Bacula
624   messages for French.  To install it, first configure and build
625   Bacula, then as root run:
626
627     cd <bacula-source>/po
628     make install
629
630   If you have your locale set properly you will get the translated
631   messages.
632 - Bacula now support Migration jobs that are documented in a new
633   Migration chapter in the manual
634   http://www.bacula.org/dev-manual/Migration.html
635 - Data encryption is now implemented and is documented in
636   a new chapter of the manual at:
637   http://www.bacula.org/dev-manual/Bacula_Data_Encryption.html
638 - Additional support for removable devices.  See the 
639   Requires Mount, Mount Point, Mount Command, and Unmount
640   Commands in the Storage daemon configuration chapter:
641   http://www.bacula.org/dev-manual/Storage_Daemon_Configuratio.html
642   Also see the Edit Codes for Mount and Unmount Directives in the
643   same chapter.
644 - Switch the Win32 build from using Microsoft C++ to using mingw32
645   cross-compiling.  The initial work was done by Howard Thomson,
646   then tweaked by me.  Robert Nelson then totally reworked the
647   cross-compiling code so that it not only cross-compiles, but
648   also compiles on Visual Studio, and at the same time, he added
649   all the current Unix features to the FD, such as selection on
650   drives, encryption support, building *all* the tools, ...
651 - The Director and Storage daemon have now been ported to Win32.
652   This code is working but should still be tested carefully
653   before putting into production.
654 - Bacula restore and bextract can now extract non-portable Win32 data to
655   any client (including Unix/Linux clients). Of course, in doing so,
656   the Microsoft specific permissions and ACLs will be lost.  Thanks
657   to Thorsten Engel for this code.
658 - The 260 character limitation for Win32 paths name lengths is now 
659   eliminated thanks to Thorsten Engel. However, if you are using
660   Volume Shadow Copy, please be careful to specify all the paths
661   in the bacula-fd.conf file using a full path notation including
662   the drive letter.
663 - Eric Bollengier wrote new RunScript directives that includes
664   the old RunBefore/AfterJob and ClientRunBefore/AfterJob features
665   plus a *lot* more, allowing you to control just about every aspect
666   of running scripts.  See the manual for detailed documentation.
667   http://www.bacula.org/dev-manual/Configuring_Director.html#5227
668 - SunOS ACLs should now work thanks to a patch from David Duchscher.
669 - Apply days keyword patch from Alexander.Bergolth at wu-wien.ac.at
670   If this patch is applied, the number of days can be specified with
671   "list nextvol days=xx"
672   or
673   "status dir days=xx"
674   This can be used to preview the next scheduled job (and the
675   next tape to be used) on Fridays if there are no scheduled jobs during
676   the weekend.
677 - From Eric Bollengier. One can now using the bconsole wait command do:
678    wait  (wait for all jobs to stop)
679    wait jobid=nn
680    wait jobuid=unique id
681    wait job=job-name
682 - Volumes can now be set to Enable, Disable, or Archive. If they
683   are not enabled, Volumes will not be mounted.             
684   Implement update volume enable=(on|off|true|false|archived|0|1|2)
685 - Add Catalog message destination in Messages resource that puts the
686   job report in the Log database table.
687 - Writing/reading DVD Volumes is much more stable -- to the point
688   of being useful. Thanks to Richard Mortimer.
689 - Add enable/disable job=<job-name>.  This command prevents
690   the specified job from being scheduled. Even when disabled,
691   the job can be manually started from the console.
692 - The database Id records should be 32/64 bit independent now. 64 bits
693   can be enabled by changing one define and changing the appropriate
694   table variable. Normally, you need 64 bits only for FileId.
695 - Relative path specifications (i.e. ../xxx) are now permitted in
696   the restore cd command.
697 - When running multiple simultaneous jobs, most jobs that use spooling
698   will now finish faster due to a mutex optimization made by Eric
699   Bollengier.
700 - Conf files containing UTF-8 marker at the head of the file as well as
701   conf files containing Window cr/lf and Mac cr line termination characters 
702   are now accepted thanks to Robert Nelson.
703 - Windows tray status windows are scrollable and resizable.
704 - Win32 external script execution is much more flexible -- handles
705   spaces in names better, ...
706 - Lots of DVD fixes -- writing DVDs is now reported to work.
707 - Fix opening of database in a restricted console to respect     
708   any Catalog ACL.
709 - Much better automatic handling of multiple database catalogs in
710   the restore command.
711 - Permit multiple console/director resources in bconsole.conf.
712   patch from Carsten Paeth calle@calle.in-berlin.de
713 - Character substitution in Job/JobDefs WriteBootStrap.
714   from Eric Bollengier.
715 - Apply patch supplied in bug #656 to pass priority field
716   in the run dialog to the Director in gnome console.
717 - Add support of encrypted data stream to bscan from Eric.
718   display data_len instead of data content (may be binary).
719 - Add Enabled=xxx on update slots command.
720 - Add host:port to connect failure messages to FD and SD from Dir/
721 - Add WhereACL to console ACL list.  If nothing is specified, only
722   the default is permitted for restore. Otherwise, *all* allows any
723   path, or you can specify permitted paths. This should allow control
724   over where users can restore files. This is untested.
725 - Install man pages with 'make install'.
726 - Add Media.Enabled flag to client backups for dotcmds.c
727 - Enforce Media.Enabled=1 for a current restore to work
728 - Require restore case 3 to have sqlquery permission to work.
729 - Add -n option to bconsole to turn off conio -- used in bweb.
730 - The bytes field in the terminated jobs part of the status
731   command now reports in KB, MB, ... units.
732 - When not descending into a directory, print the File= name that
733   triggered it -- makes why not descending a bit clearer
734 - Do not unload autochanger when doing "update slots"
735 - Implement mount command for autochanger
736 - Fix bug #462 incorrect error message printed when client script called
737   from File= was not found.
738 - Fix bug #558 (waiting for feedback) where Bacula needs too much time to
739   do a rewind on Solaris when no tape is in the drive (Solaris does not
740   have the detailed errno found on Linux).  Added Solaris specific code.
741   Note, this may apply to other OSes as well.
742 - The examples directory has a new bacula_mail_summary.sh file that
743   creates a single email summary of any number of jobs. Submitted by
744   Andrew J. Millar.
745 - Add nagios plugin to the examples directory. Submitted by
746   Christian Masopust.
747 - Modify most restore error messages to be queued so that they
748   appear at the end of the job rather than mixed with the restore
749   listing where they could be "lost".
750 - Apply patch supplied by user (slightly modified) to fix
751   correct detection of holes in block devices and FIFOs.
752   Bug # 506.
753 - Added a report.pl program to the examples directory from Jonas Bjorklund.
754 - Add two new queries to query.sql provided by Arno. One
755   list volumes known to the Storage device, and the other
756   lists volumes possibly needing replacement (error, ...).
757 - Implement new code for changing userid and group at startup. This
758   should get Bacula into the correct groups.
759 - Implement support for removable filesystems -- device type directive
760   and mount, unmount directives.
761 - Transfer rates are now presented in a more readable format thanks
762   to a user submission.
763 - SD is now aware of what volumes are mounted. More information is printed
764   in the Status report. You must take much more care now to unmount
765   devices prior to removing tapes that Bacula has open or prior to
766   changing a magazine. Don't forget to do a mount afterwards or the
767   device will be blocked.
768 - The Pool Maximum Volumes directive is now respected in all places.
769 - A Storage device can now be specified in a Pool resource. It will override
770   all other Storage specifications.
771 - Most but not all directives accept true/false in place of yes/no.
772 - A patch from Karl Hakimian that reads JobIds, FileIndexes
773   from a database table for restore.
774 - There are a number of new tables. Some such as the Location table are
775   designed for user use in doing Volume Management software.
776 - Maximum Changer Wait, Maximum Open Wait, Maximum Rewind Wait to
777   accept time qualifiers.
778 - Implement jobuid to replace old usage of job in keywords as
779   suggested by Eric Bollengier.
780 - Implement write variables for Python to set Priority (anytime), and
781   Job Level, only during JobInit event.
782 - Use the keyword ujobid to mean the unique job id; job or jobname
783   to mean the Job name given on the Name directive, and jobid to
784   be the numeric (non-unique) job id.
785 - Allow the SD to use multiple drives during a backup/restore (only
786   one at a time).
787 - Integrate addition of line count limitation to bsmtp -l from
788   Sebastian Stark <stark at tuebingen.mpg.de>
789 - Split the bacula start/start script into four files:
790    bacula         -- starts and stops calling other scripts
791    bacula-ctl-dir -- starts/stops the director
792    bacula-ctl-fd  -- starts/stops the File daemon
793    bacula-ctl-sd  -- starts/stops the Storage daemon
794 - Remove automatic case folding on Windows FDs. You must
795   explicitly use the 'Ignore Case = yes' option.
796 - Implement wild program in tools directory for testing
797   wild-cards. Almost identical to the regex program.
798 - Use the new bregex.c to implement Regex expressions on Win32.
799 - Apply patch from Christopher Hull
800   - Allow multiple connections to database with different
801     parameters.
802   - Invalidate the scheduler when doing a reload. Fixes seg
803     fault, but still 60 second window.
804   - Additional info in Reschedule message.
805   - Use set_jcr_job_status() everywhere to prevent loss of
806     cancel, error.
807   - Display peer IP in FD if error from connecting DIR.
808   - Don't increment file count for DIRBEGIN.
809   - Replace illegal characters in Win32 filename by _.
810   - Add SE_CREATE_PERMANENT_NAME privilege in Win32.
811   - Hash hard link filenames rather than linked list (performance).
812   - Fix for security failure in chdir on Win32.
813   - Add CreateDirectoryA/W win32 API entry points.
814 - programs to duplicate Bacula's base64 algorithm using standard
815   routines. This fixes bugs #296, and 565. Patch submitted by
816   author of bug #565.
817 - Fixes to reloading the Dir conf file from Eric Bollengier and Christopher
818   Hull.
819 - Modify LICENSE to correct some problems pointed out by Debian.
820 - Apply a patch submitted by cesarb in bug #606 to implement O_NOATIME support.
821     O_NOATIME is a open() flag which makes it possible to read a file without
822     updating the inode atime (and also without the inode ctime update which
823     happens if you try to set the atime back to its previous value). It also
824     prevents a race condition when two programs are reading the same file, but
825     only one does not want to change the atime. It's most useful for backup
826     programs and file integrity checkers (and bacula can fit on both
827     categories).                                                    
828   You enable it in the Bacula FileSet Options resource by setting:
829      noatime = yes
830   The effect of this option is similar to the keepatime option except
831   it is more efficient and avoids modifying ctime.
832 - Implement a pile of new man pages contributed by Jose Tallon.
833 - Modify the database format for handling Migration jobs:
834    Add PriorJobId, RealEndTime to Job table
835    Delete MAC table
836    Remove Stripe from JobMedia record (not used, wasting space)
837    Add ScratchPoolId, RecyclePoolId, Enabled to Media record
838    Add Cost to Location table.
839    Enabled to Media table and Location table.
840 - Security: harden authentication failure in FD by single threading errors
841   and forcing a 6 second wait.
842 - If using GCC (actually g++) add the following compiler flags
843   -fno-strict-aliasing -fno-exceptions -fno-rtti
844 - Turn on new bsnprintf() code.  The reason for this code is to
845   eliminate the security problems associated with using the
846   system libraries print routines.
847 - Implement job report that indicates where Storage and Pool
848   came from -- with overrides and Pool storage and NextPool,
849   it is all very complicated.
850 - Add more detail (Storage, Device) to list of volumes printed
851   for restore.
852 - Add new VOLMGMT message class. No messages are yet sent with this 
853   class.
854 - Improved Bacula rescue procedures -- see the Disaster Recovery
855   chapter of the manual
856 - Add spooling/despooling info in status output of SD.
857 - Add Comment field to llist of a volume.
858 - Allow true/false in many but not all yes/no directives.
859 - The Bacula source code is now copyrighted by the Free Software 
860   Foundation Europe. The Developer's Guide documents the new procedures,
861   and the LICENSE file has been updated.
862 - Apply Jaime Ventura's patch that implements the Messages resource
863   Mail On Success directive.
864 - The Client returns its Version string, which is printed in the Job
865   report.
866 - The Client returns whether or not VSS and Encryption are used, which
867   are printed in the Job report.
868
869 Additional Features Added for Win32:
870 - Added DriveType directive to the Director's Include Option FileSet
871   resource.  Allowed values are: fixed, removable, cdrom, and remote.  There
872   is only an implementation for Windows because it is the only platform that
873   has the concept of drives.
874  
875 - Adds EnhancedWild directive to the Director's Include Option FileSet
876   resource.  Allowed values are: yes and no.
877  
878   When EnhancedWild is enabled then the processing of the
879   Wild, WildDir and WildFile is changed in the following ways.
880  
881   Patterns conform to Posix
882       \ is not a special character in character classification []
883       To match a - it must be the first or last character
884       To match a ] it must be the first character
885  
886       fnmatch option FNM_FILE_NAME is specified * doesn't match a / 
887       so it won't match multiple directory levels in a path
888  
889 - Relative WildFile patterns (ones without a leading /) match
890   against the filename portion.  This in combination with the
891   FNM_FILE_NAME fnmatch() flag makes directives such as WildFile =
892   abc*.def work as expected.
893  
894 - Adds support for the shell's feature of brace expansion.
895
896   Here is an example where braces allow 24 lines to be expressed in 5.
897
898   # Exclude directories full of lots and lots of useless little files
899   WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/Cookies"
900   WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/Recent"
901   WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local Settings,LOCALS~1}/History"
902   WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local Settings,LOCALS~1}/Temp"
903   WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local Settings,LOCALS~1}/Temporary Internet Files"
904
905 ;;;