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

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
   3                    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
   4 [
   5   <!-- entities files to use -->
   6   <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
   7   %global_entities;
   8 ]>
   9
  10 <refentry id='amanda-compatibility.7'>
  11
  12 <refmeta>
  13 <refentrytitle>amanda-compatibility</refentrytitle>
  14 <manvolnum>7</manvolnum>
  15 &rmi.source;
  16 &rmi.version;
  17 &rmi.manual.7;
  18 </refmeta>
  19 <refnamediv>
  20 <refname>amanda-compatibility</refname>
  21 <refpurpose>Compatibility between Amanda versions</refpurpose>
  22 </refnamediv>
  23 <refentryinfo>
  24 &author.dustin;
  25 </refentryinfo>
  26 <!-- body begins here -->
  27
  28 <refsect1><title>NETWORK COMPATIBILITY</title>
  29
  30 <para>Amanda has used several on-the-wire protocols to communicate between the
  31 server and backup clients, and not all of them have been compatible.</para>
  32
  33 <para>Versions of Amanda prior to about 2.3 used a different protocol which is
  34 not compatible. 2.3 is very old so this is not of general interest.</para>
  35
  36 <para>The Amanda 2.4 series all use the same protocol. This protocol has
  37 support for extensibility. Generally upgrading clients or servers along the 2.4
  38 branch does not cause difficulty.</para>
  39
  40 <para>Amanda 2.5.0 uses the same protocol as 2.4. One can use a 2.5.0 server
  41 with 2.4 clients and a 2.4 server with 2.5.0 clients.</para>
  42
  43 <para>Kerberos4 authentication in 2.5 is compatible with 2.4. In 2.5, kerberos4
  44 encryption is broken, at least for the server.</para>
  45
  46 <para>Amanda 2.5.1 introduced a new recover protocol. Backup communication
  47 works with any combination of versions, but 2.5.1's amrecover cannot
  48 communicate with an older server. Use oldamrecover on 2.5.1 and higher clients
  49 when communicating with an older server.</para>
  50
  51 <para>Amanda 2.6.0 and later are completely compatible with 2.5.1.</para>
  52
  53 <para>To restore a dump created with the tapesplit_size option using amrecover,
  54 you need at least a 2.5 server and late-2.4 client. (Extracting that backup
  55 using only shell, mt and dd is also possible.)</para>
  56
  57 </refsect1>
  58
  59 <refsect1><title>UPGRADES</title>
  60
  61 <para>The recommended course for Amanda upgrades is to upgrade the server
  62 first, and test backups and restores before upgrading clients.  Consult the
  63 changes described below for the relevant span of versions to determine what
  64 adjustments, if any, are required.  Also see the NEWS file shipped with
  65 each Amanda release for more detailed information.</para>
  66
  67 <refsect2><title>Amanda 3.2</title>
  68
  69 <para>The following configuration configration keywords are deprecated.  This is
  70 currently a warning, but will become an error soon.
  71 <itemizedlist>
  72 <listitem><para><amkeyword>amrecover-do-fsf</amkeyword> - amrecover always seeks to files when recovering</para></listitem>
  73 <listitem><para><amkeyword>amrecover-check-label</amkeyword> - amrecover always checks the volume label when recovering</para></listitem>
  74 <listitem>
  75
  76     <para>Dumptype parameters <amkeyword>tape-splitsize</amkeyword>,
  77         <amkeyword>split-diskbuffer</amkeyword>, and
  78         <amkeyword>fallback-splitsize</amkeyword> - see
  79         <amkeyword>allow-split</amkeyword> and tapetype parameters
  80         <amkeyword>part-size</amkeyword>,
  81         <amkeyword>part-cache-type</amkeyword>,
  82         <amkeyword>part-cache-dir</amkeyword>, and
  83         <amkeyword>part-cache-max-size</amkeyword>.  See <manref
  84             name="amanda.conf" vol="5" /> for more information on these new
  85         parameters, noting particularly that all but the first are tapetype
  86         parameters, not dumptype parameters.</para>
  87
  88     <para>To convert most cases to the new parameters, set
  89         <amkeyword>part-size</amkeyword> to the old value of
  90         <amkeyword>tape-splitsize</amkeyword> and
  91         <amkeyword>part-cache-dir</amkeyword> to the old value of
  92         <amkeyword>split-diskbuffer</amkeyword>, if present.  If
  93         <amkeyword>split-diskbuffer</amkeyword> was set, then set
  94         <amkeyword>part-cache-type</amkeyword> to <amkeyword>disk</amkeyword>,
  95         otherwise <amkeyword>memory</amkeyword>.  Finally, if using memory
  96         caching, set <amkeyword>part-cache-max-size</amkeyword> to the previous
  97         value of <amkeyword>fallback-splitsize</amkeyword>.  Be sure to remove
  98         all of the old keywords from your configuration.</para>
  99
 100 </listitem>
 101 </itemizedlist>
 102 </para>
 103
 104 </refsect2>
 105
 106 <refsect2><title>Amanda 3.1</title>
 107
 108 <para>Although it is a significant rewrite, there are no incompatible changes
 109 in this release.</para>
 110
 111 <para>Old-style changer scripts are deprecated in this release.  While they
 112 remain available, they may be removed in a future release.  Consider
 113 upgrading to one of the new changer scripts.  Users of
 114 <emphasis>chg-zd-mtx</emphasis> are particularly encouraged to consider the
 115 much more intelligent <emphasis>chg-robot</emphasis>.  See <manref
 116 name="amanda-changers" vol="7" /> for more information.</para>
 117
 118 <para>The following configuration configration keywords are deprecated.  This is
 119 currently a warning, but will become an error in a future version.
 120 <itemizedlist>
 121 <listitem><para><computeroutput>label_new_tapes</computeroutput> - use <computeroutput>autolabel</computeroutput></para></listitem>
 122 </itemizedlist>
 123 </para>
 124
 125 </refsect2>
 126
 127 <refsect2><title>Amanda 2.6.1</title>
 128
 129 <para>There are no incompatible changes in this release, but consider switching
 130 to some of the new applications instead of the old GNUTAR and DUMP
 131 programs.</para>
 132
 133 <para>The following configuration configration keywords are deprecated.  This is
 134 currently a warning, but will become an error soon.
 135 <itemizedlist>
 136 <listitem><para><computeroutput>tapebufs</computeroutput> - use <computeroutput>device-output-buffer-size</computeroutput> instead</para></listitem>
 137 <listitem><para><computeroutput>rawtapedev</computeroutput> - use <computeroutput>tapedev</computeroutput> instead</para></listitem>
 138 <listitem><para><computeroutput>file-pad</computeroutput> - this is no longer optional, and all files are padded</para></listitem>
 139 </itemizedlist>
 140 </para>
 141
 142 </refsect2>
 143
 144 <refsect2><title>Amanda 2.6.0</title>
 145
 146 <para><filename>amverify</filename> and <filename>amverifyrun</filename> are removed and replaced with <manref name="amcheckdump" vol="8" />.  Both <filename>amdd</filename> and <filename>ammt</filename> are removed.</para>
 147
 148 <para>Some Amanda files are now installed in new <filename>amanda/</filename>
 149 subdirectories: libraries are now installed in
 150 <filename>$libdir/amanda</filename> and internal programs are now installed in
 151 <filename>$libexecdir/amanda</filename>.</para>
 152
 153 <para> The amandates file, previously at <filename>/etc/amandates</filename>,
 154 is now at <filename>$localstatedir/amanda/amandates</filename>.  You may want
 155 to move your existing <filename>/etc/amandates</filename> when you upgrade
 156 Amanda.</para>
 157
 158 <para>GLib is now required to build and run Amanda.</para>
 159
 160 </refsect2>
 161
 162 </refsect1>
 163
 164 <seealso>
 165 <manref name="amanda.conf" vol="5"/>,
 166 </seealso>
 167
 168
 169 </refentry>