|Linux & Unix Commands - Search Man Pages
amlabel - label an Amanda tape
amlabel [-f] config label [ slot slot ]
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 expression option. It is up to the system admin-
istrator 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 verifications.
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.
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
% amlabel DailySet1 DMP003 slot 3
label label doesn't match labelstr "str"
Label label on the command line does not match the labelstr regular expression str
label label already on a tape
Label label is already listed as an active Amanda tape.
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 configuration
This tape appears to be a valid Amanda tape, but label does not match labelstr for
this configuration 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 correctly, 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.
James da Silva <firstname.lastname@example.org>
University of Maryland, College Park
amanda(8) amdump(8) amflush(8)
All times are GMT -4. The time now is 05:06 AM.