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"
5 <!-- entities files to use -->
6 <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
10 <refentry id='amvault.8'>
12 <refentrytitle>amvault</refentrytitle>
13 <manvolnum>8</manvolnum>
19 <refname>amvault</refname>
20 <refpurpose>Copy &A; dumps from one volume to another</refpurpose>
25 <!-- body begins here -->
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>
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>
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>
50 <para>Feedback on and patches to this application are invited and
55 <refsect1><title>DESCRIPTION</title>
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>
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>
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>
71 <para>The changer parameter should specify the name of a changer defined in
72 &amconf;. For example:
74 define changer vaulting_tape {
76 tpchanger "chg-zd-mtx"
78 changerfile "vaulting-changer.conf"
80 </programlisting></para>
82 <para>The label template functions identically to the <emphasis
83 remap='I'>label-new-tapes</emphasis> parameter in &amconf;.</para>
87 <refsect1><title>SEE ALSO</title>
88 <para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>