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

   1
   2                Release Notes for Bacula 3.0.2
   3
   4   Bacula code: Total files = 1,009 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 important 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, 1325, 1331, 1333, 1335
  17
  18 Fixed:
  19  - Fix 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  - New directive to specify source address for outgoing connexions
  28  - Show volume availability in autochanger when doing restore.
  29    This is project 31 in the projects file.
  30  - Add accurate=yes/no option to estimate command
  31  - Add --with-hostname, --with-bsrdir, --with-logdir to ./configure
  32  - Add a restore menu that contructs a full restore when entering a JobId.
  33    This is project 2 in the projects file.
  34  - Add new Nagios plugin
  35
  36 Compatibility:
  37 Like always, both the Director and Storage daemon must be upgraded at
  38 the same time.
  39
  40 Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 3.0.2
  41 Director and Storage daemons. It should be no need to upgrade older File
  42 Daemon.
  43
  44 ============ Documentation improvements needed ==================
  45
  46 Note!!!!! The 3.0.0+ documentation needs rather extensive modifications in the
  47 following areas:
  48
  49 1. Missing documentation.
  50 2. Correction of links within various manuals -- most fail.
  51 3. Integration of the new features into the main documents.
  52 4. Much more.
  53
  54 The documentation will not be completed in the near future due to lack
  55 manpower.  If you are unhappy with this situation as we are, we suggest
  56 you help by submitting patches to the documentation.  Thanks.
  57 =====
  58
  59 ================== 3.0.1 Release Notes ========================
  60
  61 Version 3.0.1 is primarily a minor bug fix update to version 3.0.0 with
  62 one enhancement.
  63
  64 ================== 3.0.0 Release Notes ========================
  65
  66 The diff between 2.4.4 and 2.5.x is 208,340 lines, so this release
  67 represents an enormous effort.
  68
  69 This Director and Storage daemon must be upgraded at the same time,
  70 but they should be compatible with all 2.4.x File daemons, unless you
  71 use some of the new features that affect the FD.  In other words, you should
  72 not have to upgrade all your File daemons when you upgrade. However, any
  73 release of version 2.5.40 or greater requires a database upgrade.
  74
  75 ================== Warning !!!!!! ==========================
  76
  77 New Catalog format in version 3.0.0 (2.5.40 or later)
  78 -----------------------------------------------------
  79
  80 This release of Bacula uses a new catalog format. We provide a set of
  81 scripts that permit to convert a 2.4.x (version 10) catalog to 3.0.0 (version
  82 11).  The Bacula project rpms distributed on Source Forge will automatically
  83 detect the database change and do the upgrade for you.  We strongly
  84 recommend that you save a copy of your existing database before upgrading
  85 using rpms.
  86
  87 The simplest way to upgrade the database assuming you are building from
  88 source:
  89 1. Stop any current version of Bacula from running.
  90 2. Save a copy of your existing database.
  91 3. Configure, build, and install the 3.0.0 version of Bacula
  92    Note the new ./configure options in the manuals see the link
  93    at the bottom of this file.
  94 4. cd <your-scripts-installation-directory>
  95 5. ./update_bacula_tables
  96 6. If you have multiple catalogs, edit the update_bacula_tables
  97    script and put the name of another database, and then
  98    execute the script again. Repeat this until all Bacula
  99    catalogs have been updated.
 100 7. Start the new Bacula.  If everything worked, it should
 101    not print any error messages.
 102
 103 The upgrade operation will convert the FileId index field of the File table
 104 from 32 bits to 64 bits.  This operation will take TIME and will *temporarily*
 105 DOUBLE THE SIZE of your catalog. Bacula must be shutdown during this update,
 106 so, won't be able to run jobs during this period.  For example, a 3 million files
 107 catalog will take 2 mins to upgrade on a normal machine.  Don't forget to
 108 backup it before executing the script.
 109
 110 If you start from scratch, you don't need to run the update_bacula_tables
 111 script because the create_bacula_tables script automatically creates the new
 112 table format.  However, if you are using a version of Bacula older than 2.5.40
 113 (e.g.  2.4.4) then you need to run the update_bacula_tables script that will
 114 be found in the <bacula>/src/cats directory after you run the ./configure
 115 command.  As mentioned above, before running this script, please backup your
 116 catalog database, and when you do running it, be sure shutdown Bacula and be
 117 aware that running the script can take some time depending on your database
 118 size.
 119
 120
 121 Important New configure options :
 122 ----------------------
 123
 124 This release of Bacula 3.0.0 uses libtool by default
 125 to generate the Bacula libraries as shared objects rather than
 126 being directly linked in as in prior versions.  This means that
 127 the Bacula shared objects, must either be in a shared object
 128 directory known to the loader or they must be in the directory
 129 where the Bacula binaries are installed.  It is also possible
 130 to explicitly specify the libraries directory on the ./configure
 131 line (--libdir=/full-path/dir), but this should not be necessary.
 132
 133   ./configure --libdir=<full-path>
 134
 135 If you have problems with libtool or you wish to use the old
 136 way of building libraries and linking them into Bacula, you
 137 can do so by disabling libtool on the configure command line with:
 138
 139   ./configure --disable-libtool
 140
 141 During the installation of Bacula 3.0.0, it will now install
 142 bat help files (if you have configured bat).  These files
 143 are placed in /usr/share/doc/bacula/html by default. If you
 144 want to put them elsewhere use:
 145
 146   ./configure --htmldir=<full-path>
 147
 148 During the installation of Bacula, it will now install the
 149 ReleaseNotes, License, technotes, ChangeLog, and similar
 150 files in /usr/share/doc/bacula by default.  If you
 151 want to put them elsewhere use:
 152
 153   ./configure --docdir=<full-path>
 154
 155 During the installation of Bacula, any plugins will be
 156 installed in the plugindir, which is by default the
 157 same as libdir (/usr/lib).  You can specify an alternate
 158 location with:
 159
 160   ./configure --with-plugindir=<full-path>
 161
 162 ==============================================================
 163
 164 This release includes large number of new features and changes.
 165 It should be more or less compatible with previous xx.conf files
 166 and File daemons providing that you are not using any of the new
 167 features.
 168
 169 Please see the New Features chapter of the new manual, which documents
 170 some but not all the new features (we are still working on it):
 171
 172 http://www.bacula.org/manuals/en/concepts/concepts/New_Features.html
 173
 174
 175
 176
 177 The ChangeLog has more details.