1AMRESTORE(8) System Administration Commands AMRESTORE(8)
2
3
4
6 amrestore - low-level data-extraction from Amanda volumes
7
9 amrestore [--config config] [-r | -c | -C] [-b blocksize] [-f filenum]
10 [-l label] [-p] [-h] [--exact-match]
11 [--continue-on-filter-error] [-o configoption...]
12 [{changerspec} | {[--holding] holdingfile}]
13 [hostname [ diskname [ datestamp [ hostname [ diskname [ datestamp ... ] ] ] ] ]]
14
15 Note that this is the only Amanda command which does not take a
16 configuration name as its first argument.
17
19 Amrestore is a very low-level tool for extracting data from Amanda
20 volumes. It does not consult any catalog information or other metadata,
21 basing its operations only on the headers found on the volume. This
22 makes it an appropriate tool for bare-metal restores of an Amanda
23 server, or other situations where the catalog is not available.
24
25 See amfetchdump(8) and amrecover(8) for higher-level recoveries.
26
27 The tool does not reassemble split dumps, but can uncompress compressed
28 dumps. Note that decompression may fail for split parts after the
29 first. If this occurs, extract the parts without decompressing,
30 concatenate them, and decompress the result.
31
32 Data is restored from the current volume in changerspec, or from the
33 holding file holdingfile. In most cases, changerspec will name a
34 particular device, e.g., tape:/dev/nst0 or s3:mybucket/tape-1.
35
36 Only dumps matching the dump specification beginning with hostname are
37 extracted. If no specification is given, every file on the volume (or
38 the entire holdingfile) is restored. See the "DUMP SPECIFICATIONS"
39 section of amanda-match(7) for more information.
40
41 Unless -p is used, candidate backup images are extracted to files in
42 the current directory named: hostname.diskname.datestamp.dumplevel
43
45 -b blocksize
46 Use the given blocksize to read the volume. The default is defined
47 by the device.
48
49 -f filenum
50 Seek to file filenum before beginning the restore operation.
51
52 -l label
53 Check that the volume has label label.
54
55 -p
56 Pipe the first matching file to standard output. This is typically
57 used in a shell pipeline to send the data to a process like tar for
58 extraction.
59
60 -c, -C
61 If the file is not already compressed, compress it using the
62 fastest (-c) or best (-C) compression algorithm. Note that
63 amrestore will not re-compress an already-compressed file. Without
64 either of these options, amrestore will automatically uncompress
65 any compressed files. This option is useful when the destination
66 disk is small.
67
68 -h
69 Include 32k headers on all output files, similar to a holding file.
70 This header can be read by another application or utility (see
71 Amanda::Header) during the next phase of processing.
72
73 -r
74 Output raw files. This is similar to -h, but also disables any
75 automatic decompression and/or decryption. Output file names will
76 have a .RAW extension.
77
78 --exact-match
79 The host and disk are parsed as exact values.
80
81 --continue-on-filter-error
82 continue to the next dump if a filter (decompression/decryption)
83 fail.
84
85 -o configoption
86 See the "CONFIGURATION OVERRIDE" section in amanda(8).
87
89 The following does an interactive restore of disk rz3g from host seine,
90 to restore particular files. Note the use of the b option to restore,
91 which causes it to read in units of two 512-byte blocks (1 Kbyte) at a
92 time. This helps keep it from complaining about short reads.
93 amrestore -p /dev/nrmt9 seine rz3g | tar -xv
94
95 The next example extracts all backup images for host seine. This is a
96 typical way to extract all data for a host after a disk crash.
97 amrestore /dev/nrmt9 seine
98
99 If the backup datestamp in the above example is 20070125 and seine has
100 level 0 backups of disks rz1a and rz1g on the tape, these files will be
101 created in the current directory:
102 seine.rz1a.19910125.0
103 seine.rz1g.19910125.0
104
105 You may also use amrestore to extract a backup image from a holding
106 disk file that has not yet been flushed to tape:
107 amrestore -p /amanda/20001119/seine.rz1a.2 | tar -xv
108
110 GNU-tar must be used to restore files from backup images created with
111 the GNUTAR dumptype. Vendor tar programs sometimes fail to read GNU Tar
112 images.
113
115 amanda(8), amanda-match(7), amfetchdump(8), amrecover(8)
116
117 The Amanda Wiki: : http://wiki.zmanda.com/
118
120 James da Silva <jds@amanda.org>
121
122 Stefan G. Weichinger <sgw@amanda.org>
123
124 Dustin J. Mitchell <dustin@zmanda.com>
125 Zmanda, Inc. (http://www.zmanda.com)
126
127
128
129Amanda 3.5.1 12/01/2017 AMRESTORE(8)