Amrestore is a very low-level tool for extracting data from Amanda volumes. It does not consult any catalog information or other metadata, basing its operations only on the headers found on the volume. This makes it an appropriate tool for bare-metal restores of an Amanda server, or other situations where the catalog is not available.
See amfetchdump(8) and amrecover(8) for higher-level recoveries.
The tool does not reassemble split dumps, but can uncompress compressed dumps. Note that decompression may fail for split parts after the first. If this occurs, extract the parts without decompressing, concatenate them, and decompress the result.
Data is restored from the current volume in changerspec, or from the holding file holdingfile. In most cases, changerspec will name a particular device, e.g., tape:/dev/nst0 or s3:mybucket/tape-1.
Only dumps matching the dump specification beginning with hostname are extracted. If no specification is given, every file on the volume (or the entire holdingfile) is restored. See the "DUMP SPECIFICATIONS" section of amanda-match(7) for more information.
Unless -p is used, candidate backup images are extracted to files in the current directory named: hostname.diskname.datestamp.dumplevel
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 helps keep it from complaining about short reads.
amrestore -p /dev/nrmt9 seine rz3g | tar -xv
The next example extracts all backup images for host seine. This is a typical 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 20070125 and seine has level 0 backups of disks rz1a and rz1g on the tape, these files will be created in the current directory:
You may also use amrestore to extract a backup image from a holding disk file that has not yet been flushed to tape:
amrestore -p /amanda/20001119/seine.rz1a.2 | tar -xv
GNU-tar must be used to restore files from backup images created with the GNUTAR dumptype. Vendor tar programs sometimes fail to read GNU Tar images.
amanda(8), amanda-match(7), amfetchdump(8), amrecover(8)
The Amanda Wiki: : http://wiki.zmanda.com/
James da Silva <email@example.com>
Stefan G. Weichinger <firstname.lastname@example.org>
Dustin J. Mitchell <email@example.com>