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