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.1</title>
  68
  69 <para>Although it is a significant rewrite, there are no incompatible changes
  70 in this release.</para>
  71
  72 <para>Old-style changer scripts are deprecated in this release.  While they
  73 remain available, they may be removed in a future release.  Consider
  74 upgrading to one of the new changer scripts.  Users of
  75 <emphasis>chg-zd-mtx</emphasis> are particularly encouraged to consider the
  76 much more intelligent <emphasis>chg-robot</emphasis>.  See <manref
  77 name="amanda-changers" vol="7" /> for more information.</para>
  78
  79 <para>The following configuration configration keywords are deprecated.  This is
  80 currently a warning, but will become an error soon.
  81 <itemizedlist>
  82 <listitem><para><computeroutput>label_new_tapes</computeroutput> - use <computeroutput>autolabel</computeroutput></para></listitem>
  83 </itemizedlist>
  84 </para>
  85
  86 </refsect2>
  87
  88 <refsect2><title>Amanda 2.6.1</title>
  89
  90 <para>There are no incompatible changes in this release, but consider switching
  91 to some of the new applications instead of the old GNUTAR and DUMP
  92 programs.</para>
  93
  94 <para>The following configuration configration keywords are deprecated.  This is
  95 currently a warning, but will become an error soon.
  96 <itemizedlist>
  97 <listitem><para><computeroutput>tapebufs</computeroutput> - use <computeroutput>device-output-buffer-size</computeroutput> instead</para></listitem>
  98 <listitem><para><computeroutput>rawtapedev</computeroutput> - use <computeroutput>tapedev</computeroutput> instead</para></listitem>
  99 <listitem><para><computeroutput>file-pad</computeroutput> - this is no longer optional, and all files are padded</para></listitem>
 100 </itemizedlist>
 101 </para>
 102
 103 </refsect2>
 104
 105 <refsect2><title>Amanda 2.6.0</title>
 106
 107 <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>
 108
 109 <para>Some Amanda files are now installed in new <filename>amanda/</filename>
 110 subdirectories: libraries are now installed in
 111 <filename>$libdir/amanda</filename> and internal programs are now installed in
 112 <filename>$libexecdir/amanda</filename>.</para>
 113
 114 <para> The amandates file, previously at <filename>/etc/amandates</filename>,
 115 is now at <filename>$localstatedir/amanda/amandates</filename>.  You may want
 116 to move your existing <filename>/etc/amandates</filename> when you upgrade
 117 Amanda.</para>
 118
 119 <para>GLib is now required to build and run Amanda.</para>
 120
 121 </refsect2>
 122
 123 </refsect1>
 124
 125 <seealso>
 126 <manref name="amanda.conf" vol="5"/>,
 127 </seealso>
 128
 129
 130 </refentry>