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

   1
   2        Release Notes for Bacula 2.5.42
   3
   4   Bacula code: Total files = 521 Total lines = 204,881 (*.h *.c *.in)
   5
   6 The diff between 2.4.4 and 2.5.x is 208,340 lines, so this release
   7 represents an enormous effort.
   8
   9 This Director and Storage daemon must be upgraded at the same time,
  10 but they should be compatible with all 2.4.x File daemons, unless you
  11 use some of the new features that affect the FD.  In other words, you should
  12 not have to upgrade all your File daemons when you upgrade. However, any
  13 release of version 2.5.40 or greater requires a database upgrade.
  14
  15 ================== Warning !!!!!! ==========================
  16
  17 New Catalog format in version 2.5.40
  18 ------------------------------------
  19
  20 This BETA release of Bacula uses a new catalog format. We provide a set of
  21 scripts that permit to convert a 2.4.x (version 10) catalog to 2.5.x (version
  22 11). If you are using already a 2.5 version, you can drop the JobHistory
  23 table before upgrading your catalog (if you are using the new "long term
  24 statistics" module, you can upgrade this table the same way we do with
  25 the Job table, see the src/cats/update_bacula_tables script).
  26
  27 The simplest way to:
  28 1. Stop any current version of Bacula from running.
  29 2. Save a copy of your existing database.
  30 3. Configure, build, and install the 2.5.42 version of Bacula
  31 4. cd <your-scripts-installation-directory>
  32 5. ./update_bacula_tables
  33 6. If you have multiple catalogs, edit the update_bacula_tables
  34    script and put the name of another database, and then
  35    execute the script again. Repeat this until all Bacula
  36    catalogs have been updated.
  37 7. Start the new Bacula.  If everything worked, it should
  38    not print any error messages.
  39
  40 The upgrade operation will convert the FileId index field of the File table
  41 from 32 bits to 64 bits.  This operation will take TIME and will *temporarily*
  42 DOUBLE THE SIZE of your catalog. Bacula must be shutdown during this update,
  43 so, won't be able to run jobs during this period.  For example, a 3 million files
  44 catalog will take 2 mins to upgrade on a normal machine.  Don't forget to
  45 backup it before executing the script.
  46
  47 If you start from scratch, you don't need to run the update_bacula_tables
  48 script.  However, if you are using a version of Bacula older than 2.5.40,
  49 then you need to run the update_bacula_tables script that will be found
  50 in the <bacula>/src/cats directory after you run the ./configure command.
  51 As mentioned above, before running this script, please backup your
  52 catalog database, and when you do running it, be sure shutdown
  53 Bacula and be aware that running the script can take some time depending
  54 on your database size.
  55
  56
  57 New configure option :
  58 ----------------------
  59
  60 This BETA release of Bacula 2.5.x development code uses libtool
  61 to generate the Bacula libraries as shared objects rather than
  62 being directly linked in as in prior versions.  This means that
  63 the Bacula shared objects, must either be in a shared object
  64 directory known to the loader or they must be in the directory
  65 where the Bacula binaries are installed.  It is also possible
  66 to explicitly specify the libraries directory on the ./configure
  67 line (--libdir=/full-path/dir), but this should not be necessary.
  68
  69 If you have problems with libtool or you wish to use the old
  70 way of building libraries and linking them into Bacula, you
  71 can do so by disabling libtool on the configure command line with:
  72
  73   ./configure --disable-libtool
  74 ==============================================================
  75
  76 This release includes large number of new features and changes.
  77 It should be more or less compatible with previous xx.conf files
  78 and File daemons providing that you are not using any of the new
  79 features.
  80
  81 Please see the New Features chapter of the new manual, which documents
  82 some but not all the new features (we are still working on it):
  83
  84 http://www.bacula.org/manuals/en/concepts/concepts/New_Features.html
  85
  86 The ChangeLog has more details.