]> git.sur5r.net Git - bacula/bacula/blobdiff - bacula/ReleaseNotes
ebl update win64 doc
[bacula/bacula] / bacula / ReleaseNotes
index 4443960fa01664ddd11208d0bcc711f98819464b..d37fd90bf8654ef7f91e5ddc95e68e668cd2cde9 100644 (file)
@@ -1,33 +1,57 @@
 
-       Release Notes for Bacula 2.5.28
+       Release Notes for Bacula 2.5.42
 
-  Bacula code: Total files = 522 Total lines = 203,305 (*.h *.c *.in)
+  Bacula code: Total files = 521 Total lines = 204,881 (*.h *.c *.in)
+
+The diff between 2.4.4 and 2.5.x is 208,340 lines, so this release
+represents an enormous effort.
 
 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. There is
-no database upgrade needed from version 2.4.x.  However, the next
-BETA release will require a database upgrade.
+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.
 
 ================== Warning !!!!!! ==========================
 
-New Catalog format :
---------------------
+New Catalog format in version 2.5.40
+------------------------------------
 
 This BETA release of Bacula uses a new catalog format. We provide a set of
-script 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 need to drop the JobHistory
+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 like with the Job table, see
-upgrade_<database>_table script).
-
-The upgrade operation will convert an essential field of the File table, and
-this operation will take TIME and will DOUBLE THE SIZE of your
-catalog temporarily. Depending on your catalog backend, you won't be able to run jobs
-during this period. For example, a 3 million files catalog will take 2mins to
-upgrade on a normal machine. Don't forget to backup it before executing the
-script.
+statistics" module, you can upgrade this table the same way we do with 
+the Job table, see the src/cats/update_bacula_tables script).
+
+The simplest way to:
+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
+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.
+
+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 :
@@ -43,8 +67,8 @@ 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 static libraries, you can do so by disabling 
-libtool on the configure command line with:
+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
 ==============================================================
@@ -60,5 +84,3 @@ some but not all the new features (we are still working on it):
 http://www.bacula.org/manuals/en/concepts/concepts/New_Features.html
   
 The ChangeLog has more details.
-
-