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

   1
   2                Release Notes for Bacula 3.0.2
   3
   4   Bacula code: Total files = 1009 Total lines = 205,726 (Using SLOCCount)
   5
   6 Note, if you are not already running 3.0.x, read the 3.0.x release notes
   7 below.  Important!!!
   8
   9 Version 3.0.2 is primarily a minor bug fix update to version 3.0.1 with
  10 some enhancements (see below).
  11
  12 Changes since 3.0.1:
  13
  14 Bug fixes:
  15   1029, 1285, 1298, 1303, 1304, 1305, 1306, 1307, 1308, 1309, 1311, 1315
  16   1317, 1318, 1323, 1331, 1333, 1335
  17
  18 Fixed:
  19  - Problem with the Postgresql driver that sometime displays <NULL> values
  20  - Cleanup old job records when starting the director
  21  - Fix bugs in xattr code
  22  - Fix encoding problem with Postgresql
  23  - Fix that prevents restore by file selection from using Copy job
  24
  25 Enhancements:
  26  - Security enhancement for the File Daemon
  27  - Can specify source address for outgoing connexions
  28  - Show volume availability when doing restore
  29  - Add accurate=yes/no option to estimate command
  30  - Add --with-hostname, --with-bsrdir, --with-logdir to ./configure
  31  - Add a restore menu that contructs a full restore when entering a JobId
  32  - Add new Nagios plugin
  33
  34 Note, both the Director and Storage daemons must be upgraded at the
  35 same time. The 3.0.2 File daemons are compatible with 3.0.1 file
  36 daemons and as noted below in the 3.0.2 release notes the Director
  37 and Storage daemon should be compatible with 2.4.x File daemons.
  38 We do not expect any of the 3.0.2 File daemons to work with older
  39 Directors and Storage daemons.
  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 ================== 3.0.1 Release Notes ========================
  57
  58 Version 3.0.1 is primarily a minor bug fix update to version 3.0.0 with
  59 one enhancement.
  60
  61 ================== 3.0.0 Release Notes ========================
  62
  63 The diff between 2.4.4 and 2.5.x is 208,340 lines, so this release
  64 represents an enormous effort.
  65
  66 This Director and Storage daemon must be upgraded at the same time,
  67 but they should be compatible with all 2.4.x File daemons, unless you
  68 use some of the new features that affect the FD.  In other words, you should
  69 not have to upgrade all your File daemons when you upgrade. However, any
  70 release of version 2.5.40 or greater requires a database upgrade.
  71
  72 ================== Warning !!!!!! ==========================
  73
  74 New Catalog format in version 3.0.0 (2.5.40 or later)
  75 -----------------------------------------------------
  76
  77 This release of Bacula uses a new catalog format. We provide a set of
  78 scripts that permit to convert a 2.4.x (version 10) catalog to 3.0.0 (version
  79 11).  The Bacula project rpms distributed on Source Forge will automatically
  80 detect the database change and do the upgrade for you.  We strongly
  81 recommend that you save a copy of your existing database before upgrading
  82 using rpms.
  83
  84 The simplest way to upgrade the database assuming you are building from
  85 source:
  86 1. Stop any current version of Bacula from running.
  87 2. Save a copy of your existing database.
  88 3. Configure, build, and install the 3.0.0 version of Bacula
  89    Note the new ./configure options in the manuals see the link
  90    at the bottom of this file.
  91 4. cd <your-scripts-installation-directory>
  92 5. ./update_bacula_tables
  93 6. If you have multiple catalogs, edit the update_bacula_tables
  94    script and put the name of another database, and then
  95    execute the script again. Repeat this until all Bacula
  96    catalogs have been updated.
  97 7. Start the new Bacula.  If everything worked, it should
  98    not print any error messages.
  99
 100 The upgrade operation will convert the FileId index field of the File table
 101 from 32 bits to 64 bits.  This operation will take TIME and will *temporarily*
 102 DOUBLE THE SIZE of your catalog. Bacula must be shutdown during this update,
 103 so, won't be able to run jobs during this period.  For example, a 3 million files
 104 catalog will take 2 mins to upgrade on a normal machine.  Don't forget to
 105 backup it before executing the script.
 106
 107 If you start from scratch, you don't need to run the update_bacula_tables
 108 script because the create_bacula_tables script automatically creates the new
 109 table format.  However, if you are using a version of Bacula older than 2.5.40
 110 (e.g.  2.4.4) then you need to run the update_bacula_tables script that will
 111 be found in the <bacula>/src/cats directory after you run the ./configure
 112 command.  As mentioned above, before running this script, please backup your
 113 catalog database, and when you do running it, be sure shutdown Bacula and be
 114 aware that running the script can take some time depending on your database
 115 size.
 116
 117
 118 Important New configure options :
 119 ----------------------
 120
 121 This release of Bacula 3.0.0 uses libtool by default
 122 to generate the Bacula libraries as shared objects rather than
 123 being directly linked in as in prior versions.  This means that
 124 the Bacula shared objects, must either be in a shared object
 125 directory known to the loader or they must be in the directory
 126 where the Bacula binaries are installed.  It is also possible
 127 to explicitly specify the libraries directory on the ./configure
 128 line (--libdir=/full-path/dir), but this should not be necessary.
 129
 130   ./configure --libdir=<full-path>
 131
 132 If you have problems with libtool or you wish to use the old
 133 way of building libraries and linking them into Bacula, you
 134 can do so by disabling libtool on the configure command line with:
 135
 136   ./configure --disable-libtool
 137
 138 During the installation of Bacula 3.0.0, it will now install
 139 bat help files (if you have configured bat).  These files
 140 are placed in /usr/share/doc/bacula/html by default. If you
 141 want to put them elsewhere use:
 142
 143   ./configure --htmldir=<full-path>
 144
 145 During the installation of Bacula, it will now install the
 146 ReleaseNotes, License, technotes, ChangeLog, and similar
 147 files in /usr/share/doc/bacula by default.  If you
 148 want to put them elsewhere use:
 149
 150   ./configure --docdir=<full-path>
 151
 152 During the installation of Bacula, any plugins will be
 153 installed in the plugindir, which is by default the
 154 same as libdir (/usr/lib).  You can specify an alternate
 155 location with:
 156
 157   ./configure --with-plugindir=<full-path>
 158
 159 ==============================================================
 160
 161 This release includes large number of new features and changes.
 162 It should be more or less compatible with previous xx.conf files
 163 and File daemons providing that you are not using any of the new
 164 features.
 165
 166 Please see the New Features chapter of the new manual, which documents
 167 some but not all the new features (we are still working on it):
 168
 169 http://www.bacula.org/manuals/en/concepts/concepts/New_Features.html
 170
 171
 172
 173
 174 The ChangeLog has more details.