]> git.sur5r.net Git - bacula/bacula/blob - bacula/ReleaseNotes
update releasenotes
[bacula/bacula] / bacula / ReleaseNotes
1
2                Release Notes for Bacula 5.2.2
3
4   Bacula code: Total files = 1,110 Total lines = 231,439 (Using SLOCCount)
5
6 General:
7 --------
8 The 5.2.2 version is an important bug fix release. It contains also some
9 aditions and performance improvements. 
10
11 The 5.2.1 version is a major release since the last version 5.0.3.
12 It includes well over 299,387 lines of changes made by 20 contributors,
13 lots of bug fixes (see below), 1,851 software commits,and a 
14 number of important new features:
15
16 Version 5.2.0 was short lived, because Marco (thanks) found
17 a number of last minute bugs. So the first official release of 5.2
18 is 5.2.1.
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 5.2 New Features:
30 -----------------
31 - LZO Compression
32 - New Tray Monitor
33 - Purge Migration Job
34 - Changes in Bvfs (Bacula Virtual FileSystem)
35 - Changes in the Pruning Algorithm
36 - Ability to Verify any specified Job
37 - Additions to RunScript variables
38 - Additions to the Plugin API
39 - ACL enhancements
40 - XATTR enhancements
41 - Class Based Database Backend Drivers
42 - Hash List Enhancements
43
44 Some of the above are described below; all the above are
45 described in more detail in the New Features chapter of the
46 manual.
47
48 Closed Bugs since 5.0.3:
49 ---------------------
50 1389 1444 1448 1466 1467 1468 1476 1481 1486 1488 1493 1494 1497 1499 1501
51 1502 1504 1509 1511 1513 1516 1524 1526 1527 1532 1536 1538 1541 1542 1549
52 1551 1553 1554 1558 1559 1560 1564 1567 1568 1569 1571 1574 1577 1581 1582
53 1584 1587 1594 1595 1600 1601 1602 1603 1604 1606 1608 1610 1612 1623 1624
54 1633 1643 1648 1655 1661 1664 1666 1669 1672 1675 1684 1685 1695 1696 1699
55 1700 1703 1735 1741 1749 1751 1761 1762 1764 1768 1770 1771 2710
56
57 Note on bug 1612 where Bacula does not save a checksum for hard links during
58 full backup, but expects one during accurate differential backups. You need
59 a Full backup with the 5.2.x code to have these checksums in the Catalog.
60 Doing Incr/Diff over a 5.0.x Full backup will still display lot of errors.
61
62
63
64 ================== Warning !!!!!! ==========================
65
66  The new pruning algorithm will not allow pruning of jobs that are essential to
67  restore since the last Full backup. This is, of course, correct and desirable,
68  but it is different from older Bacula versions that could inappropriately
69  prune jobs. Pruning of volumes is not affected.
70
71 Building Bat:
72 -------------
73 To build Bat, you need Qt4 version 4.6.2.  If you build with any other
74 version it is likely not to work.  If you do not have version 4.6.2, on
75 your system, you can download the Bacula depkgs_qt version 16Dec10.
76
77 Packaging the SQL backend:
78 --------------------------
79 The main Bacula Director code is independent of the SQL backend
80 in this version. This means that the Bacula Director can be packaged
81 by itself, then each of the different SQL backends supported can
82 be packaged separately.  It is possible to build all the DB backends
83 at the same time.
84
85 - configure can be run with multiple database configure options.
86    --with-sqlite3
87    --with-mysql
88    --with-postgresql
89
90 Order of testing for database is
91 - postgresql
92 - mysql
93 - sqlite3
94
95 Each configured backend generates a libbaccats-<backend_name>-<version>.so
96 A dummy catalog library is created named libbaccats-version.so
97
98 At configure time the first detected backend is used as the so called default
99 backend and at install time the dummy libbaccats-<version>.so is replaced with
100 the default backend type.
101
102 If you configure all 3 backends you get 3 backend libraries and the postgresql
103 gets installed as the default.  When you want to switch the default you can
104 copy one of the 3 backend libraries over the libbaccats-<version>.so e.g.
105
106 cp libbaccats-postgresql-<version>.so libbaccats-<version>.so
107
108 And update the default backend in the following files:
109
110 create_bacula_database
111 drop_bacula_database
112 drop_bacula_tables
113 grant_bacula_privileges
114 make_bacula_tables
115 make_catalog_backup
116 update_bacula_tables 
117
118 New Catalog format in version 5.2.0 and greater
119 -----------------------------------------------
120 This release of Bacula uses a new catalog format. We provide a set of
121 scripts that permit to convert a 5.0.x (version 12) catalog to 5.2.1 (version
122 14).  The Bacula project rpm spec files have been modified to
123 detect the database change and do the upgrade for you.  We strongly
124 recommend that you save a copy of your existing database before upgrading
125 using rpms.
126
127 The simplest way to upgrade the database assuming you are building from
128 source (i.e. manually):
129 1. Stop any current version of Bacula from running.
130 2. Save a copy of your existing database.
131 3. Configure, build, and install the 5.2.1 version of Bacula
132    Note the new ./configure options in the manuals see the link
133    at the bottom of this file.
134 4. cd <your-scripts-installation-directory>
135 5. ./update_bacula_tables
136 6. If you have multiple catalogs, edit the update_bacula_tables
137    script and put the name of another database, and then
138    execute the script again. Repeat this until all Bacula
139    catalogs have been updated.
140 7. Start the new Bacula.  If everything worked, it should
141    not print any error messages.
142
143 If you start from scratch, you don't need to run the update_bacula_tables
144 script because the create_bacula_tables script automatically creates the new
145 table format.  However, if you are using a version of Bacula older than 5.0.0
146 (e.g.  3.0.3) then you need to run the update_bacula_tables script that will
147 be found in the <bacula>/src/cats directory after you run the ./configure
148 command.  As mentioned above, before running this script, please backup your
149 catalog database, and when you do running it, be sure shutdown Bacula and be
150 aware that running the script can take some time depending on your database
151 size.
152
153 ================================================================
154
155 Changes:
156
157 Speed and Memory Usage Enhancements:
158 - Implement LZO compression algorithm (need lzo2 headers to activate this option)
159 - New Pruning algoritm -- safer and faster
160 - Use of PostgreSQL cursor when doing large queries, should reduce the
161   memory usage during restore and accurate backups.
162 - limit command in some list commands
163 - Bacula Virtual File System for fast catalog access
164 - Faster crc32 algorithm
165
166 Security Enhancements:
167 - Additional security against injection of illegal characters
168 - Fix possible fnmatch problem
169
170 Features Enhancements:
171 - Improvements in ACL and xattr handling on additional platforms:
172   AIX, Darwind, FreeBSD, HPUX, IRIX, Solaris, Tru64
173 - Tray monitor for Windows
174 - New SQL backend and ./configure that permits building multiple catalog
175   backends in one build, and has the main Bacula core code totally independent
176   of the SQL backend, which should simplify packaging (only the
177   libbacsql.so/dll needs to be changed to switch from one database backend
178   to another (e.g. MySQL to PostgreSQL).
179 - Indent lsmark during restore
180 - Disable batch insert config item
181 - Director selection option in bconsole
182 - restorejob command in bconsole
183 - Many additional features for bat such as "brestore" panel
184 - The old bat version browser has been turned off since it does not
185   work correctly and the brestore panel provides the same functionality
186 - Improved hash table for hard links
187 - Additional script variable editing such as %b (JobBytes), %F (JobFiles) 
188   and %h (Client Address)
189
190 Other Enhancements:
191 - Includes better handling for Windows repares points, mount points, and 
192   junction points.
193 - New database format
194 - Many new plugin API features
195 - Improved memory handling for restores
196 - Significant stability enhancements to bat
197 - xattr/ACL restore failure are now printed as Warning
198 - A few path name length limits in Windows have been removed.
199
200
201 ===========================================================================
202
203 The 5.0.3 version is significant bug fix update to version 5.0.2.
204 It includes new code and some new features.
205 There is no database change since prior versions of 5.0.
206
207 Note, if you are running 5.0.0, read the 5.0.1 and 5.0.2 release notes below in
208   the 5.0.1 release section.
209   Important!!!
210
211 Compatibility:
212 --------------
213  As always, both the Director and Storage daemon must be upgraded at
214  the same time.
215
216  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.0.3
217  Director and Storage daemons. There should be no need to upgrade older File
218  Daemons.
219
220 Changes and New Features:
221 - If a VSS (Windows) snapshot fails, the whole Job is failed, previously
222   it printed a warning message and continued.
223 - New editing codes %b = Job Bytes and %f = Job Files for runscripts
224 - Any non-Bacula project plugins (i.e. third party plugins) 
225   must be upgraded to specify AGPLv3 in place of the GPLv2 used previously 
226   for the PLUGIN_LICENSE.
227 - The bat Media page text columns can be sorted by clicking on the column.
228 - If possible, the SD will automatically update the catalog Volume size if 
229   it does not match the Volume size. The mismatch between the Volume sizes
230   typically occurs when the FD has a comm line drop or the FD crashes.
231
232
233 Bug fixes
234 1538 1554 1564 1567 1568 1569 1571 1577 1581 1582 1587 1594 1595 1606 1610
235
236 - Change license from GPLv2 to AGPLv3
237 - Make Win32 no filesystem change more explicit
238 - Backport Branch-4.0 release to Branch-5.0
239 - Massive backport from Branch-5.1 to Branch-5.0
240 - Fix postgresql catalog creation when version is not on the first line
241 - Fix bug #1610 handle empty xattr values on Linux and xBSD.
242 - Garbage collect memory pool at end of job and before sm_dump
243 - Add xattr seg fault protection suggested by Marco for bug #1610
244 - Add archlinux to os.m4
245 - More fixes for 32/64 bit problems in smartall
246 - Fix 32/64 bit problem in smartalloc dump routine
247 - Fix bad copy/paste in commit c88dccb88 prably a seg fault
248 - Add .dump and .exit commands for daemons
249 - Make SD automatically fix the Volume size in the Catalog when out of sync
250 - Use Pmsg in smartall.c rather than printf for tracing Windows
251 - Up maximum block size to 20M
252 - Fix for TLS bugs #1568 and #1599
253 - Improve comm line error handling for TLS, may fix bug #1568 and #1599
254 - Fix problem when sending Cancel event to plugin
255 - Convert all Jmsg on the watchdog thread to Qmsg
256 - Fix SD crash due to mismatched lock/unlock in error condition
257 - Fix bug #1587 if you have clients with different catalogs configured, both 
258   catalogs contains all clients after a reload or restart of the dir
259 - Fix bug #1577 During migration: ERROR in block.c:950 Failed ASSERT: dev->is_open() 
260   by moving and commenting out the ASSERT()
261 - Skip HB kill in FD if HB thread terminated
262 - Fix crash from unequal volume_lock/unlock calls
263 - New prunning algorithm -- should be more accurate
264 - Save any dumps during regression to dumps directory
265 - Fix crash from rw_lock/unlock miss match
266 - Attempt to fix duplicate job kill seg fault
267 - Replace pthread_kill by my_thread_send_signal() in jcr.c
268 - fix #1595 about batch mode detection problem for postgresql with non standard 
269   install dir
270 - Fix #1594 about prune copy jobs
271 - Apply literal string fix in printf submitted by Luca Berra
272 - Fix bug #1582 Restore from multiple storage daemons breaks subsequent backups
273 - Fix segfault on "cancel jobid=" command
274 - Fix bug #1554 Windows installer doesn't honor /S flag
275 - Remove pool zap code that breaks 2drive-concurrent-test
276 - Fix #1571 and install libraries with 755 perms
277 - Fix bug #1581 ASSERTs in src/dird/jobq.c can never trigger
278 - Fix problem with BaseJob and Accurate FileSet options on client side
279 - Fix for bug #1569 deadlock/crash in Dir
280 - Fix segfault when loading Plugins
281 - Fix #1567 about display of long volume names truncated during restore
282 - Added new bacula-libs package.
283 - Fix bug #1538 Start Scripts return incorrect value
284 - Fix bug #1564 init scripts not LSB compliant
285
286 See ChangeLog for more details.
287
288 =============================================================================
289
290
291 ============= Release 5.0.2 ========================
292
293 Changes since 5.0.1
294 -------------------
295
296 Bug fixes
297 1502 1511 1517 1524 1527 1532 1536 1541 1549 1551 1553 1559 1560
298
299 - Probable fix for SD crash bug #1553
300 - Fix #1559 problem when restoring pruned jobs with a regexp
301 - Fix for bug #1560 bcopy cannot find Volume
302 - Fix cancel crash bug #1551
303 - Check if sql backend is thread-safe
304 - Correct Pool display in SD status. Fixes bug #1541
305 - Fix cancel crash reported by Stephen Thompson
306 - Rewind on close to fix #1549
307 - Remove closelog() in bpipe fixes bug #1536
308 - Fix #1517 about missing Base level in .level command
309 - Replace ASSERT in block.c with fail Job
310 - Fix database locking calling db_lock and returning from function without
311   calling db_unlock.
312 - Add missing db_unlock to bvfs_update_cache.
313 - Fix #1532 about permission on binaries
314 - Fix #1527 about deadlock during migration
315 - Another fix for OpenSSLv1
316 - Add -lrt to Solaris links
317 - Fix tls.c for OpenSSLv1
318 - Fix #1511 when trying to insert more than 50.000 directories in bvfs
319 - Fix plugin load not to stop if one plugin bad -- pointed out by James
320 - Remove --without-qwt from configure statement.
321 - Second correct fix to bug #1524 verify fails after adding or removing files
322 - Fix bug #1524 verify fails after adding or removing files
323 - Apply fix suggested by Andreas in bug #1502 for mediaview column sort problem
324 - Fix OpenSSL 1.x problem in crypto.c on Fedora 12
325 - Display AllowCompress warning message only if compression used in FileSet
326
327 =============================================================================
328
329
330 ============= Release 5.0.1 ========================
331
332 !!!!!!!!!!!!!!! NOTE FOR 5.0.0 USERS !!!!!!!!!!!!!!!!!!!!
333 The Allow Duplicate Jobs directive has been significantly 
334 reworked, and the default value has changed. See below.
335
336 Truncate On Purge has been totally rewritten. See the new
337 features section of the manual.
338
339 When Volume Poll Interval is set in the SD DEVICE configuration,
340 (default 5 mins), after a certain number of polling tries (approx
341 10) polling will stop and the operator will be asked to
342 resolve the problem.  Previously there was no limit, and an
343 error message could be produced at each poll attempt.
344 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
345
346 Changes since 5.0.0
347 -------------------
348 - We believe that we have resolved most of the problems
349   concerning canceled or failed jobs being "stuck" in the
350   Director.  There is one outstanding problem in the SD when
351   canceling jobs that we will fix in the next major release.
352   If you see jobs that seem to be stuck, in general issuing
353   a cancel command in bconsole should now make them go away.
354
355 Directives:
356 - The default for "Allow Duplicate Jobs" has been changed from 
357   no to yes.  If you use this directive, please check your
358   conf file, and note the next two items !!!!!!!!!!!!!!!!!!!
359 - AllowHigherDuplicates disabled. It did not work as documented   
360     and was confusing.
361 - New directive "CancelLowerLevelDuplicates" See New Features
362   section in the manual.
363 - Truncate on Purge rewritten.  See New Features section in the manual.
364
365 Bug fixes:
366 1448 1466 1467 1468 1476 1481 1486 1488 1494 1497 
367 1499 1501 1505 1509 1513
368
369 - Ensure SD asks for help when looping even if poll set. Fixes bug #1513.
370 - Fix three-pool regress bug
371 - Modify bacula.spec fixes bug #1505
372 - This version fixes an issue where the console window would start out
373   docked. It is fixed by initiating the variables in the Pages class wi
374   constructor.
375 - Fix make_catalog_backup.pl fails when catalog db is on other host
376 - Apply MacOSX installer patch from bug #1509
377 - Apply fix to previous fix of Copy problem. Fix proposed by reporter o
378   #1476
379 - Fix bug #1501 -t does not print errors
380 - Apply SQLite3 update fix from bug #1497
381 - Apply bashism fix for diskchanger.in script from bug #1499
382 - Apply rpm fix for Sci Linux from bug #1494
383 - Take most recent Ukranian po from bug #1448
384 - Probable fix for Copy/Migration bug #1476
385 - Fix bug #1488 -- avoid recursion and race conditions in messages.c
386 - Upgrade cats library also to 5.0.0
387 - Fix missing console page in bat
388 - Add bat help files to Window install
389 - Improve Windows upgrade to ensure old FD is shutdown
390 - Fix bug #1481 -- bat consumes all console file descriptors
391 - Backport truncate on purge from 5.1.x
392 - Fix bug #1486 -- bat doesn't show any errors on command-line
393 - Update the bsock error URL
394 - Correct .my.cnf umask in make_catalog_backup.pl
395 - Apply fix for dbcheck use by make_catalog_backup.pl
396 - Fix seg fault in bscan from new comment field
397 - Allow multiple CNs when using TLS
398 - Fix seg fault in SQlite driver
399 - Make shared libs version the same as the Bacula release version
400 - Remove file_index sequential check
401 - Fix #1466 about Bogus pruning message
402
403 For Packagers:
404 1.  The default query.sql file is now, except for some comments, empty.
405 The old file, which we no longer support (it is impossible or difficult to
406 make it work on every backend, and the queries are mostly contributed) can
407 be found in <bacula-source>/examples/sample-query.sql.  The sample file is
408 not installed by the Makefiles
409
410 2.  When you install the mtx-changer script, you must also install
411 mtx-changer.conf if it does not exist.  This new file (mtx-changer.conf) is
412 required for mtx-changer to work, but it is a user configurable file, so on
413 any update, any existing file should not be overwritten.
414
415 3.  Bat should be built on every platform that is capabable of running Qt.
416 However, the Qt code is changing rather quickly and is not always
417 compatible from version to version.  We have built and verified bat on Qt
418 4.3.4.  We strongly recommend that you do not build and distribute bat with
419 any other version of Qt unless you personally test it.  To build against Qt
420 4.3.4, download the depkgs-qt package from the Bacula Source Forge download
421 location, read the README file and follow the instructions.
422
423 If you are building for Bacula version 5.0.0, please ensure that you do not
424 have qmake-qt4 loaded on your system.  If you do, either remove it or
425 rename it before trying to build bat.  If you do not, bat will probably be
426 built using the shared objects on your system.  For Bacula 5.0.1 and later,
427 this problem (bug) does not exist.
428
429 depkgs-qt does not install Qt on your system, nor does it interfere with
430 you having any other version of Qt installed on your system.  Once you
431 build bat with depkgs-qt, it should *not* use the Qt shared objects, but
432 rather they will be linked into the program.  After fully installing bat
433 (make install), you can run "ldd bat" to see what shared objects it will
434 use.  If any Qt shared objects are referenced, something has gone wrong.
435
436 4.  Unless absolutely necessary, we recommend that you do not define any
437 special library environment variables that apply to the ./configure -- for
438 example: LIBDIR=/...  ./configure <your-options> is strongly discouraged.
439 Doing so, could potentially cause Bacula to be linked against the wrong
440 shared objects.
441
442 5.  The Bacula project strongly recommends that you install Bacula into a
443 single directory, with a few minor exceptions such as the MySQL or
444 PostgreSQL databases.  Preferrably this should be /opt/bacula.  The full
445 recommendation is:
446
447 #!/bin/sh
448 # Recommended configure script for Bacula
449 prefix=/opt/bacula
450 email=xxx@yyy.zz
451 CFLAGS="-g -O2 -Wall" \
452   ./configure \
453     --sbindir=${prefix}/bin \
454     --sysconfdir=${prefix}/etc \
455     --docdir=${prefix}/html \
456     --htmldir=${prefix}/html \
457     --with-working-dir=${prefix}/working \
458     --with-pid-dir=${prefix}/working \
459     --with-subsys-dir=${prefix}/working \
460     --with-scriptdir=${prefix}/scripts \
461     --with-plugindir=${prefix}/plugins \
462     --libdir=${prefix}/lib \
463     --enable-smartalloc \
464     --enable-tray-monitor \
465     --enable-bat \
466     --with-mysql \
467     --with-dump-email=${email} \
468     --with-job-email=${email} \
469     --with-smtp-host=localhost \
470     --with-baseport=9101
471
472 Obviously, the email, and some of the minor options (mysql, postgresql,
473 ...) can be changed to suit your distribution, but the directory names
474 defined above are strongly recommended, and over time the default values in
475 the bacula-dir.conf and bacula-sd.conf will reflect these choices.
476
477 If you have any questions about this or would like a detailed document
478 describing our recommendations including packaging requirements, please
479 send an email to the bacula-devel list.
480
481 6.  Starting with Bacula version 3.0.0 up to Bacula 5.0.0, the shared
482 libraries that Bacula uses by default are named xxx-1.0.0.  Starting with
483 Bacula 5.0.1, we are going to name the libraries using the Bacula version.
484 So in Bacula 5.0.1, the libraries will be named xxx-5.0.1.  With future
485 versions, the last digit may or may not change when we distribute patch
486 updates (i.e.  the last digit of the version changes).  This will depend on
487 whether or not we have changed something in the library.  Hopefully this
488 new procedure will resolve some of the incompatibility problems between
489 different versions of the shared objects.
490
491 7.  The default build option for bconsole is conio (my own little console
492 routines).  I did this because some years ago, readline was very difficult
493 to maintain -- it and where it was found seemed to change on every release.
494 This generated at the time a number of support problems.  It seems to me
495 that since then there have been very few problems with readline.  As a
496 consequence, I have no problem if you want to make bconsole with readline
497 enabled.  It will actually give some very nice new bconsole command
498 completion functionality that Eric has written.  Bottom line: feel free to
499 use readline or not as you please.
500
501 ==========================================================
502
503
504
505 Release Notes for Bacula 5.0.0
506
507 Release Numbering:
508 -----------------------------------------------------------
509 You might be wondering why this release jumps from 3.0.x to 
510 5.0.0 thus skipping version 4.0.0.  We have done this for 
511 several reasons: first, we wanted a way of distinguishing
512 the numbering system for the Bacula System Enterprise version
513 and the Bacula Project version.  So, to do so, we have decided
514 that the first number of the Bacula Project version will always
515 be odd, and the first number of the Enterprise version will always
516 be even. Thus the Bacula Project now moves from 3.0.x to 5.0.x.
517 In addition, we want to keep the Bacula Project version larger
518 than the Enterprise version to indicate that the Bacula Project
519 version is more advanced or has more features than the 
520 Enterprise version. For memory, the current Enterprise version
521 is 2.6.1, and the next release (in a few months -- before June 2010)
522 will be version 4.0.0.
523
524 Warning:
525 --------------------------------------------------------------
526 Please note the three Warnings below before doing any install or
527 upgrade.
528        
529
530 Changes since 3.0.3a (the last Bacula Project release):
531 -------------------------------------------------------
532
533 Bug fixes:
534 1337 1351 1352 1354 1357 1361 1367 1369 1370 1373 
535 1376 1391 1403 1409 1420 1422 1427 1428 1431 1450 
536 1454 1455 1458 1456
537
538 Fixed:
539  - Problem that locks the Director when the SMTP server wasn't 
540    responding to the bsmtp program 
541  - Restore's dir command shows incorrect file sizes 
542  - Fix various problems with the reload command   
543  - Fix problems with conio
544  - Eliminate several deadlocks or potential race conditions from SD
545
546 Enhancements:
547  - Project 5: Truncate volume after purge
548  - Project 6: File Deduplication using Base Jobs 
549  - Project 10: Restore from Multiple Storage Daemons
550  - Project 11: AllowCompression per Device
551  - Project 23: Add Maximum Concurent Jobs for Devices to balance load 
552    between drives
553  - Add Accurate Fileset Options to configure accurate detection. Can use 
554    checksum verification for example.
555  - Allow FD to keep root read but drop write permission (CAP)
556  - Secure handling of passwords for catalog backup
557  - Add Tab-completion for Bconsole when using Readline
558  - Add Bvfs API to query the catalog without building a memory tree
559  - Add new speed test to btape program
560  - Add new Bat screens (Autochanger content, Job view, Media view, ...)
561  - Windows version of Bat
562  - Added Spanish Bacula translation   
563  - New bconsole -u nnn option to have timeout on commands
564  - Allow Migrate, Copy, and Virtual Full to read and write
565    to the same Pool
566  - show disabled   -- shows disabled Jobs
567  - Add Pool File and Job retention periods (take precedence over Client)
568  - Many ACL improvements
569  - Level added to FD status Job entry
570  - Allow turning on/off Block Checksum per device
571  - Set Device Poll interval to 5 minutes -- previously did not poll
572  - Implement lock manager with bad order protection
573
574 Compatibility:
575 As always, both the Director and Storage daemon must be upgraded at
576 the same time, and on any given machine, you must run only one version
577 of Bacula. This means that on the Director and Storage daemon machines,
578 you *must* upgrade your File daemon as well.
579
580 Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 5.0.0
581 Director and Storage daemons. There should be no need to upgrade older File
582 Daemons immediately. However, we recommend that you do so as soon
583 as is reasonable for your situation.
584
585 ================== Warning !!!!!! ==========================
586
587 New Catalog format in version 5.0.0 (3.1.9 or later)
588 -----------------------------------------------------
589
590 This release of Bacula uses a new catalog format. We provide a set of
591 scripts that permit to convert a 3.0.x (version 11) catalog to 5.0.0 (version
592 12).  The Bacula project rpms distributed on Source Forge will automatically
593 detect the database change and do the upgrade for you.  We strongly
594 recommend that you save a copy of your existing database before upgrading
595 using rpms.
596
597 The simplest way to upgrade the database assuming you are building from
598 source:
599 1. Stop any current version of Bacula from running.
600 2. Save a copy of your existing database.
601 3. Configure, build, and install the 5.0.0 version of Bacula
602    Note the new ./configure options in the manuals see the link
603    at the bottom of this file.
604 4. cd <your-scripts-installation-directory>
605 5. ./update_bacula_tables
606 6. If you have multiple catalogs, edit the update_bacula_tables
607    script and put the name of another database, and then
608    execute the script again. Repeat this until all Bacula
609    catalogs have been updated.
610 7. Start the new Bacula.  If everything worked, it should
611    not print any error messages.
612
613 If you start from scratch, you don't need to run the update_bacula_tables
614 script because the create_bacula_tables script automatically creates the new
615 table format.  However, if you are using a version of Bacula older than 3.1.9
616 (e.g.  3.0.3) then you need to run the update_bacula_tables script that will
617 be found in the <bacula>/src/cats directory after you run the ./configure
618 command.  As mentioned above, before running this script, please backup your
619 catalog database, and when you do running it, be sure shutdown Bacula and be
620 aware that running the script can take some time depending on your database
621 size.
622 ================================================================
623
624
625 ================== Warning !!!!!! ==========================
626 If you upgrade a previous Win32 client installation, you must
627 first stop the File daemon, then uninstall it before attempting
628 the upgrade. If you do not do so, the upgrade will probably
629 fail and you will need to manually find and run the 
630 Uninstall.exe file, before you can upgrade to the new version.
631 This is because the file locations are different.  If you want
632 to save your previous bacula-fd.conf file, please do so before
633 uninstalling it.
634 ================================================================
635
636 ================== Warning !!!!!! ==========================
637 Due to permissions problems on Windows Vista and later systems,
638 we no longer require SYSTEM or Administrator permissions to 
639 access the binaries and configuation files.  If you wish
640 to restrict access to these files, please see the New Features
641 section of the manual for how to set access control lists.
642 ================================================================
643
644 Note, the Win32 Installer no longer installs the Bacula Servers
645 (Director and Storage daemon). See the New Features section of
646 the manual for more details.
647
648 ============ Documentation improvements needed ==================
649
650 Note!!!!! The 5.0.0+ documentation has a number of known problems:
651
652 1. We have reduced the number of manuals, which has fixed many
653    of the broken links found in the old 3.0.x version, but there
654    are still some that need fixing.
655
656 2. Integration of the 3.0.x features into the main manuals has
657    not yet been done.
658
659 The documentation will not be completed in the near future due to lack
660 manpower.  If you are unhappy with this situation as we are, we suggest
661 you help by submitting patches to the documentation.  Thanks.
662 =====
663
664
665 This release includes large number of new features and changes.
666 It should be more or less compatible with previous xx.conf files
667 and File daemons providing that you are not using any of the new
668 features.
669
670 Please see the New Features chapter of the new manual, which documents
671 some but not all the new features (we are still working on it):
672
673 http://www.bacula.org/5.0.x-manuals/en/main/main/New_Features_in_5_0_1.html
674   
675 The ChangeLog has more details.