git.gag.com Git - debian/amanda/blob - man/xml-source/amvault.8.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='amvault.8'>
  11 <refmeta>
  12 <refentrytitle>amvault</refentrytitle>
  13 <manvolnum>8</manvolnum>
  14 &rmi.source;
  15 &rmi.version;
  16 &rmi.manual.8;
  17 </refmeta>
  18 <refnamediv>
  19 <refname>amvault</refname>
  20 <refpurpose>Copy &A; dumps from one volume to another</refpurpose>
  21 </refnamediv>
  22 <refentryinfo>
  23 &author.dustin;
  24 </refentryinfo>
  25 <!-- body begins here -->
  26 <refsynopsisdiv>
  27 <cmdsynopsis>
  28   <command>amvault</command>
  29     <arg choice='plain' rep='repeat'><group><arg choice='plain'>-o </arg><replaceable>configoption</replaceable></group></arg>
  30     <arg choice='plain'><replaceable>config</replaceable></arg>
  31     <arg choice='plain'><replaceable>src-run-timestamp</replaceable></arg>
  32     <arg choice='plain'><replaceable>dst-changer</replaceable></arg>
  33     <arg choice='plain'><replaceable>label-template</replaceable></arg>
  34 </cmdsynopsis>
  35 </refsynopsisdiv>
  36
  37 <refsect1><title>WARNING</title>
  38 <para>This application is not yet in its final form, and is subject to major revision
  39 in subsequent versions of Amanda.  Backward compatibility is not guaranteed.</para>
  40
  41 <para>The significant limitations of this version of amvault are: tapetypes for
  42 secondary and tertiary volumes much match (including length and
  43 device_properties); tertiary volumes must be blank (manual erasure is required
  44 to re-use tertiary media; restore/recover operations will request tertiary
  45 media by label when dumpfiles are not found on secondary media, but there is no
  46 provision to automatically fetch such media from a different changer; and all
  47 dumpfiles on a secondary volume are moved to tertiary media - there is no
  48 provision to filter dumps.</para>
  49
  50 <para>Feedback on and patches to this application are invited and
  51 encouraged!</para>
  52
  53 </refsect1>
  54
  55 <refsect1><title>DESCRIPTION</title>
  56
  57 <para><emphasis remap='B'>Amvault</emphasis> Copies data from the run with
  58 timestamp <emphasis remap='I'>src-run-timestamp</emphasis> onto volumes using
  59 the changer <emphasis remap='I'>dst-changer</emphasis>, labeling new volumes
  60 with <emphasis remap='I'>label-template</emphasis>.  If <emphasis
  61 remap='I'>src-run-timestamp</emphasis> is "latest", then the most recent amdump
  62 or amflush run will be used.</para>
  63
  64 <para>In a vaulting operation, the source media is referred to as "secondary
  65 media", while the destination is referred to as "tertiary media".</para>
  66
  67 <para>Each source volume will be copied to a new destination volume; no
  68 re-assembly or splitting will be performed.  Destination volumes must be at
  69 least as large as the source volumes.</para>
  70
  71 <para>The changer parameter should specify the name of a changer defined in
  72 &amconf;.  For example:
  73 <programlisting>
  74 define changer vaulting_tape {
  75     tapedev "/dev/rmt/1n"
  76     tpchanger "chg-zd-mtx"
  77     changerdev "/dev/sg0"
  78     changerfile "vaulting-changer.conf"
  79 }
  80 </programlisting></para>
  81
  82 <para>The label template functions identically to the <emphasis
  83 remap='I'>label-new-tapes</emphasis> parameter in &amconf;.</para>
  84
  85 </refsect1>
  86
  87 <refsect1><title>SEE ALSO</title>
  88 <para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>
  89 </refsect1>
  90 </refentry>
  91