3 Prev Chapter 36. The Amanda Manual Pages. Next
5 -------------------------------------------------------------------------------
9 amlabel
\14 label an Amanda tape
13 amlabel [-f ] config label [slot slot] [ -o configoption]...
17 All Amanda tapes must be pre-labeled before they are used. Amanda verifies the
18 label in amdump and amflush before writing to make sure the proper tape is
20 Amlabel writes an Amanda label on the tape in the device specified by the
21 amanda.conf file in /usr/local/etc/amanda/config. Label may be any string that
22 does not contain whitespace and that matches the amanda.conf labelstr regular
23 expression option. It is up to the system administrator to define a naming
25 Amlabel appends the new tape to the tapelist file so it will be used by Amanda
26 before it reuses any other tapes. When you amlabel multiple tapes, they will be
27 used in the order you amlabel them.
28 Amlabel will not write the label if the tape contains an active Amanda tape or
29 if the label specified is on an active tape. The -f (force) flag bypasses these
31 An optional slot may be specified after the tape label. If a tape changer is in
32 use, amlabel will label the tape in the specified slot instead of the currently
34 See the amanda(8) man page for more details about Amanda.
41 See the "CONFIGURATION OVERRIDE" section in amanda(8).
46 Write an Amanda label with the string "DMP000" on the tape loaded in the device
47 named in the tapedev option in /usr/local/etc/amanda/daily/amanda.conf:
49 % amlabel daily DMP000
51 Label the tape in slot 3 of the currently configured tape changer with the
54 % amlabel daily DMP003 slot 3
61 label label doesn't match labelstr str
62 Label label on the command line does not match the labelstr regular
63 expression str from amanda.conf.
65 label label already on a tape
66 Label label is already listed as an active Amanda tape.
68 no tpchanger specified in path , so slot command invalid
69 The command line has the slot parameter but the amanda.conf file in path
70 does not have a tape changer configured.
72 reading label label, tape is in another amanda configuration
73 This tape appears to be a valid Amanda tape, but label does not match
74 labelstr for this configuration so it is probably part of a different
77 reading label label, tape is active
78 Tape label appears to already be part of this Amanda configuration and
79 active, i.e. has valid data on it.
81 no label found, are you sure tape is non-rewinding?
82 While checking that the label was written correctly, amlabel got an error
83 that might be caused by mis-configuring Amanda with a rewinding tape
84 device name instead of a non-rewinding device name for tape.
89 James da Silva, <jds@amanda.org>: Original text
90 Stefan G. Weichinger, <sgw@amanda.org>, maintainer of the Amanda-documentation:
95 amanda(8) amdump(8) amflush(8)
96 -------------------------------------------------------------------------------