1AMLABEL(8)              System Administration Commands              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(5) file so it will be used
23       by 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 OVERRIDE" 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       % amlabel daily DMP000
45
46       Label the tape in slot 3 of the currently configured tape changer with
47       the string "DMP003":
48       % amlabel daily DMP003 slot 3
49

MESSAGES

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

SEE ALSO

78       amanda(8), amdump(8), amflush(8), : http://wiki.zmanda.com
79

AUTHORS

81       James da Silva <jds@amanda.org>
82
83       Stefan G. Weichinger <sgw@amanda.org>
84
85
86
87Amanda 2.6.1p2                    11/05/2009                        AMLABEL(8)