amrestore - extract files from an Amanda tape
SYNOPSIS
amrestore [ -r | -c ] [ -p ] [ -h ] tapedevice [ hostname
[ diskname [ datestamp [ hostname [ diskname [ datestamp
... ]]]]]]
DESCRIPTION
Amrestore extracts files from the tape mounted on tapede-
vice that match hostname, diskname and datestamp patterns
given on the command line. The tape must be in a format
written by the amdump or amflush program.
If diskname is not specified, all backups on the tape for
the previous hostname are candidates. If datestamp is not
specified, all backups on the tape for the previous host-
name and diskname are candidates. If no hostname,
diskname or datestamp are specified, every backup on the
tape is a candidate.
Hostname, diskname and datestamp are regular expressions
that may match more than one backup. For example, if
diskname is "rz[23]a", it would match disks rz2a and rz3a.
Hostname, diskname or datestamp may be an empty string
("") to match every host, disk or date (this is just an
abbreviation for ".*").
Datestamp is useful if you have multiple amflush runs on
the tape.
Unless -p is used, candidate backup files are extracted to
files in the current directory named:
hostname.diskname.datestamp.dumplevel
OPTIONS
-p Pipe output. The first matching backup file is
sent to standard output, which is normally a pipe
to restore or tar, then amrestore quits. It may be
run again to continue selecting backups to process.
Make sure you specify the no-rewind tapedevice when
doing this.
Note: restore may report "short read" errors when
reading from a pipe. Most versions of restore sup-
port a blocking factor option to let you set the
read block size, and you should set it to 2. See
the example below.
-c Compress output. Amrestore normally writes output
files in a format understood by restore or tar,
even if the backups on the tape are compressed.
are not compressed. Output file names will have a
.Z extension. This option is useful when the cur-
rent directory disk is small.
-r Raw output. Backup files are output exactly as
they are on the tape, including the amdump file
headers. Output file names will have a .RAW exten-
sion. This option is only useful for debugging and
other strange circumstances.
-h Header output. The tape header block is output at
the beginning of each file. This is like -r except
-c may also be used to compress the result. Amre-
cover uses the header to determine the restore pro-
gram to use.
EXAMPLES
The following does an interactive restore of disk rz3g
from host seine, to restore particular files. Note the
use of the b option to restore, which causes it to read in
units of two 512-byte blocks (1 Kbyte) at a time. This
keeps it from complaining about short reads.
% amrestore -p /dev/nrmt9 seine rz3g | restore ivbf 2 -
The next example extracts all backup files for host seine.
This is the usual way to extract all data for a host after
a disk crash.
% amrestore /dev/nrmt9 seine
If the backup datestamp in the above example is 19910125
and seine has level 0 backups of disks rz1a and rz1g on
the tape, these files will be created in the current
directory:
seine.rz1a.19910125.0
seine.rz1g.19910125.0
AUTHOR
James da Silva <jds@cs.umd.edu>
University of Maryland, College Park
SEE ALSO
amanda(8), amdump(8), amflush(8), restore(8)