2 Release Notes for Bacula 1.39.18
4 Bacula code: Total files = 448 Total lines = 150,330 (*.h *.c *.in)
6 Warning for version 1.39.18 and greater:
7 - The documentation is almost non-existent for all new features
8 except RunScripts (written and documented by Eric Bollingier).
9 - If you have an old pre 1.39.18 database, you must upgrade it using
10 the upgrade_bacula_tables script. Please backup your database before
11 upgrading just in case.
12 - You *should* be able to use 1.38.x FDs with version 1.39.18 Director
13 and SD providing you do not use any of the new features (runscript,
14 data encryption). It seems to work here, but we do not guarantee it.
15 - Your Director and SD must be simultaneously upgraded.
16 - The restore command no longer uses the MediaType as the primary method
17 of finding a suitable Storage device. Normally it will select the last
18 device used to write a Volume. If no storage device is defined, it
19 will use the old algorithm which selects the first Storage resource
20 with the correct MediaType.
21 - The MD5/SHA1 hash codes kept in the database are now kept in a binary
22 format compatible with the rest of the world. If you are running verify
23 jobs, you *must* do an InitCatalog or all files will show an MD5
24 difference. Also, authentication uses the new algorithm by
25 default, but *should* accept connections from older components (FD) using
26 the old non-compatible algorithm. This has been tested, but more
27 more testing is still needed.
28 - The --mandir ./configure option now points to the top level man
29 directory. The man files will be installed under mandir/man8 and
30 mandir/man1 as appropriate.
31 - The "Accept Any Volume" directive has been removed. It was never
32 implemented. Bacula will always accept any valid tape that is in
33 the drive for appending.
34 - To install the 1.39.18 Win32 FD, you *must* first stop any
35 previous version that is running in a DOS shell with:
39 or select the 'Close Bacula' menu item from the Bacula tray icon,
40 you should then save your bacula-fd.conf file, and either
41 uninstall (using Uninstall.bat in the c:\bacula directory) or
42 remove the old installation by manually in a DOS shell in the
43 Bacula directory enter:
47 after that you can proceed with the installation. My experience
48 is that it does not properly create the new bacula-fd.conf file, so
49 copy the one saved to the directory you chose to install Bacula,
50 or to the directory chosen by the Installer to put the bacula-fd.conf
51 file. Then you can start Bacula in a DOS shell with:
55 or use the Windows Control Panel->Administrative Tools->Component
59 A Lot of New features for 1.39.18:
60 - Switch the Win32 build from using Microsoft C++ to using mingw32
61 cross-compiling. The inital work was done by Howard Thomson,
62 then tweaked by me. Robert Nelson then totally reworked the
63 cross-compiling code so that it not only cross-compiles, but
64 also compiles on Visual Studio, and at the same time, he added
65 all the current Unix features to the FD, such as selection on
66 drives, encryption support, building *all* the tools, ...
67 Finally, he also ported the Directory and the Storage daemon to
69 - Data encryption done in the Client is now supported due to code
70 submitted by Landon Fuller.
71 - Bacula restore and bextract can now extract non-portable Win32 data to
72 any client (including Unix/Linux clients). Of course, in doing so,
73 the Microsoft specific permissions and ACLs will be lost. Thanks
74 to Thorsten Engel for this code.
75 - The 260 character limitation for Win32 paths name lengths is now
76 eliminated thanks to Thorsted Engel.
77 - Eric Bollengier wrote new RunScript directives that includes
78 the old RunBefore/AfterJob and ClientRunBefore/AfterJob features
79 plus a *lot* more, allowing you to control just about every aspect
80 of running scripts. See the manual for detailed documentation.
81 - The examples directory has a new bacula_mail_summary.sh file that
82 creates a single email summary of any number of jobs. Submitted by
84 - SunOS ACLs should now work thanks to a patch from David Duchscher.
85 - The database Id records should be 32/64 bit independent now. 64 bits
86 can be enabled by changing one define, but this has never been tested.
87 - Apply days keyword patch from Alexander.Bergolth at wu-wien.ac.at
88 If this patch is applied, the number of days can be specified with
89 "list nextvol days=xx"
92 My use case is to be able to preview the next scheduled job (and the
93 next tape to be used) on fridays if there are no scheduled jobs during
94 the weekend. This patch was probably back ported to 1.38.x
95 - Add nagios plugin to the examples directory. Submitted by
97 - Modify most restore error messages to be queued so that they
98 appear at the end of the job rather than mixted with the restore
99 listing where they could be "lost".
100 - Apply patch supplied by user (slightly modified) to fix
101 correct detection of holes in block devices and FIFOs.
103 - Added a report.pl program to the examples directory from Jonas Bjorklund.
104 - Add enable/disable job=<job-name>. This command prevents
105 the specified job from being scheduled. Even when disabled,
106 the job can be manually started from the console.
107 - Add two new queries to query.sql provided by Arno. One
108 list volumes known to the Storage device, and the other
109 lists volumes possibly needing replacement (error, ...).
110 - Implement new code for changing userid and group at startup. This
111 should get Bacula into the correct groups.
112 - Implement support for removable filesystems.
113 - Transfer rates are now presented in a more readable format thanks
114 to a user submission.
115 - SD is now aware of what volumes are mounted. More information is printed
116 in the Status report.
117 - The Pool Maximum Volumes directive is now respected in all places.
118 - A Storage device can now be specified in a Pool resource. It will override
119 all other Storage specifications.
120 - Most but not all directives accept true/false in place of yes/no.
121 - A patch from Karl Hakimian that reads JobIds, FileIndexes
122 from a database table for restore.
123 - There are a number of new tables. Some such as the Location table are
124 designed for user use in doing Volume Management software.
125 - Maximum Changer Wait, Maximum Open Wait, Maximum Rewind Wait to
126 accept time qualifiers.
127 - Implement jobuid to replace old usage of job in keywords as
128 suggested by Eric Bollengier.
129 - Apply patch for enhancing wait from Eric Bollengier. One can now:
130 wait (wait for all jobs to stop)
132 wait jobuid=unique id
134 - Implement write variables for Python to set Priority (anytime), and
135 Job Level, only during JobInit event.
136 - Use the keyword ujobid to mean the unique job id; job or jobname
137 to mean the Job name given on the Name directive, and jobid to
138 be the numeric (non-unique) job id.
139 - Allow the SD to use multiple drives during a backup/restore (only
140 one at a time). This is not well tested.
141 - Integrate addition of line count limitation to bsmtp -l from
142 Sebastian Stark <stark at tuebingen.mpg.de>
143 - Split the bacula start/start script into four files:
144 bacula -- starts and stops calling other scripts
145 bacula-ctl-dir -- starts/stops the director
146 bacula-ctl-fd -- starts/stops the File daemon
147 bacula-ctl-sd -- starts/stops the Storage daemon
148 - Remove automatic case folding on Windows FDs. You must
149 explictly use the 'Ignore Case = yes' option.
150 - Implement wild program in tools directory for testing
151 wild-cards. Almost identical to the regex program.
152 - Use the new bregex.c to implement Regex expressions on Win32.
153 - Apply patch from Christopher Hull
154 - Allow multiple connections to database with different
156 - Invalidate the scheduler when doing a reload. Fixes seg
157 fault, but still 60 second window.
158 - Additional info in Reschedule message.
159 - Use set_jcr_job_status() everywhere to prevent loss of
161 - Display peer IP in FD if error from connecting DIR.
162 - Don't increment file count for DIRBEGIN.
163 - Replace illegal characters in Win32 filename by _.
164 - Add SE_CREATE_PERMANENT_NAME privilege in Win32.
165 - Hash hard link filenames rather than linked list (performance).
166 - Fix for security failure in chdir on Win32.
167 - Add CreateDirectoryA/W win32 API entry points.
168 - Add /silent option to Win32 FD for Install/Remove service.
169 programs to duplicate Bacula's base64 algorithm using standard
170 routines. This fixes bugs #296, and 565. Patch submitted by
172 - Fixes to reloading the Dir conf file from Eric Bollengier and Christopher
174 - Modify LICENSE to correct some problems pointed out by Debian.
175 Implement patch submitted by cesarb in bug #606 to implement O_NOATIME
177 O_NOATIME is a open() flag which makes it possible to read a file without
178 updating the inode atime (and also without the inode ctime update which
179 happens if you try to set the atime back to its previous value). It also
180 prevents a race condition when two programs are reading the same file, but
181 only one does not want to change the atime. It's most useful for backup
182 programs and file integrity checkers (and bacula can fit on both
185 Recent versions of the Linux kernel and glibc have support for it (the
186 glibc support being mostly copying the O_NOATIME definition to
187 bits/fcntl.h). If there's no support for it on the kernel, trying to use
188 it does nothing (since the kernel ignores unknown flags).
190 If the kernel has support for it, trying to use it either works, fails
191 silently (mostly in remote filesystems), or returns errno=EPERM (if you
192 are not either the owner of the file or root). A simple way to prevent the
193 failure is to open the file without the flag and set it later with
194 fcntl(F_SETFL), ignoring any EPERM errors.
195 - Implement a pile of new man pages contributed by Jose Tallon.
196 - Implement a number of user supplied patches for DVD writing.
197 - Modify the database format for handling Migration jobs:
198 Add PriorJobId, RealEndTime to Job table
200 Remove Stripe from JobMedia record (not used, wasting space)
201 Add ScratchPoolId, RecyclePoolId, Enabled to Media record
202 Add Cost to Location table.
203 Enabled to Media table and Location table.
204 - Security: harden authentication failure in FD by single threading errors
205 and forcing a 6 second wait.
206 - If using GCC (actually g++) add the following compiler flags
207 -fno-strict-aliasing -fno-exceptions -fno-rtti
208 - Turn on new bsnprintf() code. This could cause print output
210 - Implement job report that indicates where Storage and Pool
211 came from -- with overrides and Pool storage and NextPool,
212 it is all very complicated.
213 - Add more detail (Storage, Device) to list of volumes printed
215 - Add new VOLMGMT message class. No messages are yet sent with this
217 - Add Catalog message destination in Messages resource that puts the
218 job report in the Log database table.
219 - Spend a lot of time integrating mkcdrec with the rescue disk.
220 - Add spooling/despooling info in status output of SD.
221 - Add Comment field to llist of a volume.
222 - Allow true/false in some yes/no questions.
223 - Implement update volume enable=(on|off|true|false|archived|0|1|2)
225 Additional Features Added for Win32:
227 Added DriveType directive to the Director's Include Option FileSet
228 resource. Allowed values are: fixed, removable, cdrom, and remote. There
229 is only an implementation for Windows because it is the only platform that
230 has the concept of drives.
232 Adds EnhancedWild directive to the Director's Include Option FileSet
233 resource. Allowed values are: yes and no.
235 When EnhancedWild is enabled then the processing of the
236 Wild, WildDir and WildFile is changed in the following ways.
238 Patterns conform to Posix
239 \ is not a special character in character classification []
240 To match a - it must be the first or last character
241 To match a ] it must be the first character
243 fnmatch option FNM_FILE_NAME is specified * doesn't match a /
244 so it won't match multiple directory levels in a path
246 Relative WildFile patterns (ones without a leading /) match
247 against the filename portion. This in combination with the
248 FNM_FILE_NAME fnmatch() flag makes directives such as WildFile =
249 abc*.def work as expected.
251 Adds support for the shell's feature of brace expansion.
253 Here is an example where braces allow 24 lines to be expressed in 5.
255 # Exclude directories full of lots and lots of useless little files
256 WildDir = "[A-Z]:/{Documents and
257 Settings,{WINNT,Windows}/Profiles}/*/Cookies"
258 WildDir = "[A-Z]:/{Documents and
259 Settings,{WINNT,Windows}/Profiles}/*/Recent"
260 WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local
261 Settings,LOCALS~1}/History"
262 WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local
263 Settings,LOCALS~1}/Temp"
264 WildDir = "[A-Z]:/{Documents and Settings,{WINNT,Windows}/Profiles}/*/{Local
265 Settings,LOCALS~1}/Temporary Internet Files"
269 Here are some hints if you want to play with the Windows Director and/or
272 Changer and Tape device names in Windows are Changer0, Changer1, etc and
273 Tape0, Tape1, etc. If there isn't a device driver loaded for the Changer
274 then you need to use the address <Port>:<Bus>:<Target>:<Lun>. Port is the
275 SCSI Adapter Number, Bus is the Bus Number on the adapter (usually 0 since
276 most adapters only have one bus), Target is the device's Target Device ID,
277 Lun is the Logical Unit Number.
279 You must specify DeviceType = tape in the Device resource in bacula-sd.conf
280 since detection doesn't currently work.