<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
[
  <!-- entities files to use -->
  <!ENTITY % global_entities SYSTEM 'global.entities'>
  %global_entities;
]>

<!-- lifted from troff+man by doclifter -->
<refentry id='amrmtape.8'>

<refmeta>
<refentrytitle>amrmtape</refentrytitle>
<manvolnum>8</manvolnum>
&rmi.source;
&rmi.version;
&rmi.manual.8;
</refmeta>
<refnamediv>
<refname>amrmtape</refname>
<refpurpose>remove a tape from the Amanda database</refpurpose>
</refnamediv>
<refentryinfo>
&author.atf3r;
&author.sgw.xml;
</refentryinfo>
<!-- body begins here -->
<refsynopsisdiv>
<cmdsynopsis>
  <command>amrmtape</command>
    <arg choice='opt'>--changer <replaceable>changer-name</replaceable> </arg>
    <arg choice='opt'>--cleanup </arg>
    <arg choice='opt'>--dryrun </arg>
    <arg choice='opt'>-n </arg>
    <arg choice='opt'>--erase </arg>
    <arg choice='opt'>--external-copy </arg>
    <arg choice='opt'>--keep-label </arg>
    <arg choice='opt'>--list-retention </arg>
    <arg choice='opt'>--list-no-retention </arg>
    <arg choice='opt'>--remove-no-retention </arg>
    <arg choice='opt'>--quiet </arg>
    <arg choice='opt'>-q </arg>
    <arg choice='opt'>--verbose </arg>
    <arg choice='opt'>-v </arg>
    <arg choice='plain'><replaceable>config</replaceable></arg>
    <arg choice='opt'><replaceable>label</replaceable></arg>*
</cmdsynopsis>
</refsynopsisdiv>


<refsect1><title>DESCRIPTION</title>
<para><emphasis remap='B'>Amrmtape</emphasis>
invalidates the contents of an existing backup tape
in the configuration database.
This is meant as a recovery mechanism when a
good backup is damaged either by faulty hardware or user error,
e.g. the tape is eaten by the drive or is overwritten.</para>

<para>See the
<manref name="amanda" vol="8"/>
man page for more details about Amanda.</para>
</refsect1>

<refsect1><title>OPTIONS</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><option>--changer <replaceable>changer-name</replaceable> </option></term>
  <listitem>
<para>Specify which changer to use when erasing
<emphasis remap='I'>label</emphasis>
</para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term><option>--cleanup</option></term>
  <listitem>
<para>Remove logs and indexes associated with
<emphasis remap='I'>label</emphasis>.
Otherwise, they'll remain until the next run of amdump.
</para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term><option>--dryrun</option></term>
  <term><option>-n</option></term>
  <listitem>
<para>Generate new &tapelist; and database files with
<emphasis remap='I'>label</emphasis>
removed, but leave them in
<filename>/tmp</filename>
and do not update the original copies.</para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term><option>--erase</option></term>
  <listitem>
<para>Attempt to erase the data contained on the volume with the given label.
This requires that Amanda be able to find that volume using the tape changer.
Erasure is not supported by all Amanda devices, and the erasure is not "secure"
in the sense that the data can most likely be recovered by someone with the
right tools.  </para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term><option>--external-copy</option></term>
  <listitem>
<para>The volume is erased but the <emphasis remap='I'>label</emphasis> is kept in
the tapelist and the log file. This function must be used if you manually made a copy
of the volume that you can manually restore.</para>
<para>You should also mark the label as noreuse.</para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term><option>--keep-label</option></term>
  <listitem>
<para>Do not remove
<emphasis remap='I'>label</emphasis>
from the tapelist. The volume become like a new labelled tape and can be
reused by any storage using the same tape-pool.
</para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term><option>--list-retention</option></term>
  <listitem>
<para>List all labels that are required for the policy of each storage.
</para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term><option>--list-no-retention</option></term>
  <listitem>
<para>List all labels that are not required for the policy of each storage.
They are the volumes that can be reused.
</para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term><option>--remove-no-retention</option></term>
  <listitem>
<para>Remove all labels that are not required for the policy of each storage.
Useful with <option>--keep-label</option> and/or <option>--erase</option>.
</para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term><option>--verbose</option></term>
  <term><option>-v</option></term>
  <listitem>
<para>List backups of hosts and disks that are being discarded.  Enabled by default.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>--quiet</option></term>
  <term><option>-q</option></term>
  <listitem>
<para>Opposite of
<option>-v</option>.</para>
  </listitem>
  </varlistentry>
</variablelist>
</refsect1>

<refsect1><title>EXAMPLE</title>
<para>Remove tape labeled
<emphasis remap='I'>DAILY034</emphasis> and
<emphasis remap='I'>DAILY035</emphasis>
from the
<emphasis remap='I'>DailySet1</emphasis>
configuration.</para>

<programlisting>
# amrmtape DailySet1 DAILY034 DAILY035
</programlisting>
</refsect1>

<seealso>
<manref name="amadmin" vol="8"/>
</seealso>

</refentry>