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 v1.76.1 <http://docbook.sf.net/>
   5 .\"      Date: 07/25/2012
   6 .\"    Manual: Miscellanea
   7 .\"    Source: Amanda 3.3.2
   8 .\"  Language: English
   9 .\"
  10 .TH "AMANDA\-COMPATIBILIT" "7" "07/25/2012" "Amanda 3\&.3\&.2" "Miscellanea"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 amanda-compatibility \- Compatibility between Amanda versions
  32 .SH "NETWORK COMPATIBILITY"
  33 .PP
  34 Amanda has used several on\-the\-wire protocols to communicate between the server and backup clients, and not all of them have been compatible\&.
  35 .PP
  36 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\&.
  37 .PP
  38 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\&.
  39 .PP
  40 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\&.
  41 .PP
  42 Kerberos4 authentication in 2\&.5 is compatible with 2\&.4\&. In 2\&.5, kerberos4 encryption is broken, at least for the server\&.
  43 .PP
  44 Amanda 2\&.5\&.1 introduced a new recover protocol\&. Backup communication works with any combination of versions, but 2\&.5\&.1\*(Aqs amrecover cannot communicate with an older server\&. Use oldamrecover on 2\&.5\&.1 and higher clients when communicating with an older server\&.
  45 .PP
  46 Amanda 2\&.6\&.0 and later are completely compatible with 2\&.5\&.1\&.
  47 .PP
  48 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\&.)
  49 .SH "UPGRADES"
  50 .PP
  51 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\&.
  52 .SS "Amanda 3\&.2"
  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 \fBamrecover\-do\-fsf\fR
  65 \- amrecover always seeks to files when recovering
  66 .RE
  67 .sp
  68 .RS 4
  69 .ie n \{\
  70 \h'-04'\(bu\h'+03'\c
  71 .\}
  72 .el \{\
  73 .sp -1
  74 .IP \(bu 2.3
  75 .\}
  76 \fBamrecover\-check\-label\fR
  77 \- amrecover always checks the volume label when recovering
  78 .RE
  79 .sp
  80 .RS 4
  81 .ie n \{\
  82 \h'-04'\(bu\h'+03'\c
  83 .\}
  84 .el \{\
  85 .sp -1
  86 .IP \(bu 2.3
  87 .\}
  88 Dumptype parameters
  89 \fBtape\-splitsize\fR,
  90 \fBsplit\-diskbuffer\fR, and
  91 \fBfallback\-splitsize\fR
  92 \- see
  93 \fBallow\-split\fR
  94 and tapetype parameters
  95 \fBpart\-size\fR,
  96 \fBpart\-cache\-type\fR,
  97 \fBpart\-cache\-dir\fR, and
  98 \fBpart\-cache\-max\-size\fR\&. See
  99 \fBamanda.conf\fR(5)
 100 for more information on these new parameters, noting particularly that all but the first are tapetype parameters, not dumptype parameters\&.
 101 .sp
 102 To convert most cases to the new parameters, set
 103 \fBpart\-size\fR
 104 to the old value of
 105 \fBtape\-splitsize\fR
 106 and
 107 \fBpart\-cache\-dir\fR
 108 to the old value of
 109 \fBsplit\-diskbuffer\fR, if present\&. If
 110 \fBsplit\-diskbuffer\fR
 111 was set, then set
 112 \fBpart\-cache\-type\fR
 113 to
 114 \fBdisk\fR, otherwise
 115 \fBmemory\fR\&. Finally, if using memory caching, set
 116 \fBpart\-cache\-max\-size\fR
 117 to the previous value of
 118 \fBfallback\-splitsize\fR\&. Be sure to remove all of the old keywords from your configuration\&.
 119 .RE
 120 .sp
 121 .SS "Amanda 3\&.1"
 122 .PP
 123 Although it is a significant rewrite, there are no incompatible changes in this release\&.
 124 .PP
 125 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
 126 \fIchg\-zd\-mtx\fR
 127 are particularly encouraged to consider the much more intelligent
 128 \fIchg\-robot\fR\&. See
 129 \fBamanda-changers\fR(7)
 130 for more information\&.
 131 .PP
 132 The following configuration configration keywords are deprecated\&. This is currently a warning, but will become an error in a future version\&.
 133 .sp
 134 .RS 4
 135 .ie n \{\
 136 \h'-04'\(bu\h'+03'\c
 137 .\}
 138 .el \{\
 139 .sp -1
 140 .IP \(bu 2.3
 141 .\}
 142 label_new_tapes
 143 \- use
 144 autolabel
 145 .RE
 146 .sp
 147 .SS "Amanda 2\&.6\&.1"
 148 .PP
 149 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\&.
 150 .PP
 151 The following configuration configration keywords are deprecated\&. This is currently a warning, but will become an error soon\&.
 152 .sp
 153 .RS 4
 154 .ie n \{\
 155 \h'-04'\(bu\h'+03'\c
 156 .\}
 157 .el \{\
 158 .sp -1
 159 .IP \(bu 2.3
 160 .\}
 161 tapebufs
 162 \- use
 163 device\-output\-buffer\-size
 164 instead
 165 .RE
 166 .sp
 167 .RS 4
 168 .ie n \{\
 169 \h'-04'\(bu\h'+03'\c
 170 .\}
 171 .el \{\
 172 .sp -1
 173 .IP \(bu 2.3
 174 .\}
 175 rawtapedev
 176 \- use
 177 tapedev
 178 instead
 179 .RE
 180 .sp
 181 .RS 4
 182 .ie n \{\
 183 \h'-04'\(bu\h'+03'\c
 184 .\}
 185 .el \{\
 186 .sp -1
 187 .IP \(bu 2.3
 188 .\}
 189 file\-pad
 190 \- this is no longer optional, and all files are padded
 191 .RE
 192 .sp
 193 .SS "Amanda 2\&.6\&.0"
 194 .PP
 195 amverify
 196 and
 197 amverifyrun
 198 are removed and replaced with
 199 \fBamcheckdump\fR(8)\&. Both
 200 amdd
 201 and
 202 ammt
 203 are removed\&.
 204 .PP
 205 Some Amanda files are now installed in new
 206 amanda/
 207 subdirectories: libraries are now installed in
 208 $libdir/amanda
 209 and internal programs are now installed in
 210 $libexecdir/amanda\&.
 211 .PP
 212 The amandates file, previously at
 213 /etc/amandates, is now at
 214 $localstatedir/amanda/amandates\&. You may want to move your existing
 215 /etc/amandates
 216 when you upgrade Amanda\&.
 217 .PP
 218 GLib is now required to build and run Amanda\&.
 219 .SH "SEE ALSO"
 220 .PP
 221 \fBamanda\fR(8),
 222 \fBamanda.conf\fR(5)
 223 .PP
 224 The Amanda Wiki:
 225 : http://wiki.zmanda.com/
 226 .SH "AUTHOR"
 227 .PP
 228 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
 229 .RS 4
 230 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
 231 .RE