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/02/2011
   6 .\"    Manual: Miscellanea
   7 .\"    Source: Amanda 3.3.0
   8 .\"  Language: English
   9 .\"
  10 .TH "AMANDA\-COMPATIBILIT" "7" "06/02/2011" "Amanda 3\&.3\&.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\&.2"
  44 .PP
  45 The following configuration configration keywords are deprecated\&. This is currently a warning, but will become an error soon\&.
  46 .sp
  47 .RS 4
  48 .ie n \{\
  49 \h'-04'\(bu\h'+03'\c
  50 .\}
  51 .el \{\
  52 .sp -1
  53 .IP \(bu 2.3
  54 .\}
  55 \fBamrecover\-do\-fsf\fR
  56 \- amrecover always seeks to files when recovering
  57 .RE
  58 .sp
  59 .RS 4
  60 .ie n \{\
  61 \h'-04'\(bu\h'+03'\c
  62 .\}
  63 .el \{\
  64 .sp -1
  65 .IP \(bu 2.3
  66 .\}
  67 \fBamrecover\-check\-label\fR
  68 \- amrecover always checks the volume label when recovering
  69 .RE
  70 .sp
  71 .RS 4
  72 .ie n \{\
  73 \h'-04'\(bu\h'+03'\c
  74 .\}
  75 .el \{\
  76 .sp -1
  77 .IP \(bu 2.3
  78 .\}
  79 Dumptype parameters
  80 \fBtape\-splitsize\fR,
  81 \fBsplit\-diskbuffer\fR, and
  82 \fBfallback\-splitsize\fR
  83 \- see
  84 \fBallow\-split\fR
  85 and tapetype parameters
  86 \fBpart\-size\fR,
  87 \fBpart\-cache\-type\fR,
  88 \fBpart\-cache\-dir\fR, and
  89 \fBpart\-cache\-max\-size\fR\&. See
  90 \fBamanda.conf\fR(5)
  91 for more information on these new parameters, noting particularly that all but the first are tapetype parameters, not dumptype parameters\&.
  92 .sp
  93 To convert most cases to the new parameters, set
  94 \fBpart\-size\fR
  95 to the old value of
  96 \fBtape\-splitsize\fR
  97 and
  98 \fBpart\-cache\-dir\fR
  99 to the old value of
 100 \fBsplit\-diskbuffer\fR, if present\&. If
 101 \fBsplit\-diskbuffer\fR
 102 was set, then set
 103 \fBpart\-cache\-type\fR
 104 to
 105 \fBdisk\fR, otherwise
 106 \fBmemory\fR\&. Finally, if using memory caching, set
 107 \fBpart\-cache\-max\-size\fR
 108 to the previous value of
 109 \fBfallback\-splitsize\fR\&. Be sure to remove all of the old keywords from your configuration\&.
 110 .RE
 111 .sp
 112 .RE
 113 .SS "Amanda 3\&.1"
 114 .PP
 115 Although it is a significant rewrite, there are no incompatible changes in this release\&.
 116 .PP
 117 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
 118 \fIchg\-zd\-mtx\fR
 119 are particularly encouraged to consider the much more intelligent
 120 \fIchg\-robot\fR\&. See
 121 \fBamanda-changers\fR(7)
 122 for more information\&.
 123 .PP
 124 The following configuration configration keywords are deprecated\&. This is currently a warning, but will become an error in a future version\&.
 125 .sp
 126 .RS 4
 127 .ie n \{\
 128 \h'-04'\(bu\h'+03'\c
 129 .\}
 130 .el \{\
 131 .sp -1
 132 .IP \(bu 2.3
 133 .\}
 134 label_new_tapes
 135 \- use
 136 autolabel
 137 .RE
 138 .sp
 139 .RE
 140 .SS "Amanda 2\&.6\&.1"
 141 .PP
 142 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\&.
 143 .PP
 144 The following configuration configration keywords are deprecated\&. This is currently a warning, but will become an error soon\&.
 145 .sp
 146 .RS 4
 147 .ie n \{\
 148 \h'-04'\(bu\h'+03'\c
 149 .\}
 150 .el \{\
 151 .sp -1
 152 .IP \(bu 2.3
 153 .\}
 154 tapebufs
 155 \- use
 156 device\-output\-buffer\-size
 157 instead
 158 .RE
 159 .sp
 160 .RS 4
 161 .ie n \{\
 162 \h'-04'\(bu\h'+03'\c
 163 .\}
 164 .el \{\
 165 .sp -1
 166 .IP \(bu 2.3
 167 .\}
 168 rawtapedev
 169 \- use
 170 tapedev
 171 instead
 172 .RE
 173 .sp
 174 .RS 4
 175 .ie n \{\
 176 \h'-04'\(bu\h'+03'\c
 177 .\}
 178 .el \{\
 179 .sp -1
 180 .IP \(bu 2.3
 181 .\}
 182 file\-pad
 183 \- this is no longer optional, and all files are padded
 184 .RE
 185 .sp
 186 .RE
 187 .SS "Amanda 2\&.6\&.0"
 188 .PP
 189 amverify
 190 and
 191 amverifyrun
 192 are removed and replaced with
 193 \fBamcheckdump\fR(8)\&. Both
 194 amdd
 195 and
 196 ammt
 197 are removed\&.
 198 .PP
 199 Some Amanda files are now installed in new
 200 amanda/
 201 subdirectories: libraries are now installed in
 202 $libdir/amanda
 203 and internal programs are now installed in
 204 $libexecdir/amanda\&.
 205 .PP
 206 The amandates file, previously at
 207 /etc/amandates, is now at
 208 $localstatedir/amanda/amandates\&. You may want to move your existing
 209 /etc/amandates
 210 when you upgrade Amanda\&.
 211 .PP
 212 GLib is now required to build and run Amanda\&.
 213 .SH "SEE ALSO"
 214 .PP
 215 \fBamanda\fR(8),
 216 \fBamanda.conf\fR(5)
 217 .PP
 218 The Amanda Wiki:
 219 : http://wiki.zmanda.com/
 220 .SH "AUTHOR"
 221 .PP
 222 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
 223 .RS 4
 224 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
 225 .RE