git.gag.com Git - debian/amanda/blob - man/amrmtape.8

   1 '\" t
   2 .\"     Title: amrmtape
   3 .\"    Author: Adrian T. Filipi-Martin <atf3r@cs.virginia.edu>
   4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
   5 .\"      Date: 01/10/2013
   6 .\"    Manual: System Administration Commands
   7 .\"    Source: Amanda 3.3.3
   8 .\"  Language: English
   9 .\"
  10 .TH "AMRMTAPE" "8" "01/10/2013" "Amanda 3\&.3\&.3" "System Administration Commands"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 amrmtape \- remove a tape from the Amanda database
  32 .SH "SYNOPSIS"
  33 .HP \w'\fBamrmtape\fR\ 'u
  34 \fBamrmtape\fR [\-\-changer\ \fIchanger\-name\fR] [\-\-cleanup] [\-\-dryrun] [\-n] [\-\-erase] [\-\-keep\-label] [\-\-quiet] [\-q] [\-\-verbose] [\-v] \fIconfig\fR \fIlabel\fR
  35 .SH "DESCRIPTION"
  36 .PP
  37 \fBAmrmtape\fR
  38 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\&.
  39 .PP
  40 See the
  41 \fBamanda\fR(8)
  42 man page for more details about Amanda\&.
  43 .SH "OPTIONS"
  44 .PP
  45 \fB\-\-changer \fR\fB\fIchanger\-name\fR\fR\fB \fR
  46 .RS 4
  47 Specify which changer to use when erasing
  48 \fIlabel\fR
  49 .RE
  50 .PP
  51 \fB\-\-cleanup\fR
  52 .RS 4
  53 Remove logs and indexes associated with
  54 \fIlabel\fR\&. Otherwise, they\*(Aqll remain until the next run of amdump\&.
  55 .RE
  56 .PP
  57 \fB\-\-dryrun\fR, \fB\-n\fR
  58 .RS 4
  59 Generate new
  60 \fBtapelist\fR(5)
  61 and database files with
  62 \fIlabel\fR
  63 removed, but leave them in
  64 /tmp
  65 and do not update the original copies\&.
  66 .RE
  67 .PP
  68 \fB\-\-erase\fR
  69 .RS 4
  70 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\&.
  71 .RE
  72 .PP
  73 \fB\-\-keep\-label\fR
  74 .RS 4
  75 Do not remove
  76 \fIlabel\fR
  77 from the tapelist\&.
  78 .RE
  79 .PP
  80 \fB\-\-verbose\fR, \fB\-v\fR
  81 .RS 4
  82 List backups of hosts and disks that are being discarded\&. Enabled by default\&.
  83 .RE
  84 .PP
  85 \fB\-\-quiet\fR, \fB\-q\fR
  86 .RS 4
  87 Opposite of
  88 \fB\-v\fR\&.
  89 .RE
  90 .SH "EXAMPLE"
  91 .PP
  92 Remove tape labeled
  93 \fIDAILY034\fR
  94 from the
  95 \fIDailySet1\fR
  96 configuration\&.
  97 .nf
  98 # amrmtape DailySet1 DAILY034
  99 .fi
 100 .SH "SEE ALSO"
 101 .PP
 102 \fBamanda\fR(8),
 103 \fBamadmin\fR(8)
 104 .PP
 105 The Amanda Wiki:
 106 : http://wiki.zmanda.com/
 107 .SH "AUTHORS"
 108 .PP
 109 \fBAdrian T\&. Filipi\-Martin\fR <\&atf3r@cs\&.virginia\&.edu\&>
 110 .PP
 111 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>