2 Release Notes for Bacula 1.39.22
4 Bacula code: Total files = 447 Total lines = 149,711 (*.h *.c *.in)
6 New Features in 1.39.22:
7 - Fix opening of database in console to respect ACL.
8 - Permit multiple console/director resources in bconsole.conf.
9 patch from Carsten Paeth calle@calle.in-berlin.de
10 - Character substitution in Job/JobDefs WriteBootStrap.
12 - Apply patch supplied in bug #656 to pass priority field
13 in the run dialog to the Director in gnome console.
14 - Add support of encrypted data stream to bscan from Eric.
15 display data_len instead of data content (may be binary)
16 - Add Enabled=xxx on update slots command.
17 - Add host:port to connect failure messages to FD and SD from Dir
18 - Add WhereACL to console ACL list. If nothing is specified, only
19 the default is permitted for restore. Otherwise, *all* allows any
20 path, or you can specify permitted paths. This should allow control
21 over where users can restore files. This is untested.
22 - Install man pages with 'make install'
23 - Add Media.Enabled flag to client backups for dotcmds.c
24 - Enforce Media.Enabled=1 for a current restore to work
25 - Require restore case 3 to have sqlquery permission to work.
28 - Lots of fixes -- see ChangeLog.
29 - Lots of work on DVD writing.
30 - Lots of work on documentation in the manual.
31 - Lots of work on the rescue disk.
33 ==== IMPORTANT Catalog update required =====
34 - The database format has been updated from what was used in
35 Bacula 1.38.x. You must manually update your database before
36 running Bacula 1.39.x or higher. Please backup your previous
37 version of the database before running the update. The update
38 script will be automatically installed in your scripts directory,
39 or can also be found in <bacula-source>/src/cats. It is called:
41 ./update_bacula_tables
43 It is necessary to run it only once the first time you move to a
44 1.39.x beta or to 1.40.0. Upgrading the Bacula version thereafter
45 does not require updating the database again. Depending on the size of your
46 database the script make take a bit of time, to run, but in
47 general, it should be very fast.
49 ==== IMPORTANT new Win32 install procedure =====
50 For Win32 migrations from versions prior to the new installer nothing special
51 needs to be done to upgrade. Everything should be taken care of
52 automatically. The only thing not done is to delete the old C:\Bacula
53 directory (mostly out of paranoia, we can change that prior to release if
54 everyone is comfortable with it).
56 Prior to using the current installer, if you used a prior 1.39.x
57 beta version, you must do one of the following three things:
59 1) Uninstall prior beta version and select the option to delete
60 the configuration and state files. This will get rid of the bogus
61 configuration files. Reinstall the new 1.39.22 version.
63 2) Manually copy the *.conf files from C:\Bacula\bin to
64 C:\Documents and Settings\All Users\Application Data\Bacula.
66 3) Manually edit the *.conf files in C:\Documents and
67 Settings\All Users\Application Data\Bacula. The links in the Bacula menu
68 can be used to avoid having to enter that ugly path.
70 After one of these has been done the upgrade should work fine.
72 If you have problems with the above, try the following
73 The new Win32 installer requires that you deinstall any
74 previous 1.39.x beta version before installing the new version.
75 The following is not necessary if you are upgrading from
76 a 1.38.x installation.
78 The simplest way to do clean up a prior 1.39.x beta is in a DOS shell:
84 (Install the new Bacula)
86 Note, one or both of the 'net stop' commands may fail. Don't
89 If you didn't read the release notes or forgot to do those
90 commands, try the following:
98 Note, at least one of the 'net' commands and possibly both
99 will fail, and at least one of the 'sc' commands will fail.
100 Don't worry about it. After that, try again to install
104 New Features in 1.40.0 (beginning of release info)
105 - The basic features of Migration are now complete.
106 - There is a Migration chapter in the doc.
107 http://www.bacula.org/dev-manual/Migration.html
108 - There is an Encryption chapter in the doc.
109 http://www.bacula.org/dev-manual/Bacula_Data_Encryption.html
110 - Additional support for removable devices. See the
111 Requires Mount, Mount Point, Mount Command, and Unmount
112 Commands in the Storage daemon configuration chapter:
113 http://www.bacula.org/dev-manual/Storage_Daemon_Configuratio.html
114 Also see the Edit Codes for Mount and Unmount Directives in the
116 - Add -n option to bconsole to turn off conio.
117 - The bytes field in the terminated jobs part of the status
118 command now reports in KB, MB, ... units.
119 - When not descending into a directory, print the File= name that
120 triggered it -- makes why not descending a bit clearer
121 - Do not unload autochanger when doing "update slots"
122 - Implement mount command for autochanger
123 - Fix bug #462 incorrect error message printed when client script called
124 from File= was not found.
125 - Fix bug #558 (waiting for feedback) where Bacula needs too much time to
126 do a rewind on Solaris when no tape is in the drive (Solaris does not
127 have the detailed errno found on Linux). Added Solaris specific code.
128 Note, this may apply to other OSes as well.
131 ==========================================
133 Beta version 1.39.20:
134 - Writing DVDs should work much better thanks to Richard Mortimer.
135 - Many cleanups/enhancements for Win32 systems.
136 - Correct improperly formated list command output reported by Dan.
137 - Eric fixed RunScripts, which I (Kern) had broken in the last beta.
138 - Correct Client migration SQL as pointed out by Marc.
141 Warning for version 1.39.18 and greater:
142 - If you have an old pre 1.39.18 database, you must update it using
143 the update_bacula_tables script. Please backup your database before
144 updating just in case.
145 - You *should* be able to use 1.38.x FDs with version 1.39.18 Director
146 and SD providing you do not use any of the new features (runscript,
147 data encryption). It seems to work here, but we do not guarantee it.
148 - Your Director and SD must be simultaneously upgraded.
149 - The restore command no longer uses the MediaType as the primary method
150 of finding a suitable Storage device. Normally it will select the last
151 device used to write a Volume. If no storage device is defined, it
152 will use the old algorithm which selects the first Storage resource
153 with the correct MediaType.
154 - The MD5/SHA1 hash codes kept in the database are now kept in a binary
155 format compatible with the rest of the world. If you are running verify
156 jobs, you *must* do an InitCatalog or all files will show an MD5
157 difference. Also, authentication uses the new algorithm by
158 default, but *should* accept connections from older components (FD) using
159 the old non-compatible algorithm. This has been tested, but more
160 more testing is still needed.
161 - The --mandir ./configure option now points to the top level man
162 directory. The man files will be installed under mandir/man8 and
163 mandir/man1 as appropriate.
164 - The "Accept Any Volume" directive has been removed. It was never
165 implemented. Bacula will always accept any valid tape that is in
166 the drive for appending.
169 A Lot of New features for 1.39.18:
170 - Switch the Win32 build from using Microsoft C++ to using mingw32
171 cross-compiling. The inital work was done by Howard Thomson,
172 then tweaked by me. Robert Nelson then totally reworked the
173 cross-compiling code so that it not only cross-compiles, but
174 also compiles on Visual Studio, and at the same time, he added
175 all the current Unix features to the FD, such as selection on
176 drives, encryption support, building *all* the tools, ...
177 Finally, he also ported the Directory and the Storage daemon to
179 - Data encryption done in the Client is now supported due to code
180 submitted by Landon Fuller.
181 - Bacula restore and bextract can now extract non-portable Win32 data to
182 any client (including Unix/Linux clients). Of course, in doing so,
183 the Microsoft specific permissions and ACLs will be lost. Thanks
184 to Thorsten Engel for this code.
185 - The 260 character limitation for Win32 paths name lengths is now
186 eliminated thanks to Thorsted Engel.
187 - Eric Bollengier wrote new RunScript directives that includes
188 the old RunBefore/AfterJob and ClientRunBefore/AfterJob features
189 plus a *lot* more, allowing you to control just about every aspect
190 of running scripts. See the manual for detailed documentation.
191 http://www.bacula.org/dev-manual/Configuring_Director.html#5227
192 - The examples directory has a new bacula_mail_summary.sh file that
193 creates a single email summary of any number of jobs. Submitted by
195 - SunOS ACLs should now work thanks to a patch from David Duchscher.
196 - The database Id records should be 32/64 bit independent now. 64 bits
197 can be enabled by changing one define, but this has never been tested.
198 - Apply days keyword patch from Alexander.Bergolth at wu-wien.ac.at
199 If this patch is applied, the number of days can be specified with
200 "list nextvol days=xx"
203 My use case is to be able to preview the next scheduled job (and the
204 next tape to be used) on fridays if there are no scheduled jobs during
205 the weekend. This patch was probably back ported to 1.38.x
206 - Add nagios plugin to the examples directory. Submitted by
208 - Modify most restore error messages to be queued so that they
209 appear at the end of the job rather than mixted with the restore
210 listing where they could be "lost".
211 - Apply patch supplied by user (slightly modified) to fix
212 correct detection of holes in block devices and FIFOs.
214 - Added a report.pl program to the examples directory from Jonas Bjorklund.
215 - Add enable/disable job=<job-name>. This command prevents
216 the specified job from being scheduled. Even when disabled,
217 the job can be manually started from the console.
218 - Add two new queries to query.sql provided by Arno. One
219 list volumes known to the Storage device, and the other
220 lists volumes possibly needing replacement (error, ...).
221 - Implement new code for changing userid and group at startup. This
222 should get Bacula into the correct groups.
223 - Implement support for removable filesystems.
224 - Transfer rates are now presented in a more readable format thanks
225 to a user submission.
226 - SD is now aware of what volumes are mounted. More information is printed
227 in the Status report.
228 - The Pool Maximum Volumes directive is now respected in all places.
229 - A Storage device can now be specified in a Pool resource. It will override
230 all other Storage specifications.
231 - Most but not all directives accept true/false in place of yes/no.
232 - A patch from Karl Hakimian that reads JobIds, FileIndexes
233 from a database table for restore.
234 - There are a number of new tables. Some such as the Location table are
235 designed for user use in doing Volume Management software.
236 - Maximum Changer Wait, Maximum Open Wait, Maximum Rewind Wait to
237 accept time qualifiers.
238 - Implement jobuid to replace old usage of job in keywords as
239 suggested by Eric Bollengier.
240 - Apply patch for enhancing wait from Eric Bollengier. One can now:
241 wait (wait for all jobs to stop)
243 wait jobuid=unique id
245 - Implement write variables for Python to set Priority (anytime), and
246 Job Level, only during JobInit event.
247 - Use the keyword ujobid to mean the unique job id; job or jobname
248 to mean the Job name given on the Name directive, and jobid to
249 be the numeric (non-unique) job id.
250 - Allow the SD to use multiple drives during a backup/restore (only
251 one at a time). This is not well tested.
252 - Integrate addition of line count limitation to bsmtp -l from
253 Sebastian Stark <stark at tuebingen.mpg.de>
254 - Split the bacula start/start script into four files:
255 bacula -- starts and stops calling other scripts
256 bacula-ctl-dir -- starts/stops the director
257 bacula-ctl-fd -- starts/stops the File daemon
258 bacula-ctl-sd -- starts/stops the Storage daemon
259 - Remove automatic case folding on Windows FDs. You must
260 explictly use the 'Ignore Case = yes' option.
261 - Implement wild program in tools directory for testing
262 wild-cards. Almost identical to the regex program.
263 - Use the new bregex.c to implement Regex expressions on Win32.
264 - Apply patch from Christopher Hull
265 - Allow multiple connections to database with different
267 - Invalidate the scheduler when doing a reload. Fixes seg
268 fault, but still 60 second window.
269 - Additional info in Reschedule message.
270 - Use set_jcr_job_status() everywhere to prevent loss of
272 - Display peer IP in FD if error from connecting DIR.
273 - Don't increment file count for DIRBEGIN.
274 - Replace illegal characters in Win32 filename by _.
275 - Add SE_CREATE_PERMANENT_NAME privilege in Win32.
276 - Hash hard link filenames rather than linked list (performance).
277 - Fix for security failure in chdir on Win32.
278 - Add CreateDirectoryA/W win32 API entry points.
279 - Add /silent option to Win32 FD for Install/Remove service.
280 programs to duplicate Bacula's base64 algorithm using standard
281 routines. This fixes bugs #296, and 565. Patch submitted by
283 - Fixes to reloading the Dir conf file from Eric Bollengier and Christopher
285 - Modify LICENSE to correct some problems pointed out by Debian.
286 - Apply a patch submitted by cesarb in bug #606 to implement O_NOATIME support.
287 O_NOATIME is a open() flag which makes it possible to read a file without
288 updating the inode atime (and also without the inode ctime update which
289 happens if you try to set the atime back to its previous value). It also
290 prevents a race condition when two programs are reading the same file, but
291 only one does not want to change the atime. It's most useful for backup
292 programs and file integrity checkers (and bacula can fit on both
294 You enable it in the Bacula FileSet Options resource by setting:
296 The effect of this option is similar to the keepatime option except
297 it is more efficient and avoids modifying ctime.
298 - Implement a pile of new man pages contributed by Jose Tallon.
299 - Implement a number of user supplied patches for DVD writing.
300 - Modify the database format for handling Migration jobs:
301 Add PriorJobId, RealEndTime to Job table
303 Remove Stripe from JobMedia record (not used, wasting space)
304 Add ScratchPoolId, RecyclePoolId, Enabled to Media record
305 Add Cost to Location table.
306 Enabled to Media table and Location table.
307 - Security: harden authentication failure in FD by single threading errors
308 and forcing a 6 second wait.
309 - If using GCC (actually g++) add the following compiler flags
310 -fno-strict-aliasing -fno-exceptions -fno-rtti
311 - Turn on new bsnprintf() code. This could cause print output
313 - Implement job report that indicates where Storage and Pool
314 came from -- with overrides and Pool storage and NextPool,
315 it is all very complicated.
316 - Add more detail (Storage, Device) to list of volumes printed
318 - Add new VOLMGMT message class. No messages are yet sent with this
320 - Add Catalog message destination in Messages resource that puts the
321 job report in the Log database table.
322 - Spend a lot of time integrating mkcdrec with the rescue disk.
323 - Add spooling/despooling info in status output of SD.
324 - Add Comment field to llist of a volume.
325 - Allow true/false in some yes/no questions.
326 - Implement update volume enable=(on|off|true|false|archived|0|1|2)
328 Additional Features Added for Win32:
330 Added DriveType directive to the Director's Include Option FileSet
331 resource. Allowed values are: fixed, removable, cdrom, and remote. There
332 is only an implementation for Windows because it is the only platform that
333 has the concept of drives.
335 Adds EnhancedWild directive to the Director's Include Option FileSet
336 resource. Allowed values are: yes and no.
338 When EnhancedWild is enabled then the processing of the
339 Wild, WildDir and WildFile is changed in the following ways.
341 Patterns conform to Posix
342 \ is not a special character in character classification []
343 To match a - it must be the first or last character
344 To match a ] it must be the first character
346 fnmatch option FNM_FILE_NAME is specified * doesn't match a /
347 so it won't match multiple directory levels in a path
349 Relative WildFile patterns (ones without a leading /) match
350 against the filename portion. This in combination with the
351 FNM_FILE_NAME fnmatch() flag makes directives such as WildFile =
352 abc*.def work as expected.
354 Adds support for the shell's feature of brace expansion.
356 Here is an example where braces allow 24 lines to be expressed in 5.
358 # Exclude directories full of lots and lots of useless little files
359 WildDir = "[A-Z]:/{Documents and
360 Settings,{WINNT,Windows}/Profiles}/*/Cookies"
361 WildDir = "[A-Z]:/{Documents and
362 Settings,{WINNT,Windows}/Profiles}/*/Recent"
363 WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local
364 Settings,LOCALS~1}/History"
365 WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local
366 Settings,LOCALS~1}/Temp"
367 WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local
368 Settings,LOCALS~1}/Temporary Internet Files"
372 Here are some hints if you want to play with the Windows Director and/or
375 Changer and Tape device names in Windows are Changer0, Changer1, etc and
376 Tape0, Tape1, etc. If there isn't a device driver loaded for the Changer
377 then you need to use the address <Port>:<Bus>:<Target>:<Lun>. Port is the
378 SCSI Adapter Number, Bus is the Bus Number on the adapter (usually 0 since
379 most adapters only have one bus), Target is the device's Target Device ID,
380 Lun is the Logical Unit Number.
382 You must specify DeviceType = tape in the Device resource in bacula-sd.conf
383 since detection doesn't currently work.