amlabel - label an Amanda tape
SYNOPSIS
amlabel [-f] config label [ slot slot ]
DESCRIPTION
All Amanda tapes must be pre-labeled before they are used.
Amanda verifies the label in amdump and amflush before
writing to make sure the proper tape is loaded.
Amlabel writes an Amanda label on the tape in the device
specified by the amanda.conf file in /etc/amanda/config.
Label may be any string that does not contain whitespace
and that matches the amanda.conf labelstr regular expres
sion option. It is up to the system administrator to
define a naming convention.
Amlabel appends the new tape to the tapelist file so it
will be used by Amanda before it reuses any other tapes.
When you amlabel multiple tapes, they will be used in the
order you amlabel them.
Amlabel will not write the label if the tape contains an
active Amanda tape or if the label specified is on an
active tape. The -f (force) flag bypasses these verifica
tions.
An optional slot may be specified after the tape label.
If a tape changer is in use, amlabel will label the tape
in the specified slot instead of the currently loaded
tape.
See the amanda(8) man page for more details about Amanda.
EXAMPLE
Write an Amanda label with the string "DMP000" on the tape
loaded in the device named in the tapedev option in
/etc/amanda/DailySet1/amanda.conf:
% amlabel DailySet1 DMP000
Label the tape in slot 3 of the currently configured tape
changer with the string "DMP003":
% amlabel DailySet1 DMP003 slot 3
MESSAGES
label label doesn't match labelstr "str"
Label label on the command line does not match the
labelstr regular expression str from amanda.conf.
label label already on a tape
Label label is already listed as an active Amanda
no tpchanger specified in "path", so slot command invalid
The command line has the slot parameter but the
amanda.conf file in path does not have a tape
changer configured.
reading label label, tape is in another amanda configura
tion
This tape appears to be a valid Amanda tape, but
label does not match labelstr for this configura
tion so it is probably part of a different Amanda
configuration.
reading label label, tape is active
Tape label appears to already be part of this
Amanda configuration and active, i.e. has valid
data on it.
no label found, are you sure tape is non-rewinding?
While checking that the label was written cor
rectly, amlabel got an error that might be caused
by mis-configuring Amanda with a rewinding tape
device name instead of a non-rewinding device name
for tape.
AUTHOR
James da Silva <jds@cs.umd.edu>
University of Maryland, College Park
SEE ALSO
amanda(8) amdump(8) amflush(8)
Man(1) output converted with
man2html