- Release Notes for Bacula 2.5.42
+ Release Notes for Bacula 5.0.0
- Bacula code: Total files = 521 Total lines = 204,881 (*.h *.c *.in)
+ Bacula code: Total files = 1,081 Total lines = 217,272 (Using SLOCCount)
-The diff between 2.4.4 and 2.5.x is 208,340 lines, so this release
-represents an enormous effort.
+This release includes large number of new features and changes.
-This Director and Storage daemon must be upgraded at the same time,
-but they should be compatible with all 2.4.x File daemons, unless you
-use some of the new features that affect the FD. In other words, you should
-not have to upgrade all your File daemons when you upgrade. However, any
-release of version 2.5.40 or greater requires a database upgrade.
+Important changes since 3.0.3a:
+-------------------------------
+
+Bug fixes:
+1337 1351 1352 1354 1357 1361 1367 1369 1370 1373
+1376 1391 1403 1409 1420 1422 1427 1428 1431 1450
+1454 1455 1458 1456
+
+Fixed:
+ - Problem that locks the Director when the SMTP server wasn't responding
+ to bsmtp
+ - Restore's dir command shows incorrect file sizes
+ - Fix various problems with reload command
+ - Fix problems with conio
+ - Eliminate several deadlocks or potential race conditions from SD
+
+Enhancements:
+ - Project 5: Truncate volume after purge
+ - Project 6: File Deduplication using Base Jobs
+ - Project 10: Restore from Multiple Storage Daemons
+ - Project 11: AllowCompression per Device
+ - Project 23: Add Maximum Concurent Jobs for Devices to balance load
+ between drives
+ - Add Accurate Fileset Options to configure accurate detection. Can use
+ checksum verification for example.
+ - Allow FD to keep root read but drop write permission (CAP)
+ - Secure handling of passwords for catalog backup
+ - Add Tab-completion for Bconsole when using Readline
+ - Add Bvfs API to query the catalog without building a memory tree
+ - Add new speed test to btape program
+ - Add new Bat screens (Autochanger content, Job view, Media view, ...)
+ - Windows version of Bat
+ - Added Spanish Bacula translation
+ - New bconsole -u nnn option to have timeout on commands
+ - Allow Migrate, Copy, and Virtual Full to read and write
+ to the same Pool
+ - show disabled -- shows disabled Jobs
+ - Add Pool File and Job retention periods (take precedence over Client)
+ - Many ACL improvements
+ - Level added to FD status Job entry
+ - Allow to turn off/on Block Checksum per device
+ - Set Device Poll interval to 5 minutes -- previously did not poll
+ - Implement lock manager with bad order protection
+
+Compatibility:
+Like always, both the Director and Storage daemon must be upgraded at
+the same time.
+
+Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 5.0.0
+Director and Storage daemons. It should be no need to upgrade older File
+Daemon.
+
+============ Documentation improvements needed ==================
+
+Note!!!!! The 5.0.0+ documentation needs rather extensive modifications in the
+following areas:
+
+1. Missing documentation.
+2. Correction of links within various manuals -- most fail.
+3. Integration of the new features into the main documents.
+4. Much more.
+
+The documentation will not be completed in the near future due to lack
+manpower. If you are unhappy with this situation as we are, we suggest
+you help by submitting patches to the documentation. Thanks.
+=====
================== Warning !!!!!! ==========================
-New Catalog format in version 2.5.40
-------------------------------------
+New Catalog format in version 5.0.0 (3.1.9 or later)
+-----------------------------------------------------
-This BETA release of Bacula uses a new catalog format. We provide a set of
-scripts that permit to convert a 2.4.x (version 10) catalog to 2.5.x (version
-11). If you are using already a 2.5 version, you can drop the JobHistory
-table before upgrading your catalog (if you are using the new "long term
-statistics" module, you can upgrade this table the same way we do with
-the Job table, see the src/cats/update_bacula_tables script).
+This release of Bacula uses a new catalog format. We provide a set of
+scripts that permit to convert a 3.0.x (version 11) catalog to 5.0.0 (version
+12). The Bacula project rpms distributed on Source Forge will automatically
+detect the database change and do the upgrade for you. We strongly
+recommend that you save a copy of your existing database before upgrading
+using rpms.
-The simplest way to:
+The simplest way to upgrade the database assuming you are building from
+source:
1. Stop any current version of Bacula from running.
2. Save a copy of your existing database.
-3. Configure, build, and install the 2.5.42 version of Bacula
+3. Configure, build, and install the 5.0.0 version of Bacula
+ Note the new ./configure options in the manuals see the link
+ at the bottom of this file.
4. cd <your-scripts-installation-directory>
5. ./update_bacula_tables
6. If you have multiple catalogs, edit the update_bacula_tables
7. Start the new Bacula. If everything worked, it should
not print any error messages.
-The upgrade operation will convert the FileId index field of the File table
-from 32 bits to 64 bits. This operation will take TIME and will *temporarily*
-DOUBLE THE SIZE of your catalog. Bacula must be shutdown during this update,
-so, won't be able to run jobs during this period. For example, a 3 million files
-catalog will take 2 mins to upgrade on a normal machine. Don't forget to
-backup it before executing the script.
-
If you start from scratch, you don't need to run the update_bacula_tables
-script. However, if you are using a version of Bacula older than 2.5.40,
-then you need to run the update_bacula_tables script that will be found
-in the <bacula>/src/cats directory after you run the ./configure command.
-As mentioned above, before running this script, please backup your
-catalog database, and when you do running it, be sure shutdown
-Bacula and be aware that running the script can take some time depending
-on your database size.
-
-
-New configure option :
-----------------------
-
-This BETA release of Bacula 2.5.x development code uses libtool
-to generate the Bacula libraries as shared objects rather than
-being directly linked in as in prior versions. This means that
-the Bacula shared objects, must either be in a shared object
-directory known to the loader or they must be in the directory
-where the Bacula binaries are installed. It is also possible
-to explicitly specify the libraries directory on the ./configure
-line (--libdir=/full-path/dir), but this should not be necessary.
-
-If you have problems with libtool or you wish to use the old
-way of building libraries and linking them into Bacula, you
-can do so by disabling libtool on the configure command line with:
-
- ./configure --disable-libtool
-==============================================================
+script because the create_bacula_tables script automatically creates the new
+table format. However, if you are using a version of Bacula older than 3.1.9
+(e.g. 3.0.3) then you need to run the update_bacula_tables script that will
+be found in the <bacula>/src/cats directory after you run the ./configure
+command. As mentioned above, before running this script, please backup your
+catalog database, and when you do running it, be sure shutdown Bacula and be
+aware that running the script can take some time depending on your database
+size.
+
+================================================================
This release includes large number of new features and changes.
It should be more or less compatible with previous xx.conf files
Please see the New Features chapter of the new manual, which documents
some but not all the new features (we are still working on it):
-http://www.bacula.org/manuals/en/concepts/concepts/New_Features.html
+http://www.bacula.org/5.0.x-manuals/en/main/main/New_Features_in_5_0_0.html
The ChangeLog has more details.