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

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