]> git.sur5r.net Git - bacula/bacula/blob - bacula/ReleaseNotes
Update ReleaseNotes
[bacula/bacula] / bacula / ReleaseNotes
1
2                Release Notes for Bacula 5.0.0
3
4   Bacula code: Total files = 1,081 Total lines = 217,272 (Using SLOCCount)
5
6
7 Release Numbering:
8 -----------------------------------------------------------
9 You might be wondering why this release jumps from 3.0.x to 
10 5.0.0 thus skipping version 4.0.0.  We have done this for 
11 several reasons: first, we wanted a way of distinguishing
12 the numbering system for the Bacula System Enterprise version
13 and the Bacula Project version.  So, to do so, we have decided
14 that the first number of the Bacula Project version will always
15 be odd, and the first number of the Enterprise version will always
16 be even. Thus the Bacula Project now moves from 3.0.x to 5.0.x.
17 In addition, we want to keep the Bacula Project version larger
18 than the Enterprise version to indicate that the Bacula Project
19 version is more advanced or has more features than the 
20 Enterprise version. For memory, the current Enterprise version
21 is 2.6.1, and the next release (in a few months -- before June 2010)
22 will be version 4.0.0.
23
24 Warning:
25 --------------------------------------------------------------
26 Please note the three Warnings below before doing any install or
27 upgrade.
28        
29
30 Changes since 3.0.3a (the last Bacula Project release):
31 -------------------------------------------------------
32
33 Bug fixes:
34 1337 1351 1352 1354 1357 1361 1367 1369 1370 1373 
35 1376 1391 1403 1409 1420 1422 1427 1428 1431 1450 
36 1454 1455 1458 1456
37
38 Fixed:
39  - Problem that locks the Director when the SMTP server wasn't 
40    responding to the bsmtp program 
41  - Restore's dir command shows incorrect file sizes 
42  - Fix various problems with the reload command   
43  - Fix problems with conio
44  - Eliminate several deadlocks or potential race conditions from SD
45
46 Enhancements:
47  - Project 5: Truncate volume after purge
48  - Project 6: File Deduplication using Base Jobs 
49  - Project 10: Restore from Multiple Storage Daemons
50  - Project 11: AllowCompression per Device
51  - Project 23: Add Maximum Concurent Jobs for Devices to balance load 
52    between drives
53  - Add Accurate Fileset Options to configure accurate detection. Can use 
54    checksum verification for example.
55  - Allow FD to keep root read but drop write permission (CAP)
56  - Secure handling of passwords for catalog backup
57  - Add Tab-completion for Bconsole when using Readline
58  - Add Bvfs API to query the catalog without building a memory tree
59  - Add new speed test to btape program
60  - Add new Bat screens (Autochanger content, Job view, Media view, ...)
61  - Windows version of Bat
62  - Added Spanish Bacula translation   
63  - New bconsole -u nnn option to have timeout on commands
64  - Allow Migrate, Copy, and Virtual Full to read and write
65    to the same Pool
66  - show disabled   -- shows disabled Jobs
67  - Add Pool File and Job retention periods (take precedence over Client)
68  - Many ACL improvements
69  - Level added to FD status Job entry
70  - Allow turning on/off Block Checksum per device
71  - Set Device Poll interval to 5 minutes -- previously did not poll
72  - Implement lock manager with bad order protection
73
74 Compatibility:
75 As always, both the Director and Storage daemon must be upgraded at
76 the same time, and on any given machine, you must run only one version
77 of Bacula. This means that on the Director and Storage daemon machines,
78 you *must* upgrade your File daemon as well.
79
80 Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 5.0.0
81 Director and Storage daemons. There should be no need to upgrade older File
82 Daemons immediately. However, we recommend that you do so as soon
83 as is reasonable for your situation.
84
85 ================== Warning !!!!!! ==========================
86
87 New Catalog format in version 5.0.0 (3.1.9 or later)
88 -----------------------------------------------------
89
90 This release of Bacula uses a new catalog format. We provide a set of
91 scripts that permit to convert a 3.0.x (version 11) catalog to 5.0.0 (version
92 12).  The Bacula project rpms distributed on Source Forge will automatically
93 detect the database change and do the upgrade for you.  We strongly
94 recommend that you save a copy of your existing database before upgrading
95 using rpms.
96
97 The simplest way to upgrade the database assuming you are building from
98 source:
99 1. Stop any current version of Bacula from running.
100 2. Save a copy of your existing database.
101 3. Configure, build, and install the 5.0.0 version of Bacula
102    Note the new ./configure options in the manuals see the link
103    at the bottom of this file.
104 4. cd <your-scripts-installation-directory>
105 5. ./update_bacula_tables
106 6. If you have multiple catalogs, edit the update_bacula_tables
107    script and put the name of another database, and then
108    execute the script again. Repeat this until all Bacula
109    catalogs have been updated.
110 7. Start the new Bacula.  If everything worked, it should
111    not print any error messages.
112
113 If you start from scratch, you don't need to run the update_bacula_tables
114 script because the create_bacula_tables script automatically creates the new
115 table format.  However, if you are using a version of Bacula older than 3.1.9
116 (e.g.  3.0.3) then you need to run the update_bacula_tables script that will
117 be found in the <bacula>/src/cats directory after you run the ./configure
118 command.  As mentioned above, before running this script, please backup your
119 catalog database, and when you do running it, be sure shutdown Bacula and be
120 aware that running the script can take some time depending on your database
121 size.
122 ================================================================
123
124
125 ================== Warning !!!!!! ==========================
126 If you upgrade a previous Win32 client installation, you must
127 first stop the File daemon, then uninstall it before attempting
128 the upgrade. If you do not do so, the upgrade will probably
129 fail and you will need to manually find and run the 
130 Uninstall.exe file, before you can upgrade to the new version.
131 This is because the file locations are different.  If you want
132 to save your previous bacula-fd.conf file, please do so before
133 uninstalling it.
134 ================================================================
135
136 ================== Warning !!!!!! ==========================
137 Due to permissions problems on Windows Vista and later systems,
138 we no longer require SYSTEM or Administrator permissions to 
139 access the binaries and configuation files.  If you wish
140 to restrict access to these files, please see the New Features
141 section of the manual for how to set access control lists.
142 ================================================================
143
144 Note, the Win32 Installer no longer installs the Bacula Servers
145 (Director and Storage daemon). See the New Features section of
146 the manual for more details.
147
148 ============ Documentation improvements needed ==================
149
150 Note!!!!! The 5.0.0+ documentation has a number of known problems:
151
152 1. We have reduced the number of manuals, which has fixed many
153    of the broken links found in the old 3.0.x version, but there
154    are still some that need fixing.
155
156 2. Integration of the 3.0.x features into the main manuals has
157    not yet been done.
158
159 The documentation will not be completed in the near future due to lack
160 manpower.  If you are unhappy with this situation as we are, we suggest
161 you help by submitting patches to the documentation.  Thanks.
162 =====
163
164
165 This release includes large number of new features and changes.
166 It should be more or less compatible with previous xx.conf files
167 and File daemons providing that you are not using any of the new
168 features.
169
170 Please see the New Features chapter of the new manual, which documents
171 some but not all the new features (we are still working on it):
172
173 http://www.bacula.org/5.0.x-manuals/en/main/main/New_Features_in_5_0_0.html
174   
175 The ChangeLog has more details.