]> git.sur5r.net Git - bacula/docs/blob - docs/home-page/en/news.txt
b6773e56747923a650011149b671789e1908f8e1
[bacula/docs] / docs / home-page / en / news.txt
1 Kern;;;30 October 2010 at 14:50 CET
2 We have released Bacula Version 5.2.1 to Source Forge
3
4
5                Release Notes for Bacula 5.2.1
6
7   Bacula code: Total files = 1,110 Total lines = 231,439 (Using SLOCCount)
8
9 General:
10 --------
11
12 This 5.2.1 version is a major release since the last version 5.0.3.
13 It includes well over 299,387 lines of changes made by 20 contributors,
14 lots of bug fixes (see below), 1,851 software commits,and a 
15 number of important new features:
16
17 Version 5.2.0
18 -------------
19 Version 5.2.0 was short lived, because Marco (thanks) found
20 a number of last minute bugs. So the first official release of 5.2
21 is 5.2.1.
22
23 Compatibility:
24 --------------
25  As always, both the Director and Storage daemon must be upgraded at
26  the same time.
27
28  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.1
29  Director and Storage daemons. There should be no need to upgrade older File
30  Daemons.
31
32 Main New Features:
33 ------------------
34 - LZO Compression
35 - New Tray Monitor
36 - Purge Migration Job
37 - Changes in Bvfs (Bacula Virtual FileSystem)
38 - Changes in the Pruning Algorithm
39 - Ability to Verify any specified Job
40 - Additions to RunScript variables
41 - Additions to the Plugin API
42 - ACL enhancements
43 - XATTR enhancements
44 - Class Based Database Backend Drivers
45 - Hash List Enhancements
46
47 Some of the above are described below; all the above are
48 described in more detail in the New Features chapter of the
49 manual.
50
51 Closed Bugs since 5.0.3:
52 ---------------------
53 1389 1444 1448 1466 1467 1468 1476 1481 1486 1488 1493 1494 1497 1499 1501
54 1502 1504 1509 1511 1513 1516 1524 1526 1527 1532 1536 1538 1541 1542 1549
55 1551 1553 1554 1558 1559 1560 1564 1567 1568 1569 1571 1574 1577 1581 1582
56 1584 1587 1594 1595 1600 1601 1602 1603 1604 1606 1608 1610 1612 1623 1624
57 1633 1643 1648 1655 1661 1664 1666 1669 1672 1675 1684 1685 1695 1696 1699
58 1700 1703 1735 1741 1749 1751 1761 1762 1764 1768 1770 1771 2710
59
60
61 ================== Warning !!!!!! ==========================
62
63  The new pruning algorithm will not allow pruning of jobs that are essential to
64  restore since the last Full backup. This is, of course, correct and desirable,
65  but it is different from older Bacula versions that could inappropriately
66  prune jobs. Pruning of volumes is not affected.
67
68 Building Bat:
69 -------------
70 To build Bat, you need Qt4 version 4.6.2.  If you build with any other
71 version it is likely not to work.  If you do not have version 4.6.2, on
72 your system, you can download the Bacula depkgs_qt version 16Dec10.
73
74 Packaging the SQL backend:
75 --------------------------
76 The main Bacula Director code is independent of the SQL backend
77 in this version. This means that the Bacula Director can be packaged
78 by itself, then each of the different SQL backends supported can
79 be packaged separately.  It is possible to build all the DB backends
80 at the same time.
81
82 - configure can be run with multiple database configure options.
83    --with-sqlite3
84    --with-mysql
85    --with-postgresql
86
87 Order of testing for database is
88 - postgresql
89 - mysql
90 - sqlite3
91
92 Each configured backend generates a libbaccats-<backend_name>-<version>.so
93 A dummy catalog library is created named libbaccats-version.so
94
95 At configure time the first detected backend is used as the so called default
96 backend and at install time the dummy libbaccats-<version>.so is replaced with
97 the default backend type.
98
99 If you configure all 3 backends you get 3 backend libraries and the postgresql
100 gets installed as the default.  When you want to switch the default you can
101 copy one of the 3 backend libraries over the libbaccats-<version>.so e.g.
102
103 cp libbaccats-postgresql-<version>.so libbaccats-<version>.so
104
105 And update the default backend in the following files:
106
107 create_bacula_database
108 drop_bacula_database
109 drop_bacula_tables
110 grant_bacula_privileges
111 make_bacula_tables
112 make_catalog_backup
113 update_bacula_tables 
114
115 New Catalog format in version 5.2.0 and greater
116 -----------------------------------------------
117 This release of Bacula uses a new catalog format. We provide a set of
118 scripts that permit to convert a 5.0.x (version 12) catalog to 5.2.1 (version
119 14).  The Bacula project rpm spec files have been modified to
120 detect the database change and do the upgrade for you.  We strongly
121 recommend that you save a copy of your existing database before upgrading
122 using rpms.
123
124 The simplest way to upgrade the database assuming you are building from
125 source (i.e. manually):
126 1. Stop any current version of Bacula from running.
127 2. Save a copy of your existing database.
128 3. Configure, build, and install the 5.2.1 version of Bacula
129    Note the new ./configure options in the manuals see the link
130    at the bottom of this file.
131 4. cd <your-scripts-installation-directory>
132 5. ./update_bacula_tables
133 6. If you have multiple catalogs, edit the update_bacula_tables
134    script and put the name of another database, and then
135    execute the script again. Repeat this until all Bacula
136    catalogs have been updated.
137 7. Start the new Bacula.  If everything worked, it should
138    not print any error messages.
139
140 If you start from scratch, you don't need to run the update_bacula_tables
141 script because the create_bacula_tables script automatically creates the new
142 table format.  However, if you are using a version of Bacula older than 5.0.0
143 (e.g.  3.0.3) then you need to run the update_bacula_tables script that will
144 be found in the <bacula>/src/cats directory after you run the ./configure
145 command.  As mentioned above, before running this script, please backup your
146 catalog database, and when you do running it, be sure shutdown Bacula and be
147 aware that running the script can take some time depending on your database
148 size.
149
150 ================================================================
151
152 Changes:
153
154 Speed and Memory Usage Enhancements:
155 - Implement LZO compression algorithm (need lzo2 headers to activate this option)
156 - New Pruning algoritm -- safer and faster
157 - Use of PostgreSQL cursor when doing large queries, should reduce the
158   memory usage during restore and accurate backups.
159 - limit command in some list commands
160 - Bacula Virtual File System for fast catalog access
161 - Faster crc32 algorithm
162
163 Security Enhancements:
164 - Additional security against injection of illegal characters
165 - Fix possible fnmatch problem
166
167 Features Enhancements:
168 - Improvements in ACL and xattr handling on additional platforms:
169   AIX, Darwind, FreeBSD, HPUX, IRIX, Solaris, Tru64
170 - Tray monitor for Windows
171 - New SQL backend and ./configure that permits building multiple catalog
172   backends in one build, and has the main Bacula core code totally independent
173   of the SQL backend, which should simplify packaging (only the
174   libbacsql.so/dll needs to be changed to switch from one database backend
175   to another (e.g. MySQL to PostgreSQL).
176 - Indent lsmark during restore
177 - Disable batch insert config item
178 - Director selection option in bconsole
179 - restorejob command in bconsole
180 - Many additional features for bat such as "brestore" panel
181 - The old bat version browser has been turned off since it does not
182   work correctly and the brestore panel provides the same functionality
183 - Improved hash table for hard links
184 - Additional script variable editing such as %b (JobBytes), %F (JobFiles) 
185   and %h (Client Address)
186
187 Other Enhancements:
188 - Includes better handling for Windows repares points, mount points, and 
189   junction points.
190 - New database format
191 - Many new plugin API features
192 - Improved memory handling for restores
193 - Significant stability enhancements to bat
194 - xattr/ACL restore failure are now printed as Warning
195 - A few path name length limits in Windows have been removed.
196
197
198 ===========================================================================
199 ;;;;
200 Kern;;;06 August 2010 at 19:15 CET
201 We have released Bacula Version 5.0.3 to Source Forge
202
203 This 5.0.3 version is significant bug fix update to version 5.0.2.
204 It includes new code and some new features.
205 There is no database change since prior versions of 5.0.
206
207 Note, if you are running 5.0.0, read the 5.0.1 and 5.0.2 release notes below in
208   the 5.0.1 release section.
209   Important!!!
210
211 Compatibility:
212 --------------
213  As always, both the Director and Storage daemon must be upgraded at
214  the same time.
215
216  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.0.3
217  Director and Storage daemons. There should be no need to upgrade older File
218  Daemons.
219
220 Changes and New Features:
221 - If a VSS (Windows) snapshot fails, the whole Job is failed, previously
222   it printed a warning message and continued.
223 - New editing codes %b = Job Bytes and %f = Job Files for runscripts
224 - Any non-Bacula project plugins (i.e. third party plugins) 
225   must be upgraded to specify AGPLv3 in place of the GPLv2 used previously 
226   for the PLUGIN_LICENSE.
227 - The bat Media page text columns can be sorted by clicking on the column.
228 - If possible, the SD will automatically update the catalog Volume size if 
229   it does not match the Volume size. The mismatch between the Volume sizes
230   typically occurs when the FD has a comm line drop or the FD crashes.
231
232
233 Bug fixes
234 1538 1554 1564 1567 1568 1569 1571 1577 1581 1582 1587 1594 1595 1606 1610
235
236 - Change license from GPLv2 to AGPLv3
237 - Make Win32 no filesystem change more explicit
238 - Backport Branch-4.0 release to Branch-5.0
239 - Massive backport from Branch-5.1 to Branch-5.0
240 - Fix postgresql catalog creation when version is not on the first line
241 - Fix bug #1610 handle empty xattr values on Linux and xBSD.
242 - Garbage collect memory pool at end of job and before sm_dump
243 - Add xattr seg fault protection suggested by Marco for bug #1610
244 - Add archlinux to os.m4
245 - More fixes for 32/64 bit problems in smartall
246 - Fix 32/64 bit problem in smartalloc dump routine
247 - Fix bad copy/paste in commit c88dccb88 prably a seg fault
248 - Add .dump and .exit commands for daemons
249 - Make SD automatically fix the Volume size in the Catalog when out of sync
250 - Use Pmsg in smartall.c rather than printf for tracing Windows
251 - Up maximum block size to 20M
252 - Fix for TLS bugs #1568 and #1599
253 - Improve comm line error handling for TLS, may fix bug #1568 and #1599
254 - Fix problem when sending Cancel event to plugin
255 - Convert all Jmsg on the watchdog thread to Qmsg
256 - Fix SD crash due to mismatched lock/unlock in error condition
257 - Fix bug #1587 if you have clients with different catalogs configured, both 
258   catalogs contains all clients after a reload or restart of the dir
259 - Fix bug #1577 During migration: ERROR in block.c:950 Failed ASSERT: dev->is_open() 
260   by moving and commenting out the ASSERT()
261 - Skip HB kill in FD if HB thread terminated
262 - Fix crash from unequal volume_lock/unlock calls
263 - New prunning algorithm -- should be more accurate
264 - Save any dumps during regression to dumps directory
265 - Fix crash from rw_lock/unlock miss match
266 - Attempt to fix duplicate job kill seg fault
267 - Replace pthread_kill by my_thread_send_signal() in jcr.c
268 - fix #1595 about batch mode detection problem for postgresql with non standard 
269   install dir
270 - Fix #1594 about prune copy jobs
271 - Apply literal string fix in printf submitted by Luca Berra
272 - Fix bug #1582 Restore from multiple storage daemons breaks subsequent backups
273 - Fix segfault on "cancel jobid=" command
274 - Fix bug #1554 Windows installer doesn't honor /S flag
275 - Remove pool zap code that breaks 2drive-concurrent-test
276 - Fix #1571 and install libraries with 755 perms
277 - Fix bug #1581 ASSERTs in src/dird/jobq.c can never trigger
278 - Fix problem with BaseJob and Accurate FileSet options on client side
279 - Fix for bug #1569 deadlock/crash in Dir
280 - Fix segfault when loading Plugins
281 - Fix #1567 about display of long volume names truncated during restore
282 - Added new bacula-libs package.
283 - Fix bug #1538 Start Scripts return incorrect value
284 - Fix bug #1564 init scripts not LSB compliant
285
286 See ChangeLog for more details.
287
288 ;;;;
289 Kern;;;01 August 2010 at 17:23 CET
290 Welcome to our new bacula.org server
291
292 This is our new bacula.org server, graciously provided
293 by UKFast.  Our previous server, also hosted by UKFast, was
294 getting to be a bit old, so they furnished us a new one,
295 and we are very pleased.
296
297 ;;;;
298 Kern;;;28 April 2010 at 19:15 CET
299 Eric has released Bacula Version 5.0.2 to Source Forge
300
301 This 5.0.2 version is primarily a important bug fix update to version 5.0.1.
302
303 Note, if you are running 5.0.0, read the 5.0.1 release notes below.
304   Important!!!
305
306 Compatibility:
307 --------------
308  As always, both the Director and Storage daemon must be upgraded at
309  the same time.
310
311  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.0.2
312  Director and Storage daemons. There should be no need to upgrade older File
313  Daemons.
314
315 Changes since 5.0.1
316 -------------------
317
318 Bug fixes
319 1502 1511 1517 1524 1527 1532 1536 1541 1549 1551 1553 1559 1560
320
321 - Probable fix for SD crash bug #1553
322 - Fix #1559 problem when restoring pruned jobs with a regexp
323 - Fix for bug #1560 bcopy cannot find Volume
324 - Fix cancel crash bug #1551
325 - Check if sql backend is thread-safe
326 - Correct Pool display in SD status. Fixes bug #1541
327 - Fix cancel crash reported by Stephen Thompson
328 - Rewind on close to fix #1549
329 - Remove closelog() in bpipe fixes bug #1536
330 - Fix #1517 about missing Base level in .level command
331 - Replace ASSERT in block.c with fail Job
332 - Fix database locking calling db_lock and returning from function without
333   calling db_unlock.
334 - Add missing db_unlock to bvfs_update_cache.
335 - Fix #1532 about permission on binaries
336 - Fix #1527 about deadlock during migration
337 - Another fix for OpenSSLv1
338 - Add -lrt to Solaris links
339 - Fix tls.c for OpenSSLv1
340 - Fix #1511 when trying to insert more than 50.000 directories in bvfs
341 - Fix plugin load not to stop if one plugin bad -- pointed out by James
342 - Remove --without-qwt from configure statement.
343 - Second correct fix to bug #1524 verify fails after adding or removing files
344 - Fix bug #1524 verify fails after adding or removing files
345 - Apply fix suggested by Andreas in bug #1502 for mediaview column sort problem
346 - Fix OpenSSL 1.x problem in crypto.c on Fedora 12
347 - Display AllowCompress warning message only if compression used in FileSet
348
349 ;;;;
350
351 Kern;;;25 February 2010 at 15:35
352 Bacula Version 5.0.1 has been released to Source Forge
353
354 Bacula version 5.0.1 source code and Windows (32/64 bit) binaries have been 
355 released to Source Forge (thanks Eric).  
356
357 This is a major bug fix release including a few directives that have been 
358 rewritten, one new directive, and some different directive behavior (see the 
359 release notes below).  As is usual for a patch release (last digit changes by 
360 one), this version is compatible with the 5.0.0 database and with prior 
361 clients.  However, you *must* upgrade all components that are on any one 
362 machine (that is you must upgrade your Director, Storage daemon, and File 
363 daemon at the same time, if they reside on the same machine).
364
365 Note, Bacula does not normally uninstall previous versions, and we have 
366 changed the shared object naming convention, so you might want to first save 
367 your configuration files then uninstall the old Bacula using the old Bacula 
368 uninstall prior to installing the new one.  If you do not, it should not be 
369 serious, but you may be left with some older Bacula shared objects that are 
370 not used and hence wasting a small amount of disk space.
371
372 If you are upgrading from version 3.0.x or prior, please see the full release 
373 notes as you must do a database upgrade.  When updating from 5.0.0 to this 
374 release there is no database upgrade needed.
375
376 Scott has made a number of changes and improvements in the rpm packaging over 
377 the past few weeks since version 5.0.0 was released, so he will probably be 
378 releasing the 5.0.1 rpms quite soon.
379
380 Thanks for using Bacula :-)
381
382 Best regards,
383
384 Kern
385
386 =============  Performance Note ==================
387
388 Some of you have encountered performance problems with your
389 database (mainly with MySQL) with Bacula version 5.0.0.  This is
390 mainly because we've changed the SQL query used for restore,
391 accurate jobs and base jobs.  We have extensively tested this
392 change, and though it should be a little bit slower than the previous
393 versions, on a well configured database it should run
394 extremely well.  
395
396 We strongly recommend to avoid the temptation to add new indexes.
397 In general, these will cause very significant performance
398 problems in other areas.  A better approch is to carefully check
399 that all your MySQL memory configuation parameters are are
400 suitable for the size of your installation.  If you backup
401 millions of files, you need to adapt the database memory
402 configuration parameters concerning sorting, joining and global
403 memory.  By default, sort and join parameters are very small
404 (sometimes 8Kb), and having sufficient memory specified by those
405 parameters is extremely important to run fast.  
406
407 If adjusting your MySQL memory configuration values does not
408 solve your problem, you can also consider switching to
409 PostgreSQL, which performs much better with Bacula on big
410 installations (many millions of files per Job).  However for
411 large installations, you will also need to adjust the default
412 PostgreSQL memory configuration parameters.
413
414 ==========================================
415
416
417                Release Notes for Bacula 5.0.1
418
419   Bacula code: Total files = 1,081 Total lines = 217,272 (Using SLOCCount)
420
421 !!!!!!!!!!!!!!!!!!!!! NOTE !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
422 The Allow Duplicate Jobs directive has been significantly 
423 reworked, and the default value has changed. See below.
424
425 Truncate On Purge has been totally rewritten. See the new
426 features section of the manual.
427
428 When Volume Poll Interval is set in the SD DEVICE configuration,
429 (default 5 mins), after a certain number of polling tries (approx
430 10) polling will stop and the operator will be asked to
431 resolve the problem.  Previously there was no limit, and an
432 error message could be produced at each poll attempt.
433 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
434
435 Changes since 5.0.0
436 -------------------
437 - We believe that we have resolved most of the problems
438   concerning canceled or failed jobs being "stuck" in the
439   Director.  There is one outstanding problem in the SD when
440   canceling jobs that we will fix in the next major release.
441   If you see jobs that seem to be stuck, in general issuing
442   a cancel command in bconsole should now make them go away.
443
444 Directives:
445 - The default for "Allow Duplicate Jobs" has been changed from 
446   no to yes.  If you use this directive, please check your
447   conf file, and note the next two items !!!!!!!!!!!!!!!!!!!
448 - AllowHigherDuplicates disabled. It did not work as documented   
449     and was confusing.
450 - New directive "CancelLowerLevelDuplicates" See New Features
451   section in the manual.
452 - Truncate on Purge rewritten.  See New Features section in the manual.
453
454 Bug fixes:
455 1448 1466 1467 1468 1476 1481 1486 1488 1494 1497 
456 1499 1501 1505 1509 1513
457
458 - Ensure SD asks for help when looping even if poll set. Fixes bug #1513.
459 - Fix three-pool regress bug
460 - Modify bacula.spec fixes bug #1505
461 - This version fixes an issue where the console window would start out
462   docked. It is fixed by initiating the variables in the Pages class wi
463   constructor.
464 - Fix make_catalog_backup.pl fails when catalog db is on other host
465 - Apply MacOSX installer patch from bug #1509
466 - Apply fix to previous fix of Copy problem. Fix proposed by reporter o
467   #1476
468 - Fix bug #1501 -t does not print errors
469 - Apply SQLite3 update fix from bug #1497
470 - Apply bashism fix for diskchanger.in script from bug #1499
471 - Apply rpm fix for Sci Linux from bug #1494
472 - Take most recent Ukranian po from bug #1448
473 - Probable fix for Copy/Migration bug #1476
474 - Fix bug #1488 -- avoid recursion and race conditions in messages.c
475 - Upgrade cats library also to 5.0.0
476 - Fix missing console page in bat
477 - Add bat help files to Window install
478 - Improve Windows upgrade to ensure old FD is shutdown
479 - Fix bug #1481 -- bat consumes all console file descriptors
480 - Backport truncate on purge from 5.1.x
481 - Fix bug #1486 -- bat doesn't show any errors on command-line
482 - Update the bsock error URL
483 - Correct .my.cnf umask in make_catalog_backup.pl
484 - Apply fix for dbcheck use by make_catalog_backup.pl
485 - Fix seg fault in bscan from new comment field
486 - Allow multiple CNs when using TLS
487 - Fix seg fault in SQlite driver
488 - Make shared libs version the same as the Bacula release version
489 - Remove file_index sequential check
490 - Fix #1466 about Bogus pruning message
491
492 For Packagers:
493 1.  The default query.sql file is now, except for some comments, empty.
494 The old file, which we no longer support (it is impossible or difficult to
495 make it work on every backend, and the queries are mostly contributed) can
496 be found in <bacula-source>/examples/sample-query.sql.  The sample file is
497 not installed by the Makefiles
498
499 2.  When you install the mtx-changer script, you must also install
500 mtx-changer.conf if it does not exist.  This new file (mtx-changer.conf) is
501 required for mtx-changer to work, but it is a user configurable file, so on
502 any update, any existing file should not be overwritten.
503
504 3.  Bat should be built on every platform that is capabable of running Qt.
505 However, the Qt code is changing rather quickly and is not always
506 compatible from version to version.  We have built and verified bat on Qt
507 4.3.4.  We strongly recommend that you do not build and distribute bat with
508 any other version of Qt unless you personally test it.  To build against Qt
509 4.3.4, download the depkgs-qt package from the Bacula Source Forge download
510 location, read the README file and follow the instructions.
511
512 If you are building for Bacula version 5.0.0, please ensure that you do not
513 have qmake-qt4 loaded on your system.  If you do, either remove it or
514 rename it before trying to build bat.  If you do not, bat will probably be
515 built using the shared objects on your system.  For Bacula 5.0.1 and later,
516 this problem (bug) does not exist.
517
518 depkgs-qt does not install Qt on your system, nor does it interfere with
519 you having any other version of Qt installed on your system.  Once you
520 build bat with depkgs-qt, it should *not* use the Qt shared objects, but
521 rather they will be linked into the program.  After fully installing bat
522 (make install), you can run "ldd bat" to see what shared objects it will
523 use.  If any Qt shared objects are referenced, something has gone wrong.
524
525 4.  Unless absolutely necessary, we recommend that you do not define any
526 special library environment variables that apply to the ./configure -- for
527 example: LIBDIR=/...  ./configure <your-options> is strongly discouraged.
528 Doing so, could potentially cause Bacula to be linked against the wrong
529 shared objects.
530
531 5.  The Bacula project strongly recommends that you install Bacula into a
532 single directory, with a few minor exceptions such as the MySQL or
533 PostgreSQL databases.  Preferrably this should be /opt/bacula.  The full
534 recommendation is:
535
536 #!/bin/sh
537 # Recommended configure script for Bacula
538 prefix=/opt/bacula
539 email=xxx@yyy.zz
540 CFLAGS="-g -O2 -Wall" \
541   ./configure \
542     --sbindir=${prefix}/bin \
543     --sysconfdir=${prefix}/etc \
544     --docdir=${prefix}/html \
545     --htmldir=${prefix}/html \
546     --with-working-dir=${prefix}/working \
547     --with-pid-dir=${prefix}/working \
548     --with-subsys-dir=${prefix}/working \
549     --with-scriptdir=${prefix}/scripts \
550     --with-plugindir=${prefix}/plugins \
551     --libdir=${prefix}/lib \
552     --enable-smartalloc \
553     --enable-tray-monitor \
554     --enable-bat \
555     --with-mysql \
556     --with-dump-email=${email} \
557     --with-job-email=${email} \
558     --with-smtp-host=localhost \
559     --with-baseport=9101
560
561 Obviously, the email, and some of the minor options (mysql, postgresql,
562 ...) can be changed to suit your distribution, but the directory names
563 defined above are strongly recommended, and over time the default values in
564 the bacula-dir.conf and bacula-sd.conf will reflect these choices.
565
566 If you have any questions about this or would like a detailed document
567 describing our recommendations including packaging requirements, please
568 send an email to the bacula-devel list.
569
570 6.  Starting with Bacula version 3.0.0 up to Bacula 5.0.0, the shared
571 libraries that Bacula uses by default are named xxx-1.0.0.  Starting with
572 Bacula 5.0.1, we are going to name the libraries using the Bacula version.
573 So in Bacula 5.0.1, the libraries will be named xxx-5.0.1.  With future
574 versions, the last digit may or may not change when we distribute patch
575 updates (i.e.  the last digit of the version changes).  This will depend on
576 whether or not we have changed something in the library.  Hopefully this
577 new procedure will resolve some of the incompatibility problems between
578 different versions of the shared objects.
579
580 7.  The default build option for bconsole is conio (my own little console
581 routines).  I did this because some years ago, readline was very difficult
582 to maintain -- it and where it was found seemed to change on every release.
583 This generated at the time a number of support problems.  It seems to me
584 that since then there have been very few problems with readline.  As a
585 consequence, I have no problem if you want to make bconsole with readline
586 enabled.  It will actually give some very nice new bconsole command
587 completion functionality that Eric has written.  Bottom line: feel free to
588 use readline or not as you please.
589
590
591 ;;;;
592 Eric;;;25 January 2010 at 10:00
593 Bacula Version 5.0.0 has been released to Source Forge
594
595 Release Numbering:
596 -----------------------------------------------------------
597 You might be wondering why this release jumps from 3.0.x to 
598 5.0.0 thus skipping version 4.0.0.  We have done this for 
599 several reasons: first, we wanted a way of distinguishing
600 the numbering system for the Bacula System Enterprise version
601 and the Bacula Project version.  So, to do so, we have decided
602 that the first number of the Bacula Project version will always
603 be odd, and the first number of the Enterprise version will always
604 be even. Thus the Bacula Project now moves from 3.0.x to 5.0.x.
605 In addition, we want to keep the Bacula Project version larger
606 than the Enterprise version to indicate that the Bacula Project
607 version is more advanced or has more features than the 
608 Enterprise version. For memory, the current Enterprise version
609 is 2.6.1, and the next release (in a few months -- before June 2010)
610 will be version 4.0.0.
611
612 Warning:
613 --------------------------------------------------------------
614 Please note the three Warnings below before doing any install or
615 upgrade.
616        
617
618 Changes since 3.0.3a (the last Bacula Project release):
619 -------------------------------------------------------
620
621 Bug fixes:
622 1337 1351 1352 1354 1357 1361 1367 1369 1370 1373 
623 1376 1391 1403 1409 1420 1422 1427 1428 1431 1450 
624 1454 1455 1458 1456
625
626 Fixed:
627  - Problem that locks the Director when the SMTP server wasn't 
628    responding to the bsmtp program 
629  - Restore's dir command shows incorrect file sizes 
630  - Fix various problems with the reload command   
631  - Fix problems with conio
632  - Eliminate several deadlocks or potential race conditions from SD
633
634 Enhancements:
635  - Project 5: Truncate volume after purge
636  - Project 6: File Deduplication using Base Jobs 
637  - Project 10: Restore from Multiple Storage Daemons
638  - Project 11: AllowCompression per Device
639  - Project 23: Add Maximum Concurrent Jobs for Devices to balance load 
640    between drives
641  - Add Accurate Fileset Options to configure accurate detection. Can use 
642    checksum verification for example.
643  - Allow FD to keep root read but drop write permission (CAP)
644  - Secure handling of passwords for catalog backup
645  - Add Tab-completion for Bconsole when using Readline
646  - Add Bvfs API to query the catalog without building a memory tree
647  - Add new speed test to btape program
648  - Add new Bat screens (Autochanger content, Job view, Media view, ...)
649  - Windows version of Bat
650  - Added Spanish Bacula translation   
651  - New bconsole -u nnn option to have timeout on commands
652  - Allow Migrate, Copy, and Virtual Full to read and write
653    to the same Pool
654  - show disabled   -- shows disabled Jobs
655  - Add Pool File and Job retention periods (take precedence over Client)
656  - Many ACL improvements
657  - Level added to FD status Job entry
658  - Allow turning on/off Block Checksum per device
659  - Set Device Poll interval to 5 minutes -- previously did not poll
660  - Implement lock manager with bad order protection
661
662 Compatibility:
663 As always, both the Director and Storage daemon must be upgraded at
664 the same time, and on any given machine, you must run only one version
665 of Bacula. This means that on the Director and Storage daemon machines,
666 you *must* upgrade your File daemon as well.
667
668 Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 5.0.0
669 Director and Storage daemons. There should be no need to upgrade older File
670 Daemons immediately. However, we recommend that you do so as soon
671 as is reasonable for your situation.
672
673 ================== Warning !!!!!! ==========================
674
675 New Catalog format in version 5.0.0 (3.1.9 or later)
676 -----------------------------------------------------
677
678 This release of Bacula uses a new catalog format. We provide a set of
679 scripts that permit to convert a 3.0.x (version 11) catalog to 5.0.0 (version
680 12).  The Bacula project rpms distributed on Source Forge will automatically
681 detect the database change and do the upgrade for you.  We strongly
682 recommend that you save a copy of your existing database before upgrading
683 using rpms.
684
685 The simplest way to upgrade the database assuming you are building from
686 source:
687 1. Stop any current version of Bacula from running.
688 2. Save a copy of your existing database.
689 3. Configure, build, and install the 5.0.0 version of Bacula
690    Note the new ./configure options in the manuals see the link
691    at the bottom of this file.
692 4. cd <your-scripts-installation-directory>
693 5. ./update_bacula_tables
694 6. If you have multiple catalogs, edit the update_bacula_tables
695    script and put the name of another database, and then
696    execute the script again. Repeat this until all Bacula
697    catalogs have been updated.
698 7. Start the new Bacula.  If everything worked, it should
699    not print any error messages.
700
701 If you start from scratch, you don't need to run the update_bacula_tables
702 script because the create_bacula_tables script automatically creates the new
703 table format.  However, if you are using a version of Bacula older than 3.1.9
704 (e.g.  3.0.3) then you need to run the update_bacula_tables script that will
705 be found in the <bacula>/src/cats directory after you run the ./configure
706 command.  As mentioned above, before running this script, please backup your
707 catalog database, and when you do running it, be sure shutdown Bacula and be
708 aware that running the script can take some time depending on your database
709 size.
710 ================================================================
711
712
713 ================== Warning !!!!!! ==========================
714 If you upgrade a previous Win32 client installation, you must
715 first stop the File daemon, then uninstall it before attempting
716 the upgrade. If you do not do so, the upgrade will probably
717 fail and you will need to manually find and run the 
718 Uninstall.exe file, before you can upgrade to the new version.
719 This is because the file locations are different.  If you want
720 to save your previous bacula-fd.conf file, please do so before
721 uninstalling it.
722 ================================================================
723
724 ================== Warning !!!!!! ==========================
725 Due to permissions problems on Windows Vista and later systems,
726 we no longer require SYSTEM or Administrator permissions to 
727 access the binaries and configuation files.  If you wish
728 to restrict access to these files, please see the New Features
729 section of the manual for how to set access control lists.
730 ================================================================
731
732 Note, the Win32 Installer no longer installs the Bacula Servers
733 (Director and Storage daemon). See the New Features section of
734 the manual for more details.
735
736 ============ Documentation improvements needed ==================
737
738 Note!!!!! The 5.0.0+ documentation has a number of known problems:
739
740 1. We have reduced the number of manuals, which has fixed many
741    of the broken links found in the old 3.0.x version, but there
742    are still some that need fixing.
743
744 2. Integration of the 3.0.x features into the main manuals has
745    not yet been done.
746
747 The documentation will not be completed in the near future due to lack
748 manpower.  If you are unhappy with this situation as we are, we suggest
749 you help by submitting patches to the documentation.  Thanks.
750 =====
751
752
753 This release includes large number of new features and changes.
754 It should be more or less compatible with previous xx.conf files
755 and File daemons providing that you are not using any of the new
756 features.
757
758 Please see the New Features chapter of the new manual, which documents
759 some but not all the new features (we are still working on it):
760
761 http://www.bacula.org/5.0.x-manuals/en/main/main/New_Features_in_5_0_0.html
762   
763 The ChangeLog has more details.
764
765 ;;;;
766
767
768 Kern;;;18 October 2009 at 21:00
769 Bacula Version 3.0.3 has been released to Source Forge
770
771 Note, if you are not already running 3.0.x, read the 3.0.x release notes 
772   below.  Important!!!
773
774 Version 3.0.3 is primarily a important bug fix update to version 3.0.2.
775
776 Changes since 3.0.2:
777 Bug fixes:
778  1391, 1288, 1346, 1352, 1359, 1355, 1363, 1364, 1365, 1366, 1368, 
779  1369, 1370, 1371, 1382
780
781 Fixes:
782      Apply James' fix for some Exchange plugin crashes
783      Integrate patch for building dmg on OSX from Lorenz Schori <lo@znerol.ch>
784      Fix bug #1391 Job status improperly set due to subtle variable overload problem
785      Fix #1352 about double free with regexp and big filenames on windows
786      Apply Graham's idea for recovering from disk full by recursing
787        when doing fixup_write_error ...
788      Make fix for VirtualFull changing device based on suggestion by
789        Nicolae Mihalache <mache@abcpages.com>
790      Fix concurrent Job recycle bug #1288
791      Backport part of one possible fix from bug #1346
792      Fix bug #1382 newly created disk volumes -> file not found warning
793      Fix Alpha ifdefing -- should fix bug #1359
794      Use old code for selecting file during restore.
795      Cherry-pick 3.1.x commits
796      tweak space on projects file
797      Fix seg fault in ignoredir code
798      Apply Frank's slash patch
799      Fix seg fault in SD bug #1371
800        3.0.2-Fix-seg-fault-in-SD-bug-1371.patch 
801      Add more info when SD connection refused
802        3.0.2-Add-more-info-when-SD-connection-refused.patch
803      Fix bug #1355 Director crashes with double free in Accurate SQL query
804        3.0.2-accurate.patch
805      Fixes bug #1368 ASSERT Failure on MacOS.
806        3.0.2-mac-path-len.patch
807      Fix #1364 and #1363 about compression buffer error.
808        3.0.2-zlib-buffer.patch
809      Fixes bug #1365 and #1366 about MacOSX resource forks. 
810        3.0.2-bug-1365.patch and 3.0.2-bug-1366.patch
811      Fix "Exclude Dir Containing" fileset option
812        3.0.2-exclude-dir-containing-fd.patch
813        3.0.2-exclude-dir-containing.patch
814        3.0.2-exclude-dir-containing-top_level.patch
815
816 Compatibility:
817  As always, both the Director and Storage daemon must be upgraded at
818  the same time.
819
820  Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 3.0.3
821  Director and Storage daemons. There should be no need to upgrade older File
822  Daemons.
823
824 ;;;;
825
826 Kern;;;20 July 2009 at 14:49
827 Bacula Version 3.0.2 has been released to Source Forge
828 Note, if you are not already running 3.0.x, read the 3.0.x release notes
829 below.  Important!!!
830
831 Version 3.0.2 is primarily a important bug fix update to version 3.0.1 with
832 some enhancements (see below).
833
834 Changes since 3.0.1:
835
836 Bug fixes:
837   1029, 1285, 1298, 1303, 1304, 1305, 1306, 1307, 1308, 1309, 1311, 1315
838   1317, 1318, 1323, 1325, 1331, 1333, 1335
839
840 Fixed:
841  - Fix problem with the Postgresql driver that sometime displays <NULL> values
842  - Cleanup old job records when starting the Director
843  - Fix bugs in xattr code
844  - Fix encoding problem with Postgresql
845  - Fix that prevents restore by file selection from using Copy job
846
847 Enhancements:
848  - Security enhancement for the File Daemon
849  - New directive to specify source address for outgoing connexions
850  - Show volume availability in autochanger when doing restore.
851    This is project 31 in the projects file.
852  - Add accurate=yes/no option to estimate command
853  - Add --with-hostname, --with-bsrdir, --with-logdir to ./configure
854  - Add a restore menu that contructs a full restore when entering a JobId.
855    This is project 2 in the projects file.
856  - Add new Nagios plugin
857
858 Compatibility:
859 Like always, both the Director and Storage daemon must be upgraded at
860 the same time.
861
862 Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 3.0.2
863 Director and Storage daemons. It should be no need to upgrade older File
864 Daemon.
865 ;;;;
866
867 Kern;;;30 April 2009 at 17:49
868 Bacula Version 3.0.1 has been released to Source Forge.
869
870 Note, if you are not already running 3.0.0, please read the 3.0.0 release notes.  Important!!!
871
872 Version 3.0.1 is primarily a minor bug fix update to version 3.0.0 with
873 one enhancement (see below).
874
875 Changes since 3.0.0:
876 Bug fixes:
877   1276, 1274, 1275, 1272 1246, 1268, 1281, 1282.
878
879 Fixed:
880 - Check for job_canceled() in fd_plugin code.
881 - Update Win32 table creation to have new DB version 11 format
882 - Remove illegal Options in Exclude of default Win32/64 bacula-dir.conf
883 - Remove 'Reposition' messages when restoring
884 - Updated projects file
885 - Tweak version string to display versionid field at the end
886   and keep fields order.
887   - Add additional mysql connection debug code submitted by:
888     Chandranshu <chandranshu@gmail.com>
889
890 Enhancement:
891 - Modify insertion of read Volumes in SD to be done *before* the
892   drive reservation. This ensures that a Volume to be read will not
893     be reserved for writing. Significant improvement in eliminating
894       tape deadlock situations.
895
896 Note, both the Director and Storage daemons must be upgraded at the
897 same time. The 3.0.1 File daemons are compatible with 3.0.0 file
898 daemons and as noted below in the 3.0.0 release notes the Director
899 and Storage daemon should be compatible with 2.4.x File daemons.
900 In general, we do not expect any of the 3.0.x File daemons to work with older
901 Directors and Storage daemons (as has always been the case for Bacula
902 releases).
903
904 ============ Documentation improvements needed ==================
905
906 Note!!!!! The 3.0.0+ documentation needs rather extensive modifications in the
907 following areas:
908
909 1. Missing documentation.
910 2. Correction of links within various manuals -- most fail.
911 3. Integration of the new features into the main documents.
912 4. Much more.
913
914 The documentation will not be completed in the near future due to lack
915 manpower.  If you are unhappy with this situation as we are, we suggest
916 you help by submitting patches to the documentation.  Thanks.
917 =====
918 ;;;
919
920 Kern;;;09 April 2009 at 22:30
921 Bacula Version 3.0.0 has been released to Source Forge.
922
923 This is to inform you that we have uploaded the Bacula version 3.0.0 source 
924 tar files and the Win32/64 installer files to the Bacula Source Forge 
925 download location.
926
927 There are quite a number of new features in this release, and upgrading to it 
928 requires a database upgrade, so please read the release notes carefully 
929 (included below) and the documentation for the new features at:
930
931 http://www.bacula.org/manuals/en/concepts/concepts/New_Features.html
932
933 There is still a good deal of work to do to finish the release process (mainly 
934 reorganizing the web site manuals ...), but at least the source files are 
935 released.  The rpms should follow shortly (probably this weekend).
936
937 If you are currently using 2.4.4, please note that within a few months that 
938 version will no longer be supported, so please consider the possibility of 
939 upgrading.
940
941 This release probably has the most new features that we have ever released, 
942 and it has taken a long time to produce it.  The basic code is very well 
943 tested, and if you stick to 2.4.4 features, you are unlikely to experience 
944 problems.  However, many of the new features have not been well tested, so 
945 your help will be appreciated.
946
947 The following issues with 3.0.0 are known and we are working on them:
948
949 1. The documentation is not 100% complete (there are so many new features that 
950 we missed documenting some).  
951
952 2. All the new documentation is in the New Features chapter, but not all of it 
953 has yet been integrated back into the appropriate chapters.
954
955 3. James has reported that the Exchange plugin may crash if you cancel a job 
956 while it is running.  He is working on this.
957
958 4. The SD has many new features that will make it more stable. One in 
959 particular is that it knows what Volumes will be read during a migration, 
960 copy, or Virtual backup job, and will ensure that they are not selected for 
961 writing (something easy to do if you are using disk files and the same pool 
962 for reading an writing).  However, the day after the release was cut, I found 
963 a problem with this code that prevents it from working properly during 
964 certain pre-allocations of the write tape.
965
966 5. There is still an outstanding bug report on VSS failing (it seems to be a 
967 bit of a rare case).
968
969 As I previously announced, we will now make 3.0.0 our main release source code 
970 stream, and we hope to release new version every six months and bug fix 
971 updates even sooner.  To be able to do this, we will support version 2.4.4 
972 only for a few more months.  There after the project will only support the 
973 most current release ...
974
975 This release comprises a lot of work by a lot of different people and many 
976 contributions.  Normally I hesitate to mention particular people or 
977 contributions because I always forget someone, but since this was such a big 
978 release, I would like to mention at least the big contributions:
979
980 Sponsor Company(s)  -  Programmer - Project
981 Bacula Systems - Eric Bollengier - Accurate Backup
982 Bacula Systems - Eric Bollengier - Catalog format enhancements
983 Bacula Systems - Eric Bollengier - bextract non-portable Win32 data
984 Bacula Systems - Eric Bollengier - Win64 File daemon
985 Bacula Systems - Eric Bollengier - SD deadlock detection + postmortum dump
986 Bacula Systems - Eric Bollengier - Faster Attribute despooling if DIR & FD on 
987                                                      same machine
988 Bacula Systems - Eric Bollengier - Virtual tape emulation
989 Bacula Systems - Kern Sibbald - USB rescue key
990 Equiinet funded development - James Harper - MS Exchange plugin
991
992 Personal contributions:
993 Kjetil Torgrim Homme - Regex expressions for restore in bootstrap file
994 Marco van Wieringen - ACL code overhaul
995 Marco van Wieringen - Solaris ZFS/NFSv4 ACL support
996 Marco van Wieringen - Extended Attribute support
997 Marco van Wieringen - Shared Objects
998 Dirk Bartley - Bat speedup + stability improvement + many enhancements
999 Joao Henrique Freitas - libdbi catalog driver
1000 Scott Barninger - rpm packaging
1001 Kern Sibbald - many big and little projects ...
1002 Many people -- see the AUTHORS file.
1003
1004 Many thanks to everyone for making Bacula what it is today.
1005
1006 === List of new features ===
1007 - Accurate Backup
1008 - Copy Jobs
1009 - ACL code overhaul
1010 - Solaris ZFS/NFSv4 ACL support
1011 - Extended Attribute support
1012   --disable-xattr (default=auto)
1013 - Shared Objects
1014   --enable-libtool (default)
1015   --disable-libtool
1016 - Virtual Backup
1017 - Catalog Format Enhancements
1018   - Support for more than 4 Billion file entries
1019   - New stats tables
1020 - Duplicate Job Control
1021 - TLS Authentication
1022 - bextract non-portable Win32 data
1023 - State File updated at Job Termination
1024 - Bacula Plugins
1025   - FD bpipe plugin
1026   - FD Exchange plugin
1027 - libdbi DB driver
1028 - Console Enhancements
1029   - status slots
1030   - list joblog
1031   - command separator
1032 - Bootstrap regex
1033 - Restore seek optimization
1034 - Virtual Tape Emulation
1035 - Bat Enhancements
1036 - RunScript Enhancements
1037 - Status enhancements
1038 - FD connect timeout default to 3 minutes
1039 - ftruncate implemented for NFS Volumes
1040 - FD Version compatibily flag
1041 - Statistics Enhancements
1042 - Faster Attribute despooling
1043 - Document split into 6 manuals
1044 - GPLv2 license now compatible with OpenSSL
1045 - Win64 File daemon
1046 - Postmortum dump improvements in SD
1047 - Deadlock mutex detection in SD
1048 - Improved Volume management in SD to avoid deadlocks.
1049 - New configure install options
1050   --docdir=  (default=/usr/share/doc/bacula-VERSION)
1051   --htmldir= (default=/usr/share/doc/bacula-VERSION/html -- bat help files)
1052   --plugindir= (default=sysconfdir, where plugins will be installed)
1053 - New Bare Metal Recovery with USB key. See rescue/linux/usb
1054  New Directives:
1055 - Max Full Interval
1056 - Max Diff Interval
1057 - Honor No Dump Flag
1058 - Exclude Dirs Containing
1059 - Recycle Pool
1060 - Max Run Sched Time
1061 - Max Wait Time    
1062 - Full/Diff/Incr Max Run Time
1063 - Scratch Pool
1064 - Max Console Connections
1065 - Spool Size (in Job resource)
1066 - Allow Mixed Priorities
1067 - Allow Duplicate Jobs
1068 - Allow Higher Duplicates
1069 - Cancel Queued Duplicates
1070 - Cancel Running Duplicates
1071 - TLS Authenticate
1072 - Console (in RunScript)
1073
1074 New features from Project Items Completed for version 3.0.0
1075     also listed above:
1076 Item  1:  Accurate restoration of renamed/deleted files
1077 Item  3:  Merge multiple backups (Synthetic Backup or Consolidation)
1078 Item  4:  Implement Catalog directive for Pool resource in Director
1079 Item  5:  Add an item to the restore option where you can select a Pool
1080 Item  8:  Implement Copy pools
1081 Item 12:  Add Plug-ins to the FileSet Include statements.
1082 Item 13:  Restore only file attributes (permissions, ACL, owner, group...)
1083 Item 18:  Better control over Job execution
1084 Item 26:  Store and restore extended attributes, especially selinux file 
1085 contexts
1086 Item 27:  make changing "spooldata=yes|no" possible for
1087 Item 28:  Implement an option to modify the last written date for volumes
1088 Item  n:  Split documentation into several books
1089 ================================
1090
1091
1092        Release Notes for Bacula 3.0.0
1093
1094   Bacula code: Total files = 520 Total lines = 205,459 (*.h *.c *.in)
1095
1096 The diff between 2.4.4 and 2.5.x is 208,340 lines, so this release
1097 represents an enormous effort.
1098
1099 This Director and Storage daemon must be upgraded at the same time,
1100 but they should be compatible with all 2.4.x File daemons, unless you
1101 use some of the new features that affect the FD.  In other words, you should
1102 not have to upgrade all your File daemons when you upgrade. However, any
1103 release of version 2.5.40 or greater requires a database upgrade.
1104
1105 ================== Warning !!!!!! ==========================
1106
1107 New Catalog format in version 3.0.0 (2.5.40 or later)
1108 -----------------------------------------------------
1109
1110 This release of Bacula uses a new catalog format. We provide a set of
1111 scripts that permit to convert a 2.4.x (version 10) catalog to 3.0.0 (version
1112 11).  The Bacula project rpms distributed on Source Forge will automatically
1113 detect the database change and do the upgrade for you.  We strongly
1114 recommend that you save a copy of your existing database before upgrading
1115 using rpms.
1116
1117 The simplest way to upgrad the database assuming you are building from
1118 source:
1119 1. Stop any current version of Bacula from running.
1120 2. Save a copy of your existing database.
1121 3. Configure, build, and install the 3.0.0 version of Bacula
1122    Note the new ./configure options in the manuals see the link
1123    at the bottom of this file.
1124 4. cd <your-scripts-installation-directory>
1125 5. ./update_bacula_tables
1126 6. If you have multiple catalogs, edit the update_bacula_tables
1127    script and put the name of another database, and then
1128    execute the script again. Repeat this until all Bacula
1129    catalogs have been updated.
1130 7. Start the new Bacula.  If everything worked, it should
1131    not print any error messages.
1132
1133 The upgrade operation will convert the FileId index field of the File table
1134 from 32 bits to 64 bits.  This operation will take TIME and will *temporarily* 
1135 DOUBLE THE SIZE of your catalog. Bacula must be shutdown during this update,
1136 so, won't be able to run jobs during this period.  For example, a 3 million 
1137 files
1138 catalog will take 2 mins to upgrade on a normal machine.  Don't forget to
1139 backup it before executing the script.
1140
1141 If you start from scratch, you don't need to run the update_bacula_tables
1142 script because the create_bacula_tables script automatically creates the new
1143 table format.  However, if you are using a version of Bacula older than 2.5.40
1144 (e.g.  2.4.4) then you need to run the update_bacula_tables script that will
1145 be found in the <bacula>/src/cats directory after you run the ./configure
1146 command.  As mentioned above, before running this script, please backup your
1147 catalog database, and when you do running it, be sure shutdown Bacula and be
1148 aware that running the script can take some time depending on your database
1149 size.
1150
1151
1152 Important New configure options :
1153 ----------------------
1154
1155 This release of Bacula 3.0.0 uses libtool by default
1156 to generate the Bacula libraries as shared objects rather than
1157 being directly linked in as in prior versions.  This means that
1158 the Bacula shared objects, must either be in a shared object 
1159 directory known to the loader or they must be in the directory
1160 where the Bacula binaries are installed.  It is also possible
1161 to explicitly specify the libraries directory on the ./configure
1162 line (--libdir=/full-path/dir), but this should not be necessary.
1163
1164   ./configure --libdir=<full-path>
1165
1166 If you have problems with libtool or you wish to use the old 
1167 way of building libraries and linking them into Bacula, you 
1168 can do so by disabling libtool on the configure command line with:
1169
1170   ./configure --disable-libtool
1171
1172 During the installation of Bacula 3.0.0, it will now install
1173 bat help files (if you have configured bat).  These files
1174 are placed in /usr/share/doc/bacula/html by default. If you
1175 want to put them elsewhere use:
1176
1177   ./configure --htmldir=<full-path>
1178
1179 During the installation of Bacula, it will now install the
1180 ReleaseNotes, License, technotes, ChangeLog, and similar
1181 files in /usr/share/doc/bacula by default.  If you
1182 want to put them elsewhere use:
1183
1184   ./configure --docdir=<full-path>
1185
1186 During the installation of Bacula, any plugins will be
1187 installed in the plugindir, which is by default the
1188 same as libdir (/usr/lib).  You can specify an alternate
1189 location with:
1190
1191   ./configure --with-plugindir=<full-path>
1192
1193 ==============================================================
1194
1195 This release includes large number of new features and changes.
1196 It should be more or less compatible with previous xx.conf files
1197 and File daemons providing that you are not using any of the new
1198 features.
1199
1200 Please see the New Features chapter of the new manual, which documents
1201 some but not all the new features (we are still working on it):
1202
1203 http://www.bacula.org/manuals/en/concepts/concepts/New_Features.html
1204   
1205 The ChangeLog has more details.
1206
1207 ;;;
1208 Kern;;;03 Nobember 2008 at 17:35
1209 Critical 2.4.3-orphaned-jobs.patch released
1210 We recently found and corrected a serious bug in Bacula that causes jobs to be
1211 orphaned or "stuck" in the director during the pruning process.  Depending on
1212 what jobs get stuck and how many there are, it could prevent additional jobs
1213 from running.  As best we can tell, this problem occurs only during what could
1214 be called extreme pruning conditions -- i.e.  there are insufficient Volumes
1215 available for normal operations.
1216
1217 In any case, we recommend that everyone apply the 2.4.3-orphaned-jobs.patch,
1218 which you can find in the bacula-patches section of the Source Forge download
1219 area as well as in the directory patches of both the trunk and Branch-2.4 SVN.
1220 ;;;
1221
1222 Kern;;;12 October 2008 at 10:30am
1223 Creation of Bacula Systems SA
1224 Dear Members of the Bacula Community,
1225
1226 I'm pleased to announce the creation of Bacula Systems S.A., a new company to 
1227 provide professional support and service for Bacula.  I believe you will be 
1228 pleased to see how we have married a strong commitment to the ethos of honest 
1229 open source software with the availability of services desired by a wide 
1230 range of Bacula users. 
1231
1232 As many of you know, I began work on Bacula in 2000 and released the first 
1233 public version in April 2002 to Source Forge.  Although I have personally 
1234 written a very substantial part of the code, I offer sincere thanks to the 
1235 many members of the community who have provided ideas, fixes, testing, and 
1236 contributions of code, without which Bacula would not be what it is today.  
1237 It has been a labor of love and I am pleased that so many people have found 
1238 Bacula useful. 
1239
1240 Before telling you more about Bacula Systems, let me reiterate my unfaltering, 
1241 ongoing commitment to open source software and the Bacula open source 
1242 project. The code for Bacula and all future releases will remain available as 
1243 free open source software under the GPL license that I transferred to the 
1244 protection of the Free Software Foundation of Europe. Unlike some other open 
1245 source projects, there will be no separate "enterprise" or proprietary 
1246 version of the Bacula source code. www.bacula.org will continue to be the 
1247 home for Bacula project development.
1248
1249 So, why create Bacula Systems? The company was created to respond to requests 
1250 from users who want professional support with guaranteed levels of service 
1251 and response times.  To ensure continuity and the highest level of knowledge 
1252 transfer, I will take the position of Chairman of the Board and Chief 
1253 Technical Officer of Bacula Systems S.A..  
1254
1255 Several members of the Bacula community have joined me to start the company. 
1256 The other team members are also strongly dedicated to the spirit of keeping 
1257 Bacula open and free while simultaneously offering commercial services to 
1258 those for whom it is essential in making the decision to deploy Bacula.  
1259 Bacula Systems is self-financed -- the initial capital comes from the 
1260 founders; no outside venture capital was sought or accepted.  This means we 
1261 have the power to establish the company's priorities and we can remain 
1262 dedicated to "honest open source". Bacula Systems S.A. is a Swiss company 
1263 with offices in Yverdon-les-Bains, and with branches in France and Germany 
1264 initially.  We will open additional branches as business requires.
1265
1266 I will continue to support development of Bacula via bacula.org and the Bacula 
1267 community. Future developments will be in the "community" code base which 
1268 will remain free.  Bacula Systems will offer "funded development" to 
1269 customers who wish to accelerate the addition of certain features to Bacula.  
1270 Code developed this way will be contributed to the free distribution and will 
1271 be available to the entire community at no charge. Bacula Systems will 
1272 provide additional fee-based services, including high quality consulting, 
1273 training, documentation and certified binaries.
1274
1275 Our goal in establishing Bacula Systems is to be inclusive of the community, 
1276 and expand it by creating opportunities for members of the Bacula community 
1277 through a well-defined Partner Program.  If you provide IT services or 
1278 consulting, the Bacula Systems Partner Program can provide you with the 
1279 additional back-up (pardon the pun) support you need to serve your customers 
1280 more effectively. 
1281
1282 Our plan is to develop an international network of partners who offer high 
1283 value added services to Bacula users -- installing, configuring and optimizing 
1284 Bacula for their customers, as well as Level 3 and 4 support, with guaranteed 
1285 service levels.  We will also provide training and tools to our partners.
1286
1287 The Bacula project website, www.bacula.org, and Source Forge will be unchanged 
1288 in the mission and ideals of being  free sources of information, mail lists 
1289 and forum-based support for and by the community. Both Bacula source code and 
1290 Bacula binaries will continue to be available for free, as in the past, and 
1291 new releases will also be available for free. The new commercial website, 
1292 www.baculasystems.com will provide information on commercial subscriptions 
1293 for those users who want guaranteed levels of service, support, documentation 
1294 and certified binaries.  
1295
1296 All members of the Bacula community are encouraged to register for free at 
1297 www.baculasystems.com, so that you will receive announcements and news about 
1298 our commercial activities, and so that you can send feedback to our new 
1299 company, Bacula Systems.
1300
1301 Thank you for your interest and participation in the Bacula community.  
1302
1303 Sincerely,
1304
1305 Kern Sibbald
1306 ;;;
1307
1308 Kern;;;11 October 2008 at 11:30am
1309 Bacula version 2.4.3 Released
1310 This is to let you know that the source tar files and the Win32 binaries for 
1311 Bacula version 2.4.3 have been released to the Bacula Source Forge download 
1312 area.
1313
1314 Release 2.4.3
1315  This is a bug fix to version 2.4.2.  All daemons are compatible
1316  with other 2.4.x versions.
1317
1318 Bugs Fixed:
1319   1159, 1162. 1149, 1128, 1143, 1140, 1129
1320
1321 Change Summary:
1322 - Apply 2.4.2-cancel-non-running-jobs.patch to be able to cancel
1323   a non created job faster.
1324 - This should correct bug #1159 where Migration does not properly
1325   respect the Migration Low Bytes directive.
1326 - Fix typo in configure.in that breaks --with-db-password option
1327 - This code should fix the race condition that leads to a Director
1328   crash at job end time when the job list is updated. This was reported
1329   in bug #1162.
1330 - Remove all double quotes from SQLite creating script and
1331   replace by single quotes as suggested by John Huttley.
1332 - Fix SQL case problem that may cause the failure of DiskToCatalog
1333   in bug #1149.
1334 - Copy missing storage name into edit buffer. As far as I can tell
1335   this never caused a bug.
1336 - Remove catalog dependency for bcopy
1337 - Modify catalog scripts to have an easier packaging integration,
1338   using default variables.
1339   Make difference between SQLite3 and SQLite in db_get_type()
1340 - Attempt to fix bug #1128 InChanger flag cleared during Migration
1341   job when reading from one autochanger and writing to another.
1342 - Add more information to SD acquire.c INFO messages.
1343 - Fix NULL Volume name error when reading and the drive must
1344   be switched.
1345 - Fix a Verify InitCatalog problem where in certain cases
1346   a garbage filename may be entered in the verification database.  This
1347   fixes bug #1143.
1348 - Add space after version before date in bat about dialog.
1349 - Fix seg fault in Dir during estimate command with no level value
1350   given. This fixes bug #1140.
1351 - Add message to migration job when the target job is already migrated.
1352   This closes bug #1129.
1353
1354 Unless some really serious new bug shows up, this will be the last release 
1355 until the next major version (3.0.0), which we hope will be ready around the 
1356 end of the year.
1357 ;;;
1358
1359 Kern;;;26 July 2008 at 10:30am
1360 Bacula version 2.4.2 Released
1361 This is to inform you that we have released the source and Win32 binaries of 
1362 Bacula version 2.4.2 to the Bacula Source Forge download area.
1363
1364  This is an important bug fix release since version 2.4.1.
1365
1366 Bugs Fixed:
1367  1034, 1125, 1118, 1124, 1107, 1129, 1126
1368
1369 Change Summary:
1370 26Jul08
1371 - When a migration job actually runs, re-check the Job record
1372   and skip if the job is already migrated. This should
1373   significantly reduce the problems with bug #1129.
1374 - Break the do_swapping into do_unload, do_swapping, and
1375   do_load.  It is much more logical that way.
1376 - Implement a set_dcr_from_vol subroutine in acquire.c for
1377   reading volumes. This allows the dcr to be refreshed after being
1378   zapped when the wrong volume is mounted. This should fix bug #1126 -
1379 - During multiple tape restore, bacula
1380   does not ask for physical tape change, but rereads same tape
1381 - Apply patch submitted for bug #1107 with a small modification.
1382   This fixes a bug where bcopy copied too many records.
1383 - Make some tweaks to bsmtp based on patch submitted in bug #1124.
1384   This fixes bug #1124.
1385 - Make the default bat restore Pool be Any. This fixes bug #1118.
1386 - Fix bug #1125 which reports a SD crash at the end of a tape
1387   during restore. It was a debug statement that should not be
1388   in a release.
1389 - Fix #1034 by setting big timeout on mysql connections
1390 - Do partial integration of the Win32 bat build created by Eric.
1391 - Ensure that SD tried to mount a volume not in an autochanger
1392   at least once before asking for operator intervention.
1393 - Fix a pthreads bug in the Win32 pthreads emulation code affects only
1394   version 2.5.x and above.
1395 ;;;
1396
1397 Kern;;;7 July 2008 at 10:30am
1398 Bacula version 2.4.1 Released
1399 This is to inform you that we have released the source and Win32 binaries of 
1400 Bacula version 2.4.1 to the Bacula Source Forge download area.
1401
1402 Bugs Fixed:
1403  1103, 1100, 1105, 1094, 1109, 1106, 1101, 1102, 1112
1404  1117, 1116, 1097.
1405
1406 Change summary:
1407 -  Clear in-use bit on vol when unused while swapping.
1408 -  Remove sleep at end of ./bacula
1409 -  Clear hash packet for hardlinked files correctly. This corrects
1410    a long standing bug where hardlinked files selected individually
1411    would occasionally not be restored.
1412 -  Apply Eric's patch to ensure that autoprune does not return
1413    a Volume not in the autochanger unless requested to do so.
1414 -  Correct bat restore display of multiple drives. This fixes
1415    bug #1117.
1416 -  Do find_a_volume() each time an unload is done. This
1417    fixes the failure of maxvol2-test.
1418 -  Use Qmsg() in job.c watchdog callback.
1419 -  Release main control rwlock if ABORTing.
1420 -  Make watchdog connect timeout queue messages rather than sending
1421    directly to avoid lock conflicts with the real thread.
1422 -  Remove const char that causes problems with Python, which has
1423    older 'incorrect' headers.
1424 -  Add const char in dbd.c to avoid compiler warnings.
1425 -  Fix mtx-changer to detect both versions of Ubuntu (Debian)
1426    mt. This fixes bug #1116.
1427 -  Fix failure of 2drive-concurrent-test. Always read label;
1428    clear_unload() only after drive is defined in acquire_for_read().
1429 -  Generally clean up the manual tape loading code. The main
1430    conceptial change is that when a volume is marked to be unloaded,
1431    its volume name is retained, and it is only marked as unloaded
1432    when either the autoloader says it is unloaded or another tape
1433    is read on that drive.
1434 -  Fix a recycling problem with two autochangers reported in bug
1435    #1106. This may also (unlikely) fix a second recycling bug as
1436    reported in #1103.
1437 -  Fix a SD lock volumes deadlock problem reported in bug #1100.
1438 -  Fix format problem in bscan output reported in bug #1105.
1439 -  Copy more data when restarting a job so that run
1440    overrides are kept. This should fix bug #1094.
1441 -  Backport updates to jobq.c where possible.
1442 -  Fix bug where SD did not ask operator if the device could not
1443    be opened. Reported by Eric.
1444 -  Add dbuser to DIR conf file (replaces user).
1445 -  Add --with-db-password to ./configure
1446 -  Fix regress to handle db_password.
1447 -  Fix a couple of pedantic compiler warnings.
1448 -  Fix bug when starting a restore on a storage that doesn't
1449    have the requested MediaType.
1450 -  More work on word alignments -- eliminate all ints from
1451    the configuration routines.
1452 -  Fix bug reported by Scott Barninger where the bacula script
1453    refers to scripts in the wrong directory. Needed to meet the
1454    requirements of recent FHS location changes.
1455 -  Fix word alignment problem on non-Intel 64 bit machines
1456    such as Solaris.  This should fix bug #1097 -- bus error in SD.
1457 -  Add missing win32/patches/wxWidgets.patch to 2.4 repository.
1458 ;;;
1459
1460
1461 Kern;;;4 Jun 2008 at 10:30am
1462 Bacula version 2.4.0 Released
1463 This is to inform you that we have released the source and Win32 binaries of 
1464 Bacula version 2.4.0 to the Bacula Source Forge download area.
1465
1466 This release consists mainly of a number of bug fixes since 2.2.x
1467 but most importantly, a rewrite of significant portions of the
1468 Storage daemon reservation and autochanger code. This rewritten
1469 code is simpler, more stable, and works much better, particularly
1470 with multiple drive autochangers than the prior code did.  That
1471 said, there are still a number of issues to be resolved. Note,
1472 the new code has not been tested in manual volume mount situations.
1473
1474 As usual, we strongly recommend when installing to keep the Director and the 
1475 Storage daemon on the same version.  However, since this release only 
1476 contains refactored code and bug fixes rather than new features, the clients 
1477 (File daemons) should function perfectly with any 2.2.x version, and there is 
1478 no database upgrade needed.
1479
1480 =====================================================
1481                                                                      
1482        Release Notes for Bacula 2.4.0
1483
1484   Bacula code: Total files = 500 Total lines = 188,654 (*.h *.c *.in)
1485
1486 This Director and Storage daemon must be upgraded at the same time,
1487 but they should be compatible with all 2.0.x File daemons, unless you
1488 use some of the new features that affect the FD.  In other words, you should
1489 not have to upgrade all your File daemons when you upgrade. There is
1490 no database upgrade needed from version 2.0.x to 2.2.0 nor from version
1491 2.2.x to version 2.4.0
1492
1493 ==================   Warning !!!!!! ==========================
1494 As of Version 2.4.0, the Win32 FD should not descend into
1495 any reparse point directory or reparse mount points unless the
1496 specified directory is explicitly mentioned at the top level of
1497 FileSet (as with Unix). A file that is linked to another file will
1498 be backed up, much like Unix hardlinked files.  If you want
1499 reparse directories backed up, you must explicitly include them
1500 in your FileSet.
1501 ======================================================
1502
1503 This release consists mainly of a number of bug fixes since 2.2.x
1504 but most importantly, a rewrite of significant portions of the
1505 Storage daemon reservation and autochanger code. This rewritten
1506 code is simpler, more stable, and works much better, particularly
1507 with multiple drive autochangers than the prior code did.  That
1508 said, there are still a number of issues to be resolved. Note,
1509 the new code has not been tested in manual volume mount situations.
1510
1511 Bugs fixed:
1512  1095, 1086, 1091, 1070, 1041, 1083, 1078, 1066, 1068, 1038
1513  1062, 1065, 1046, 1047, 1031
1514
1515 New features:
1516 - You can now build bat without the QWT libraries. Use
1517   --without-qwt as a ./configure option.
1518
1519 Release Version 2.4.0
1520 - Update version to 2.4.0 to reflect the magnitude of the SD changes.
1521 - Make sure to clear JS_WaitMedia when operator mounts a Volume.
1522   This fixes bug #1095.
1523 - Add create_postgresql_database.sql to Win32 installer. Should
1524   fix problem reported by Juilio Monteiro.
1525 - Get correct slot when auto unloading a device. This fixes bug
1526   #1086.
1527 - Fix possible seg fault if SQL error.
1528 - Fix renaming a Volume, which used the wrong Volume name.
1529 - If operator has rewind tape, print warning, release tape and
1530   try once more. If tape is positioned somewhere, something went
1531   wrong, so mark the tape in error and try once more. Previously
1532   this error was fatal, now it produces an error message.
1533 - Ensure correct volume name displayed during restore
1534 - Fix a few more Coverity reported problems.
1535 - Fix #1091 about bad output in estimate command.
1536 - Modify autochanger locking to attempt to avoid race
1537   conditions.
1538 - Make sure device not busy before doing label command.
1539 - Display open() errors except when polling. Previously too
1540   many were suppressed.  This should fix bug #1070.
1541 - Fix Win32 reparse points. Bacula will not recurse into any
1542   reparse point directory, including mount points, unless the
1543   directory is explicitly mentioned at the top level (same as   
1544  with Unix).  A file that is linked to another file will be
1545   backed up -- much as Unix does for hardlinked files.
1546   This fixes bug #1041.
1547 - Remove StorageId test when pruning and recycling (Eric's changes).
1548 - Fix buffer overruns detected by Coverity.
1549 - Implement --without-qwt
1550 - Fix layout of restore tree dialog
1551 - Add configure bat QWT libraries, so that bat can be built
1552   with or without the QWT libaries.
1553 - Implement regression that explicitly tests swapping a Volume
1554   from one drive to another.
1555 - Enhance disk-changer to detect most error conditions.
1556 - Fix SD code so that it properly swaps a Volume between drives.
1557   This fixes bug #1083.
1558 - Prevent a Volume that is being swapped from being freed from
1559   the volume list. This will most likely fix, at least partially,
1560   bug #1083.
1561 - Fix strippath so that it does not get a buffer overrun and crash FD.
1562   This fixes bug #1078.
1563 - Make inability to change owner/group when creating a dir only a
1564   warning rather than an error.
1565 - Fix SQL query in migration code
1566 - Fix bat seg fault at termination.
1567 - Add Bacula generated version to bat about box.
1568 - Backport development stream SD reservation system changes.
1569 - When wrong volume is mounted during read, unload_autochanger.
1570 - Stop searching for Volumes in SD askdir if DIR returns the
1571   same volume name twice in a row.
1572 - Rework class structures for VOLRES, DCR, and DEVICE to make
1573   the method names a bit more logical, and for more logically
1574   handling the responsibilities.
1575 - Remove redundant code in terminating the scheduler that just
1576   causes a seg fault in many cases.
1577 - Improve algorithm for detecting pre-reserved volume and
1578   swapping volumes.
1579 - Prevent volume from being released while being swapped.
1580 - Refactor parts of stored/mount.c
1581 - Add sanity checks for VolWriteTime and VolReadTime
1582 - Take care of bad clock changes while computing VolWriteTime
1583   and VolReadTime. This should fix or limit #1066
1584 - Correct error string numbers in dird/catreq.c
1585 - Restructure reserving, acquiring, and mounting volumes. Calls to
1586   autochanger are deferred for mount.c -- simplifes the code.
1587 - Do not prune any running job. It just fails the job.
1588 - Lock the volumes when changing dev->reserved_device and marking
1589   the volume unused otherwise the device can get reserved by
1590   another job before the volume is released, thus blocking it.
1591 - Correct some SD catalog request error messages.
1592 - Turn off code in read_record that causes a seg fault in the SD
1593   when reading past an EOS_LABEL.
1594 - Turn off unloading the autochanger in reserve.c as it just
1595    causes problems.
1596 - Lock volumes when unreserving a device.
1597 - Do not mark volume unused when recycling.
1598 - Fix bug #1068 fixes a SD crash when using Virtual autochanger.
1599 - Generate correct JobMedia records during spooling/despooling when
1600   running concurrent jobs.  Thanks to Tom Ivar Helbekkmo
1601   <tih@hamartun.priv.no> for excellent analysis and testing.
1602 - *Massive* commit of all fixes and back ports to create 2.2.9
1603   Mostly SD reservations enhancements.
1604 - Fix Win32 FD backup/restore memory leak due to improper termination
1605   of BackupRead/Write. This fixes bug# 1038.
1606 - Fixes a StorageId problem with volumes after migration.
1607 - Implements autostart scripts for Debian
1608 - Fix mtx-changer.in for broken Debian mt program.
1609 - Apply doc fix from bug #1062.
1610 - Resolve crash and improper restore wx-console Win32 restore
1611   GUI. Fixes bug #1065.
1612 - Update Win32 wxWidgets to latest version.
1613 - Attempt to do correct handling of Win32 mount points. Should
1614   fix bug #1046.
1615 - Add const to AIX prototype for initgroups()
1616 - Fix to the JobMedia patch, which introduced a new problem.
1617 - Fix creating first JobMedia record during Migration to include
1618   proper index. This caused slow restores of migrated jobs.
1619 - Fix bug #1047, do not strip paths on symbolic links.
1620 - Set catalog backup database and user name from values specified on
1621   the ./configure line.
1622 - Apply patch to correct bug #1031, about wrong pool source information
1623   in job report.
1624 ;;;;
1625
1626 Kern;;;27 Jan 2008 at 10:30am
1627 Bacula version 2.2.8 Released
1628 Bacula version 2.2.8 source tar files as well as the Win32
1629 binaries are available in the bacula and Win32 release areas 
1630 of Source Forge. I have hidden the previous BETA release
1631
1632 Version 2.2.8 is a bug fix to version 2.2.7 and has a few
1633   additional bugs fixed than the BETA 2.2.8 version previously
1634   released:
1635 - It fixes bugs: 1036, 1033(doc), 1028, 1040, 1045(doc), 1030,
1636   1042(partially), and possibly bugs 1018 and 1032.
1637   Bugs 1018 and 1032 involve problems with multiple-drive autochangers,
1638   and are difficult to reproduce.         
1639   See the ChangeLog for more details.
1640   Note, if you previously loaded version 2.2.8 BETA, you will probably
1641   want to upgrade, but it is not urgent ...
1642 ;;;
1643
1644
1645 Kern;;;9 Jan 2008 at 20:30
1646 Bacula version BETA 2.2.8 Released
1647 Bacula version 2.2.8 source tar files as well as the Win32
1648 binaries are available in the bacula-beta and
1649 Win32-beta release areas of Source Forge
1650
1651 Version BETA 2.2.8 is a bug fix to version 2.2.7:
1652 - It fixes bugs: 1036, 1033(doc), 1028, and possibly 1018 and 1032.
1653   Bugs 1018 and 1032 involve problems with multiple-drive autochangers.
1654 ;;;
1655
1656 Kern;;;24 Dec 2007;;20:30
1657 Bacula version 2.2.7 Released
1658 Bacula version 2.2.7 source tar files as well as the Win32
1659 binaries are available in the Bacula release area of Source Forge
1660
1661 Version 2.2.7 has several new features and several important bug fixes
1662   since version 2.2.6:
1663 - It fixes bugs: 1009, 1022, 1024, 1019, 1012, 1021, 1020
1664   1007, 1008.  For more details, please see the technotes-2.1 file.
1665 - Fixed a seg fault reported by Frank Sweetser that depended on
1666   exact path lengths, but the problem was in bsnprintf.c
1667 - Double quoting include filenames (@xxx) in Bacula conf files is now
1668   possible, thanks to a patch by Michael Stapelberg.
1669 - You can pipe input to include filenames (@|prog) by using a vertical
1670   bar, thanks to the above patch.
1671 - A daylight savings time bug in the Win32 bsmpt was fixed by a patch from
1672   Nerijus Baliunas.
1673 - Marc Cousins submitted a patch that permits building the PostgreSQL
1674   driver with version 8.3.
1675 - The configure option --archivedir has been changed to --with-archivedir
1676 ;;;
1677 Kern;;;9 Nov 2007;;15:25
1678 Bacula version 2.2.6 Released
1679 Bacula version 2.2.6 source tar files as well as the Win32
1680 binaries are available in the Bacula release area of Source Forge.
1681
1682 This release is a minor fix upgrade to version 2.2.5,
1683 and we recommend that all users upgrade when they can.
1684
1685 Version 2.2.6 is a minor bug fix realease to version 2.2.5
1686 - It fixes bugs: #1003, 942, 982, 990(response only), 991,
1687   993, 986, 976.
1688   - Fix bat crash wen it cannot connect to Director.
1689   - Fix joblist failure bug in bat.
1690 ;;;
1691 Kern;;;9 Oct 2007;;15:25
1692 Bacula version 2.2.5 Released
1693 Despite the fact that the Release Notes are rather short, the bug
1694 fixes represent quite a lot of work:
1695
1696 Version 2.2.5 is a major bug fix release to version 2.2.4
1697 - It fixes the following bugs: #961, 962, 963, 969, 968, 960,
1698   964, (possibly 935 and 903), 953, 953, 967, 966, 965, 954,
1699   957, 908, 958, and 955.
1700 - It also improves listing performance problems in bat pointed
1701   out by Chris Howells.
1702 ;;;
1703 Kern;;;29 Sept 2007;;20:30
1704 A serious data loss bug in Bacula version 2.2.4 found and fixed
1705
1706 This bug was very elusive and time consuming to track down.  It
1707 turned out to be a race condition that can lose the last one or
1708 two blocks of a Job, which can happen in rare cases only when
1709 running multiple simultaneous jobs when a volume fills and one
1710 Job finishes receiving the last data from the FD and at the same
1711 time a second job detects the end of the Volume.  The bug was
1712 introduced in version 2.0.0 and did not exist in version 1.38.x.
1713 If the bug is triggered, the data is lost (not written to the
1714 Volume), and it can occur for any backup job of any level under
1715 the conditions noted above.
1716
1717 The bug is reported in the bugs database as bug #964, and just
1718 this morning I found and tested a fix, which is attached as a patch
1719 to the bug report.  The patch (2.2.4-lost-block.patch) is also
1720 uploaded to the bacula-patches 2.2.x release area.  This bug may
1721 also be part of the problems reported in bug #935 and possibly
1722 #903.
1723
1724 Also in the bacula-patches 2.2.x area, you will find other
1725 patches that fixes bugs #953, 966, 967, 965, 958, 908, and
1726 955. Please refer to bugs.bacula.org for the details.
1727
1728 Though this bug quite serious (data loss), it should be rare.
1729 However, we recommend everyone to apply the patch.
1730 ;;;
1731 Kern;;;2007/9/14;;;14:30 
1732 Bacula version 2.2.4 Released 
1733
1734 This version of Bacula is a minor bug release to version 2.2.3.
1735 It contains the following fixes:
1736
1737 - Possible fix for authorization problems bug #953.
1738 - Possible fix for bug #908.
1739 - Add waits to multiple exit detection code to try to force pid
1740   file to always be deleted.
1741 - Restore good dev.tar.gz to rescue set appropriate binary property.
1742   This fixes bug #950.
1743 - Fix seg fault in error exit of acquire_for_read after unsuccessfully
1744   trying to switch drives by checking for blocking before unblocking.
1745   Fixes bug #906.
1746 - Cancel storage daemon in all cases where FD reports error. This
1747   should fix virtually all cases of bug #920 and will ensure that Devices
1748   are released as soon as possible.
1749 - Fix error message that was clobbered when Dir tells SD it does not
1750   have write permission on Volume.  This should fix a minor point
1751   in bug #942, but not the main problem.
1752 - Fix migration code to get correct Volume name with multiple volumes 
1753   by skipping |.  Fixes bug #936.
1754 - Implement patch supplied by Landon to fix bug #944 where using
1755   TLS with bconsole uses 99+% of the CPU.
1756 - Fix bug #946 about "bacula-dir -t" which doesn't works
1757   as expected.
1758 - Using "m" in bconsole will show messages as in prior versions
1759   and not memory usage.
1760
1761 - Note, you need GTK >= 2.10 to be able to link the Tray Monitor
1762   program.
1763 ;;;
1764 Kern;;;2007/9/9;;;14:30
1765 I regret to announce that there is a rather serious bug in Bacula.
1766
1767 Bacula bug #935 reports that during a restore, a large number of files are 
1768 missing and thus not restored.  This is really quite surprising because we 
1769 have a fairly extensive regression test suite that explicitly tests for this 
1770 kind of problem many times.
1771
1772 Despite our testing, there is indeed a bug in Bacula that has the following 
1773 characteristics:
1774
1775 1. It happens only when multiple simultaneous Jobs are run (regardless of
1776 whether or not data spooling is enabled), and happens only when the
1777 Storage daemon is changing from one Volume to another  -- i.e. the
1778 backups span multiple volumes, and it only happens for Jobs writing
1779 to the same volume.
1780
1781 2. It has only been observed on disk based backup, but not on tape.
1782
1783 3. Under the right circumstances (timing), it could and probably does happen
1784 on tape backups.
1785
1786 4. It seems to be timing dependent, and requires multiple clients to
1787 reproduce, although under the right circumstances, it should be reproducible
1788 with a single client doing multiple simultaneous backups.
1789
1790 5. Analysis indicates that it happens most often when the clients are slow
1791 (e.g. doing Incremental backups).
1792
1793 6. It has been verified to exist in versions 2.0.x and 2.2.x.
1794
1795 7. It should also be in version 1.38, but could not be reproduced in testing,
1796 perhaps due to timing considerations or the fact that the test FD daemons
1797 were version 2.2.2.
1798
1799 8. The data is correctly stored on the Volume, but incorrect index (JobMedia)
1800 records are stored in the database.  (the JobMedia record generated during
1801 the Volume change contains the index of the new Volume rather than the
1802 previous Volume).  This will be described in more detail below.
1803
1804 9. You can prevent the problem from occurring by either turning off multiple
1805 simultaneous Jobs or by ensuring that while running multiple simultaneous
1806 Jobs that those Jobs do not span Volumes.  E.g. you could manually mark
1807 Volumes as full when they are sufficiently large.
1808
1809 10. If you are not running multiple simultaneous Jobs, you will not be
1810 affected by this bug.
1811
1812 11. If you are running multiple simultaneous Jobs to tapes, I believe there is
1813 a reasonable probability that this problem could show up when Jobs are split
1814 across tapes.
1815
1816 12. If you are running multiple simultaneous Jobs to disks, I believe there is
1817 a high probability that this problem will show up when Jobs are split across
1818 disks Volumes.
1819
1820 13. The bug concerns only the Storage daemon so there is no need to update
1821 the clients, though I do recommend updating the Director when installing
1822 an updated Storage daemon.
1823
1824 I have uploaded patches to bug #935 (bugs.bacula.org) that will correct
1825 version 2.2.0, 2.2.1, and 2.2.2.  The patch has been tested only on version
1826 2.2.2 and passes all regression tests as well as the specific test that
1827 reproduced the problem. 
1828
1829 The patch has now been confirmed to fix the problem reported, and Bacula
1830 version 2.2.3 has been released to Source Forge.
1831
1832 For the technical details of the bug, please see: 
1833
1834   http://www.bacula.org/downloads/bug-935.txt
1835
1836 ;;;
1837
1838 Kern;;;2007/8/11;;;14:30
1839
1840 Bacula Version 2.2.0 has been released to Source Forge.         
1841
1842           Release Notes for Bacula 2.2.0 
1843
1844   Bacula code: Total files = 520 Total lines = 195,550 (*.h *.c *.in)
1845   82 new files, 41,221 new lines of code, 208,380 lines of change from 2.0.3
1846
1847 This Director and Storage daemon must be upgraded at the same time,
1848 but they should be compatible with all 2.0.x File daemons, unless you
1849 use some of the new features that affect the FD.  In other words, you should
1850 not have to upgrade all your File daemons when you upgrade. There is
1851 no database upgrade needed from version 2.0.x to 2.2.0.
1852
1853 Areas requiring caution or testing:
1854 - You must have the thread safe version of MySQL client libraries loaded
1855   to build with MySQL enabled.
1856 - Volumes are pruned only when absolutely necessary -- this may cause
1857   your database to grow compared to prior Bacula versions.
1858 - Solaris door and even port files are no longer restored (equivalent
1859     to what we do with sockets).
1860 - SQLite is no longer supported for Solaris -- it fails too often with
1861   bus errors.  SQLite3 should work on Solaris.
1862 - The default setting for SQLite3 is now 'PRAGMA synchronous=OFF'.
1863   This makes it run 30 times faster, but increases the possiblity
1864   of a corrupted database if your server shuts down unexpectedly.
1865   The default behavior can be changed in src/version.h
1866 - Restore on Win32, and in particular on Vista is untested. Please
1867   test before relying on it.  It should backup and restore reparse
1868   points.
1869 - Win32 servers are untested, and very likely not to work.
1870
1871 The major new features are:
1872 - Much faster insertion of attributes (somewhere around 10 times),
1873   many thanks to Eric Bollengier and Marc Cousin. 
1874 - First release of bat (Bacula Administration Tool).  Note to build
1875   bat you must explicitly enable it on the ./configure line, you
1876   must have the Qt4 version 4.2 or later libraries loaded, the qwt
1877   (Qt Graphics) package loaded, and qmake and the other Qt4 tools 
1878   must be available. Most of the implementation was done by Dirk Bartley.
1879 - Red/Black restore in memory tree (500 times faster loading).
1880 - The Regex Where code to allow easier relocation of restored files 
1881   thanks to Eric.
1882 - Socket level heartbeat for all connections (untested).
1883 - posix_fadvise() use in the FD to improve performance reduces
1884   swapping due to opening/reading lots of files. Win32 equivalent
1885   implemented.
1886 - Much improved Volume reservation code that should eliminate most
1887   conflicts experienced in multiple drive autochangers.
1888 - Simpler locking in the SD in the reservation system.
1889 - Detection of file size/date change during backup if enabled.
1890 - New Recycle Pool feature -- thanks to Eric.
1891 - Efficient implementation of very large include/exclude lists.
1892 - Volumes are no longer pruned during 'status dir'
1893 - Pruning is now more efficient, and if a Volume is purged,
1894   during pruning, it is immediately discovered.
1895 - License is now GPL v2 without modifications, fix a few copyright
1896   mistakes made when adding FSFE copyright notice.
1897
1898 New ./configure options:
1899 - --enable-bwx-console    
1900 - --enable-bat
1901 - --with-qwt=
1902 - --with-db-name=
1903 - --with-db-user=
1904 - --enable-batch-insert
1905
1906 New bconsole commands:
1907 - exec
1908 - memory
1909 - update recyclepool
1910 - .sql
1911 - .api
1912 - .pwd (in restore tree)
1913 - restoreclient (keyword)
1914 - backupclient  (keyword)
1915 - regexwhere    (keyword)
1916 - update jobid  (new command)
1917 - recyclepool   (keyword) 
1918
1919 New directives:
1920 - Heartbeat Interval (bconsole.conf)
1921 - Heartbeat Interval (bacula-dir.conf in Director, Client, Storage)
1922 - TLS Allowed CN     (bacula-dir.conf in Client)
1923 - Regex Where        (bacula-dir.conf in Job)
1924 - Strip Prefix       (bacula-dir.conf in Job)
1925 - Add Prefix         (bacula-dir.conf in Job)
1926 - Add Suffex         (bacula-dir.conf in Job)
1927 - Recycle Pool       (bacula-dir.conf in Pool)
1928 - FailJobOnError     (bacula-dir.conf in RunScript)
1929 - CheckFileChanges   (bacula-dir.conf in FileSet)
1930 - StripPath          (bacula-dir.conf in FileSet)
1931
1932 Other features or bug fixes:
1933 - Fixed bugs: 916, 910, 917, 914, 906, 907, 
1934   842, 830, 893, 861, 888, 886, 807, 877, 872
1935   885, 887, 864, 874, 882, 881, 863, 859, 
1936   856, 854, 845, 847, 846, 809, 772, 
1937   822, 825, 824, 808, 802, 797, 798, 795, 789, 791, 
1938   788, 780, 763, 782, 612, 767, 775, 621, 772, 764, 
1939   766, 621, 761, 755, 750, 741, 747, 742, 744, and 743.
1940 - Configure bat with --enable-bat. Define qwt libraries with
1941   --with-qwt=<dir>. See Installation chapter of manual for details.
1942 - Create a depkgs-qt package that has both Qt4 and qwt, which are
1943   needed to build bat. Most modern Linux systems will have both
1944   these packages in the distro.
1945 - Storage overrides delete all previous storage definitions instead
1946   of prepending.
1947 - One should be able to mount and unmount removable devices if the
1948   Device resource has Removeable Media set and the mount and unmount
1949   directives are defined.
1950 - ./configure will do a better job of searching for qwt libraries.
1951 - The Win32 version can no longer be shutdown from the tray monitor.
1952   Use the command line or the Services panne.
1953 - Keep prune_volumes() from pruning the whole Scratch pool.
1954 - More debug output in status storage.
1955 - Correct moving a Scratch volume from pool to pool (some
1956   critical columns were lost).
1957 - Different locking in reservations and despooling systems,
1958   which means more micro-locking and less macro-locking, which
1959   should give a lot more concurrency at the expense of slightly
1960   (<0.1%) more overhead due to more locking/unlocking, but     
1961   concurrent jobs should run much faster.
1962 - Additional drive reservation algorithm that should solve a lot of
1963   the problems experienced with multiple drive autochangers.
1964 - Storage daemon status command enhanced to more clearly show Volume,
1965   pool and media type when a job is waiting.
1966 - Made bsmtp work with more strict SMTP servers.
1967 - Detect doubly freed buffers in smartall.c
1968 - wx-console renamed to bwx-console (Fedora request)
1969 - gnome-console renamed to bgnome-console (Fedora request)
1970 - Migration preserves original job's FileSetId
1971 - Spooling implemented for migration jobs.
1972 - Config files can be read through a pipe, by specifying a leading |
1973   in front of the configuration path/filename.
1974 - New memory command (bconsole) that will print the current Director's
1975   memory usage, and an in use buffer dump.
1976 - Console name changed from *Console* to -Console- to accomodate Win32
1977   filename restrictions.  
1978 - Corrected the Win32 ftruncate bug.
1979 - Additional version information added to Job reports.
1980 - New -8 option for bsmtp to specify UTF-8 encoding type.
1981 - bsmtp will no longer add < > to target (from, to, cc) if there
1982   is already a < in the target.
1983 - Prefer Mounted Volumes extended to mean a volume that is being
1984   mounted by another job.
1985 - Runscript timing set to same as version 1.38.11
1986 - New TLS Allowed CN directive(s) permitted.
1987 - New bconsole 'exec' command to run external script/command.
1988 - Turn on FreeBSD/OpenBSD code to set EOT model on tape.
1989 - Drop from root done before database is opened.
1990 - Database user and name can be configured with:
1991   --with-db-name=name --with-db-user=user
1992 - Turn on wait_for_drive in mtx-changer script.
1993 - Rework how bar codes are handled in mtx-changer script.
1994   This appears to have been an unreported bug.
1995 - Updated nagios plugin supplied by Christian Masopust
1996 - Better restricted console ACL checking.
1997 - New Client Connect Wait directive in Storage daemon so that
1998   users can configure how long SD waits for FD connection.
1999 - Bacula will no longer permit pruning of the currently running
2000   job (note, if other jobs are running, they may be pruned).
2001 - Sockets are no longer restored.
2002 - dbcheck works in 300K chunks so will typically run faster.
2003 - Include/Exclude lists can now be efficiently handled for quite
2004   large sizes -- tens of thousands of entries.
2005 - Several memory leaks in migration and database usage were fixed.
2006 - New console keyword restoreclient, which specifies the client to
2007   which the restore will be sent. The client keyword specifies 
2008   the backup client. The restoreclient keyword is optional if it is
2009   not specified, the backup client will also be the restore client.
2010 - The disk file size is now checked to ensure that it agrees with the
2011   catalog value before Bacula will append to the disk (same as tape
2012   and DVD).
2013
2014 ;;;
2015
2016 Kern;;;2007/3/6;;;14:30
2017
2018 Bacula Version 2.0.3 has been released to Source Forge.
2019 This is a bug fix release to version 2.0.2.  If you are upgrading from
2020 a version older than 2.0.0, please be sure to read the important notes
2021 below.
2022
2023 Also, please check the patches directory in the current SVN or the
2024 patches release section on Source Forge for important bug fixes to   
2025 this version.
2026
2027 5Mar07
2028 kes  File migrate bug with Pool Occupancy using mediaid instead
2029      of jobids.  Fixes bug #795.
2030 kes  Fix orphaned buffers in filed backup and verify due to
2031      crypto buffers not freed during errors.  Fixes bug #789.
2032 04Mar07
2033 kes  Add smartctl call to bacula-sd.conf as an example of getting
2034      tape alert info.
2035 02Mar07
2036 kes  Add Client Connect Wait to Storage daemon to permit users to
2037      modify the time the SD waits for a FD connection.
2038 28Feb07 
2039 kes  Apply Command ACL filter to JobId list in restore command.
2040 kes  Correct typeo in var.c patch.
2041 27Feb07
2042 kes  Don't let Bacula prune File or Job records for the current Job.
2043 kes  Fix variable substitution pad + inc bug reported (with patch)
2044      in bug #791.
2045 26Feb07
2046 kes  Correct SQLite log table index as reported by Luca Berra.
2047 24Feb07
2048 ebl  Fix FIFO stuff, bacula tries to rewind the FIFO... Thanks to Andreas
2049 22Feb07
2050 kes  Fix a few places in lib/message.c where the open fd may
2051      not be zeroed.
2052 21Feb07
2053 kes  Add LANG=C to autoconf/randpass so it works with languages other
2054      than English.  Fixes bug #788.
2055 20Feb07
2056 ebl  Revert ClientRunBeforeJob as it was in 1.38.x
2057      This fixes bug #780
2058      You will not be able to generate Include/Exclude list any more.
2059      If you want to use this, you can apply 
2060      trunk/bacula/patches/testing/clientrunbeforejob_can_generate_include_exclude_list.patch
2061 19Feb07
2062 kes  Restore of sockets created false error messages because Bacula
2063      no longer restores sockets, but the code was still trying to
2064      set the attributes on a non-existent file. Reported by a user.
2065 16Feb07
2066 kes  Fix encryption deblocking bug, which caused some restored files
2067      to be truncated. This fixes bug #763. This is a CRITICAL bug fix.
2068 kes  Add FD event sequence order prepared by Eric -- for RunScripts.
2069 kes  Fix 12am/pm bug as reported in bug #782.
2070 15Feb07
2071 kes  Add quick disconnect FD code from 2.1.4 to 2.0.3.  This code
2072      causes the SD to release the FD as soon as the FD has sent
2073      all the data to the SD. After that the SD will do any final
2074      despooling (data and attributes) that are necessary. This
2075      allows laptops to disconnect much quicker from the network 
2076      after a backup.
2077 13Feb07
2078 kes  Apply Eric's ClientRunScriptAfter patch to 2.0 and 2.1.
2079 11Feb07
2080 kes  Optimize the use of the database a bit in the Status dir command.
2081      Only open it when needed, ensure that if any previous database
2082      was opened, it is closed.
2083 10Feb07
2084 kes  Modify dbcheck to handle orphaned JobMedia, Path, Filename,
2085      and File records in 300K chunks to be more efficient. This
2086      idea came from Juan Luis Frances (if I remember right).
2087 09Feb07
2088 kes  Update projects list.
2089 08Feb07
2090 kes  Fix dird/ua_cmds.c so that a cancel command checks if the
2091      console is authorized to cancel the job.  This fixes bug 
2092      #767.
2093 kes  Modify SD so that the VolCatJobs medium record is updated
2094      at the beginning of a Job rather than the end.  This
2095      fixes bug #775 where exceeding MaxVolJobs caused jobs
2096      to fail.
2097 kes  Added a mutex around getting and setting Volume information
2098      so that multiple simultaneous jobs will single thread.
2099 07Feb07
2100      Switch to using Subversion
2101 kes  Remove src/pygtk-console/ from configure
2102 06Feb07
2103 kes  Delete src/lib/btree.c from win32 build, then add rblist.c
2104      plus the entrypoints.
2105 kes  Apply patch supplied that corrects debug print
2106      in canceling jobs for max run time.  Supplied as
2107      part of bug #621, which was previously fixed.
2108 05Feb07
2109 kes  Test on job_canceled() and sd_msg_thread_done inside
2110      loop starting the message thread to avoid a race condition.
2111      Fixes bug #771.
2112 kes  Remove rl_catch_signal from console.c as it conflicted
2113      with the header definition. Fixes bug #765.
2114 ebl  Fixes bug #766 about RunsOnClient = Yes (case sensitive)
2115 04Feb07
2116 kes  Clarify some stored/acquire messages to indicate if the
2117      problem is with read or append.
2118 02Feb07
2119 kes  Fix memory leak with storage ids in cats/sql_get.c
2120 kes  Terminate watchdog earlier to avoid reference to released
2121      memory -- reported by Jason Austin.
2122 kes  Move closing the database from jobq.c to the director daemon
2123      termination routine. This fixes memory leaks for shadow jobs
2124      (i.e. migration jobs).
2125 kes  Free up the unique jobid chain items in migrate.c.  This fixes
2126      a memory leak problem.
2127 kes  Convert some ugly looking for statements to use foreach_alist
2128      in findlib/find.c.  This will facilitate converting the structures
2129      to use dlist (for large include/exclude lists).
2130 kes  Fix a bug in the btree.c and btree.h routines, then rename them
2131      rblist and add them to be built in src/lib.  Include some new
2132      methods written by Rudolf Cejka that make the code more readable
2133      (hides some of the ugly casting).
2134 26Jan07 (back port)
2135 kes  Implement item #12 on project list -- quick release of FD by
2136      the SD. This is noted in more detail above.
2137
2138 ;;;
2139
2140 Kern;;;2007/1/28;;;14:30
2141
2142 Bacula Version 2.0.2 released:
2143 28Jan08
2144 kes  Fix maxruntime bug #621.
2145 27Jan07
2146 kes  Get current main CVS .specs for RedHat, SuSE, Mandrake.
2147 26Jan07
2148 ebl  Implement the include JobID in spool file name project.
2149 kes  Reorder projects file in order determined by Jan 2007 vote.
2150 kes  Fix open of SQLite3 db where user does not have write permission
2151      so that DIR does not crash. Fixes bug #761.
2152 25Jan07
2153 kes  Change 'Device not configured to autolabel' from INFO
2154      to WARNING.
2155 kes  Fix jobq.c to restart failed jobs when Reschedule Times = 0
2156      which should restart an indefinite # of times.
2157 kes  Fix configure --help to print --with-mysql[=DIR]. Same for
2158      other DIR specifications.
2159 23Jan07
2160 rn   Fix msvc build problems. Fix bacula.dll exports for msvc build.
2161      Fix path quoting in SQLite scripts.
2162      Fix problems with SHGetFolderPath.
2163 19Jan07
2164 kes  Create patches/2.0.1-restart.patch. Fixes bug #755.
2165 18Jan07
2166 kes  Fix Job restart on error bug that promotes an Inc to a Full
2167      backup.  This should fix bug #755.
2168 kes  Add qt-console and first cut of code.
2169
2170 ;;;
2171
2172 Kern;;;2007/1/13;;;14:30
2173
2174 Bacula Version 2.0.1 has been released to Source Forge.
2175 This is bug fix update to version 2.0.0 and contains
2176 the following fixes:
2177
2178 -    Fix Bacula->Documentation link on Win32 to point to index.html
2179      instead of bacula.html. Fixed bug #750.
2180 -    Return JobId in db_get_job_record() when JobId==0. This should
2181      fix bug #741.
2182 -    Do not release source pointers when restarting a failed job.
2183 -    Add dynamic dll entry point for SHGetFolderPath to Win32 code.
2184      This *should* fix bug #747.
2185 -    Modify winbacula.nsi to substitute with g bin_dir_cmd. Should fix
2186      bug #742.
2187 -    Modify USTORE constructor to set an empty store_source string, 
2188      and don't copy the store_source string in a cancel.  Hopefully
2189      this will fix Arno's seg fault, bug #744.
2190 -    Add back code to disable conio in configure. Fixes bug #743.
2191 -    Correct the Options scanner in the FD to correctly handle  
2192      SHA1 option, which was eating the next option.  Reported by    
2193      Sebastien Guilbaud.
2194 -    Add code to indicate when the SD is spooling, spool wait, and 
2195      despooling as requested by Alan Brown.
2196
2197 ;;;
2198
2199 Kern;;;2007/1/4;;;14:30
2200
2201 Bacula Version 2.0.0 has been released to Source Forge.
2202
2203 There is an English Press Kit, written by Dan Langille at:
2204    
2205    http://www.bacula.org/about/press/presskit200.html.en
2206
2207 and a German version, translated by Arno Lehmann at:
2208
2209    http://www.bacula.org/about/press/presskit200.html.de
2210
2211 ;;;
2212    
2213 Kern;;;2007/1/4;;;14:31
2214
2215           Release Notes for Bacula 2.0.0
2216
2217   Bacula code: Total files = 438 Total lines = 154,329 (*.h *.c *.in)
2218
2219 ==== IMPORTANT Catalog update required =====
2220 - The database format has been updated from what was used in    
2221   Bacula 1.38.x.  You must manually update your database before 
2222   running Bacula 1.39.x or higher.  If you are using Bacula supplied
2223   RPMs this is not necessary as the RPM does it automatically.
2224   Please backup your previous version of the database before
2225   running the update.  The update script will be automatically
2226   installed in your scripts directory, or can also be found in
2227   <bacula-source>/src/cats.  It is called:
2228
2229      ./update_bacula_tables
2230
2231   It is necessary to run it only once the first time you move to
2232   a 2.0.0.  Upgrading the Bacula version thereafter does not
2233   require updating the database again.  Depending on the size of
2234   your database the script make take a bit of time, to run, but
2235   in general, it should be very fast.
2236
2237 ==== IMPORTANT new Win32 install procedure =====
2238   For Win32 migrations from versions prior to 1.39.0 nothing special
2239   needs to be done to upgrade.  Everything should be taken care of
2240   automatically.  The only thing not done is to delete the old C:\bacula
2241   directory mostly out of paranoia.
2242
2243 ==== IMPORTANT miscellaneous ====
2244 - The Gnome console program (gconsole) no longer functions as it
2245   should.More importantly, in restore mode, the restore tree is
2246   no longer shown in the left pane.  I suspect this is due to
2247   incompatible changes in the GTK+ API, and hence have given up
2248   on gnome and gtk+, as this has already happened several times
2249   previously.  At some point there will be a new GUI console.
2250 - The bacula-dir.conf directive Accept Any Volume has been
2251   removed because it was never implemented. You must delete all
2252   occurrence of this directive for the Director to run. The Storage
2253   daemon will automatically accept any valid Volume that you mount.
2254 - The --mandir ./configure option now points to the top level man
2255   directory.  The man files will be installed under mandir/man8 and
2256   mandir/man1 as appropriate.
2257 - You *should* be able to use 1.38.x FDs with version 2.0.0 Director
2258   and SD providing you do not use any of the new features (runscript,   
2259   data encryption). It seems to work here, but we do not guarantee it.
2260 - Your Director and SD must be simultaneously upgraded.
2261 - The restore command no longer uses the MediaType as the primary method
2262   of finding a suitable Storage device. Normally it will select the last
2263   device used to write a Volume. If no storage device is defined, it
2264   will use the old algorithm which selects the first Storage resource  
2265   with the correct MediaType.
2266 - The MD5/SHA1 hash codes kept in the database are now kept in a binary
2267   format compatible with the rest of the world. If you are running verify 
2268   jobs, you *must* do an InitCatalog or all files will show an MD5   
2269   difference.  Also, authentication uses the new algorithm by
2270   default, but *should* accept connections from older components (FD) using
2271   the old non-compatible algorithm. This has been tested, but more
2272   more testing is still needed.  
2273 - A stock SuSE 10.1 kernel may crash when Bacula runs and accesses
2274   the tape drive. Workaround, load the SuSE 10.1 version 2.6.16.21-0.25
2275   kernel or later. The SuSE 10.2 Alpha 5 or later kernel also works.
2276   This problem may also be present in certain Fedora FC5 kernels.
2277 - If you have been using the data encryption feature of 1.39.x, please
2278   be aware that certain combinations of encryption and other options
2279   with version 1.39.0 through 1.39.26 created Volume data that cannot
2280   be restored. We strongly recommend that anyone using encryption 
2281   carefully review his/her backups and at a minium do a Full backup
2282   with 1.39.28 of all encrypted data.  Robert Nelson has identified 
2283   and fixed it as follows:
2284      As of 1.39.27:
2285         No filters = Works fine
2286         Sparse = Works fine
2287         Compression = Works fine
2288         Encryption = Works fine
2289         Sparse + Compression = Works fine
2290
2291         Sparse + Encryption = Restore broken
2292         Sparse + Compression + Encryption = Restore broken
2293         Compression + Encryption = Restore broken
2294
2295      As of 1.39.28:
2296         Most combinations work, but some encrypted files are
2297         not properly restored.
2298
2299      As of 1.39.30:
2300         All combinations work fine except Sparse+Encryption.
2301
2302   Bottom line, if you are using data encryption, please test restoring
2303   data to be sure it all works correctly.
2304 - The current Volume format written by 1.39.22 is different from
2305   the format written by previous versions. The two formats
2306   are not compatible. Thus any DVDs written prior to 1.39.22 will
2307   be unreadable by version 1.39.22.
2308 - If you previously run a Bacula version prior to 1.39.30, the JobMedia
2309   data may not be correct for disk Volumes. This can cause incorrect
2310   seeking in versions after 1.39.30. If you experience what appears to
2311   be data I/O or integrity errors during restores, please add the
2312   following directive to your disk DEVICE resource in the Storage
2313   daemon conf file:
2314
2315     Block Positioning = no
2316
2317   This will turn off all seek requests during restores and avoid
2318   this problem.
2319 - VSS for Windows clients is now enabled by default.
2320 - Do not unload autochanger when doing "update slots"
2321 - Implement mount command for autochanger, see manual.
2322
2323 New Features in 2.0.0:
2324 - Turn on disk seek code for restores.
2325 - There is a partial but reasonable translation of the Bacula
2326   messages for French.  To install it, first configure and build
2327   Bacula, then as root run:
2328
2329     cd <bacula-source>/po
2330     make install
2331
2332   If you have your locale set properly you will get the translated
2333   messages.
2334 - Bacula now support Migration jobs that are documented in a new
2335   Migration chapter in the manual
2336   http://www.bacula.org/dev-manual/Migration.html
2337 - Data encryption is now implemented and is documented in
2338   a new chapter of the manual at:
2339   http://www.bacula.org/dev-manual/Bacula_Data_Encryption.html
2340 - Additional support for removable devices.  See the 
2341   Requires Mount, Mount Point, Mount Command, and Unmount
2342   Commands in the Storage daemon configuration chapter:
2343   http://www.bacula.org/dev-manual/Storage_Daemon_Configuratio.html
2344   Also see the Edit Codes for Mount and Unmount Directives in the
2345   same chapter.
2346 - Switch the Win32 build from using Microsoft C++ to using mingw32
2347   cross-compiling.  The initial work was done by Howard Thomson,
2348   then tweaked by me.  Robert Nelson then totally reworked the
2349   cross-compiling code so that it not only cross-compiles, but
2350   also compiles on Visual Studio, and at the same time, he added
2351   all the current Unix features to the FD, such as selection on
2352   drives, encryption support, building *all* the tools, ...
2353 - The Director and Storage daemon have now been ported to Win32.
2354   This code is working but should still be tested carefully
2355   before putting into production.
2356 - Bacula restore and bextract can now extract non-portable Win32 data to
2357   any client (including Unix/Linux clients). Of course, in doing so,
2358   the Microsoft specific permissions and ACLs will be lost.  Thanks
2359   to Thorsten Engel for this code.
2360 - The 260 character limitation for Win32 paths name lengths is now 
2361   eliminated thanks to Thorsten Engel. However, if you are using
2362   Volume Shadow Copy, please be careful to specify all the paths
2363   in the bacula-fd.conf file using a full path notation including
2364   the drive letter.
2365 - Eric Bollengier wrote new RunScript directives that includes
2366   the old RunBefore/AfterJob and ClientRunBefore/AfterJob features
2367   plus a *lot* more, allowing you to control just about every aspect
2368   of running scripts.  See the manual for detailed documentation.
2369   http://www.bacula.org/dev-manual/Configuring_Director.html#5227
2370 - SunOS ACLs should now work thanks to a patch from David Duchscher.
2371 - Apply days keyword patch from Alexander.Bergolth at wu-wien.ac.at
2372   If this patch is applied, the number of days can be specified with
2373   "list nextvol days=xx"
2374   or
2375   "status dir days=xx"
2376   This can be used to preview the next scheduled job (and the
2377   next tape to be used) on Fridays if there are no scheduled jobs during
2378   the weekend.
2379 - From Eric Bollengier. One can now using the bconsole wait command do:
2380    wait  (wait for all jobs to stop)
2381    wait jobid=nn
2382    wait jobuid=unique id
2383    wait job=job-name
2384 - Volumes can now be set to Enable, Disable, or Archive. If they
2385   are not enabled, Volumes will not be mounted.             
2386   Implement update volume enable=(on|off|true|false|archived|0|1|2)
2387 - Add Catalog message destination in Messages resource that puts the
2388   job report in the Log database table.
2389 - Writing/reading DVD Volumes is much more stable -- to the point
2390   of being useful. Thanks to Richard Mortimer.
2391 - Add enable/disable job=<job-name>.  This command prevents
2392   the specified job from being scheduled. Even when disabled,
2393   the job can be manually started from the console.
2394 - The database Id records should be 32/64 bit independent now. 64 bits
2395   can be enabled by changing one define and changing the appropriate
2396   table variable. Normally, you need 64 bits only for FileId.
2397 - Relative path specifications (i.e. ../xxx) are now permitted in
2398   the restore cd command.
2399 - When running multiple simultaneous jobs, most jobs that use spooling
2400   will now finish faster due to a mutex optimization made by Eric
2401   Bollengier.
2402 - Conf files containing UTF-8 marker at the head of the file as well as
2403   conf files containing Window cr/lf and Mac cr line termination characters 
2404   are now accepted thanks to Robert Nelson.
2405 - Windows tray status windows are scrollable and resizable.
2406 - Win32 external script execution is much more flexible -- handles
2407   spaces in names better, ...
2408 - Lots of DVD fixes -- writing DVDs is now reported to work.
2409 - Fix opening of database in a restricted console to respect     
2410   any Catalog ACL.
2411 - Much better automatic handling of multiple database catalogs in
2412   the restore command.
2413 - Permit multiple console/director resources in bconsole.conf.
2414   patch from Carsten Paeth calle@calle.in-berlin.de
2415 - Character substitution in Job/JobDefs WriteBootStrap.
2416   from Eric Bollengier.
2417 - Apply patch supplied in bug #656 to pass priority field
2418   in the run dialog to the Director in gnome console.
2419 - Add support of encrypted data stream to bscan from Eric.
2420   display data_len instead of data content (may be binary).
2421 - Add Enabled=xxx on update slots command.
2422 - Add host:port to connect failure messages to FD and SD from Dir/
2423 - Add WhereACL to console ACL list.  If nothing is specified, only
2424   the default is permitted for restore. Otherwise, *all* allows any
2425   path, or you can specify permitted paths. This should allow control
2426   over where users can restore files. This is untested.
2427 - Install man pages with 'make install'.
2428 - Add Media.Enabled flag to client backups for dotcmds.c
2429 - Enforce Media.Enabled=1 for a current restore to work
2430 - Require restore case 3 to have sqlquery permission to work.
2431 - Add -n option to bconsole to turn off conio -- used in bweb.
2432 - The bytes field in the terminated jobs part of the status
2433   command now reports in KB, MB, ... units.
2434 - When not descending into a directory, print the File= name that
2435   triggered it -- makes why not descending a bit clearer
2436 - Do not unload autochanger when doing "update slots"
2437 - Implement mount command for autochanger
2438 - Fix bug #462 incorrect error message printed when client script called
2439   from File= was not found.
2440 - Fix bug #558 (waiting for feedback) where Bacula needs too much time to
2441   do a rewind on Solaris when no tape is in the drive (Solaris does not
2442   have the detailed errno found on Linux).  Added Solaris specific code.
2443   Note, this may apply to other OSes as well.
2444 - The examples directory has a new bacula_mail_summary.sh file that
2445   creates a single email summary of any number of jobs. Submitted by
2446   Andrew J. Millar.
2447 - Add nagios plugin to the examples directory. Submitted by
2448   Christian Masopust.
2449 - Modify most restore error messages to be queued so that they
2450   appear at the end of the job rather than mixed with the restore
2451   listing where they could be "lost".
2452 - Apply patch supplied by user (slightly modified) to fix
2453   correct detection of holes in block devices and FIFOs.
2454   Bug # 506.
2455 - Added a report.pl program to the examples directory from Jonas Bjorklund.
2456 - Add two new queries to query.sql provided by Arno. One
2457   list volumes known to the Storage device, and the other
2458   lists volumes possibly needing replacement (error, ...).
2459 - Implement new code for changing userid and group at startup. This
2460   should get Bacula into the correct groups.
2461 - Implement support for removable filesystems -- device type directive
2462   and mount, unmount directives.
2463 - Transfer rates are now presented in a more readable format thanks
2464   to a user submission.
2465 - SD is now aware of what volumes are mounted. More information is printed
2466   in the Status report. You must take much more care now to unmount
2467   devices prior to removing tapes that Bacula has open or prior to
2468   changing a magazine. Don't forget to do a mount afterwards or the
2469   device will be blocked.
2470 - The Pool Maximum Volumes directive is now respected in all places.
2471 - A Storage device can now be specified in a Pool resource. It will override
2472   all other Storage specifications.
2473 - Most but not all directives accept true/false in place of yes/no.
2474 - A patch from Karl Hakimian that reads JobIds, FileIndexes
2475   from a database table for restore.
2476 - There are a number of new tables. Some such as the Location table are
2477   designed for user use in doing Volume Management software.
2478 - Maximum Changer Wait, Maximum Open Wait, Maximum Rewind Wait to
2479   accept time qualifiers.
2480 - Implement jobuid to replace old usage of job in keywords as
2481   suggested by Eric Bollengier.
2482 - Implement write variables for Python to set Priority (anytime), and
2483   Job Level, only during JobInit event.
2484 - Use the keyword ujobid to mean the unique job id; job or jobname
2485   to mean the Job name given on the Name directive, and jobid to
2486   be the numeric (non-unique) job id.
2487 - Allow the SD to use multiple drives during a backup/restore (only
2488   one at a time).
2489 - Integrate addition of line count limitation to bsmtp -l from
2490   Sebastian Stark <stark at tuebingen.mpg.de>
2491 - Split the bacula start/start script into four files:
2492    bacula         -- starts and stops calling other scripts
2493    bacula-ctl-dir -- starts/stops the director
2494    bacula-ctl-fd  -- starts/stops the File daemon
2495    bacula-ctl-sd  -- starts/stops the Storage daemon
2496 - Remove automatic case folding on Windows FDs. You must
2497   explicitly use the 'Ignore Case = yes' option.
2498 - Implement wild program in tools directory for testing
2499   wild-cards. Almost identical to the regex program.
2500 - Use the new bregex.c to implement Regex expressions on Win32.
2501 - Apply patch from Christopher Hull
2502   - Allow multiple connections to database with different
2503     parameters.
2504   - Invalidate the scheduler when doing a reload. Fixes seg
2505     fault, but still 60 second window.
2506   - Additional info in Reschedule message.
2507   - Use set_jcr_job_status() everywhere to prevent loss of
2508     cancel, error.
2509   - Display peer IP in FD if error from connecting DIR.
2510   - Don't increment file count for DIRBEGIN.
2511   - Replace illegal characters in Win32 filename by _.
2512   - Add SE_CREATE_PERMANENT_NAME privilege in Win32.
2513   - Hash hard link filenames rather than linked list (performance).
2514   - Fix for security failure in chdir on Win32.
2515   - Add CreateDirectoryA/W win32 API entry points.
2516 - programs to duplicate Bacula's base64 algorithm using standard
2517   routines. This fixes bugs #296, and 565. Patch submitted by
2518   author of bug #565.
2519 - Fixes to reloading the Dir conf file from Eric Bollengier and Christopher
2520   Hull.
2521 - Modify LICENSE to correct some problems pointed out by Debian.
2522 - Apply a patch submitted by cesarb in bug #606 to implement O_NOATIME support.
2523     O_NOATIME is a open() flag which makes it possible to read a file without
2524     updating the inode atime (and also without the inode ctime update which
2525     happens if you try to set the atime back to its previous value). It also
2526     prevents a race condition when two programs are reading the same file, but
2527     only one does not want to change the atime. It's most useful for backup
2528     programs and file integrity checkers (and bacula can fit on both
2529     categories).                                                    
2530   You enable it in the Bacula FileSet Options resource by setting:
2531      noatime = yes
2532   The effect of this option is similar to the keepatime option except
2533   it is more efficient and avoids modifying ctime.
2534 - Implement a pile of new man pages contributed by Jose Tallon.
2535 - Modify the database format for handling Migration jobs:
2536    Add PriorJobId, RealEndTime to Job table
2537    Delete MAC table
2538    Remove Stripe from JobMedia record (not used, wasting space)
2539    Add ScratchPoolId, RecyclePoolId, Enabled to Media record
2540    Add Cost to Location table.
2541    Enabled to Media table and Location table.
2542 - Security: harden authentication failure in FD by single threading errors
2543   and forcing a 6 second wait.
2544 - If using GCC (actually g++) add the following compiler flags
2545   -fno-strict-aliasing -fno-exceptions -fno-rtti
2546 - Turn on new bsnprintf() code.  The reason for this code is to
2547   eliminate the security problems associated with using the
2548   system libraries print routines.
2549 - Implement job report that indicates where Storage and Pool
2550   came from -- with overrides and Pool storage and NextPool,
2551   it is all very complicated.
2552 - Add more detail (Storage, Device) to list of volumes printed
2553   for restore.
2554 - Add new VOLMGMT message class. No messages are yet sent with this 
2555   class.
2556 - Improved Bacula rescue procedures -- see the Disaster Recovery
2557   chapter of the manual
2558 - Add spooling/despooling info in status output of SD.
2559 - Add Comment field to llist of a volume.
2560 - Allow true/false in many but not all yes/no directives.
2561 - The Bacula source code is now copyrighted by the Free Software 
2562   Foundation Europe. The Developer's Guide documents the new procedures,
2563   and the LICENSE file has been updated.
2564 - Apply Jaime Ventura's patch that implements the Messages resource
2565   Mail On Success directive.
2566 - The Client returns its Version string, which is printed in the Job
2567   report.
2568 - The Client returns whether or not VSS and Encryption are used, which
2569   are printed in the Job report.
2570
2571 Additional Features Added for Win32:
2572 - Added DriveType directive to the Director's Include Option FileSet
2573   resource.  Allowed values are: fixed, removable, cdrom, and remote.  There
2574   is only an implementation for Windows because it is the only platform that
2575   has the concept of drives.
2576  
2577 - Adds EnhancedWild directive to the Director's Include Option FileSet
2578   resource.  Allowed values are: yes and no.
2579  
2580   When EnhancedWild is enabled then the processing of the
2581   Wild, WildDir and WildFile is changed in the following ways.
2582  
2583   Patterns conform to Posix
2584       \ is not a special character in character classification []
2585       To match a - it must be the first or last character
2586       To match a ] it must be the first character
2587  
2588       fnmatch option FNM_FILE_NAME is specified * doesn't match a / 
2589       so it won't match multiple directory levels in a path
2590  
2591 - Relative WildFile patterns (ones without a leading /) match
2592   against the filename portion.  This in combination with the
2593   FNM_FILE_NAME fnmatch() flag makes directives such as WildFile =
2594   abc*.def work as expected.
2595  
2596 - Adds support for the shell's feature of brace expansion.
2597
2598   Here is an example where braces allow 24 lines to be expressed in 5.
2599
2600   # Exclude directories full of lots and lots of useless little files
2601   WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/Cookies"
2602   WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/Recent"
2603   WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local Settings,LOCALS~1}/History"
2604   WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local Settings,LOCALS~1}/Temp"
2605   WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local Settings,LOCALS~1}/Temporary Internet Files"
2606
2607 ;;;