git.sur5r.net Git - bacula/bacula/blob - bacula/ReleaseNotes

   1
   2                Release Notes for Bacula 5.0.1
   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 5.0.0
  31 -------------------
  32
  33 Bug fixes:
  34 1466 1467 1468 1481 1486 1488
  35
  36 - Fix bug #1488 -- create delivery_error() subroutine to avoid recursion and
  37   race conditions in messages.c
  38 - Upgrade cats library also to 5.0.0
  39 - Fix missing console page in bat
  40 - Add bat help files to Win64 installer
  41 - Win -- add help files to installer + stop any running bacula-fd before
  42   install
  43 - Fix bug #1481 -- bat consumes all console file descriptors
  44 - Backport truncate on purge from 5.1.x
  45 - Fix bug #1486 -- bat doesn't show any errors on command-line
  46 - Update the bsock error url
  47 - Correct .my.cnf umask in make_catalog_backup.pl
  48 - Apply Philipp's fix for dbcheck use by make_catalog_backup.pl
  49 - Fix seg fault in bscan from new comment field
  50 - Patch from checks multple CNs when using TLS
  51 - Fix seg fault in SQlite driver
  52 - Make versions of shared libs inline with the software version.
  53 - Remove file_index sequential check -- reported by Graham
  54 - Fix #1466 about Bogus pruning message
  55
  56
  57 Changes since 3.0.3a (the last Bacula Project release):
  58 -------------------------------------------------------
  59
  60 Bug fixes:
  61 1337 1351 1352 1354 1357 1361 1367 1369 1370 1373
  62 1376 1391 1403 1409 1420 1422 1427 1428 1431 1450
  63 1454 1455 1458 1456
  64
  65 Fixed:
  66  - Problem that locks the Director when the SMTP server wasn't
  67    responding to the bsmtp program
  68  - Restore's dir command shows incorrect file sizes
  69  - Fix various problems with the reload command
  70  - Fix problems with conio
  71  - Eliminate several deadlocks or potential race conditions from SD
  72
  73 Enhancements:
  74  - Project 5: Truncate volume after purge
  75  - Project 6: File Deduplication using Base Jobs
  76  - Project 10: Restore from Multiple Storage Daemons
  77  - Project 11: AllowCompression per Device
  78  - Project 23: Add Maximum Concurent Jobs for Devices to balance load
  79    between drives
  80  - Add Accurate Fileset Options to configure accurate detection. Can use
  81    checksum verification for example.
  82  - Allow FD to keep root read but drop write permission (CAP)
  83  - Secure handling of passwords for catalog backup
  84  - Add Tab-completion for Bconsole when using Readline
  85  - Add Bvfs API to query the catalog without building a memory tree
  86  - Add new speed test to btape program
  87  - Add new Bat screens (Autochanger content, Job view, Media view, ...)
  88  - Windows version of Bat
  89  - Added Spanish Bacula translation
  90  - New bconsole -u nnn option to have timeout on commands
  91  - Allow Migrate, Copy, and Virtual Full to read and write
  92    to the same Pool
  93  - show disabled   -- shows disabled Jobs
  94  - Add Pool File and Job retention periods (take precedence over Client)
  95  - Many ACL improvements
  96  - Level added to FD status Job entry
  97  - Allow turning on/off Block Checksum per device
  98  - Set Device Poll interval to 5 minutes -- previously did not poll
  99  - Implement lock manager with bad order protection
 100
 101 Compatibility:
 102 As always, both the Director and Storage daemon must be upgraded at
 103 the same time, and on any given machine, you must run only one version
 104 of Bacula. This means that on the Director and Storage daemon machines,
 105 you *must* upgrade your File daemon as well.
 106
 107 Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 5.0.0
 108 Director and Storage daemons. There should be no need to upgrade older File
 109 Daemons immediately. However, we recommend that you do so as soon
 110 as is reasonable for your situation.
 111
 112 ================== Warning !!!!!! ==========================
 113
 114 New Catalog format in version 5.0.0 (3.1.9 or later)
 115 -----------------------------------------------------
 116
 117 This release of Bacula uses a new catalog format. We provide a set of
 118 scripts that permit to convert a 3.0.x (version 11) catalog to 5.0.0 (version
 119 12).  The Bacula project rpms distributed on Source Forge will automatically
 120 detect the database change and do the upgrade for you.  We strongly
 121 recommend that you save a copy of your existing database before upgrading
 122 using rpms.
 123
 124 The simplest way to upgrade the database assuming you are building from
 125 source:
 126 1. Stop any current version of Bacula from running.
 127 2. Save a copy of your existing database.
 128 3. Configure, build, and install the 5.0.0 version of Bacula
 129    Note the new ./configure options in the manuals see the link
 130    at the bottom of this file.
 131 4. cd <your-scripts-installation-directory>
 132 5. ./update_bacula_tables
 133 6. If you have multiple catalogs, edit the update_bacula_tables
 134    script and put the name of another database, and then
 135    execute the script again. Repeat this until all Bacula
 136    catalogs have been updated.
 137 7. Start the new Bacula.  If everything worked, it should
 138    not print any error messages.
 139
 140 If you start from scratch, you don't need to run the update_bacula_tables
 141 script because the create_bacula_tables script automatically creates the new
 142 table format.  However, if you are using a version of Bacula older than 3.1.9
 143 (e.g.  3.0.3) then you need to run the update_bacula_tables script that will
 144 be found in the <bacula>/src/cats directory after you run the ./configure
 145 command.  As mentioned above, before running this script, please backup your
 146 catalog database, and when you do running it, be sure shutdown Bacula and be
 147 aware that running the script can take some time depending on your database
 148 size.
 149 ================================================================
 150
 151
 152 ================== Warning !!!!!! ==========================
 153 If you upgrade a previous Win32 client installation, you must
 154 first stop the File daemon, then uninstall it before attempting
 155 the upgrade. If you do not do so, the upgrade will probably
 156 fail and you will need to manually find and run the
 157 Uninstall.exe file, before you can upgrade to the new version.
 158 This is because the file locations are different.  If you want
 159 to save your previous bacula-fd.conf file, please do so before
 160 uninstalling it.
 161 ================================================================
 162
 163 ================== Warning !!!!!! ==========================
 164 Due to permissions problems on Windows Vista and later systems,
 165 we no longer require SYSTEM or Administrator permissions to
 166 access the binaries and configuation files.  If you wish
 167 to restrict access to these files, please see the New Features
 168 section of the manual for how to set access control lists.
 169 ================================================================
 170
 171 Note, the Win32 Installer no longer installs the Bacula Servers
 172 (Director and Storage daemon). See the New Features section of
 173 the manual for more details.
 174
 175 ============ Documentation improvements needed ==================
 176
 177 Note!!!!! The 5.0.0+ documentation has a number of known problems:
 178
 179 1. We have reduced the number of manuals, which has fixed many
 180    of the broken links found in the old 3.0.x version, but there
 181    are still some that need fixing.
 182
 183 2. Integration of the 3.0.x features into the main manuals has
 184    not yet been done.
 185
 186 The documentation will not be completed in the near future due to lack
 187 manpower.  If you are unhappy with this situation as we are, we suggest
 188 you help by submitting patches to the documentation.  Thanks.
 189 =====
 190
 191
 192 This release includes large number of new features and changes.
 193 It should be more or less compatible with previous xx.conf files
 194 and File daemons providing that you are not using any of the new
 195 features.
 196
 197 Please see the New Features chapter of the new manual, which documents
 198 some but not all the new features (we are still working on it):
 199
 200 http://www.bacula.org/5.0.x-manuals/en/main/main/New_Features_in_5_0_0.html
 201
 202 The ChangeLog has more details.