2 Release Notes for Bacula 1.39.32
4 Bacula code: Total files = 438 Total lines = 153,698 (*.h *.c *.in)
7 Version 1.39.32 contains mainly bug fixes to 1.39.30 Please
8 see the ChangeLog for more details.
11 ==== IMPORTANT Encrypted Volume data may be unreadable ====
12 - If you have been using the data encryption feature of 1.39.x, please
13 be aware that certain combinations of encryption and other options
14 with version 1.39.0 through 1.39.26 created Volume data that cannot
15 be restored. We strongly recommend that anyone using encryption
16 carefully review his/her backups and at a minium do a Full backup
17 with 1.39.28 of all encrypted data. Robert Nelson has identified
18 and fixed it as follows:
20 No filters = Works fine
22 Compression = Works fine
23 Encryption = Works fine
24 Sparse + Compression = Works fine
26 Sparse + Encryption = Restore broken
27 Sparse + Compression + Encryption = Restore broken
28 Compression + Encryption = Restore broken
31 Most combinations work, but some encrypted files are
32 not properly restored.
35 All combinations work fine except Sparse+Encryption.
37 Bottom line, if you are using data encryption, please test restoring
38 data to be sure it all works correctly.
40 ==== IMPORTANT a stock SuSE 10.1 kernel may crash =====
41 - A stock SuSE 10.1 kernel may crash when Bacula runs and accesses
42 the tape drive. Workaround, load the SuSE 10.1 version 2.6.16.21-0.25
43 kernel or later. The SuSE 10.2 Alpha 5 or later kernel also works.
45 ==== IMPORTANT Catalog update required =====
46 - The database format has been updated from what was used in
47 Bacula 1.38.x. You must manually update your database before
48 running Bacula 1.39.x or higher. Please backup your previous
49 version of the database before running the update. The update
50 script will be automatically installed in your scripts directory,
51 or can also be found in <bacula-source>/src/cats. It is called:
53 ./update_bacula_tables
55 It is necessary to run it only once the first time you move to
56 a 1.39.x beta or to 1.40.0. Upgrading the Bacula version
57 thereafter does not require updating the database again.
58 Depending on the size of your database the script make take a
59 bit of time, to run, but in general, it should be very fast.
61 ==== IMPORTANT DVD Volume format changed ====
62 - The current Volume format written by 1.39.22 is different from
63 the format written by previous versions. The two formats
64 are not compatible. Thus any DVDs written prior to 1.39.22 will
65 be unreadable by version 1.39.22.
67 ==== IMPORTANT miscellaneous ====
68 - The Gnome console program (gconsole) no longer functions as it
69 should. If you have multiple catalogs, you will need to select
70 the catalog (this I will fix). More importantly, in restore
71 mode, the restore tree is no longer shown in the left pane. I
72 suspect this is due to incompatible changes in the GTK+ API,
73 and hence have given up on gnome and gtk+, as this has already
74 happened several times previously. At some point there
75 will be a new GUI console.
76 - The bacula-dir.conf directive Accept Any Volume has been
77 removed because it was never implemented. You must delete all
78 occurrence of this directive for the Director to run.
79 - The --mandir ./configure option now points to the top level man
80 directory. The man files will be installed under mandir/man8 and
81 mandir/man1 as appropriate.
82 - The "Accept Any Volume" directive has been removed. It was never
83 implemented. Bacula will always accept any valid tape that is in
84 the drive for appending.
85 - You *should* be able to use 1.38.x FDs with version 1.39.18 Director
86 and SD providing you do not use any of the new features (runscript,
87 data encryption). It seems to work here, but we do not guarantee it.
88 - Your Director and SD must be simultaneously upgraded.
89 - The restore command no longer uses the MediaType as the primary method
90 of finding a suitable Storage device. Normally it will select the last
91 device used to write a Volume. If no storage device is defined, it
92 will use the old algorithm which selects the first Storage resource
93 with the correct MediaType.
94 - The MD5/SHA1 hash codes kept in the database are now kept in a binary
95 format compatible with the rest of the world. If you are running verify
96 jobs, you *must* do an InitCatalog or all files will show an MD5
97 difference. Also, authentication uses the new algorithm by
98 default, but *should* accept connections from older components (FD) using
99 the old non-compatible algorithm. This has been tested, but more
100 more testing is still needed.
102 ==== IMPORTANT new Win32 install procedure =====
103 For Win32 migrations from versions prior to 1.39.0 nothing special
104 needs to be done to upgrade. Everything should be taken care of
105 automatically. The only thing not done is to delete the old C:\Bacula
106 directory (mostly out of paranoia, we can change that prior to release if
107 everyone is comfortable with it).
109 Prior to using the current installer, if you used a version of the beta
110 prior to 1.39.26, you must do one of the following three things:
112 1) Uninstall prior beta version and select the option to delete
113 the configuration and state files. This will get rid of the bogus
114 configuration files. Reinstall the new 1.39.26 version.
116 2) Manually copy the *.conf files from C:\Bacula\bin to
117 C:\Documents and Settings\All Users\Application Data\Bacula.
119 3) Manually edit the *.conf files in C:\Documents and
120 Settings\All Users\Application Data\Bacula. The links in the Bacula menu
121 can be used to avoid having to enter that ugly path.
123 After one of these has been done the upgrade should work fine.
126 New Features in 1.39.30:
127 - The Bacula source code is now copyrighted by the Free Software
128 Foundation Europe. The Developer's Guide documents the new procedures,
129 and the LICENSE file has been updated.
130 - Turn on disk seek code for restores.
131 - Apply Jaime Ventura's patch that implements the Messages resource
132 Mail On Success directive.
133 - The Client returns its Version string, which is printed in the Job
135 - The Client returns whether or not VSS and Encryption are used, which
136 are printed in the Job report.
138 Major new Features in 1.40.0:
139 - The basic features of Migration are now complete, and
140 are documented in a new Migration chapter in the manual
141 http://www.bacula.org/dev-manual/Migration.html
142 - There is an Encryption chapter in the doc.
143 http://www.bacula.org/dev-manual/Bacula_Data_Encryption.html
144 - Additional support for removable devices. See the
145 Requires Mount, Mount Point, Mount Command, and Unmount
146 Commands in the Storage daemon configuration chapter:
147 http://www.bacula.org/dev-manual/Storage_Daemon_Configuratio.html
148 Also see the Edit Codes for Mount and Unmount Directives in the
150 - Switch the Win32 build from using Microsoft C++ to using mingw32
151 cross-compiling. The initial work was done by Howard Thomson,
152 then tweaked by me. Robert Nelson then totally reworked the
153 cross-compiling code so that it not only cross-compiles, but
154 also compiles on Visual Studio, and at the same time, he added
155 all the current Unix features to the FD, such as selection on
156 drives, encryption support, building *all* the tools, ...
157 - The Director and Storage daemon have now been ported to Win32.
158 This code is working but should still be considered beta (i.e.
159 test carefully before putting into production).
160 - Data encryption done in the Client is now supported due to code
161 submitted by Landon Fuller.
162 - Bacula restore and bextract can now extract non-portable Win32 data to
163 any client (including Unix/Linux clients). Of course, in doing so,
164 the Microsoft specific permissions and ACLs will be lost. Thanks
165 to Thorsten Engel for this code.
166 - The 260 character limitation for Win32 paths name lengths is now
167 eliminated thanks to Thorsten Engel.
168 - Eric Bollengier wrote new RunScript directives that includes
169 the old RunBefore/AfterJob and ClientRunBefore/AfterJob features
170 plus a *lot* more, allowing you to control just about every aspect
171 of running scripts. See the manual for detailed documentation.
172 http://www.bacula.org/dev-manual/Configuring_Director.html#5227
173 - SunOS ACLs should now work thanks to a patch from David Duchscher.
174 - Apply days keyword patch from Alexander.Bergolth at wu-wien.ac.at
175 If this patch is applied, the number of days can be specified with
176 "list nextvol days=xx"
179 This can be used to preview the next scheduled job (and the
180 next tape to be used) on Fridays if there are no scheduled jobs during
182 - Apply patch for enhancing wait from Eric Bollengier. One can now:
183 wait (wait for all jobs to stop)
185 wait jobuid=unique id
187 - Volumes can now be set to Enable, Disable, or Archive. If they
188 are not enabled, Volumes will not be mounted.
189 Implement update volume enable=(on|off|true|false|archived|0|1|2)
190 - Add Catalog message destination in Messages resource that puts the
191 job report in the Log database table.
194 New Features in 1.40.0:
195 - Add enable/disable job=<job-name>. This command prevents
196 the specified job from being scheduled. Even when disabled,
197 the job can be manually started from the console.
198 - The database Id records should be 32/64 bit independent now. 64 bits
199 can be enabled by changing one define, but this has never been tested.
200 - Relative path specifications (i.e. ../xxx) are now permitted in
201 the restore cd command.
202 - When running multiple simultaneous jobs, most jobs that use spooling
203 will now finish faster due to a mutex optimization made by Eric
205 - Conf files containing UTF-8 marker at the head of the file as well as
206 conf files containing Window cr/lf and Mac cr line termination characters
207 are now accepted thanks to Robert Nelson.
208 - Windows tray status windows are scrollable and resizable.
209 - Win32 external script execution is much more flexible -- handles
210 spaces in names better, ...
211 - Lots of DVD fixes -- writing DVDs is now reported to work.
212 - Fix opening of database in a restricted console to respect
214 - Permit multiple console/director resources in bconsole.conf.
215 patch from Carsten Paeth calle@calle.in-berlin.de
216 - Character substitution in Job/JobDefs WriteBootStrap.
217 from Eric Bollengier.
218 - Apply patch supplied in bug #656 to pass priority field
219 in the run dialog to the Director in gnome console.
220 - Add support of encrypted data stream to bscan from Eric.
221 display data_len instead of data content (may be binary).
222 - Add Enabled=xxx on update slots command.
223 - Add host:port to connect failure messages to FD and SD from Dir/
224 - Add WhereACL to console ACL list. If nothing is specified, only
225 the default is permitted for restore. Otherwise, *all* allows any
226 path, or you can specify permitted paths. This should allow control
227 over where users can restore files. This is untested.
228 - Install man pages with 'make install'.
229 - Add Media.Enabled flag to client backups for dotcmds.c
230 - Enforce Media.Enabled=1 for a current restore to work
231 - Require restore case 3 to have sqlquery permission to work.
232 - Add -n option to bconsole to turn off conio.
233 - The bytes field in the terminated jobs part of the status
234 command now reports in KB, MB, ... units.
235 - When not descending into a directory, print the File= name that
236 triggered it -- makes why not descending a bit clearer
237 - Do not unload autochanger when doing "update slots"
238 - Implement mount command for autochanger
239 - Fix bug #462 incorrect error message printed when client script called
240 from File= was not found.
241 - Fix bug #558 (waiting for feedback) where Bacula needs too much time to
242 do a rewind on Solaris when no tape is in the drive (Solaris does not
243 have the detailed errno found on Linux). Added Solaris specific code.
244 Note, this may apply to other OSes as well.
245 - The examples directory has a new bacula_mail_summary.sh file that
246 creates a single email summary of any number of jobs. Submitted by
248 - Add nagios plugin to the examples directory. Submitted by
250 - Modify most restore error messages to be queued so that they
251 appear at the end of the job rather than mixed with the restore
252 listing where they could be "lost".
253 - Apply patch supplied by user (slightly modified) to fix
254 correct detection of holes in block devices and FIFOs.
256 - Added a report.pl program to the examples directory from Jonas Bjorklund.
257 - Add two new queries to query.sql provided by Arno. One
258 list volumes known to the Storage device, and the other
259 lists volumes possibly needing replacement (error, ...).
260 - Implement new code for changing userid and group at startup. This
261 should get Bacula into the correct groups.
262 - Implement support for removable filesystems.
263 - Transfer rates are now presented in a more readable format thanks
264 to a user submission.
265 - SD is now aware of what volumes are mounted. More information is printed
266 in the Status report.
267 - The Pool Maximum Volumes directive is now respected in all places.
268 - A Storage device can now be specified in a Pool resource. It will override
269 all other Storage specifications.
270 - Most but not all directives accept true/false in place of yes/no.
271 - A patch from Karl Hakimian that reads JobIds, FileIndexes
272 from a database table for restore.
273 - There are a number of new tables. Some such as the Location table are
274 designed for user use in doing Volume Management software.
275 - Maximum Changer Wait, Maximum Open Wait, Maximum Rewind Wait to
276 accept time qualifiers.
277 - Implement jobuid to replace old usage of job in keywords as
278 suggested by Eric Bollengier.
279 - Implement write variables for Python to set Priority (anytime), and
280 Job Level, only during JobInit event.
281 - Use the keyword ujobid to mean the unique job id; job or jobname
282 to mean the Job name given on the Name directive, and jobid to
283 be the numeric (non-unique) job id.
284 - Allow the SD to use multiple drives during a backup/restore (only
285 one at a time). This is not well tested.
286 - Integrate addition of line count limitation to bsmtp -l from
287 Sebastian Stark <stark at tuebingen.mpg.de>
288 - Split the bacula start/start script into four files:
289 bacula -- starts and stops calling other scripts
290 bacula-ctl-dir -- starts/stops the director
291 bacula-ctl-fd -- starts/stops the File daemon
292 bacula-ctl-sd -- starts/stops the Storage daemon
293 - Remove automatic case folding on Windows FDs. You must
294 explicitly use the 'Ignore Case = yes' option.
295 - Implement wild program in tools directory for testing
296 wild-cards. Almost identical to the regex program.
297 - Use the new bregex.c to implement Regex expressions on Win32.
298 - Apply patch from Christopher Hull
299 - Allow multiple connections to database with different
301 - Invalidate the scheduler when doing a reload. Fixes seg
302 fault, but still 60 second window.
303 - Additional info in Reschedule message.
304 - Use set_jcr_job_status() everywhere to prevent loss of
306 - Display peer IP in FD if error from connecting DIR.
307 - Don't increment file count for DIRBEGIN.
308 - Replace illegal characters in Win32 filename by _.
309 - Add SE_CREATE_PERMANENT_NAME privilege in Win32.
310 - Hash hard link filenames rather than linked list (performance).
311 - Fix for security failure in chdir on Win32.
312 - Add CreateDirectoryA/W win32 API entry points.
313 - programs to duplicate Bacula's base64 algorithm using standard
314 routines. This fixes bugs #296, and 565. Patch submitted by
316 - Fixes to reloading the Dir conf file from Eric Bollengier and Christopher
318 - Modify LICENSE to correct some problems pointed out by Debian.
319 - Apply a patch submitted by cesarb in bug #606 to implement O_NOATIME support.
320 O_NOATIME is a open() flag which makes it possible to read a file without
321 updating the inode atime (and also without the inode ctime update which
322 happens if you try to set the atime back to its previous value). It also
323 prevents a race condition when two programs are reading the same file, but
324 only one does not want to change the atime. It's most useful for backup
325 programs and file integrity checkers (and bacula can fit on both
327 You enable it in the Bacula FileSet Options resource by setting:
329 The effect of this option is similar to the keepatime option except
330 it is more efficient and avoids modifying ctime.
331 - Implement a pile of new man pages contributed by Jose Tallon.
332 - Implement a number of user supplied patches for DVD writing.
333 - Modify the database format for handling Migration jobs:
334 Add PriorJobId, RealEndTime to Job table
336 Remove Stripe from JobMedia record (not used, wasting space)
337 Add ScratchPoolId, RecyclePoolId, Enabled to Media record
338 Add Cost to Location table.
339 Enabled to Media table and Location table.
340 - Security: harden authentication failure in FD by single threading errors
341 and forcing a 6 second wait.
342 - If using GCC (actually g++) add the following compiler flags
343 -fno-strict-aliasing -fno-exceptions -fno-rtti
344 - Turn on new bsnprintf() code.
345 The reason for this code is to eliminate the
346 security problems associated with using the system libraries
348 - Implement job report that indicates where Storage and Pool
349 came from -- with overrides and Pool storage and NextPool,
350 it is all very complicated.
351 - Add more detail (Storage, Device) to list of volumes printed
353 - Add new VOLMGMT message class. No messages are yet sent with this
355 - Spend a lot of time integrating mkcdrec with the rescue disk.
356 - Add spooling/despooling info in status output of SD.
357 - Add Comment field to llist of a volume.
358 - Allow true/false in some yes/no questions.
360 Additional Features Added for Win32:
361 - Added DriveType directive to the Director's Include Option FileSet
362 resource. Allowed values are: fixed, removable, cdrom, and remote. There
363 is only an implementation for Windows because it is the only platform that
364 has the concept of drives.
366 - Adds EnhancedWild directive to the Director's Include Option FileSet
367 resource. Allowed values are: yes and no.
369 When EnhancedWild is enabled then the processing of the
370 Wild, WildDir and WildFile is changed in the following ways.
372 Patterns conform to Posix
373 \ is not a special character in character classification []
374 To match a - it must be the first or last character
375 To match a ] it must be the first character
377 fnmatch option FNM_FILE_NAME is specified * doesn't match a /
378 so it won't match multiple directory levels in a path
380 - Relative WildFile patterns (ones without a leading /) match
381 against the filename portion. This in combination with the
382 FNM_FILE_NAME fnmatch() flag makes directives such as WildFile =
383 abc*.def work as expected.
385 - Adds support for the shell's feature of brace expansion.
387 Here is an example where braces allow 24 lines to be expressed in 5.
389 # Exclude directories full of lots and lots of useless little files
390 WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/Cookies"
391 WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/Recent"
392 WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local Settings,LOCALS~1}/History"
393 WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local Settings,LOCALS~1}/Temp"
394 WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local Settings,LOCALS~1}/Temporary Internet Files"