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