amlabel(8)

1AMLABEL(8)                                                          AMLABEL(8)
2
3
4

NAME

6       amlabel - label an Amanda tape
7

SYNOPSIS

9       amlabel [-f] config label [slot slot] [-o configoption]...
10

DESCRIPTION

12       All Amanda tapes must be pre-labeled before they are used.  Amanda
13       verifies the label in amdump and amflush before writing to make sure
14       the proper tape is loaded.
15
16       Amlabel writes an Amanda label on the tape in the device specified by
17       the amanda.conf file in /usr/local/etc/amanda/config.  Label may be any
18       string that does not contain whitespace and that matches the
19       amanda.conf labelstr regular expression option. It is up to the system
20       administrator to define a naming convention.
21
22       Amlabel appends the new tape to the tapelist file so it will be used by
23       Amanda before it reuses any other tapes. When you amlabel multiple
24       tapes, they will be used in the order you amlabel them.
25
26       Amlabel will not write the label if the tape contains an active Amanda
27       tape or if the label specified is on an active tape. The -f (force)
28       flag bypasses these verifications.
29
30       An optional slot may be specified after the tape label. If a tape
31       changer is in use, amlabel will label the tape in the specified slot
32       instead of the currently loaded tape.
33
34       See the amanda(8) man page for more details about Amanda.
35

OPTIONS

37       -o configoption
38           See the "CONFIGURATION OVERWRITE" section in amanda(8).
39

EXAMPLE

41       Write an Amanda label with the string "DMP000" on the tape loaded in
42       the device named in the tapedev option in
43       /usr/local/etc/amanda/daily/amanda.conf:
44
45           % amlabel daily DMP000
46
47       Label the tape in slot 3 of the currently configured tape changer with
48       the string "DMP003":
49
50           % amlabel daily DMP003 slot 3
51

MESSAGES

53       label label doesn't match labelstr str
54           Label label on the command line does not match the labelstr regular
55           expression str from amanda.conf.
56
57       label label already on a tape
58           Label label is already listed as an active Amanda tape.
59
60       no tpchanger specified in path , so slot command invalid
61           The command line has the slot parameter but the amanda.conf file in
62           path does not have a tape changer configured.
63
64       reading label label, tape is in another amanda configuration
65           This tape appears to be a valid Amanda tape, but label does not
66           match labelstr for this configuration so it is probably part of a
67           different Amanda configuration.
68
69       reading label label, tape is active
70           Tape label appears to already be part of this Amanda configuration
71           and active, i.e. has valid data on it.
72
73       no label found, are you sure tape is non-rewinding?
74           While checking that the label was written correctly, amlabel got an
75           error that might be caused by mis-configuring Amanda with a
76           rewinding tape device name instead of a non-rewinding device name
77           for tape.
78

AUTHOR

80       James da Silva, <jds@amanda.org>: Original text
81
82       Stefan G. Weichinger, <sgw@amanda.org>, maintainer of the
83       Amanda-documentation: XML-conversion
84