3 .\" Author: James da Silva <jds@amanda.org>
4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 2.6.1p2
10 .TH "AMLABEL" "8" "11/05/2009" "Amanda 2\&.6\&.1p2" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 amlabel \- label an \fIAmanda\fR tape
24 .HP \w'\fBamlabel\fR\ 'u
25 \fBamlabel\fR [\-f] \fIconfig\fR \fIlabel\fR [slot\ \fIslot\fR] [\-o\ \fIconfigoption\fR]...
30 tapes must be pre\-labeled before they are used\&.
36 before writing to make sure the proper tape is loaded\&.
41 label on the tape in the device specified by the
43 file in /usr/local/etc/amanda/\fIconfig\fR\&.
45 may be any string that does not contain whitespace and that matches the
48 regular expression option\&. It is up to the system administrator to define a naming convention\&.
51 appends the new tape to the
53 file so it will be used by
55 before it reuses any other tapes\&. When you
57 multiple tapes, they will be used in the order you
62 will not write the label if the tape contains an active
64 tape or if the label specified is on an active tape\&. The
66 (force) flag bypasses these verifications\&.
70 may be specified after the tape label\&. If a tape changer is in use,
72 will label the tape in the specified slot instead of the currently loaded tape\&.
76 man page for more details about
80 \fB\-o\fR \fIconfigoption\fR
82 See the "\fBCONFIGURATION OVERRIDE\fR" section in
89 label with the string "DMP000" on the tape loaded in the device named in the
91 option in /usr/local/etc/amanda/daily/amanda\&.conf:
93 % amlabel daily DMP000
96 Label the tape in slot 3 of the currently configured tape changer with the string "DMP003":
98 % amlabel daily DMP003 slot 3
102 label \fIlabel\fR doesn\'t match labelstr \fIstr\fR
106 on the command line does not match the
111 \fIamanda\&.conf\fR\&.
114 label \fIlabel\fR already on a tape
118 is already listed as an active
123 no tpchanger specified in \fIpath\fR , so slot command invalid
125 The command line has the
131 does not have a tape changer configured\&.
134 reading label \fIlabel\fR, tape is in another amanda configuration
136 This tape appears to be a valid
138 tape, but label does not match
140 for this configuration so it is probably part of a different
145 reading label \fIlabel\fR, tape is active
149 appears to already be part of this
151 configuration and active, i\&.e\&. has valid data on it\&.
154 no label found, are you sure \fItape\fR is non\-rewinding?
156 While checking that the label was written correctly,
158 got an error that might be caused by mis\-configuring
160 with a rewinding tape device name instead of a non\-rewinding device name for
168 : http://wiki.zmanda.com
171 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
173 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>