Imported Upstream version 3.3.2

[debian/amanda] / man / amanda-compatibility.7

diff --git a/man/amanda-compatibility.7 b/man/amanda-compatibility.7
index cc9f4085eca5ff7d0e36181002a55d46e176db33..afea373248bb71572fa83dd1b78226325ce7eea3 100644 (file)
--- a/man/amanda-compatibility.7
+++ b/man/amanda-compatibility.7
@@ -1,13 +1,22 @@
 '\" t
 .\"     Title: amanda-compatibility
 .\"    Author: Dustin J. Mitchell <dustin@zmanda.com>
-.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
-.\"      Date: 06/01/2010
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
+.\"      Date: 07/25/2012
 .\"    Manual: Miscellanea
-.\"    Source: Amanda 3.1.0
+.\"    Source: Amanda 3.3.2
 .\"  Language: English
 .\"
-.TH "AMANDA\-COMPATIBILIT" "7" "06/01/2010" "Amanda 3\&.1\&.0" "Miscellanea"
+.TH "AMANDA\-COMPATIBILIT" "7" "07/25/2012" "Amanda 3\&.3\&.2" "Miscellanea"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
@@ -32,7 +41,7 @@ Amanda 2\&.5\&.0 uses the same protocol as 2\&.4\&. One can use a 2\&.5\&.0 serv
 .PP
 Kerberos4 authentication in 2\&.5 is compatible with 2\&.4\&. In 2\&.5, kerberos4 encryption is broken, at least for the server\&.
 .PP
-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\&.
+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\&.
 .PP
 Amanda 2\&.6\&.0 and later are completely compatible with 2\&.5\&.1\&.
 .PP
@@ -40,6 +49,75 @@ To restore a dump created with the tapesplit_size option using amrecover, you ne
 .SH "UPGRADES"
 .PP
 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\&.
+.SS "Amanda 3\&.2"
+.PP
+The following configuration configration keywords are deprecated\&. This is currently a warning, but will become an error soon\&.
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamrecover\-do\-fsf\fR
+\- amrecover always seeks to files when recovering
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamrecover\-check\-label\fR
+\- amrecover always checks the volume label when recovering
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Dumptype parameters
+\fBtape\-splitsize\fR,
+\fBsplit\-diskbuffer\fR, and
+\fBfallback\-splitsize\fR
+\- see
+\fBallow\-split\fR
+and tapetype parameters
+\fBpart\-size\fR,
+\fBpart\-cache\-type\fR,
+\fBpart\-cache\-dir\fR, and
+\fBpart\-cache\-max\-size\fR\&. See
+\fBamanda.conf\fR(5)
+for more information on these new parameters, noting particularly that all but the first are tapetype parameters, not dumptype parameters\&.
+.sp
+To convert most cases to the new parameters, set
+\fBpart\-size\fR
+to the old value of
+\fBtape\-splitsize\fR
+and
+\fBpart\-cache\-dir\fR
+to the old value of
+\fBsplit\-diskbuffer\fR, if present\&. If
+\fBsplit\-diskbuffer\fR
+was set, then set
+\fBpart\-cache\-type\fR
+to
+\fBdisk\fR, otherwise
+\fBmemory\fR\&. Finally, if using memory caching, set
+\fBpart\-cache\-max\-size\fR
+to the previous value of
+\fBfallback\-splitsize\fR\&. Be sure to remove all of the old keywords from your configuration\&.
+.RE
+.sp
 .SS "Amanda 3\&.1"
 .PP
 Although it is a significant rewrite, there are no incompatible changes in this release\&.
@@ -51,7 +129,7 @@ are particularly encouraged to consider the much more intelligent
 \fBamanda-changers\fR(7)
 for more information\&.
 .PP
-The following configuration configration keywords are deprecated\&. This is currently a warning, but will become an error soon\&.
+The following configuration configration keywords are deprecated\&. This is currently a warning, but will become an error in a future version\&.
 .sp
 .RS 4
 .ie n \{\
@@ -66,7 +144,6 @@ label_new_tapes
 autolabel
 .RE
 .sp
-.RE
 .SS "Amanda 2\&.6\&.1"
 .PP
 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\&.
@@ -113,7 +190,6 @@ file\-pad
 \- this is no longer optional, and all files are padded
 .RE
 .sp
-.RE
 .SS "Amanda 2\&.6\&.0"
 .PP
 amverify