1TAPELIST(5)              File formats and conventions              TAPELIST(5)
2
3
4

NAME

6       tapelist - The list of Amanda volumes in use
7

DESCRIPTION

9       The tapelist file contains the list of tapes in active use. This file
10       is not ordinarily edited or examined manually. Its format may change,
11       or it may be removed altogether, in future versions of Amanda. It
12       contains lines of the form:
13
14       YYYYMMDDHHMMSS label flags [BARCODE:barcode] [META:meta] [BLOCKSIZE:blocksize] [POOL:pool] [STORAGE:storage] [CONFIG:config] [#comment]
15
16       Where YYYYMMDDHHMMSS is the time the tape was written, label is a label
17       for the tape as written by amlabel and flags is one of "reuse" or
18       "no-reuse" and tells Amanda whether the tape may be reused. A
19       non-reusable tape will not be overwritten, even if it is older than
20       dumpcycle dumps. See the reuse options of amadmin(8).
21
22       The optional barcode is prefixed with 'BARCODE' if the volume have a
23       barcode.
24
25       The optional meta label is prefixed with 'META' if the volume is on a
26       meta volume.
27
28       The optional blocksize is prefixed with 'BLOCKSIZE'.
29
30       The optional pool is prefixed with 'POOL', it is the name of the
31       tape-pool.
32
33       The optional storage is prefixed with 'STORAGE', it is the name of the
34       storage.
35
36       The optional config is prefixed with 'CONFIG', it is name of the config
37       that
38
39       is using that volume. This is useful to share the tapelist across
40       multiple config.
41
42       The optional comment is prefixed with a '#' and continues to the end of
43       the line.
44
45       Amanda will maintain this comment until the tape is overwritten. Note
46       that comments are not allowed on blank lines.
47
48       An entry without POOL is in the tape-pool with the name of config
49       running name.
50
51       A new labelled volume have a timestamp of "0" and have no STORAGE and
52       CONFIG.
53
54       A used volume with timestamp != "0" without STORAGE is in the storage
55       with the name of the running config
56
57       A used volume with timestamp != "0" without CONFIG is in the running
58       config.
59
60       It is possible to share the same tapelist across multiple config If the
61       POOL, STORAGE and CONFIG are correctly set.
62
63       The file is sorted such that the most-recently used tape appears on the
64       first line, and the oldest tape appears on the last line.
65
66       Amdump and amflush will by default refuse to write to an unlabeled
67       tape, or to a labeled tape that is considered active or marked
68       "no-reuse". There must be more tapes in active rotation (see the
69       tapecycle option) than there are runs in the backup cycle (see the
70       dumpcycle option) to prevent overwriting a backup image that would be
71       needed to do a full recovery.
72

SEE ALSO

74       amanda(8), amanda.conf(5)
75
76       The Amanda Wiki: : http://wiki.zmanda.com/
77

AUTHORS

79       James da Silva <jds@amanda.org>
80
81       Stefan G. Weichinger <sgw@amanda.org>
82
83       Dustin J. Mitchell <dustin@zmanda.com>
84           Zmanda, Inc. (http://www.zmanda.com)
85
86
87
88Amanda 3.5.4                      07/27/2023                       TAPELIST(5)
Impressum