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