]> git.sur5r.net Git - bacula/bacula/blob - bacula/ReleaseNotes
Separate definitions of streams, filetypes, and fileoptions to separate files
[bacula/bacula] / bacula / ReleaseNotes
1
2                Release Notes for Bacula 5.0.3
3
4   Bacula code: Total files = 1,088 Total lines = 219,172 (Using SLOCCount)
5
6 General:
7 --------
8
9 This 5.0.3 version is significant bug fix update to version 5.0.2.
10 It includes new code and some new features.
11 There is no database change since prior versions of 5.0.
12
13 Note, if you are running 5.0.0, read the 5.0.1 and 5.0.2 release notes below in
14   the 5.0.1 release section.
15   Important!!!
16
17 Compatibility:
18 --------------
19  As always, both the Director and Storage daemon must be upgraded at
20  the same time.
21
22  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.0.3
23  Director and Storage daemons. There should be no need to upgrade older File
24  Daemons.
25
26 Changes and New Features:
27 - If a VSS (Windows) snapshot fails, the whole Job is failed, previously
28   it printed a warning message and continued.
29 - New editing codes %b = Job Bytes and %f = Job Files for runscripts
30 - Any non-Bacula project plugins (i.e. third party plugins) 
31   must be upgraded to specify AGPLv3 in place of the GPLv2 used previously 
32   for the PLUGIN_LICENSE.
33 - The bat Media page text columns can be sorted by clicking on the column.
34 - If possible, the SD will automatically update the catalog Volume size if 
35   it does not match the Volume size. The mismatch between the Volume sizes
36   typically occurs when the FD has a comm line drop or the FD crashes.
37
38
39 Bug fixes
40 1538 1554 1564 1567 1568 1569 1571 1577 1581 1582 1587 1594 1595 1606 1610
41
42 - Change license from GPLv2 to AGPLv3
43 - Make Win32 no filesystem change more explicit
44 - Backport Branch-4.0 release to Branch-5.0
45 - Massive backport from Branch-5.1 to Branch-5.0
46 - Fix postgresql catalog creation when version is not on the first line
47 - Fix bug #1610 handle empty xattr values on Linux and xBSD.
48 - Garbage collect memory pool at end of job and before sm_dump
49 - Add xattr seg fault protection suggested by Marco for bug #1610
50 - Add archlinux to os.m4
51 - More fixes for 32/64 bit problems in smartall
52 - Fix 32/64 bit problem in smartalloc dump routine
53 - Fix bad copy/paste in commit c88dccb88 prably a seg fault
54 - Add .dump and .exit commands for daemons
55 - Make SD automatically fix the Volume size in the Catalog when out of sync
56 - Use Pmsg in smartall.c rather than printf for tracing Windows
57 - Up maximum block size to 20M
58 - Fix for TLS bugs #1568 and #1599
59 - Improve comm line error handling for TLS, may fix bug #1568 and #1599
60 - Fix problem when sending Cancel event to plugin
61 - Convert all Jmsg on the watchdog thread to Qmsg
62 - Fix SD crash due to mismatched lock/unlock in error condition
63 - Fix bug #1587 if you have clients with different catalogs configured, both 
64   catalogs contains all clients after a reload or restart of the dir
65 - Fix bug #1577 During migration: ERROR in block.c:950 Failed ASSERT: dev->is_open() 
66   by moving and commenting out the ASSERT()
67 - Skip HB kill in FD if HB thread terminated
68 - Fix crash from unequal volume_lock/unlock calls
69 - New prunning algorithm -- should be more accurate
70 - Save any dumps during regression to dumps directory
71 - Fix crash from rw_lock/unlock miss match
72 - Attempt to fix duplicate job kill seg fault
73 - Replace pthread_kill by my_thread_send_signal() in jcr.c
74 - fix #1595 about batch mode detection problem for postgresql with non standard 
75   install dir
76 - Fix #1594 about prune copy jobs
77 - Apply literal string fix in printf submitted by Luca Berra
78 - Fix bug #1582 Restore from multiple storage daemons breaks subsequent backups
79 - Fix segfault on "cancel jobid=" command
80 - Fix bug #1554 Windows installer doesn't honor /S flag
81 - Remove pool zap code that breaks 2drive-concurrent-test
82 - Fix #1571 and install libraries with 755 perms
83 - Fix bug #1581 ASSERTs in src/dird/jobq.c can never trigger
84 - Fix problem with BaseJob and Accurate FileSet options on client side
85 - Fix for bug #1569 deadlock/crash in Dir
86 - Fix segfault when loading Plugins
87 - Fix #1567 about display of long volume names truncated during restore
88 - Added new bacula-libs package.
89 - Fix bug #1538 Start Scripts return incorrect value
90 - Fix bug #1564 init scripts not LSB compliant
91
92 See ChangeLog for more details.
93
94 =============================================================================
95
96
97 ============= Release 5.0.2 ========================
98
99 Changes since 5.0.1
100 -------------------
101
102 Bug fixes
103 1502 1511 1517 1524 1527 1532 1536 1541 1549 1551 1553 1559 1560
104
105 - Probable fix for SD crash bug #1553
106 - Fix #1559 problem when restoring pruned jobs with a regexp
107 - Fix for bug #1560 bcopy cannot find Volume
108 - Fix cancel crash bug #1551
109 - Check if sql backend is thread-safe
110 - Correct Pool display in SD status. Fixes bug #1541
111 - Fix cancel crash reported by Stephen Thompson
112 - Rewind on close to fix #1549
113 - Remove closelog() in bpipe fixes bug #1536
114 - Fix #1517 about missing Base level in .level command
115 - Replace ASSERT in block.c with fail Job
116 - Fix database locking calling db_lock and returning from function without
117   calling db_unlock.
118 - Add missing db_unlock to bvfs_update_cache.
119 - Fix #1532 about permission on binaries
120 - Fix #1527 about deadlock during migration
121 - Another fix for OpenSSLv1
122 - Add -lrt to Solaris links
123 - Fix tls.c for OpenSSLv1
124 - Fix #1511 when trying to insert more than 50.000 directories in bvfs
125 - Fix plugin load not to stop if one plugin bad -- pointed out by James
126 - Remove --without-qwt from configure statement.
127 - Second correct fix to bug #1524 verify fails after adding or removing files
128 - Fix bug #1524 verify fails after adding or removing files
129 - Apply fix suggested by Andreas in bug #1502 for mediaview column sort problem
130 - Fix OpenSSL 1.x problem in crypto.c on Fedora 12
131 - Display AllowCompress warning message only if compression used in FileSet
132
133 =============================================================================
134
135
136 ============= Release 5.0.1 ========================
137
138 !!!!!!!!!!!!!!! NOTE FOR 5.0.0 USERS !!!!!!!!!!!!!!!!!!!!
139 The Allow Duplicate Jobs directive has been significantly 
140 reworked, and the default value has changed. See below.
141
142 Truncate On Purge has been totally rewritten. See the new
143 features section of the manual.
144
145 When Volume Poll Interval is set in the SD DEVICE configuration,
146 (default 5 mins), after a certain number of polling tries (approx
147 10) polling will stop and the operator will be asked to
148 resolve the problem.  Previously there was no limit, and an
149 error message could be produced at each poll attempt.
150 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
151
152 Changes since 5.0.0
153 -------------------
154 - We believe that we have resolved most of the problems
155   concerning canceled or failed jobs being "stuck" in the
156   Director.  There is one outstanding problem in the SD when
157   canceling jobs that we will fix in the next major release.
158   If you see jobs that seem to be stuck, in general issuing
159   a cancel command in bconsole should now make them go away.
160
161 Directives:
162 - The default for "Allow Duplicate Jobs" has been changed from 
163   no to yes.  If you use this directive, please check your
164   conf file, and note the next two items !!!!!!!!!!!!!!!!!!!
165 - AllowHigherDuplicates disabled. It did not work as documented   
166     and was confusing.
167 - New directive "CancelLowerLevelDuplicates" See New Features
168   section in the manual.
169 - Truncate on Purge rewritten.  See New Features section in the manual.
170
171 Bug fixes:
172 1448 1466 1467 1468 1476 1481 1486 1488 1494 1497 
173 1499 1501 1505 1509 1513
174
175 - Ensure SD asks for help when looping even if poll set. Fixes bug #1513.
176 - Fix three-pool regress bug
177 - Modify bacula.spec fixes bug #1505
178 - This version fixes an issue where the console window would start out
179   docked. It is fixed by initiating the variables in the Pages class wi
180   constructor.
181 - Fix make_catalog_backup.pl fails when catalog db is on other host
182 - Apply MacOSX installer patch from bug #1509
183 - Apply fix to previous fix of Copy problem. Fix proposed by reporter o
184   #1476
185 - Fix bug #1501 -t does not print errors
186 - Apply SQLite3 update fix from bug #1497
187 - Apply bashism fix for diskchanger.in script from bug #1499
188 - Apply rpm fix for Sci Linux from bug #1494
189 - Take most recent Ukranian po from bug #1448
190 - Probable fix for Copy/Migration bug #1476
191 - Fix bug #1488 -- avoid recursion and race conditions in messages.c
192 - Upgrade cats library also to 5.0.0
193 - Fix missing console page in bat
194 - Add bat help files to Window install
195 - Improve Windows upgrade to ensure old FD is shutdown
196 - Fix bug #1481 -- bat consumes all console file descriptors
197 - Backport truncate on purge from 5.1.x
198 - Fix bug #1486 -- bat doesn't show any errors on command-line
199 - Update the bsock error URL
200 - Correct .my.cnf umask in make_catalog_backup.pl
201 - Apply fix for dbcheck use by make_catalog_backup.pl
202 - Fix seg fault in bscan from new comment field
203 - Allow multiple CNs when using TLS
204 - Fix seg fault in SQlite driver
205 - Make shared libs version the same as the Bacula release version
206 - Remove file_index sequential check
207 - Fix #1466 about Bogus pruning message
208
209 For Packagers:
210 1.  The default query.sql file is now, except for some comments, empty.
211 The old file, which we no longer support (it is impossible or difficult to
212 make it work on every backend, and the queries are mostly contributed) can
213 be found in <bacula-source>/examples/sample-query.sql.  The sample file is
214 not installed by the Makefiles
215
216 2.  When you install the mtx-changer script, you must also install
217 mtx-changer.conf if it does not exist.  This new file (mtx-changer.conf) is
218 required for mtx-changer to work, but it is a user configurable file, so on
219 any update, any existing file should not be overwritten.
220
221 3.  Bat should be built on every platform that is capabable of running Qt.
222 However, the Qt code is changing rather quickly and is not always
223 compatible from version to version.  We have built and verified bat on Qt
224 4.3.4.  We strongly recommend that you do not build and distribute bat with
225 any other version of Qt unless you personally test it.  To build against Qt
226 4.3.4, download the depkgs-qt package from the Bacula Source Forge download
227 location, read the README file and follow the instructions.
228
229 If you are building for Bacula version 5.0.0, please ensure that you do not
230 have qmake-qt4 loaded on your system.  If you do, either remove it or
231 rename it before trying to build bat.  If you do not, bat will probably be
232 built using the shared objects on your system.  For Bacula 5.0.1 and later,
233 this problem (bug) does not exist.
234
235 depkgs-qt does not install Qt on your system, nor does it interfere with
236 you having any other version of Qt installed on your system.  Once you
237 build bat with depkgs-qt, it should *not* use the Qt shared objects, but
238 rather they will be linked into the program.  After fully installing bat
239 (make install), you can run "ldd bat" to see what shared objects it will
240 use.  If any Qt shared objects are referenced, something has gone wrong.
241
242 4.  Unless absolutely necessary, we recommend that you do not define any
243 special library environment variables that apply to the ./configure -- for
244 example: LIBDIR=/...  ./configure <your-options> is strongly discouraged.
245 Doing so, could potentially cause Bacula to be linked against the wrong
246 shared objects.
247
248 5.  The Bacula project strongly recommends that you install Bacula into a
249 single directory, with a few minor exceptions such as the MySQL or
250 PostgreSQL databases.  Preferrably this should be /opt/bacula.  The full
251 recommendation is:
252
253 #!/bin/sh
254 # Recommended configure script for Bacula
255 prefix=/opt/bacula
256 email=xxx@yyy.zz
257 CFLAGS="-g -O2 -Wall" \
258   ./configure \
259     --sbindir=${prefix}/bin \
260     --sysconfdir=${prefix}/etc \
261     --docdir=${prefix}/html \
262     --htmldir=${prefix}/html \
263     --with-working-dir=${prefix}/working \
264     --with-pid-dir=${prefix}/working \
265     --with-subsys-dir=${prefix}/working \
266     --with-scriptdir=${prefix}/scripts \
267     --with-plugindir=${prefix}/plugins \
268     --libdir=${prefix}/lib \
269     --enable-smartalloc \
270     --enable-tray-monitor \
271     --enable-bat \
272     --with-mysql \
273     --with-dump-email=${email} \
274     --with-job-email=${email} \
275     --with-smtp-host=localhost \
276     --with-baseport=9101
277
278 Obviously, the email, and some of the minor options (mysql, postgresql,
279 ...) can be changed to suit your distribution, but the directory names
280 defined above are strongly recommended, and over time the default values in
281 the bacula-dir.conf and bacula-sd.conf will reflect these choices.
282
283 If you have any questions about this or would like a detailed document
284 describing our recommendations including packaging requirements, please
285 send an email to the bacula-devel list.
286
287 6.  Starting with Bacula version 3.0.0 up to Bacula 5.0.0, the shared
288 libraries that Bacula uses by default are named xxx-1.0.0.  Starting with
289 Bacula 5.0.1, we are going to name the libraries using the Bacula version.
290 So in Bacula 5.0.1, the libraries will be named xxx-5.0.1.  With future
291 versions, the last digit may or may not change when we distribute patch
292 updates (i.e.  the last digit of the version changes).  This will depend on
293 whether or not we have changed something in the library.  Hopefully this
294 new procedure will resolve some of the incompatibility problems between
295 different versions of the shared objects.
296
297 7.  The default build option for bconsole is conio (my own little console
298 routines).  I did this because some years ago, readline was very difficult
299 to maintain -- it and where it was found seemed to change on every release.
300 This generated at the time a number of support problems.  It seems to me
301 that since then there have been very few problems with readline.  As a
302 consequence, I have no problem if you want to make bconsole with readline
303 enabled.  It will actually give some very nice new bconsole command
304 completion functionality that Eric has written.  Bottom line: feel free to
305 use readline or not as you please.
306
307 ==========================================================
308
309
310
311 Release Notes for Bacula 5.0.0
312
313 Release Numbering:
314 -----------------------------------------------------------
315 You might be wondering why this release jumps from 3.0.x to 
316 5.0.0 thus skipping version 4.0.0.  We have done this for 
317 several reasons: first, we wanted a way of distinguishing
318 the numbering system for the Bacula System Enterprise version
319 and the Bacula Project version.  So, to do so, we have decided
320 that the first number of the Bacula Project version will always
321 be odd, and the first number of the Enterprise version will always
322 be even. Thus the Bacula Project now moves from 3.0.x to 5.0.x.
323 In addition, we want to keep the Bacula Project version larger
324 than the Enterprise version to indicate that the Bacula Project
325 version is more advanced or has more features than the 
326 Enterprise version. For memory, the current Enterprise version
327 is 2.6.1, and the next release (in a few months -- before June 2010)
328 will be version 4.0.0.
329
330 Warning:
331 --------------------------------------------------------------
332 Please note the three Warnings below before doing any install or
333 upgrade.
334        
335
336 Changes since 3.0.3a (the last Bacula Project release):
337 -------------------------------------------------------
338
339 Bug fixes:
340 1337 1351 1352 1354 1357 1361 1367 1369 1370 1373 
341 1376 1391 1403 1409 1420 1422 1427 1428 1431 1450 
342 1454 1455 1458 1456
343
344 Fixed:
345  - Problem that locks the Director when the SMTP server wasn't 
346    responding to the bsmtp program 
347  - Restore's dir command shows incorrect file sizes 
348  - Fix various problems with the reload command   
349  - Fix problems with conio
350  - Eliminate several deadlocks or potential race conditions from SD
351
352 Enhancements:
353  - Project 5: Truncate volume after purge
354  - Project 6: File Deduplication using Base Jobs 
355  - Project 10: Restore from Multiple Storage Daemons
356  - Project 11: AllowCompression per Device
357  - Project 23: Add Maximum Concurent Jobs for Devices to balance load 
358    between drives
359  - Add Accurate Fileset Options to configure accurate detection. Can use 
360    checksum verification for example.
361  - Allow FD to keep root read but drop write permission (CAP)
362  - Secure handling of passwords for catalog backup
363  - Add Tab-completion for Bconsole when using Readline
364  - Add Bvfs API to query the catalog without building a memory tree
365  - Add new speed test to btape program
366  - Add new Bat screens (Autochanger content, Job view, Media view, ...)
367  - Windows version of Bat
368  - Added Spanish Bacula translation   
369  - New bconsole -u nnn option to have timeout on commands
370  - Allow Migrate, Copy, and Virtual Full to read and write
371    to the same Pool
372  - show disabled   -- shows disabled Jobs
373  - Add Pool File and Job retention periods (take precedence over Client)
374  - Many ACL improvements
375  - Level added to FD status Job entry
376  - Allow turning on/off Block Checksum per device
377  - Set Device Poll interval to 5 minutes -- previously did not poll
378  - Implement lock manager with bad order protection
379
380 Compatibility:
381 As always, both the Director and Storage daemon must be upgraded at
382 the same time, and on any given machine, you must run only one version
383 of Bacula. This means that on the Director and Storage daemon machines,
384 you *must* upgrade your File daemon as well.
385
386 Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 5.0.0
387 Director and Storage daemons. There should be no need to upgrade older File
388 Daemons immediately. However, we recommend that you do so as soon
389 as is reasonable for your situation.
390
391 ================== Warning !!!!!! ==========================
392
393 New Catalog format in version 5.0.0 (3.1.9 or later)
394 -----------------------------------------------------
395
396 This release of Bacula uses a new catalog format. We provide a set of
397 scripts that permit to convert a 3.0.x (version 11) catalog to 5.0.0 (version
398 12).  The Bacula project rpms distributed on Source Forge will automatically
399 detect the database change and do the upgrade for you.  We strongly
400 recommend that you save a copy of your existing database before upgrading
401 using rpms.
402
403 The simplest way to upgrade the database assuming you are building from
404 source:
405 1. Stop any current version of Bacula from running.
406 2. Save a copy of your existing database.
407 3. Configure, build, and install the 5.0.0 version of Bacula
408    Note the new ./configure options in the manuals see the link
409    at the bottom of this file.
410 4. cd <your-scripts-installation-directory>
411 5. ./update_bacula_tables
412 6. If you have multiple catalogs, edit the update_bacula_tables
413    script and put the name of another database, and then
414    execute the script again. Repeat this until all Bacula
415    catalogs have been updated.
416 7. Start the new Bacula.  If everything worked, it should
417    not print any error messages.
418
419 If you start from scratch, you don't need to run the update_bacula_tables
420 script because the create_bacula_tables script automatically creates the new
421 table format.  However, if you are using a version of Bacula older than 3.1.9
422 (e.g.  3.0.3) then you need to run the update_bacula_tables script that will
423 be found in the <bacula>/src/cats directory after you run the ./configure
424 command.  As mentioned above, before running this script, please backup your
425 catalog database, and when you do running it, be sure shutdown Bacula and be
426 aware that running the script can take some time depending on your database
427 size.
428 ================================================================
429
430
431 ================== Warning !!!!!! ==========================
432 If you upgrade a previous Win32 client installation, you must
433 first stop the File daemon, then uninstall it before attempting
434 the upgrade. If you do not do so, the upgrade will probably
435 fail and you will need to manually find and run the 
436 Uninstall.exe file, before you can upgrade to the new version.
437 This is because the file locations are different.  If you want
438 to save your previous bacula-fd.conf file, please do so before
439 uninstalling it.
440 ================================================================
441
442 ================== Warning !!!!!! ==========================
443 Due to permissions problems on Windows Vista and later systems,
444 we no longer require SYSTEM or Administrator permissions to 
445 access the binaries and configuation files.  If you wish
446 to restrict access to these files, please see the New Features
447 section of the manual for how to set access control lists.
448 ================================================================
449
450 Note, the Win32 Installer no longer installs the Bacula Servers
451 (Director and Storage daemon). See the New Features section of
452 the manual for more details.
453
454 ============ Documentation improvements needed ==================
455
456 Note!!!!! The 5.0.0+ documentation has a number of known problems:
457
458 1. We have reduced the number of manuals, which has fixed many
459    of the broken links found in the old 3.0.x version, but there
460    are still some that need fixing.
461
462 2. Integration of the 3.0.x features into the main manuals has
463    not yet been done.
464
465 The documentation will not be completed in the near future due to lack
466 manpower.  If you are unhappy with this situation as we are, we suggest
467 you help by submitting patches to the documentation.  Thanks.
468 =====
469
470
471 This release includes large number of new features and changes.
472 It should be more or less compatible with previous xx.conf files
473 and File daemons providing that you are not using any of the new
474 features.
475
476 Please see the New Features chapter of the new manual, which documents
477 some but not all the new features (we are still working on it):
478
479 http://www.bacula.org/5.0.x-manuals/en/main/main/New_Features_in_5_0_1.html
480   
481 The ChangeLog has more details.