git.gag.com Git - debian/amanda/blob - man/amanda-compatibility.7

   1 '\" t
   2 .\"     Title: amanda-compatibility
   3 .\"    Author: Dustin J. Mitchell <dustin@zmanda.com>
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
   5 .\"      Date: 06/01/2010
   6 .\"    Manual: Miscellanea
   7 .\"    Source: Amanda 3.1.0
   8 .\"  Language: English
   9 .\"
  10 .TH "AMANDA\-COMPATIBILIT" "7" "06/01/2010" "Amanda 3\&.1\&.0" "Miscellanea"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 amanda-compatibility \- Compatibility between Amanda versions
  23 .SH "NETWORK COMPATIBILITY"
  24 .PP
  25 Amanda has used several on\-the\-wire protocols to communicate between the server and backup clients, and not all of them have been compatible\&.
  26 .PP
  27 Versions of Amanda prior to about 2\&.3 used a different protocol which is not compatible\&. 2\&.3 is very old so this is not of general interest\&.
  28 .PP
  29 The Amanda 2\&.4 series all use the same protocol\&. This protocol has support for extensibility\&. Generally upgrading clients or servers along the 2\&.4 branch does not cause difficulty\&.
  30 .PP
  31 Amanda 2\&.5\&.0 uses the same protocol as 2\&.4\&. One can use a 2\&.5\&.0 server with 2\&.4 clients and a 2\&.4 server with 2\&.5\&.0 clients\&.
  32 .PP
  33 Kerberos4 authentication in 2\&.5 is compatible with 2\&.4\&. In 2\&.5, kerberos4 encryption is broken, at least for the server\&.
  34 .PP
  35 Amanda 2\&.5\&.1 introduced a new recover protocol\&. Backup communication works with any combination of versions, but 2\&.5\&.1\'s amrecover cannot communicate with an older server\&. Use oldamrecover on 2\&.5\&.1 and higher clients when communicating with an older server\&.
  36 .PP
  37 Amanda 2\&.6\&.0 and later are completely compatible with 2\&.5\&.1\&.
  38 .PP
  39 To restore a dump created with the tapesplit_size option using amrecover, you need at least a 2\&.5 server and late\-2\&.4 client\&. (Extracting that backup using only shell, mt and dd is also possible\&.)
  40 .SH "UPGRADES"
  41 .PP
  42 The recommended course for Amanda upgrades is to upgrade the server first, and test backups and restores before upgrading clients\&. Consult the changes described below for the relevant span of versions to determine what adjustments, if any, are required\&. Also see the NEWS file shipped with each Amanda release for more detailed information\&.
  43 .SS "Amanda 3\&.1"
  44 .PP
  45 Although it is a significant rewrite, there are no incompatible changes in this release\&.
  46 .PP
  47 Old\-style changer scripts are deprecated in this release\&. While they remain available, they may be removed in a future release\&. Consider upgrading to one of the new changer scripts\&. Users of
  48 \fIchg\-zd\-mtx\fR
  49 are particularly encouraged to consider the much more intelligent
  50 \fIchg\-robot\fR\&. See
  51 \fBamanda-changers\fR(7)
  52 for more information\&.
  53 .PP
  54 The following configuration configration keywords are deprecated\&. This is currently a warning, but will become an error soon\&.
  55 .sp
  56 .RS 4
  57 .ie n \{\
  58 \h'-04'\(bu\h'+03'\c
  59 .\}
  60 .el \{\
  61 .sp -1
  62 .IP \(bu 2.3
  63 .\}
  64 label_new_tapes
  65 \- use
  66 autolabel
  67 .RE
  68 .sp
  69 .RE
  70 .SS "Amanda 2\&.6\&.1"
  71 .PP
  72 There are no incompatible changes in this release, but consider switching to some of the new applications instead of the old GNUTAR and DUMP programs\&.
  73 .PP
  74 The following configuration configration keywords are deprecated\&. This is currently a warning, but will become an error soon\&.
  75 .sp
  76 .RS 4
  77 .ie n \{\
  78 \h'-04'\(bu\h'+03'\c
  79 .\}
  80 .el \{\
  81 .sp -1
  82 .IP \(bu 2.3
  83 .\}
  84 tapebufs
  85 \- use
  86 device\-output\-buffer\-size
  87 instead
  88 .RE
  89 .sp
  90 .RS 4
  91 .ie n \{\
  92 \h'-04'\(bu\h'+03'\c
  93 .\}
  94 .el \{\
  95 .sp -1
  96 .IP \(bu 2.3
  97 .\}
  98 rawtapedev
  99 \- use
 100 tapedev
 101 instead
 102 .RE
 103 .sp
 104 .RS 4
 105 .ie n \{\
 106 \h'-04'\(bu\h'+03'\c
 107 .\}
 108 .el \{\
 109 .sp -1
 110 .IP \(bu 2.3
 111 .\}
 112 file\-pad
 113 \- this is no longer optional, and all files are padded
 114 .RE
 115 .sp
 116 .RE
 117 .SS "Amanda 2\&.6\&.0"
 118 .PP
 119 amverify
 120 and
 121 amverifyrun
 122 are removed and replaced with
 123 \fBamcheckdump\fR(8)\&. Both
 124 amdd
 125 and
 126 ammt
 127 are removed\&.
 128 .PP
 129 Some Amanda files are now installed in new
 130 amanda/
 131 subdirectories: libraries are now installed in
 132 $libdir/amanda
 133 and internal programs are now installed in
 134 $libexecdir/amanda\&.
 135 .PP
 136 The amandates file, previously at
 137 /etc/amandates, is now at
 138 $localstatedir/amanda/amandates\&. You may want to move your existing
 139 /etc/amandates
 140 when you upgrade Amanda\&.
 141 .PP
 142 GLib is now required to build and run Amanda\&.
 143 .SH "SEE ALSO"
 144 .PP
 145 \fBamanda\fR(8),
 146 \fBamanda.conf\fR(5)
 147 .PP
 148 The Amanda Wiki:
 149 : http://wiki.zmanda.com/
 150 .SH "AUTHOR"
 151 .PP
 152 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
 153 .RS 4
 154 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
 155 .RE