1AMVAULT(8) System Administration Commands AMVAULT(8)
2
3
4
6 amvault - Copy Amanda dumps from one volume to another
7
9 amvault [-o configoption...] [--dry-run | -n] [--quiet | -q]
10 [--fulls-only] [--latest-fulls] [--incrs-only] [--exact-match]
11 [--export] [--no-interactivity] [--src-timestamp src-timestamp]
12 [--src-storage src-storage] [--dest-storage dest-storage]
13 [--no-uniq] [--delayed] [--run-delayed] config
14 [hostname [ disk [ date [ level [ hostname [dumpspec...] ] ] ] ]]
15
17 This application is not yet in its final form, and is subject to major
18 revision in subsequent versions of Amanda. Backward compatibility is
19 not guaranteed.
20
21 Behavior change in 3.5.2: Amvault will not vault a dump if there is
22 already a copy of it on the destination storage.
23
24 Note that Amanda restore/recover operations will request tertiary media
25 by label when dumpfiles are not found on secondary media, but there is
26 no provision to automatically fetch such media from a different changer
27
28 Feedback on and patches to this application are invited and encouraged!
29
31 Amvault is conceptually equivalent to "amfetchdump | taper". That is,
32 it reads specified dumps from secondary media and re-writes them on
33 tertiary media.
34
35 Amvault Copies dumps selected by the specified filters onto volumes on
36 the storage dest-storage.
37
38 Secondary Media
39 The dumps to be read from secondary media can be specified by any
40 combination of dump specifications, --fulls-only, --latest-fulls,
41 --incrs-only, and --src-timestamp. At least one must be specified, lest
42 amvault attempt to vault all dumps in the catalog. See amanda-match(7)
43 for more information on dump specifications.
44
45 Note that the datestamp given in the dumpspec is the dump datestamp -
46 the run in which the backup was taken on the Amanda client. The
47 --src-timestamp, on the other hand, is the write timestamp - the run in
48 which the dump was written to secondary media. The latter option
49 facilitates duplicating the results of an entire backup run, including
50 any dumps that might have been flushed from holding disk.
51
52 Tertiary Media
53 The amvault-storage is the default destination storage.
54
55 If amanda.conf(5) contains the new part-size splitting parameters, then
56 amvault will use them without any additional configuration. However, if
57 the configuration still uses the old splitting parameters
58 (tape_splitsize, split_diskbuffer, and fallback_splitsize), then
59 amvault will need some additional configuration in order to properly
60 split dumps to tertiary media. To do so, specify a new tapetype in
61 amanda.conf(5), say "TERTIARY", and set the part-size and other
62 appropriate parameters there. Then reference that tapetype in the
63 amvault invocation:
64
65 amvault -otapetype=TERTIARY ...
66
68 --dest-storage dest-storage
69 The vaulted dumps are written to the specified storage.
70
71 If the vault-storage option is specified in amanda.conf(5), amvault
72 will use that storage as the default destination. If not, a
73 destination storage must be specified on the amvault command line.
74
75 --dry-run, -n
76 Cause amvault to print the dumps it would vault, but not actually
77 perform any vaulting operations.
78
79 --exact-match
80 The host and disk names in the dumpspecs are parsed as exact
81 values.
82
83 --export
84 Cause amvault to attempt to move completed tertiary volumes to
85 import/export slots, where they can be more easily removed by an
86 operator.
87
88 --fulls-only
89 Only full (level-0) dumps are copied.
90
91 --incrs-only
92 Only incremental (level > 0) dumps are copied.
93
94 --latest-fulls
95 The latest full of every DLE in the disklist that do not have the
96 skip strategy.
97
98 --no-interactivity
99 Disable interactivity if a source or destination volume is not
100 found.
101
102 --no-uniq
103 Allow to vault a dump even if the storage already have a copy.
104
105 --delayed
106 Schedule the vault to be run later.
107
108 --run-delayed
109 Run the delayed vault, it is the same as running:
110
111 amdump CONF --no-flush --no-dump --vault -ostorage= -ovault-storage=$dest-storage
112
113 --quiet, -q
114 Suppress the progress messages normally printed to the terminal as
115 dumps are being copied.
116
117 --src-labelstr labelstr
118 Only dumps from volumes matching labelstr are copied.
119
120 labelstr is a Perl regular expression, and will be matched as a
121 substring of the volume labels -- it may be necessary to anchor the
122 labelstr with "^" and/or "$" in order to prevent undesired partial
123 matches.
124
125 Also note that if a dump is split across multiple volumes and
126 labelstr matches only one of those volumes, amvault will not select
127 that dump for copying. For this reason, it is generally safer to to
128 select dumps directly using other filters, in which case amvault
129 will be able to retrieve parts of split dumps from whatever volume
130 they were originally written to.
131
132 --src-storage src-storage
133 Only dumps found on the specified storage are copied. (If this
134 option is not given, all available source storages will be
135 searched.)
136
137 --src-timestamps src-timestamps
138 Specifies the timestamps in the format 'YYYYMMDDHHMMSS' of the run
139 to vault, can be "latest", then the most recent amdump or amflush
140 run will be used.
141
142 -o configoption
143 See the "CONFIGURATION OVERRIDE" section in amanda(8).
144
146 Vault all dump written to tape in the latest amdump or amflush run:
147 $ amvault --src-timestamps latest CONF
148
149 Vault all dump written on the run of December 7 2011 12:13:14 :
150 $ amvault --src-timestamps 20111207121314 CONF
151
152 Vault all dump dumped on any run of December 7 2011:
153 $ amvault CONF \* \* 20111207
154
156 amanda(8), amanda-changers(7), amfetchdump(8)
157
158 The Amanda Wiki: : http://wiki.zmanda.com/
159
161 Dustin J. Mitchell <dustin@zmanda.com>
162 Zmanda, Inc. (http://www.zmanda.com)
163
164
165
166Amanda 3.5.4 07/27/2023 AMVAULT(8)