]> git.sur5r.net Git - bacula/bacula/blob - bacula/ReleaseNotes
Tweak ChangeLog ReleaseNotes
[bacula/bacula] / bacula / ReleaseNotes
1
2                Release Notes for Bacula 5.2.11
3
4   Bacula code: Total files = 1,110 Total lines = 231,439 (Using SLOCCount)
5
6 General:
7 --------
8 Version 5.2.11 version is a bug fix release.
9
10 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
11 Please note that with this version of Bacula, during the install
12 of the shared libraries from the src/cats, src/lib, and src/findlib
13 directories, any old Bacula libraries in the installation 
14 destination directory will be removed.  This should not cause
15 any problems and at least keeps the installation library cleaner.
16 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
17
18 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
19 For packagers, if you change options, naming, and the way 
20 we link our shared object files, as at least one of you does,
21 you are creating a situation where the user may not be able
22 to run multiple versions of Bacula on the same machine, which
23 is often very useful, and in addition, you create a configuration
24 that the project cannot properly support.
25 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
26
27 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
28 If you are upgrading from a version older than 5.2.10, please
29 read all the old ReleaseNotes of all versions released
30 after the version you are upgrading from. There area
31 many important notices sumarized here, and we do not 
32 repeat them each bug fix release.
33 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
34
35 Compatibility:
36 --------------
37  As always, both the Director and Storage daemon must be upgraded at
38  the same time.
39
40  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.11
41  Director and Storage daemons. There should be no need to upgrade older File
42  Daemons.
43
44 Important changes since last release:
45  - A new bpluginfo utility tool
46  - Make dump_resource respect console ACL's (security fix)
47  - Add chio-changer-openbsd submitted in bug #1903
48  - Important Copy job bug fixed.
49
50 10Sep12
51  - Add JobId to SD debug output
52  - Commit batch session every 800,000 files
53  - Simplify safer delete code using a single regex
54  - Clean up error message generation during update attributes -- should fix bug 
55   #1823
56  - Eliminate heartbeat error messages. Fixes bug #1925
57  - Apply patch from bug #1911 to implement --with-logdir
58  - Add chio-changer-openbsd submitted in bug #1903
59  - mysql database install/update scripts patch. Fixes bug #1901
60  - Delegate uid/gid changing to systemd. Fixes bug #1905
61  - Fix bug #1906
62  - Fix manpage errors, fixes bug #1907
63  - Final fix for #1859 missed one query.
64  - bpluginfo - Utility tool display various information
65  - Backport more master code
66  - Fix Makefile.in so that testfind builds with acl dependency
67  - Make dump_resource respect console ACL's (security fix)
68  - backport code from master
69  - Fix #1923 about MySQL 4 support for BVFS
70  - Fix #1902 about bad status slots output
71  - Fix Sigma Copy bug #4377
72  - Fix bsmtp
73  - Reset bsmtp to only send to IPv4 mailhosts.
74
75 Bugs fixed/closed since last release:
76 1823 1859 1901 1902 1903 1905 1906 1907 1911 1923 1925 4377
77
78
79 =======================================================
80
81 General:
82 --------
83 The 5.2.10 version is a significant bug fix release including 
84 our first cut at AFS support.
85
86 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
87 Please note that with this version of Bacula, during the install
88 of the shared libraries from the src/cats, src/lib, and src/findlib
89 directories, any old Bacula libraries in the installation 
90 destination directory will be removed.  This should not cause
91 any problems and at least keeps the installation library cleaner.
92 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
93
94 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
95 For packagers, if you change options, naming, and the way 
96 we link our shared object files, as at least one of you does,
97 you are creating a situation where the user may not be able
98 to run multiple versions of Bacula on the same machine, which
99 is often very useful, and in addition, you create a configuration
100 that the project cannot properly support.
101 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
102
103 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
104 If you are upgrading from a version older than 5.2.9, please
105 read all the old ReleaseNotes of all versions released
106 after the version you are upgrading from. There area
107 many important notices sumarized here, and we do not 
108 repeat them each bug fix release.
109 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
110
111 Compatibility:
112 --------------
113  As always, both the Director and Storage daemon must be upgraded at
114  the same time.
115
116  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.9
117  Director and Storage daemons. There should be no need to upgrade older File
118  Daemons.
119
120 Major changes since 5.2.9:
121 - Fix IPv6 networking
122 - Fix SQL Counter problems 
123 - Fix Bat hanging after running a number of jobs
124 - Fix dbcheck rw_writelock problem
125 - Fix Windows VSS restore bug
126
127 New Feature:
128 - Add rudimentary support for backing up AFS
129
130
131 28Jun12
132  - Add extra test for unsupported Protocol Families.
133  - Fix inet_pton call.
134  - Real fix of bug #1897 5.2.9 breaks IPv6 connectivity
135  - Fix bug #1891 wrong daemon name printed with -? option
136  - Fix bug #1859 INSERT INTO Counters fails
137  - First try at fixing bug #1897 5.2.9 breaks IPv6 connectivity
138  - Convert write_rec_to_block() to a state machine
139  - Fix bat from eating all Dir connections -- fixes bug #1872
140  - Back port fixes from BEE to fix Windows restore bug #1892
141  - Add block checksum flag to version.h
142  - Add block checksum debug code
143  - Fix bug #1893 dbcheck -B gives rwl_writelock error.
144  - Remove restriction of network buffer size being multiple of a tape block
145  - Add rudimentary support for saving AFS acls.
146  - Send level before the fileset in estimate_cmd() like in backup()
147
148 Bugs fixed/closed since last release:
149 1859 1872 1891 1892 1893 1897
150
151
152 ===============================================================
153
154 General:
155 --------
156 The 5.2.9 version is a bug fix release. 
157
158 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
159 Please note that with this version of Bacula, during the install
160 of the shared libraries from the src/cats, src/lib, and src/findlib
161 directories, any old Bacula libraries in the installation 
162 destination directory will be removed.  This should not cause
163 any problems and at least keeps the installation library cleaner.
164 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
165
166 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
167 For packagers, if you change options, naming, and the way 
168 we link our shared object files, as at least one of you does,
169 you are creating a situation where the user may not be able
170 to run multiple versions of Bacula on the same machine, which
171 is often very useful, and in addition, you create a configuration
172 that the project cannot properly support.
173 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
174
175 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
176 If you are upgrading from a version older than 5.2.7, please
177 read all the old ReleaseNotes of all versions released
178 after the version you are upgrading from. There area
179 many important notices sumarized here, and we do not 
180 repeat them each bug fix release.
181 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
182
183 Compatibility:
184 --------------
185  As always, both the Director and Storage daemon must be upgraded at
186  the same time.
187
188  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.8
189  Director and Storage daemons. There should be no need to upgrade older File
190  Daemons.
191
192 Changes since 5.2.7:
193 --------------------
194
195 11Jun12
196  - Remove bad TERM_LIB patch from version 5.2.8 
197      "Apply readline without TERM_LIB dependency patch from bug #1871"
198  - Ensure cancel status is set for canceled duplicate jobs -- partial fix for 
199    bug #1851
200  - Enhance Win32 error messages -- fixes bug #1879
201  - Apply patch from bug 1876 to permit dot commands in a runscript
202  - Remove config variables from examples/devices fixes bug #1884
203  - Add more debug code for bug 1885
204  - Add more debug to block.c when read rejected
205  - Fail job that attempts to read from closed device -- reported in bug 1885 but 
206    not fixed
207  - Detect Python 2.7 fixes bug #1888
208  - Apply systemd patch from bug #1886
209  - Rewrite some SD subroutines as class members
210  - New overhaul of xattr code.
211  - Use IPPROTO_TCP for SOL_TCP if SOL_TCP isn't defined.
212  - Fix compiler warning.
213
214 Bugs fixed/closed since last release:
215 1851 1879 1884 1886 1888
216
217
218 ====================================================================
219
220 General:
221 --------
222 Version 5.2.8 was a short lived version because it had a TERM_LIB
223 patch that broke on Solaris and other machines.  That patch was
224 removed in 5.2.9.
225
226 General:
227 --------
228 The 5.2.7 version is a significan bug fix release. (The
229 diff file between 5.2.6 and this one is over 25,000 lines).
230
231 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
232 Please note that with this version of Bacula, during the install
233 of the shared libraries from the src/cats, src/lib, and src/findlib
234 directories, any old Bacula libraries in the installation 
235 destination directory will be removed.  This should not cause
236 any problems and at least keeps the installation library cleaner.
237 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
238
239 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
240 For packagers, if you change options, naming, and the way 
241 we link our shared object files, as at least one of you does,
242 you are creating a situation where the user may not be able
243 to run multiple versions of Bacula on the same machine, which
244 is often very useful, and in addition, you create a configuration
245 that the project cannot properly support.
246 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
247
248 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
249 If you are upgrading from a version older than 5.2.7, please
250 read all the old ReleaseNotes of all versions released
251 after the version you are upgrading from. There area
252 many important notices sumarized here, and we do not 
253 repeat them each bug fix release.
254 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
255
256 Compatibility:
257 --------------
258  As always, both the Director and Storage daemon must be upgraded at
259  the same time.
260
261  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.3
262  Director and Storage daemons. There should be no need to upgrade older File
263  Daemons.
264
265 Changes since 5.2.6:
266 --------------------
267 02Jun12
268  - Correct Qt version needed for bat
269  - Turn on SD deadlock detection by default
270  - Fix bug #1880 ltdl.m4 missing for new feature.
271  - Fix bug #1870 GNU binutils-gold build failure.
272  - Add new empty netinet/tcp.h so Windows compile works
273  - Eliminate compiler warning in stored/dircmd.c
274  - Fix TCP Heartbeat code
275  - Align conio.c struct at 8 bytes to fix Sparc bus error.
276  - Fix get_basename() -- rewrite
277  - Apply James' exchange-fd.c regression fix
278  - Add first Dutch translation
279  - Ensure that StorageId is updated after write
280  - Fix updating of cached slots + error message numbering
281  - Remove old shared objects before install
282  - Add missing dummy bVarPrefixLinks variable retrieval.
283  - Fix mysql config for older versions of mysql+config.
284  - Fix problem in BVFS with concurrent queries
285  - Add more checks to bvfs
286  - Try to use multi-row insert statements for mysql.
287  - On some platforms intptr_t is in an other include file.
288  - Add support for fcntl(fd, F_CLOSEM) to close filedescriptors.
289  - Use closefrom if available instead of trying to close fds ourself.
290  - Fix class member shadowing.
291  - Move storages tls initialization to proper place.
292  - Fix Copyright on init scripts suse, add specific daemon user & group
293  - Add support for new POSIX getaddrinfo interface.
294  - Apply MSQL detection fixes from bug #1829
295  - Fix bug #1805 cannot specify hostname in ./configure
296  - Fix restore_job restore keyword
297  - Allow plugin to backup a directory
298  - Print seconds in schedule time as noted in bug #1854
299  - Fix #1857 about restore cd command that blocks on empty directory
300  - Backport new StorageId code
301  - More definitive fix for update slots bug
302  - Fix #4062 on make_catalog_backup.pl script when user/password are empty
303  - Fix bug #1853: bacula-sd dead but pid file exists.
304  - Fix bug #1841 estimate command level=differential goes wrong in accurate 
305    mode.
306  - Fix bug #1842 Incorrect port number reported
307  - Fix bug #1848 bsock.c:335 Socket has errors=1 on call to client
308  - Force the re-initialization of BaseJobOpts, AccurateOpts and VerifyOpts 
309    between two Include{}
310
311 Bugs fixed/closed since last release:
312 1805 1829 1841 1842 1848 1853 1854 1857 1870 1874 1880 4062
313
314
315
316 General:
317 --------
318 The 5.2.6 version is a bug fix release.
319
320 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
321 If you are upgrading directly from 5.0.3 to this version, please see the
322 important notices below for version 5.2.3, particularly
323 the database upgrade and the difference in packaging the
324 SQL shared libraries.
325 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
326
327 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
328 If you store .bsr or .mail files in the Bacula working
329 directory, please be aware that they will all be deleted
330 each time the Director starts.
331 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
332
333 Compatibility:
334 --------------
335  As always, both the Director and Storage daemon must be upgraded at
336  the same time.
337
338  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.3
339  Director and Storage daemons. There should be no need to upgrade older File
340  Daemons.
341
342 New Feature:
343  - The restore tree cd command accepts wild cards within each
344    part of a path. Wild cards apply only to a single part at a
345    time: i.e. cd a*/b*/xx* will match abc/bcd/xxfxx
346    but */xx* will not match the above filename.
347
348 Changes since 5.2.5:
349
350 17Feb12
351  - Fix old exchange-fd plugin Accurate checkFile code.
352  - Insert the slot field as a numeric field.
353  - Fix #1831 by dropping the table before creating it
354  - Make cd accept wildcards
355  - Remove bad optimization from Accurate code
356  - Lock read acquire in SD to prevent to read jobs getting the same thing
357  - Implement more robust check in other drives for tape slot wanted
358  - Fix lost dcr point -- memory loss in Copy/Migration + possible confusion
359  - Ensure that bvfs SQL link is not shared
360  - Fix error printing in acl and xattr code.
361  - Backport better error debug output for sd plugins.
362  - Add wait on bad connection for security
363  - Make mtx-changer more fault tolerant
364  - Fix 32/64 bit problems in SD sscanf commands
365  - Skip certain filesystem types on some platforms.
366  - Allow BVFS to browse and restore Base jobs
367  - Add error message to .bvfs_clear_cache command
368  - Fix plugin bug with multiple simultaneous jobs
369
370 Bugs fixed/closed since last release:
371 1831
372
373 ===============================================================
374
375 General:
376 --------
377 The 5.2.5 version is a bug fix release.
378
379 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
380 If you are upgrading directly from 5.0.3 to this version, please see the
381 important notices below for version 5.2.3, particularly
382 the database upgrade and the difference in packaging the
383 SQL shared libraries.
384 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
385
386 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
387 If you store .bsr or .mail files in the Bacula working
388 directory, please be aware that they will all be deleted
389 each time the Director starts.
390 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
391
392 Compatibility:
393 --------------
394  As always, both the Director and Storage daemon must be upgraded at
395  the same time.
396
397  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.3
398  Director and Storage daemons. There should be no need to upgrade older File
399  Daemons.
400
401 Changes since 5.2.4:
402
403 25Jan12
404  - Disable usage of JS_Warning waiting for a more complete implementation
405  - Removed old sd plugins which doesn't work anymore.
406  - Adapt sample-query.sql for Warning job status
407  - Fix location of Qt dlls for Win64 build
408  - Fix MediaView::getSelection
409
410 Bugs fixed/closed since last release:
411 1824 (1814 1806 1818 non-bugs)
412
413 =============================================================
414 General:
415 --------
416 The 5.2.4 version is a bug fix release.
417
418 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
419 If you are upgrading directly from 5.0.3 to this version, please see the
420 important notices below for version 5.2.3, particularly
421 the database upgrade and the difference in packaging the
422 SQL shared libraries.
423 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
424
425 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
426 If you store .bsr or .mail files in the Bacula working
427 directory, please be aware that they will all be deleted
428 each time the Director starts.
429 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
430
431 Compatibility:
432 --------------
433  As always, both the Director and Storage daemon must be upgraded at
434  the same time.
435
436  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.3
437  Director and Storage daemons. There should be no need to upgrade older File
438  Daemons.
439
440 Most important changes since 5.2.3:
441 - Fix LZO detection so that it correctly detects presense of header
442   files.
443 - Switch the way we handle shared object versioning.
444 - Backport Enterprise spec files to platforms/rpms
445 - Switch to using Qt 4.7.4 (you must download new 
446   depkgs-qt-24Dec11.tar.gz
447 - Update depkgs to depkgs-24Dec11.tar.gz
448 - Enhancements to File daemon and Storage daemon plugins
449 - Compiler warning cleanups
450 - xattr fixes
451 - Cleanup old files in the working directory when the Director starts
452
453 Changes since 5.2.3:
454
455 18Jan12
456  - Prepare for adding IPv6 to Windows in the future
457  - Fix bug #1822 Schedule run line parsing fails if value is keyword
458  - Revert to 5.0 size computation in accurate elements, may fix #1821
459  - Mark that a file was found in the accurate list in the ff_pkt with a
460    variable
461  - Definitive fix for MySQL MaxValue problem bug #1810
462  - Initialize delta_seq to -1 because 0 means that we have already a version
463  - Adapt bfileview for bvfs tables
464  - Set job status to running when restore job really starts
465  - Remove ifdeffing that turned off JS_Warning status -- must have been missed 
466   test code
467  - Add support for soname setting in libtool.
468  - Fix bug #1815
469  - Fix systemd pid files.
470  - Limit migration/copy jobs to starting 100 at a time
471  - Avoid conflict with PAGE_SIZE define
472  - Send previous Job name during Incremental/Differential to the FD
473  - Fix bug #1811 Filed fails to backup more then one xattr.
474  - system.posix_acl_default is also an acl stored as xattr
475  - Fix bug #1807
476  - Add configure for new redhat spec files
477  - Backport Enterprise spec files
478  - Fix bad memset() reported by clang
479  - Test new plugin function in bpipe and test plugin
480  - Try to fix openssl problem with signal
481  - Add BSOCK::set_killable()
482  - Set directory attributes when using Replace=Never when Bacula creates them
483  - Use RestoreObject type in Catalog
484  - Add new features in plugin
485  - Add helper for ini files
486  - Implement run accurate=yes/no
487  - Add .bvfs_clear_cache
488  - Add Accurate and MaxRunSchedTime in Schedule resource
489  - Fix bug #1802 configure code to detect LZO is broken
490  - Fix bug #1806 failure to save second and more xattr.
491  - Add second xattr to show bug 1806
492  - Fix seg fault in plugin event loop
493  - Fix #3210 about slow restore with bvfs
494
495 Bugs fixed/closed since last release:
496 1802 1806 1807 1810 1811 1815 1821 1822 3210
497
498
499 ==============================================================
500
501 General:
502 --------
503 The 5.2.3 version is an bug fix release.
504
505 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
506 If you are upgrading directly from 5.0.3 to this version, please see the
507 important notices below for version 5.2.2, particularly
508 the database upgrade and the difference in packaging the
509 SQL shared libraries.
510 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
511
512 Compatibility:
513 --------------
514  As always, both the Director and Storage daemon must be upgraded at
515  the same time.
516
517  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.3
518  Director and Storage daemons. There should be no need to upgrade older File
519  Daemons.
520
521 Changes since 5.2.2:
522
523  - Revert patch from Ben to not compress man pages on Solaris fix #1801
524  - Fix bug #3322 don't poll when operator is labeling tapes
525  - bvfs: Fix mysql REGEXP operator
526  - Fix Mysql 5.5.18 symbol lookup
527  - fix utf8/iso8859 problems
528  - Fix #3419, update stats problem
529  - Fix cats_test to use the new method names.
530  - Update accurate code to use 1 byte instead of 3
531  - Fix segfault in accurate code
532  - Fix compilation warning on FreeBSD
533
534 Bugs fixed/closed since last release:
535 1801 3322 3419
536
537
538 ================================================================
539 Version 5.2.2
540
541 General:
542 --------
543 The 5.2.2 version is an important bug fix release. It contains also some
544 additions and performance improvements. 
545
546 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
547 If you are upgrading directly from 5.0.3 to this version, please see the
548 important notices below for version 5.2.1, particularly
549 the database upgrade and the difference in packaging the
550 SQL shared libraries.
551 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
552
553 Compatibility:
554 --------------
555  As always, both the Director and Storage daemon must be upgraded at
556  the same time.
557
558  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.2
559  Director and Storage daemons. There should be no need to upgrade older File
560  Daemons.
561
562 Changes since 5.2.1:
563 -----------------
564  - Implement -t option for Bat
565  - Require correct Qt version 4.6.2 or later to build bat
566  - Get new lib/plugins.h
567  - Pull new SD plugin files from Master
568  - Fix script to set mode of cats scripts
569  - Add Systemd configure options
570  - Split messages line by line before sending it to syslog() fix #3325
571  - Fix bvfs_restore on MySQL
572  - Fix #3308 where a SMTP problem can block the director
573  - Change locking scheme of the mountpoint cache.
574  - Enhance mountcache with rescan option after interval.
575  - Add %D option to edit_job_code, simplify callbacks on director side
576  - Move Zdeflate and Zinflate to seperate file.
577  - Put libraries in the correct order for non shared libs.
578  - Remove last traces of @SQL_BINDIR@ and @DB_TYPE@
579  - Fix bug #1774
580  - Move batch insert detection into db.m4
581  - bat: try to fix offset button problem when clicking too much on previous
582  - bvfs: Use single transaction for each job during update
583  - Add missing bwild & bregex man8 pages
584  - Fix compilation issue of wx-console #1778
585  - bvfs: fix filter for pattern= bvfs parameter
586  - Improve speed of BVFS with SQLite, Thanks to J.Starek
587  - bvfs: add clear_cache function
588  - bvfs: Handle windows drive when building path hierarchy
589
590 Closed Bugs Since 5.2.1
591 -----------------------
592 1774 1778 3308 3325
593
594
595 ================================================================
596
597 Version 5.2.1
598
599 The 5.2.1 version is a major release since the last version 5.0.3.
600 It includes well over 299,387 lines of changes made by 20 contributors,
601 lots of bug fixes (see below), 1,851 software commits,and a 
602 number of important new features:
603
604 Version 5.2.0 was short lived, because Marco (thanks) found
605 a number of last minute bugs. So the first official release of 5.2
606 is 5.2.1.
607
608 Compatibility:
609 --------------
610  As always, both the Director and Storage daemon must be upgraded at
611  the same time.
612
613  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.1
614  Director and Storage daemons. There should be no need to upgrade older File
615  Daemons.
616
617 5.2.1 New Features:
618 -----------------
619 - LZO Compression
620 - New Tray Monitor
621 - Purge Migration Job
622 - Changes in Bvfs (Bacula Virtual FileSystem)
623 - Changes in the Pruning Algorithm
624 - Ability to Verify any specified Job
625 - Additions to RunScript variables
626 - Additions to the Plugin API
627 - ACL enhancements
628 - XATTR enhancements
629 - Class Based Database Backend Drivers
630 - Hash List Enhancements
631
632 Some of the above are described below; all the above are
633 described in more detail in the New Features chapter of the
634 manual.
635
636 Closed Bugs since 5.0.3:
637 ---------------------
638 1389 1444 1448 1466 1467 1468 1476 1481 1486 1488 1493 1494 1497 1499 1501
639 1502 1504 1509 1511 1513 1516 1524 1526 1527 1532 1536 1538 1541 1542 1549
640 1551 1553 1554 1558 1559 1560 1564 1567 1568 1569 1571 1574 1577 1581 1582
641 1584 1587 1594 1595 1600 1601 1602 1603 1604 1606 1608 1610 1612 1623 1624
642 1633 1643 1648 1655 1661 1664 1666 1669 1672 1675 1684 1685 1695 1696 1699
643 1700 1703 1735 1741 1749 1751 1761 1762 1764 1768 1770 1771 2710
644
645 Note on bug 1612 where Bacula does not save a checksum for hard links during
646 full backup, but expects one during accurate differential backups. You need
647 a Full backup with the 5.2.x code to have these checksums in the Catalog.
648 Doing Incr/Diff over a 5.0.x Full backup will still display lot of errors.
649
650
651
652 ================== Warning !!!!!! ==========================
653
654  The new pruning algorithm will not allow pruning of jobs that are essential to
655  restore since the last Full backup. This is, of course, correct and desirable,
656  but it is different from older Bacula versions that could inappropriately
657  prune jobs. Pruning of volumes is not affected.
658
659 Building Bat:
660 -------------
661 To build Bat, you need Qt4 version 4.6.2.  If you build with any other
662 version it is likely not to work.  If you do not have version 4.6.2, on
663 your system, you can download the Bacula depkgs_qt version 16Dec10.
664
665 Packaging the SQL backend:
666 --------------------------
667 The main Bacula Director code is independent of the SQL backend
668 in this version. This means that the Bacula Director can be packaged
669 by itself, then each of the different SQL backends supported can
670 be packaged separately.  It is possible to build all the DB backends
671 at the same time.
672
673 - configure can be run with multiple database configure options.
674    --with-sqlite3
675    --with-mysql
676    --with-postgresql
677
678 Order of testing for database is
679 - postgresql
680 - mysql
681 - sqlite3
682
683 Each configured backend generates a libbaccats-<backend_name>-<version>.so
684 A dummy catalog library is created named libbaccats-version.so
685
686 At configure time the first detected backend is used as the so called default
687 backend and at install time the dummy libbaccats-<version>.so is replaced with
688 the default backend type.
689
690 If you configure all three backends you get three backend libraries and the
691 postgresql gets installed as the default.  When you want to switch the default
692 you can copy one of the three backend libraries over the
693 libbaccats-<version>.so e.g.
694
695 cp libbaccats-postgresql-<version>.so libbaccats-<version>.so
696
697 And update the default backend in the following files:
698
699 create_bacula_database
700 drop_bacula_database
701 drop_bacula_tables
702 grant_bacula_privileges
703 make_bacula_tables
704 make_catalog_backup
705 update_bacula_tables 
706
707 New Catalog format in version 5.2.0 and greater
708 -----------------------------------------------
709 This release of Bacula uses a new catalog format. We provide a set of
710 scripts that permit to convert a 5.0.x (version 12) catalog to 5.2.1 (version
711 14).  The Bacula project rpm spec files have been modified to
712 detect the database change and do the upgrade for you.  We strongly
713 recommend that you save a copy of your existing database before upgrading
714 using rpms.
715
716 The simplest way to upgrade the database assuming you are building from
717 source (i.e. manually):
718 1. Stop any current version of Bacula from running.
719 2. Save a copy of your existing database.
720 3. Configure, build, and install the 5.2.1 version of Bacula
721    Note the new ./configure options in the manuals see the link
722    at the bottom of this file.
723 4. cd <your-scripts-installation-directory>
724 5. ./update_bacula_tables
725 6. If you have multiple catalogs, edit the update_bacula_tables
726    script and put the name of another database, and then
727    execute the script again. Repeat this until all Bacula
728    catalogs have been updated.
729 7. Start the new Bacula.  If everything worked, it should
730    not print any error messages.
731
732 If you start from scratch, you don't need to run the update_bacula_tables
733 script because the create_bacula_tables script automatically creates the new
734 table format.  However, if you are using a version of Bacula older than 5.0.0
735 (e.g.  3.0.3) then you need to run the update_bacula_tables script that will
736 be found in the <bacula>/src/cats directory after you run the ./configure
737 command.  As mentioned above, before running this script, please backup your
738 catalog database, and when you do running it, be sure shutdown Bacula and be
739 aware that running the script can take some time depending on your database
740 size.
741
742 ================================================================
743
744 Changes:
745
746 Speed and Memory Usage Enhancements:
747 - Implement LZO compression algorithm (need lzo2 headers to activate this option)
748 - New Pruning algoritm -- safer and faster
749 - Use of PostgreSQL cursor when doing large queries, should reduce the
750   memory usage during restore and accurate backups.
751 - limit command in some list commands
752 - Bacula Virtual File System for fast catalog access
753 - Faster crc32 algorithm
754
755 Security Enhancements:
756 - Additional security against injection of illegal characters
757 - Fix possible fnmatch problem
758
759 Features Enhancements:
760 - Improvements in ACL and xattr handling on additional platforms:
761   AIX, Darwind, FreeBSD, HPUX, IRIX, Solaris, Tru64
762 - Tray monitor for Windows
763 - New SQL backend and ./configure that permits building multiple catalog
764   backends in one build, and has the main Bacula core code totally independent
765   of the SQL backend, which should simplify packaging (only the
766   libbacsql.so/dll needs to be changed to switch from one database backend
767   to another (e.g. MySQL to PostgreSQL).
768 - Indent lsmark during restore
769 - Disable batch insert config item
770 - Director selection option in bconsole
771 - restorejob command in bconsole
772 - Many additional features for bat such as "brestore" panel
773 - The old bat version browser has been turned off since it does not
774   work correctly and the brestore panel provides the same functionality
775 - Improved hash table for hard links
776 - Additional script variable editing such as %b (JobBytes), %F (JobFiles) 
777   and %h (Client Address)
778
779 Other Enhancements:
780 - Includes better handling for Windows repares points, mount points, and 
781   junction points.
782 - New database format
783 - Many new plugin API features
784 - Improved memory handling for restores
785 - Significant stability enhancements to bat
786 - xattr/ACL restore failure are now printed as Warning
787 - A few path name length limits in Windows have been removed.
788
789
790 ===========================================================================
791
792 The 5.0.3 version is significant bug fix update to version 5.0.2.
793 It includes new code and some new features.
794 There is no database change since prior versions of 5.0.
795
796 Note, if you are running 5.0.0, read the 5.0.1 and 5.0.2 release notes below in
797   the 5.0.1 release section.
798   Important!!!
799
800 Compatibility:
801 --------------
802  As always, both the Director and Storage daemon must be upgraded at
803  the same time.
804
805  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.0.3
806  Director and Storage daemons. There should be no need to upgrade older File
807  Daemons.
808
809 Changes and New Features:
810 - If a VSS (Windows) snapshot fails, the whole Job is failed, previously
811   it printed a warning message and continued.
812 - New editing codes %b = Job Bytes and %f = Job Files for runscripts
813 - Any non-Bacula project plugins (i.e. third party plugins) 
814   must be upgraded to specify AGPLv3 in place of the GPLv2 used previously 
815   for the PLUGIN_LICENSE.
816 - The bat Media page text columns can be sorted by clicking on the column.
817 - If possible, the SD will automatically update the catalog Volume size if 
818   it does not match the Volume size. The mismatch between the Volume sizes
819   typically occurs when the FD has a comm line drop or the FD crashes.
820
821
822 Bug fixes
823 1538 1554 1564 1567 1568 1569 1571 1577 1581 1582 1587 1594 1595 1606 1610
824
825 - Change license from GPLv2 to AGPLv3
826 - Make Win32 no filesystem change more explicit
827 - Backport Branch-4.0 release to Branch-5.0
828 - Massive backport from Branch-5.1 to Branch-5.0
829 - Fix postgresql catalog creation when version is not on the first line
830 - Fix bug #1610 handle empty xattr values on Linux and xBSD.
831 - Garbage collect memory pool at end of job and before sm_dump
832 - Add xattr seg fault protection suggested by Marco for bug #1610
833 - Add archlinux to os.m4
834 - More fixes for 32/64 bit problems in smartall
835 - Fix 32/64 bit problem in smartalloc dump routine
836 - Fix bad copy/paste in commit c88dccb88 prably a seg fault
837 - Add .dump and .exit commands for daemons
838 - Make SD automatically fix the Volume size in the Catalog when out of sync
839 - Use Pmsg in smartall.c rather than printf for tracing Windows
840 - Up maximum block size to 20M
841 - Fix for TLS bugs #1568 and #1599
842 - Improve comm line error handling for TLS, may fix bug #1568 and #1599
843 - Fix problem when sending Cancel event to plugin
844 - Convert all Jmsg on the watchdog thread to Qmsg
845 - Fix SD crash due to mismatched lock/unlock in error condition
846 - Fix bug #1587 if you have clients with different catalogs configured, both 
847   catalogs contains all clients after a reload or restart of the dir
848 - Fix bug #1577 During migration: ERROR in block.c:950 Failed ASSERT: dev->is_open() 
849   by moving and commenting out the ASSERT()
850 - Skip HB kill in FD if HB thread terminated
851 - Fix crash from unequal volume_lock/unlock calls
852 - New prunning algorithm -- should be more accurate
853 - Save any dumps during regression to dumps directory
854 - Fix crash from rw_lock/unlock miss match
855 - Attempt to fix duplicate job kill seg fault
856 - Replace pthread_kill by my_thread_send_signal() in jcr.c
857 - fix #1595 about batch mode detection problem for postgresql with non standard 
858   install dir
859 - Fix #1594 about prune copy jobs
860 - Apply literal string fix in printf submitted by Luca Berra
861 - Fix bug #1582 Restore from multiple storage daemons breaks subsequent backups
862 - Fix segfault on "cancel jobid=" command
863 - Fix bug #1554 Windows installer doesn't honor /S flag
864 - Remove pool zap code that breaks 2drive-concurrent-test
865 - Fix #1571 and install libraries with 755 perms
866 - Fix bug #1581 ASSERTs in src/dird/jobq.c can never trigger
867 - Fix problem with BaseJob and Accurate FileSet options on client side
868 - Fix for bug #1569 deadlock/crash in Dir
869 - Fix segfault when loading Plugins
870 - Fix #1567 about display of long volume names truncated during restore
871 - Added new bacula-libs package.
872 - Fix bug #1538 Start Scripts return incorrect value
873 - Fix bug #1564 init scripts not LSB compliant
874
875 See ChangeLog for more details.
876
877 =============================================================================
878
879
880 ============= Release 5.0.2 ========================
881
882 Changes since 5.0.1
883 -------------------
884
885 Bug fixes
886 1502 1511 1517 1524 1527 1532 1536 1541 1549 1551 1553 1559 1560
887
888 - Probable fix for SD crash bug #1553
889 - Fix #1559 problem when restoring pruned jobs with a regexp
890 - Fix for bug #1560 bcopy cannot find Volume
891 - Fix cancel crash bug #1551
892 - Check if sql backend is thread-safe
893 - Correct Pool display in SD status. Fixes bug #1541
894 - Fix cancel crash reported by Stephen Thompson
895 - Rewind on close to fix #1549
896 - Remove closelog() in bpipe fixes bug #1536
897 - Fix #1517 about missing Base level in .level command
898 - Replace ASSERT in block.c with fail Job
899 - Fix database locking calling db_lock and returning from function without
900   calling db_unlock.
901 - Add missing db_unlock to bvfs_update_cache.
902 - Fix #1532 about permission on binaries
903 - Fix #1527 about deadlock during migration
904 - Another fix for OpenSSLv1
905 - Add -lrt to Solaris links
906 - Fix tls.c for OpenSSLv1
907 - Fix #1511 when trying to insert more than 50.000 directories in bvfs
908 - Fix plugin load not to stop if one plugin bad -- pointed out by James
909 - Remove --without-qwt from configure statement.
910 - Second correct fix to bug #1524 verify fails after adding or removing files
911 - Fix bug #1524 verify fails after adding or removing files
912 - Apply fix suggested by Andreas in bug #1502 for mediaview column sort problem
913 - Fix OpenSSL 1.x problem in crypto.c on Fedora 12
914 - Display AllowCompress warning message only if compression used in FileSet
915
916 =============================================================================
917
918
919 ============= Release 5.0.1 ========================
920
921 !!!!!!!!!!!!!!! NOTE FOR 5.0.0 USERS !!!!!!!!!!!!!!!!!!!!
922 The Allow Duplicate Jobs directive has been significantly 
923 reworked, and the default value has changed. See below.
924
925 Truncate On Purge has been totally rewritten. See the new
926 features section of the manual.
927
928 When Volume Poll Interval is set in the SD DEVICE configuration,
929 (default 5 mins), after a certain number of polling tries (approx
930 10) polling will stop and the operator will be asked to
931 resolve the problem.  Previously there was no limit, and an
932 error message could be produced at each poll attempt.
933 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
934
935 Changes since 5.0.0
936 -------------------
937 - We believe that we have resolved most of the problems
938   concerning canceled or failed jobs being "stuck" in the
939   Director.  There is one outstanding problem in the SD when
940   canceling jobs that we will fix in the next major release.
941   If you see jobs that seem to be stuck, in general issuing
942   a cancel command in bconsole should now make them go away.
943
944 Directives:
945 - The default for "Allow Duplicate Jobs" has been changed from 
946   no to yes.  If you use this directive, please check your
947   conf file, and note the next two items !!!!!!!!!!!!!!!!!!!
948 - AllowHigherDuplicates disabled. It did not work as documented   
949     and was confusing.
950 - New directive "CancelLowerLevelDuplicates" See New Features
951   section in the manual.
952 - Truncate on Purge rewritten.  See New Features section in the manual.
953
954 Bug fixes:
955 1448 1466 1467 1468 1476 1481 1486 1488 1494 1497 
956 1499 1501 1505 1509 1513
957
958 - Ensure SD asks for help when looping even if poll set. Fixes bug #1513.
959 - Fix three-pool regress bug
960 - Modify bacula.spec fixes bug #1505
961 - This version fixes an issue where the console window would start out
962   docked. It is fixed by initiating the variables in the Pages class wi
963   constructor.
964 - Fix make_catalog_backup.pl fails when catalog db is on other host
965 - Apply MacOSX installer patch from bug #1509
966 - Apply fix to previous fix of Copy problem. Fix proposed by reporter o
967   #1476
968 - Fix bug #1501 -t does not print errors
969 - Apply SQLite3 update fix from bug #1497
970 - Apply bashism fix for diskchanger.in script from bug #1499
971 - Apply rpm fix for Sci Linux from bug #1494
972 - Take most recent Ukranian po from bug #1448
973 - Probable fix for Copy/Migration bug #1476
974 - Fix bug #1488 -- avoid recursion and race conditions in messages.c
975 - Upgrade cats library also to 5.0.0
976 - Fix missing console page in bat
977 - Add bat help files to Window install
978 - Improve Windows upgrade to ensure old FD is shutdown
979 - Fix bug #1481 -- bat consumes all console file descriptors
980 - Backport truncate on purge from 5.1.x
981 - Fix bug #1486 -- bat doesn't show any errors on command-line
982 - Update the bsock error URL
983 - Correct .my.cnf umask in make_catalog_backup.pl
984 - Apply fix for dbcheck use by make_catalog_backup.pl
985 - Fix seg fault in bscan from new comment field
986 - Allow multiple CNs when using TLS
987 - Fix seg fault in SQlite driver
988 - Make shared libs version the same as the Bacula release version
989 - Remove file_index sequential check
990 - Fix #1466 about Bogus pruning message
991
992 For Packagers:
993 1.  The default query.sql file is now, except for some comments, empty.
994 The old file, which we no longer support (it is impossible or difficult to
995 make it work on every backend, and the queries are mostly contributed) can
996 be found in <bacula-source>/examples/sample-query.sql.  The sample file is
997 not installed by the Makefiles
998
999 2.  When you install the mtx-changer script, you must also install
1000 mtx-changer.conf if it does not exist.  This new file (mtx-changer.conf) is
1001 required for mtx-changer to work, but it is a user configurable file, so on
1002 any update, any existing file should not be overwritten.
1003
1004 3.  Bat should be built on every platform that is capabable of running Qt.
1005 However, the Qt code is changing rather quickly and is not always
1006 compatible from version to version.  We have built and verified bat on Qt
1007 4.3.4.  We strongly recommend that you do not build and distribute bat with
1008 any other version of Qt unless you personally test it.  To build against Qt
1009 4.3.4, download the depkgs-qt package from the Bacula Source Forge download
1010 location, read the README file and follow the instructions.
1011
1012 If you are building for Bacula version 5.0.0, please ensure that you do not
1013 have qmake-qt4 loaded on your system.  If you do, either remove it or
1014 rename it before trying to build bat.  If you do not, bat will probably be
1015 built using the shared objects on your system.  For Bacula 5.0.1 and later,
1016 this problem (bug) does not exist.
1017
1018 depkgs-qt does not install Qt on your system, nor does it interfere with
1019 you having any other version of Qt installed on your system.  Once you
1020 build bat with depkgs-qt, it should *not* use the Qt shared objects, but
1021 rather they will be linked into the program.  After fully installing bat
1022 (make install), you can run "ldd bat" to see what shared objects it will
1023 use.  If any Qt shared objects are referenced, something has gone wrong.
1024
1025 4.  Unless absolutely necessary, we recommend that you do not define any
1026 special library environment variables that apply to the ./configure -- for
1027 example: LIBDIR=/...  ./configure <your-options> is strongly discouraged.
1028 Doing so, could potentially cause Bacula to be linked against the wrong
1029 shared objects.
1030
1031 5.  The Bacula project strongly recommends that you install Bacula into a
1032 single directory, with a few minor exceptions such as the MySQL or
1033 PostgreSQL databases.  Preferrably this should be /opt/bacula.  The full
1034 recommendation is:
1035
1036 #!/bin/sh
1037 # Recommended configure script for Bacula
1038 prefix=/opt/bacula
1039 email=xxx@yyy.zz
1040 CFLAGS="-g -O2 -Wall" \
1041   ./configure \
1042     --sbindir=${prefix}/bin \
1043     --sysconfdir=${prefix}/etc \
1044     --docdir=${prefix}/html \
1045     --htmldir=${prefix}/html \
1046     --with-working-dir=${prefix}/working \
1047     --with-pid-dir=${prefix}/working \
1048     --with-subsys-dir=${prefix}/working \
1049     --with-scriptdir=${prefix}/scripts \
1050     --with-plugindir=${prefix}/plugins \
1051     --libdir=${prefix}/lib \
1052     --enable-smartalloc \
1053     --enable-tray-monitor \
1054     --enable-bat \
1055     --with-mysql \
1056     --with-dump-email=${email} \
1057     --with-job-email=${email} \
1058     --with-smtp-host=localhost \
1059     --with-baseport=9101
1060
1061 Obviously, the email, and some of the minor options (mysql, postgresql,
1062 ...) can be changed to suit your distribution, but the directory names
1063 defined above are strongly recommended, and over time the default values in
1064 the bacula-dir.conf and bacula-sd.conf will reflect these choices.
1065
1066 If you have any questions about this or would like a detailed document
1067 describing our recommendations including packaging requirements, please
1068 send an email to the bacula-devel list.
1069
1070 6.  Starting with Bacula version 3.0.0 up to Bacula 5.0.0, the shared
1071 libraries that Bacula uses by default are named xxx-1.0.0.  Starting with
1072 Bacula 5.0.1, we are going to name the libraries using the Bacula version.
1073 So in Bacula 5.0.1, the libraries will be named xxx-5.0.1.  With future
1074 versions, the last digit may or may not change when we distribute patch
1075 updates (i.e.  the last digit of the version changes).  This will depend on
1076 whether or not we have changed something in the library.  Hopefully this
1077 new procedure will resolve some of the incompatibility problems between
1078 different versions of the shared objects.
1079
1080 7.  The default build option for bconsole is conio (my own little console
1081 routines).  I did this because some years ago, readline was very difficult
1082 to maintain -- it and where it was found seemed to change on every release.
1083 This generated at the time a number of support problems.  It seems to me
1084 that since then there have been very few problems with readline.  As a
1085 consequence, I have no problem if you want to make bconsole with readline
1086 enabled.  It will actually give some very nice new bconsole command
1087 completion functionality that Eric has written.  Bottom line: feel free to
1088 use readline or not as you please.
1089
1090 ==========================================================
1091
1092
1093
1094 Release Notes for Bacula 5.0.0
1095
1096 Release Numbering:
1097 -----------------------------------------------------------
1098 You might be wondering why this release jumps from 3.0.x to 
1099 5.0.0 thus skipping version 4.0.0.  We have done this for 
1100 several reasons: first, we wanted a way of distinguishing
1101 the numbering system for the Bacula System Enterprise version
1102 and the Bacula Project version.  So, to do so, we have decided
1103 that the first number of the Bacula Project version will always
1104 be odd, and the first number of the Enterprise version will always
1105 be even. Thus the Bacula Project now moves from 3.0.x to 5.0.x.
1106 In addition, we want to keep the Bacula Project version larger
1107 than the Enterprise version to indicate that the Bacula Project
1108 version is more advanced or has more features than the 
1109 Enterprise version. For memory, the current Enterprise version
1110 is 2.6.1, and the next release (in a few months -- before June 2010)
1111 will be version 4.0.0.
1112
1113 Warning:
1114 --------------------------------------------------------------
1115 Please note the three Warnings below before doing any install or
1116 upgrade.
1117        
1118
1119 Changes since 3.0.3a (the last Bacula Project release):
1120 -------------------------------------------------------
1121
1122 Bug fixes:
1123 1337 1351 1352 1354 1357 1361 1367 1369 1370 1373 
1124 1376 1391 1403 1409 1420 1422 1427 1428 1431 1450 
1125 1454 1455 1458 1456
1126
1127 Fixed:
1128  - Problem that locks the Director when the SMTP server wasn't 
1129    responding to the bsmtp program 
1130  - Restore's dir command shows incorrect file sizes 
1131  - Fix various problems with the reload command   
1132  - Fix problems with conio
1133  - Eliminate several deadlocks or potential race conditions from SD
1134
1135 Enhancements:
1136  - Project 5: Truncate volume after purge
1137  - Project 6: File Deduplication using Base Jobs 
1138  - Project 10: Restore from Multiple Storage Daemons
1139  - Project 11: AllowCompression per Device
1140  - Project 23: Add Maximum Concurent Jobs for Devices to balance load 
1141    between drives
1142  - Add Accurate Fileset Options to configure accurate detection. Can use 
1143    checksum verification for example.
1144  - Allow FD to keep root read but drop write permission (CAP)
1145  - Secure handling of passwords for catalog backup
1146  - Add Tab-completion for Bconsole when using Readline
1147  - Add Bvfs API to query the catalog without building a memory tree
1148  - Add new speed test to btape program
1149  - Add new Bat screens (Autochanger content, Job view, Media view, ...)
1150  - Windows version of Bat
1151  - Added Spanish Bacula translation   
1152  - New bconsole -u nnn option to have timeout on commands
1153  - Allow Migrate, Copy, and Virtual Full to read and write
1154    to the same Pool
1155  - show disabled   -- shows disabled Jobs
1156  - Add Pool File and Job retention periods (take precedence over Client)
1157  - Many ACL improvements
1158  - Level added to FD status Job entry
1159  - Allow turning on/off Block Checksum per device
1160  - Set Device Poll interval to 5 minutes -- previously did not poll
1161  - Implement lock manager with bad order protection
1162
1163 Compatibility:
1164 As always, both the Director and Storage daemon must be upgraded at
1165 the same time, and on any given machine, you must run only one version
1166 of Bacula. This means that on the Director and Storage daemon machines,
1167 you *must* upgrade your File daemon as well.
1168
1169 Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 5.0.0
1170 Director and Storage daemons. There should be no need to upgrade older File
1171 Daemons immediately. However, we recommend that you do so as soon
1172 as is reasonable for your situation.
1173
1174 ================== Warning !!!!!! ==========================
1175
1176 New Catalog format in version 5.0.0 (3.1.9 or later)
1177 -----------------------------------------------------
1178
1179 This release of Bacula uses a new catalog format. We provide a set of
1180 scripts that permit to convert a 3.0.x (version 11) catalog to 5.0.0 (version
1181 12).  The Bacula project rpms distributed on Source Forge will automatically
1182 detect the database change and do the upgrade for you.  We strongly
1183 recommend that you save a copy of your existing database before upgrading
1184 using rpms.
1185
1186 The simplest way to upgrade the database assuming you are building from
1187 source:
1188 1. Stop any current version of Bacula from running.
1189 2. Save a copy of your existing database.
1190 3. Configure, build, and install the 5.0.0 version of Bacula
1191    Note the new ./configure options in the manuals see the link
1192    at the bottom of this file.
1193 4. cd <your-scripts-installation-directory>
1194 5. ./update_bacula_tables
1195 6. If you have multiple catalogs, edit the update_bacula_tables
1196    script and put the name of another database, and then
1197    execute the script again. Repeat this until all Bacula
1198    catalogs have been updated.
1199 7. Start the new Bacula.  If everything worked, it should
1200    not print any error messages.
1201
1202 If you start from scratch, you don't need to run the update_bacula_tables
1203 script because the create_bacula_tables script automatically creates the new
1204 table format.  However, if you are using a version of Bacula older than 3.1.9
1205 (e.g.  3.0.3) then you need to run the update_bacula_tables script that will
1206 be found in the <bacula>/src/cats directory after you run the ./configure
1207 command.  As mentioned above, before running this script, please backup your
1208 catalog database, and when you do running it, be sure shutdown Bacula and be
1209 aware that running the script can take some time depending on your database
1210 size.
1211 ================================================================
1212
1213
1214 ================== Warning !!!!!! ==========================
1215 If you upgrade a previous Win32 client installation, you must
1216 first stop the File daemon, then uninstall it before attempting
1217 the upgrade. If you do not do so, the upgrade will probably
1218 fail and you will need to manually find and run the 
1219 Uninstall.exe file, before you can upgrade to the new version.
1220 This is because the file locations are different.  If you want
1221 to save your previous bacula-fd.conf file, please do so before
1222 uninstalling it.
1223 ================================================================
1224
1225 ================== Warning !!!!!! ==========================
1226 Due to permissions problems on Windows Vista and later systems,
1227 we no longer require SYSTEM or Administrator permissions to 
1228 access the binaries and configuation files.  If you wish
1229 to restrict access to these files, please see the New Features
1230 section of the manual for how to set access control lists.
1231 ================================================================
1232
1233 Note, the Win32 Installer no longer installs the Bacula Servers
1234 (Director and Storage daemon). See the New Features section of
1235 the manual for more details.
1236
1237 ============ Documentation improvements needed ==================
1238
1239 Note!!!!! The 5.0.0+ documentation has a number of known problems:
1240
1241 1. We have reduced the number of manuals, which has fixed many
1242    of the broken links found in the old 3.0.x version, but there
1243    are still some that need fixing.
1244
1245 2. Integration of the 3.0.x features into the main manuals has
1246    not yet been done.
1247
1248 The documentation will not be completed in the near future due to lack
1249 manpower.  If you are unhappy with this situation as we are, we suggest
1250 you help by submitting patches to the documentation.  Thanks.
1251 =====
1252
1253
1254 This release includes large number of new features and changes.
1255 It should be more or less compatible with previous xx.conf files
1256 and File daemons providing that you are not using any of the new
1257 features.
1258
1259 Please see the New Features chapter of the new manual, which documents
1260 some but not all the new features (we are still working on it):
1261
1262 http://www.bacula.org/5.0.x-manuals/en/main/main/New_Features_in_5_0_1.html
1263   
1264 The ChangeLog has more details.