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

   1
   2                Release Notes for Bacula 3.0.1
   3
   4   Bacula code: Total files = 521 Total lines = 206,512 (*.h *.c *.in)
   5
   6 Note, if you are not already running 3.0.0, read the 3.0.0 release notes
   7 below.  Important!!!
   8
   9 Version 3.0.1 is primarily a minor bug fix update to version 3.0.0 with
  10 one enhancement (see below).
  11
  12 Changes since 3.0.0:
  13 Bug fixes:
  14   1276, 1274, 1275, 1272 1246, 1268, 1281, 1282.
  15
  16 Fixed:
  17 - Check for job_canceled() in fd_plugin code.
  18 - Update Win32 table creation to have new DB version 11 format
  19 - Remove illegal Options in Exclude of default Win32/64 bacula-dir.conf
  20 - Remove 'Reposition' messages when restoring
  21 - Updated projects file
  22 - Tweak version string to display versionid field at the end
  23   and keep fields order.
  24 - Add additional mysql connection debug code submitted by:
  25   Chandranshu <chandranshu@gmail.com>
  26
  27 Enhancement:
  28 - Modify insertion of read Volumes in SD to be done *before* the
  29   drive reservation. This ensures that a Volume to be read will not
  30   be reserved for writing. Significant improvement in eliminating
  31   tape deadlock situations.
  32
  33 Note, both the Director and Storage daemons must be upgraded at the
  34 same time. The 3.0.1 File daemons are compatible with 3.0.0 file
  35 daemons and as noted below in the 3.0.0 release notes the Director
  36 and Storage daemon should be compatible with 2.4.x File daemons.
  37 In general, we do not expect any of the 3.0.x File daemons to work with older
  38 Directors and Storage daemons (as has always been the case for Bacula
  39 releases).
  40
  41 ============ Documentation improvements needed ==================
  42
  43 Note!!!!! The 3.0.0+ documentation needs rather extensive modifications in the
  44 following areas:
  45
  46 1. Missing documentation.
  47 2. Correction of links within various manuals -- most fail.
  48 3. Integration of the new features into the main documents.
  49 4. Much more.
  50
  51 The documentation will not be completed in the near future due to lack
  52 manpower.  If you are unhappy with this situation as we are, we suggest
  53 you help by submitting patches to the documentation.  Thanks.
  54 =====
  55
  56
  57 ================== 3.0.0 Release Notes ========================
  58
  59 The diff between 2.4.4 and 2.5.x is 208,340 lines, so this release
  60 represents an enormous effort.
  61
  62 This Director and Storage daemon must be upgraded at the same time,
  63 but they should be compatible with all 2.4.x File daemons, unless you
  64 use some of the new features that affect the FD.  In other words, you should
  65 not have to upgrade all your File daemons when you upgrade. However, any
  66 release of version 2.5.40 or greater requires a database upgrade.
  67
  68 ================== Warning !!!!!! ==========================
  69
  70 New Catalog format in version 3.0.0 (2.5.40 or later)
  71 -----------------------------------------------------
  72
  73 This release of Bacula uses a new catalog format. We provide a set of
  74 scripts that permit to convert a 2.4.x (version 10) catalog to 3.0.0 (version
  75 11).  The Bacula project rpms distributed on Source Forge will automatically
  76 detect the database change and do the upgrade for you.  We strongly
  77 recommend that you save a copy of your existing database before upgrading
  78 using rpms.
  79
  80 The simplest way to upgrade the database assuming you are building from
  81 source:
  82 1. Stop any current version of Bacula from running.
  83 2. Save a copy of your existing database.
  84 3. Configure, build, and install the 3.0.0 version of Bacula
  85    Note the new ./configure options in the manuals see the link
  86    at the bottom of this file.
  87 4. cd <your-scripts-installation-directory>
  88 5. ./update_bacula_tables
  89 6. If you have multiple catalogs, edit the update_bacula_tables
  90    script and put the name of another database, and then
  91    execute the script again. Repeat this until all Bacula
  92    catalogs have been updated.
  93 7. Start the new Bacula.  If everything worked, it should
  94    not print any error messages.
  95
  96 The upgrade operation will convert the FileId index field of the File table
  97 from 32 bits to 64 bits.  This operation will take TIME and will *temporarily*
  98 DOUBLE THE SIZE of your catalog. Bacula must be shutdown during this update,
  99 so, won't be able to run jobs during this period.  For example, a 3 million files
 100 catalog will take 2 mins to upgrade on a normal machine.  Don't forget to
 101 backup it before executing the script.
 102
 103 If you start from scratch, you don't need to run the update_bacula_tables
 104 script because the create_bacula_tables script automatically creates the new
 105 table format.  However, if you are using a version of Bacula older than 2.5.40
 106 (e.g.  2.4.4) then you need to run the update_bacula_tables script that will
 107 be found in the <bacula>/src/cats directory after you run the ./configure
 108 command.  As mentioned above, before running this script, please backup your
 109 catalog database, and when you do running it, be sure shutdown Bacula and be
 110 aware that running the script can take some time depending on your database
 111 size.
 112
 113
 114 Important New configure options :
 115 ----------------------
 116
 117 This release of Bacula 3.0.0 uses libtool by default
 118 to generate the Bacula libraries as shared objects rather than
 119 being directly linked in as in prior versions.  This means that
 120 the Bacula shared objects, must either be in a shared object
 121 directory known to the loader or they must be in the directory
 122 where the Bacula binaries are installed.  It is also possible
 123 to explicitly specify the libraries directory on the ./configure
 124 line (--libdir=/full-path/dir), but this should not be necessary.
 125
 126   ./configure --libdir=<full-path>
 127
 128 If you have problems with libtool or you wish to use the old
 129 way of building libraries and linking them into Bacula, you
 130 can do so by disabling libtool on the configure command line with:
 131
 132   ./configure --disable-libtool
 133
 134 During the installation of Bacula 3.0.0, it will now install
 135 bat help files (if you have configured bat).  These files
 136 are placed in /usr/share/doc/bacula/html by default. If you
 137 want to put them elsewhere use:
 138
 139   ./configure --htmldir=<full-path>
 140
 141 During the installation of Bacula, it will now install the
 142 ReleaseNotes, License, technotes, ChangeLog, and similar
 143 files in /usr/share/doc/bacula by default.  If you
 144 want to put them elsewhere use:
 145
 146   ./configure --docdir=<full-path>
 147
 148 During the installation of Bacula, any plugins will be
 149 installed in the plugindir, which is by default the
 150 same as libdir (/usr/lib).  You can specify an alternate
 151 location with:
 152
 153   ./configure --with-plugindir=<full-path>
 154
 155 ==============================================================
 156
 157 This release includes large number of new features and changes.
 158 It should be more or less compatible with previous xx.conf files
 159 and File daemons providing that you are not using any of the new
 160 features.
 161
 162 Please see the New Features chapter of the new manual, which documents
 163 some but not all the new features (we are still working on it):
 164
 165 http://www.bacula.org/manuals/en/concepts/concepts/New_Features.html
 166
 167
 168
 169
 170 The ChangeLog has more details.