Update ReleaseNotes

[bacula/bacula] / bacula / ReleaseNotes

diff --git a/bacula/ReleaseNotes b/bacula/ReleaseNotes
index 00a1c2442175d800422f63bffa968e43f3a05f0e..4ff6f6f2916c20977efea623fe8b638f1cfb216f 100644 (file)
--- a/bacula/ReleaseNotes
+++ b/bacula/ReleaseNotes
@@ -7,25 +7,64 @@ General:
 --------
 
 This 5.2.0 version is a major release since the last version 5.0.3.
 --------
 
 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.
 
 
 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.
 
  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:
 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.
 - 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
 
 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:
 
 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.
 
 - 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.
 
 It includes new code and some new features.
 There is no database change since prior versions of 5.0.