]> git.sur5r.net Git - bacula/bacula/blob - bacula/ReleaseNotes
Remove closelog() in bpipe fixes bug #1536
[bacula/bacula] / bacula / ReleaseNotes
1
2                Release Notes for Bacula 5.0.1
3
4   Bacula code: Total files = 1,081 Total lines = 217,272 (Using SLOCCount)
5
6 !!!!!!!!!!!!!!!!!!!!! NOTE !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
7 The Allow Duplicate Jobs directive has been significantly 
8 reworked, and the default value has changed. See below.
9
10 Truncate On Purge has been totally rewritten. See the new
11 features section of the manual.
12 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
13
14 Changes since 5.0.0
15 -------------------
16 - We believe that we have resolved most of the problems
17   concerning canceled or failed jobs being "stuck" in the
18   Director.  There is one outstanding problem in the SD when
19   canceling jobs that we will fix in the next major release.
20   If you see jobs that seem to be stuck, in general issuing
21   a cancel command in bconsole should now make them go away.
22
23 Directives:
24 - The default for "Allow Duplicate Jobs" has been changed from 
25   no to yes.  If you use this directive, please check your
26   conf file, and note the next two items !!!!!!!!!!!!!!!!!!!
27 - AllowHigherDuplicates disabled. It did not work as documented   
28     and was confusing.
29 - New directive "CancelLowerLevelDuplicates" See New Features
30   section in the manual.
31 - Truncate on Purge rewritten.  See New Features section in the manual.
32
33 Bug fixes:
34 1448 1466 1467 1468 1476 1481 1486 1488 1494 1497 1499 1501 1509
35
36 - Apply MacOSX installer patch from bug #1509
37 - Apply fix to previous fix of Copy problem. Fix proposed by reporter o
38   #1476
39 - Fix bug #1501 -t does not print errors
40 - Apply SQLite3 update fix from bug #1497
41 - Apply bashism fix for diskchanger.in script from bug #1499
42 - Apply rpm fix for Sci Linux from bug #1494
43 - Take most recent Ukranian po from bug #1448
44 - Probable fix for Copy/Migration bug #1476
45 - Fix bug #1488 -- avoid recursion and race conditions in messages.c
46 - Upgrade cats library also to 5.0.0
47 - Fix missing console page in bat
48 - Add bat help files to Window install
49 - Improve Windows upgrade to ensure old FD is shutdown
50 - Fix bug #1481 -- bat consumes all console file descriptors
51 - Backport truncate on purge from 5.1.x
52 - Fix bug #1486 -- bat doesn't show any errors on command-line
53 - Update the bsock error URL
54 - Correct .my.cnf umask in make_catalog_backup.pl
55 - Apply fix for dbcheck use by make_catalog_backup.pl
56 - Fix seg fault in bscan from new comment field
57 - Allow multiple CNs when using TLS
58 - Fix seg fault in SQlite driver
59 - Make shared libs version the same as the Bacula release version
60 - Remove file_index sequential check
61 - Fix #1466 about Bogus pruning message
62
63 For Packagers:
64 1.  The default query.sql file is now, except for some comments, empty.
65 The old file, which we no longer support (it is impossible or difficult to
66 make it work on every backend, and the queries are mostly contributed) can
67 be found in <bacula-source>/examples/sample-query.sql.  The sample file is
68 not installed by the Makefiles
69
70 2.  When you install the mtx-changer script, you must also install
71 mtx-changer.conf if it does not exist.  This new file (mtx-changer.conf) is
72 required for mtx-changer to work, but it is a user configurable file, so on
73 any update, any existing file should not be overwritten.
74
75 3.  Bat should be built on every platform that is capabable of running Qt.
76 However, the Qt code is changing rather quickly and is not always
77 compatible from version to version.  We have built and verified bat on Qt
78 4.3.4.  We strongly recommend that you do not build and distribute bat with
79 any other version of Qt unless you personally test it.  To build against Qt
80 4.3.4, download the depkgs-qt package from the Bacula Source Forge download
81 location, read the README file and follow the instructions.
82
83 If you are building for Bacula version 5.0.0, please ensure that you do not
84 have qmake-qt4 loaded on your system.  If you do, either remove it or
85 rename it before trying to build bat.  If you do not, bat will probably be
86 built using the shared objects on your system.  For Bacula 5.0.1 and later,
87 this problem (bug) does not exist.
88
89 depkgs-qt does not install Qt on your system, nor does it interfere with
90 you having any other version of Qt installed on your system.  Once you
91 build bat with depkgs-qt, it should *not* use the Qt shared objects, but
92 rather they will be linked into the program.  After fully installing bat
93 (make install), you can run "ldd bat" to see what shared objects it will
94 use.  If any Qt shared objects are referenced, something has gone wrong.
95
96 4.  Unless absolutely necessary, we recommend that you do not define any
97 special library environment variables that apply to the ./configure -- for
98 example: LIBDIR=/...  ./configure <your-options> is strongly discouraged.
99 Doing so, could potentially cause Bacula to be linked against the wrong
100 shared objects.
101
102 5.  The Bacula project strongly recommends that you install Bacula into a
103 single directory, with a few minor exceptions such as the MySQL or
104 PostgreSQL databases.  Preferrably this should be /opt/bacula.  The full
105 recommendation is:
106
107 #!/bin/sh
108 # Recommended configure script for Bacula
109 prefix=/opt/bacula
110 email=xxx@yyy.zz
111 CFLAGS="-g -O2 -Wall" \
112   ./configure \
113     --sbindir=${prefix}/bin \
114     --sysconfdir=${prefix}/etc \
115     --docdir=${prefix}/html \
116     --htmldir=${prefix}/html \
117     --with-working-dir=${prefix}/working \
118     --with-pid-dir=${prefix}/working \
119     --with-subsys-dir=${prefix}/working \
120     --with-scriptdir=${prefix}/scripts \
121     --with-plugindir=${prefix}/plugins \
122     --libdir=${prefix}/lib \
123     --enable-smartalloc \
124     --enable-tray-monitor \
125     --enable-bat \
126     --with-mysql \
127     --with-dump-email=${email} \
128     --with-job-email=${email} \
129     --with-smtp-host=localhost \
130     --with-baseport=9101
131
132 Obviously, the email, and some of the minor options (mysql, postgresql,
133 ...) can be changed to suit your distribution, but the directory names
134 defined above are strongly recommended, and over time the default values in
135 the bacula-dir.conf and bacula-sd.conf will reflect these choices.
136
137 If you have any questions about this or would like a detailed document
138 describing our recommendations including packaging requirements, please
139 send an email to the bacula-devel list.
140
141 6.  Starting with Bacula version 3.0.0 up to Bacula 5.0.0, the shared
142 libraries that Bacula uses by default are named xxx-1.0.0.  Starting with
143 Bacula 5.0.1, we are going to name the libraries using the Bacula version.
144 So in Bacula 5.0.1, the libraries will be named xxx-5.0.1.  With future
145 versions, the last digit may or may not change when we distribute patch
146 updates (i.e.  the last digit of the version changes).  This will depend on
147 whether or not we have changed something in the library.  Hopefully this
148 new procedure will resolve some of the incompatibility problems between
149 different versions of the shared objects.
150
151 7.  The default build option for bconsole is conio (my own little console
152 routines).  I did this because some years ago, readline was very difficult
153 to maintain -- it and where it was found seemed to change on every release.
154 This generated at the time a number of support problems.  It seems to me
155 that since then there have been very few problems with readline.  As a
156 consequence, I have no problem if you want to make bconsole with readline
157 enabled.  It will actually give some very nice new bconsole command
158 completion functionality that Eric has written.  Bottom line: feel free to
159 use readline or not as you please.
160
161 ==========================================================
162
163
164
165 Release Notes for Bacula 5.0.0
166
167 Release Numbering:
168 -----------------------------------------------------------
169 You might be wondering why this release jumps from 3.0.x to 
170 5.0.0 thus skipping version 4.0.0.  We have done this for 
171 several reasons: first, we wanted a way of distinguishing
172 the numbering system for the Bacula System Enterprise version
173 and the Bacula Project version.  So, to do so, we have decided
174 that the first number of the Bacula Project version will always
175 be odd, and the first number of the Enterprise version will always
176 be even. Thus the Bacula Project now moves from 3.0.x to 5.0.x.
177 In addition, we want to keep the Bacula Project version larger
178 than the Enterprise version to indicate that the Bacula Project
179 version is more advanced or has more features than the 
180 Enterprise version. For memory, the current Enterprise version
181 is 2.6.1, and the next release (in a few months -- before June 2010)
182 will be version 4.0.0.
183
184 Warning:
185 --------------------------------------------------------------
186 Please note the three Warnings below before doing any install or
187 upgrade.
188        
189
190
191
192 Changes since 3.0.3a (the last Bacula Project release):
193 -------------------------------------------------------
194
195 Bug fixes:
196 1337 1351 1352 1354 1357 1361 1367 1369 1370 1373 
197 1376 1391 1403 1409 1420 1422 1427 1428 1431 1450 
198 1454 1455 1458 1456
199
200 Fixed:
201  - Problem that locks the Director when the SMTP server wasn't 
202    responding to the bsmtp program 
203  - Restore's dir command shows incorrect file sizes 
204  - Fix various problems with the reload command   
205  - Fix problems with conio
206  - Eliminate several deadlocks or potential race conditions from SD
207
208 Enhancements:
209  - Project 5: Truncate volume after purge
210  - Project 6: File Deduplication using Base Jobs 
211  - Project 10: Restore from Multiple Storage Daemons
212  - Project 11: AllowCompression per Device
213  - Project 23: Add Maximum Concurent Jobs for Devices to balance load 
214    between drives
215  - Add Accurate Fileset Options to configure accurate detection. Can use 
216    checksum verification for example.
217  - Allow FD to keep root read but drop write permission (CAP)
218  - Secure handling of passwords for catalog backup
219  - Add Tab-completion for Bconsole when using Readline
220  - Add Bvfs API to query the catalog without building a memory tree
221  - Add new speed test to btape program
222  - Add new Bat screens (Autochanger content, Job view, Media view, ...)
223  - Windows version of Bat
224  - Added Spanish Bacula translation   
225  - New bconsole -u nnn option to have timeout on commands
226  - Allow Migrate, Copy, and Virtual Full to read and write
227    to the same Pool
228  - show disabled   -- shows disabled Jobs
229  - Add Pool File and Job retention periods (take precedence over Client)
230  - Many ACL improvements
231  - Level added to FD status Job entry
232  - Allow turning on/off Block Checksum per device
233  - Set Device Poll interval to 5 minutes -- previously did not poll
234  - Implement lock manager with bad order protection
235
236 Compatibility:
237 As always, both the Director and Storage daemon must be upgraded at
238 the same time, and on any given machine, you must run only one version
239 of Bacula. This means that on the Director and Storage daemon machines,
240 you *must* upgrade your File daemon as well.
241
242 Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 5.0.0
243 Director and Storage daemons. There should be no need to upgrade older File
244 Daemons immediately. However, we recommend that you do so as soon
245 as is reasonable for your situation.
246
247 ================== Warning !!!!!! ==========================
248
249 New Catalog format in version 5.0.0 (3.1.9 or later)
250 -----------------------------------------------------
251
252 This release of Bacula uses a new catalog format. We provide a set of
253 scripts that permit to convert a 3.0.x (version 11) catalog to 5.0.0 (version
254 12).  The Bacula project rpms distributed on Source Forge will automatically
255 detect the database change and do the upgrade for you.  We strongly
256 recommend that you save a copy of your existing database before upgrading
257 using rpms.
258
259 The simplest way to upgrade the database assuming you are building from
260 source:
261 1. Stop any current version of Bacula from running.
262 2. Save a copy of your existing database.
263 3. Configure, build, and install the 5.0.0 version of Bacula
264    Note the new ./configure options in the manuals see the link
265    at the bottom of this file.
266 4. cd <your-scripts-installation-directory>
267 5. ./update_bacula_tables
268 6. If you have multiple catalogs, edit the update_bacula_tables
269    script and put the name of another database, and then
270    execute the script again. Repeat this until all Bacula
271    catalogs have been updated.
272 7. Start the new Bacula.  If everything worked, it should
273    not print any error messages.
274
275 If you start from scratch, you don't need to run the update_bacula_tables
276 script because the create_bacula_tables script automatically creates the new
277 table format.  However, if you are using a version of Bacula older than 3.1.9
278 (e.g.  3.0.3) then you need to run the update_bacula_tables script that will
279 be found in the <bacula>/src/cats directory after you run the ./configure
280 command.  As mentioned above, before running this script, please backup your
281 catalog database, and when you do running it, be sure shutdown Bacula and be
282 aware that running the script can take some time depending on your database
283 size.
284 ================================================================
285
286
287 ================== Warning !!!!!! ==========================
288 If you upgrade a previous Win32 client installation, you must
289 first stop the File daemon, then uninstall it before attempting
290 the upgrade. If you do not do so, the upgrade will probably
291 fail and you will need to manually find and run the 
292 Uninstall.exe file, before you can upgrade to the new version.
293 This is because the file locations are different.  If you want
294 to save your previous bacula-fd.conf file, please do so before
295 uninstalling it.
296 ================================================================
297
298 ================== Warning !!!!!! ==========================
299 Due to permissions problems on Windows Vista and later systems,
300 we no longer require SYSTEM or Administrator permissions to 
301 access the binaries and configuation files.  If you wish
302 to restrict access to these files, please see the New Features
303 section of the manual for how to set access control lists.
304 ================================================================
305
306 Note, the Win32 Installer no longer installs the Bacula Servers
307 (Director and Storage daemon). See the New Features section of
308 the manual for more details.
309
310 ============ Documentation improvements needed ==================
311
312 Note!!!!! The 5.0.0+ documentation has a number of known problems:
313
314 1. We have reduced the number of manuals, which has fixed many
315    of the broken links found in the old 3.0.x version, but there
316    are still some that need fixing.
317
318 2. Integration of the 3.0.x features into the main manuals has
319    not yet been done.
320
321 The documentation will not be completed in the near future due to lack
322 manpower.  If you are unhappy with this situation as we are, we suggest
323 you help by submitting patches to the documentation.  Thanks.
324 =====
325
326
327 This release includes large number of new features and changes.
328 It should be more or less compatible with previous xx.conf files
329 and File daemons providing that you are not using any of the new
330 features.
331
332 Please see the New Features chapter of the new manual, which documents
333 some but not all the new features (we are still working on it):
334
335 http://www.bacula.org/5.0.x-manuals/en/main/main/New_Features_in_5_0_0.html
336   
337 The ChangeLog has more details.