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

   1
   2        Release Notes for Bacula 3.0.0
   3
   4   Bacula code: Total files = 520 Total lines = 205,459 (*.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 3.0.0 (2.5.40 or later)
  18 -----------------------------------------------------
  19
  20 This 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 3.0.0 (version
  22 11).  The Bacula project rpms distributed on Source Forge will automatically
  23 detect the database change and do the upgrade for you.  We strongly
  24 recommend that you save a copy of your existing database before upgrading
  25 using rpms.
  26
  27 The simplest way to upgrad the database assuming you are building from
  28 source:
  29 1. Stop any current version of Bacula from running.
  30 2. Save a copy of your existing database.
  31 3. Configure, build, and install the 3.0.0 version of Bacula
  32    Note the new ./configure options in the manuals see the link
  33    at the bottom of this file.
  34 4. cd <your-scripts-installation-directory>
  35 5. ./update_bacula_tables
  36 6. If you have multiple catalogs, edit the update_bacula_tables
  37    script and put the name of another database, and then
  38    execute the script again. Repeat this until all Bacula
  39    catalogs have been updated.
  40 7. Start the new Bacula.  If everything worked, it should
  41    not print any error messages.
  42
  43 The upgrade operation will convert the FileId index field of the File table
  44 from 32 bits to 64 bits.  This operation will take TIME and will *temporarily*
  45 DOUBLE THE SIZE of your catalog. Bacula must be shutdown during this update,
  46 so, won't be able to run jobs during this period.  For example, a 3 million files
  47 catalog will take 2 mins to upgrade on a normal machine.  Don't forget to
  48 backup it before executing the script.
  49
  50 If you start from scratch, you don't need to run the update_bacula_tables
  51 script because the create_bacula_tables script automatically creates the new
  52 table format.  However, if you are using a version of Bacula older than 2.5.40
  53 (e.g.  2.4.4) then you need to run the update_bacula_tables script that will
  54 be found in the <bacula>/src/cats directory after you run the ./configure
  55 command.  As mentioned above, before running this script, please backup your
  56 catalog database, and when you do running it, be sure shutdown Bacula and be
  57 aware that running the script can take some time depending on your database
  58 size.
  59
  60
  61 Important New configure options :
  62 ----------------------
  63
  64 This release of Bacula 3.0.0 uses libtool by default
  65 to generate the Bacula libraries as shared objects rather than
  66 being directly linked in as in prior versions.  This means that
  67 the Bacula shared objects, must either be in a shared object
  68 directory known to the loader or they must be in the directory
  69 where the Bacula binaries are installed.  It is also possible
  70 to explicitly specify the libraries directory on the ./configure
  71 line (--libdir=/full-path/dir), but this should not be necessary.
  72
  73   ./configure --libdir=<full-path>
  74
  75 If you have problems with libtool or you wish to use the old
  76 way of building libraries and linking them into Bacula, you
  77 can do so by disabling libtool on the configure command line with:
  78
  79   ./configure --disable-libtool
  80
  81 During the installation of Bacula 3.0.0, it will now install
  82 bat help files (if you have configured bat).  These files
  83 are placed in /usr/share/doc/bacula/html by default. If you
  84 want to put them elsewhere use:
  85
  86   ./configure --htmldir=<full-path>
  87
  88 During the installation of Bacula, it will now install the
  89 ReleaseNotes, License, technotes, ChangeLog, and similar
  90 files in /usr/share/doc/bacula by default.  If you
  91 want to put them elsewhere use:
  92
  93   ./configure --docdir=<full-path>
  94
  95 During the installation of Bacula, any plugins will be
  96 installed in the plugindir, which is by default the
  97 same as libdir (/usr/lib).  You can specify an alternate
  98 location with:
  99
 100   ./configure --with-plugindir=<full-path>
 101
 102 ==============================================================
 103
 104 This release includes large number of new features and changes.
 105 It should be more or less compatible with previous xx.conf files
 106 and File daemons providing that you are not using any of the new
 107 features.
 108
 109 Please see the New Features chapter of the new manual, which documents
 110 some but not all the new features (we are still working on it):
 111
 112 http://www.bacula.org/manuals/en/concepts/concepts/New_Features.html
 113
 114 ============ Documentation improvements needed ==================
 115
 116 Note!!!!! The documentation needs rather extensive modifications in the
 117 following areas:
 118
 119 1. Missing documentation.
 120 2. Correction of links within various manuals -- most fail.
 121 3. Integration of the new features into the main documents.
 122 4. Much more.
 123
 124 The documentation will not be completed in the near future due to lack
 125 manpower.  If you are unhappy with this situation as we are, we suggest
 126 you help by submitting patches to the documentation.  Thanks.
 127 =====
 128
 129
 130
 131 The ChangeLog has more details.