git.gag.com Git - debian/amanda/blob - docs/UPGRADE

   1
   2 Amanda Upgrade Issues
   3
   4 -----
   5
   6 Amanda 2.4.0 has introduced a major incompatibility in the Amanda
   7 protocol.  This means that pre-2.4.0 clients won't interoperate with a
   8 2.4.0 server, nor will 2.4.0 clients interoperate with pre-2.4.0
   9 servers.  You have to upgrade them all at the same time.
  10
  11 To ease the upgrade process Amanda has, from release 2.4.0 on, a
  12 configure flag (--with-testing) that will cause Amanda to use alternate
  13 service names (amanda-test) instead of the standard ones.  This allows
  14 you to keep using your old version of Amanda while you test the new one.
  15
  16 -----
  17
  18 Depending upon the version of Amanda you are upgrading from, Amanda may
  19 use a different database library to store the backup information, and
  20 the new Amanda may not be able to read the old Amanda database files.
  21 In this case, you will want to do something like the following:
  22
  23 Before the upgrade (using the old version of amadmin):
  24
  25         # cd /var/amanda/CONFIG
  26         # amadmin CONFIG export > zzz
  27         # mkdir backup
  28         # mv curinfo* backup
  29
  30 and after the upgrade (using the new version of amadmin):
  31
  32         # cd /var/amanda/CONFIG
  33         # amadmin CONFIG import < zzz
  34
  35 and a month (:-) after you are happy with the new version:
  36
  37         # cd /var/amanda/CONFIG
  38         # rm -rf backup
  39
  40 -----
  41
  42 After 2.4.0, the structure of the directory holding the index files
  43 was changed to have three levels instead of being flat.  This greatly
  44 reduces the number of files in a given directory, which was a problem
  45 for some systems.
  46
  47 The new layout is:
  48
  49         [indexdir]/hostname/filesystem/YYYYMMDD_L.gz
  50
  51 where hostname and filesystem are "sanitized" versions of the names from
  52 disklist, i.e. '/' characters are converted to '_' and so on.  This new
  53 naming convention matches the one used for the text formatted database.
  54
  55 A script is available to convert the flat directory structure to the
  56 new layout:
  57
  58         ftp://ftp.amanda.org/pub/amanda/maillist-archives/amanda-users/www/Apr-Jun.1998/msg00428.html
  59
  60 -----