git.gag.com Git - debian/amanda/blob - UPGRADING

   1 Upgrading
   2 =========
   3
   4 This file describes the process for ugprading Amanda from a previous
   5 version.  In general, the Amanda development team aims for seamless
   6 upgrades.  In the rare cases where an upgrade requires other changes
   7 on your system, they are described in this file.
   8
   9 The file is organized from oldest to newest.  Please follow all of
  10 the directions, in order, for the range of versions over which you
  11 are upgrading.
  12
  13 See also http://wiki.zmanda.com/index.php/Version_compatibility for notes
  14 on the compatibility of various versions of Amanda.
  15
  16 Upgrading from pre-2.4.0
  17 ------------------------
  18
  19 Amanda 2.4.0 has introduced a major incompatibility in the Amanda protocol.
  20 This means that pre-2.4.0 clients won't interoperate with a 2.4.0 server, nor
  21 will 2.4.0 clients interoperate with pre-2.4.0 servers. You have to upgrade
  22 them all at the same time.
  23
  24 To ease the upgrade process Amanda has, from release 2.4.0 on, a configure flag
  25 (--with-testing) that will cause Amanda to use alternate service names (Amanda-
  26 test) instead of the standard ones. This allows you to keep using your old
  27 version of Amanda while you test the new one.
  28
  29 Depending upon the version of Amanda you are upgrading from, Amanda may use a
  30 different database library to store the backup information, and the new Amanda
  31 may not be able to read the old Amanda database files. In this case, you will
  32 want to do something like the following:
  33
  34 Before the upgrade (using the old version of amadmin):
  35
  36         # cd /var/AMANDA/CONFIG
  37         # amadmin CONFIG export > zzz
  38         # mkdir backup
  39         # mv curinfo* backup
  40
  41
  42 and after the upgrade (using the new version of amadmin):
  43
  44         # cd /var/AMANDA/CONFIG
  45         # amadmin CONFIG import < zzz
  46
  47
  48 and a month :-) after you are happy with the new version:
  49
  50         # cd /var/AMANDA/CONFIG
  51         # rm -rf backup
  52
  53
  54 After 2.4.0, the structure of the directory holding the index files was changed
  55 to have three levels instead of being flat. This greatly reduces the number of
  56 files in a given directory, which was a problem for some systems.
  57
  58 The new layout is:
  59
  60   [indexdir]/hostname/filesystem/YYYYMMDD_L.gz
  61
  62 where hostname and filesystem are "sanitized" versions of the names from
  63 disklist, i.e. '/' characters are converted to '_' and so on. This new naming
  64 convention matches the one used for the text formatted database.
  65
  66 A script is available to convert the flat directory structure to the new
  67 layout:
  68
  69   http://www.amanda.org/2.4-conv/msg00428.html