2 Release Notes for Bacula 1.37.3
4 Bacula code: Total files = 411 Total lines = 121,855 (*.h *.c *.in)
8 - This version has a new database format that is not compatible
9 with previous databases. There are NO upgrade scripts yet.
10 - Due to the massive changes made during the last two weeks,
11 version 1.37.3 should be considered unstable. It does, however,
12 pass the regression tests.
14 - First cut at ANSI labels.
15 - New communications protocol between DIR and SD to reserve
19 - Preliminary Python Event support has been added. See below for
21 A Python script will be called at particular points or conditions
22 in Bacula called Events. The currently defined Events are called:
24 StartJob, EndJob, NewVolume
26 Where StartJob is called before the RunBeforeJob, EndJob is called
27 after RunAfterJob, and NewVolume, is called before all other
28 "methods" of obtaining a new Volume name, when one is needed.
30 The Python script of the same name as the Event name (but with a .py)
31 is called from the Scripts Directory (a directive defined in the
32 Director resource). Note, both the Filename, and the name of
33 the function in the file must correspond to the Event name.
35 Once the Python script gets control, it can have access to Bacula
40 The script is called with one argument, typically called j. This
41 argument *must* be passed unchanged to each bacula function. The
42 format of the call is slightly different for reading Bacula
43 variable and for writing bacula variables. See below.
45 Bacula variables can be read with:
47 bacula.get(j, "Variable-name")
49 where j is the argument passed to the function, and Variable-name
50 is on of the following:
52 JobId, Client, Pool, Storage, Catalog, MediaType, NumVols, DirName,
53 Level, Type, Job, JobName, JobStatus
55 Bacula varibles can be set using Python keyword arguments:
57 bacula.set(jcr=j, VolumeName="xyz")
59 The two currently implemented writable "variables" are:
61 VolumeName and JobReport
63 It is possible to submit a Bacula run command with the following:
65 bacula.run(j, "run kernsave client=Matou storage=File")
67 this function returns the JobId of the job that was started. If
68 there is an error, the return value is zero.
76 jobid = bacula.get(j, "JobId")
77 client = bacula.get(j, "Client")
78 bacula.set(jcr=j, JobReport="EndJob output: JobId=%d Client=%s.\n" % (jobid, client))
80 startid = bacula.run(j, "run kernsave")
81 print "Python started jobid=", startid
86 == File NewVolume.py ===
90 jobid = bacula.get(j, "JobId")
92 client = bacula.get(j, "Client")
93 print "Client=" + client
94 numvol = bacula.get(j, "NumVols");
95 print "NumVols=", numvol
96 bacula.set(jcr=j, JobReport="New Volume set for Job.\n")
97 bacula.set(jcr=j, VolumeName="TestA-001")
100 - Part files support: File volumes can now be splitted in multiple
101 files, called "parts".
102 - DVD writing support, using parts, and a lot of new directives in
103 the Device resource of the Storage configuration file.
106 - Scripts Directory = <directory> name. Defines the directory from
107 which Bacula scripts will be called for events. In fact, Bacula
108 appends this name to the standard Python list of search directories,
109 so the script could also be in any of the Python system directories.
110 - In FileSet, you can exclude backing up of hardlinks (if you have
111 a lot, it can be very expensive), by using:
113 in the Options section. Patch supplied by David R Bosso. Thanks.
114 - MaximumPartSize = bytes (SD, Device resource)
115 Defines the maximum part size.
116 - Requires Mount = Yes/No (SD, Device resource)
117 Defines if the device require to be mounted to be read, and if it
118 must be written in a special way. If it set, the following directives
119 must be defined in the same Device resource:
120 + Mount Point = directory
121 Directory where the device must be mounted.
122 + Mount Command = name-string
123 Command that must be executed to mount the device. Before the command
124 is executed, %a is replaced with the Archive Device, and %m with the
126 + Unmount Command = name-string
127 Command that must be executed to unmount the device. Before the
128 command is executed, %a is replaced with the Archive Device, and
129 %m with the Mount Point.
130 + Write Part Command = name-string
131 Command that must be executed to write a part to the device. Before
132 the command is executed, %a is replaced with the Archive Device, %m
133 with the Mount Point, %n with the current part number (0-based),
134 and %v with the current part filename.
135 + Free Space Command = name-string
136 Command that must be executed to check how much free space is left
137 on the device. Before the command is executed, %a is replaced with
138 the Archive Device, %m with the Mount Point, %n with the current part
139 number (0-based), and %v with the current part filename.
140 - Write Part After Job = Yes/No (DIR, Job Resource, and Schedule Resource)
141 If this directive is set to yes (default no), a new part file will be
142 created after the job is finished.
145 - "python restart" restarts the Python interpreter. Rather brutal, make
146 sure no Python scripts are running. This permits you to change
147 a Python script and get Bacula to use the new script.
150 - You must add --with-python=[DIR] to the configure command line
151 if you want Python support. Python 2.2 and 2.3 should be automatically
152 detected if in the standard place.
153 - With Python 2.2 version, the link of the Director gets a few linker
154 warnings due to the fact that Python pulls in some old non-secure
156 - With Python 2.3, there are a few compiler warnings.
159 - 2 new scripts, dvd-writepart and dvd-freespace, in the scripts directory,
160 which are designed to be used as parameters to Write Part Command and
161 Free Space Command. They need the dvd+rw-tools to be installed
162 (http://fy.chalmers.se/~appro/linux/DVD+RW/).