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