]> git.sur5r.net Git - bacula/bacula/blobdiff - bacula/ReleaseNotes
Update ReleaseNotes
[bacula/bacula] / bacula / ReleaseNotes
index 00a1c2442175d800422f63bffa968e43f3a05f0e..4ff6f6f2916c20977efea623fe8b638f1cfb216f 100644 (file)
@@ -7,25 +7,64 @@ General:
 --------
 
 This 5.2.0 version is a major release since the last version 5.0.3.
-It includes well over 50,000 lines of changes and a number of important
-new features:
+It includes well over 50,000 lines of changes made by 19 contributors
+and a number of important new features:
 
 Compatibility:
 --------------
  As always, both the Director and Storage daemon must be upgraded at
  the same time.
 
- The new pruning algorithm will not allow to prune jobs that are essential to
- restore since the last Full backup.  (TODO: see for an option...)
-
  Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.0
  Director and Storage daemons. There should be no need to upgrade older File
  Daemons.
 
+================== Warning !!!!!! ==========================
+
+ The new pruning algorithm will not allow to prune jobs that are essential to
+ restore since the last Full backup. Pruning of volumes are not affected.
+
+New Catalog format in version 5.2.0
+-----------------------------------
+This release of Bacula uses a new catalog format. We provide a set of
+scripts that permit to convert a 5.0.x (version 12) catalog to 5.2.0 (version
+14).  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 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 5.2.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
+   script and put the name of another database, and then
+   execute the script again. Repeat this until all Bacula
+   catalogs have been updated.
+7. Start the new Bacula.  If everything worked, it should
+   not print any error messages.
+
+If you start from scratch, you don't need to run the update_bacula_tables
+script because the create_bacula_tables script automatically creates the new
+table format.  However, if you are using a version of Bacula older than 5.0.0
+(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.
+
+================================================================
+
 Changes:
 
 Speed and Memory Usage Enhancements:
-- Implement LZO compression algorithm
+- Implement LZO compression algorithm (need lzo2 headers to activate this option)
 - New Pruning algoritm -- safer and faster
 - Use of PostgreSQL cursor when doing large queries, should reduce the
   memory usage during restore and accurate backups.
@@ -35,7 +74,7 @@ Speed and Memory Usage Enhancements:
 
 Security Enhancements:
 - Additional security against injection of illegal characters
-- Possible fnmatch problem
+- Fix possible fnmatch problem
 
 Features Enhancements:
 - Improvements in ACL and xattr handling on additional platforms:
@@ -63,12 +102,10 @@ Other Enhancements:
 - Significant stability enhancements to bat
 - A few path name length limits in Windows have been removed.
 
-Bug fixes
-
 
 ===========================================================================
 
-This 5.0.3 version is significant bug fix update to version 5.0.2.
+The 5.0.3 version is significant bug fix update to version 5.0.2.
 It includes new code and some new features.
 There is no database change since prior versions of 5.0.