2 .\" Author: James da Silva <jds@amanda.org>
3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
5 .\" Manual: System Administration Commands
6 .\" Source: Amanda 2.6.1
9 .TH "AMLABEL" "8" "01/22/2009" "Amanda 2\&.6\&.1" "System Administration Commands"
10 .\" -----------------------------------------------------------------
11 .\" * (re)Define some macros
12 .\" -----------------------------------------------------------------
13 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
14 .\" toupper - uppercase a string (locale-aware)
15 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
17 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
19 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
21 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
22 .\" SH-xref - format a cross-reference to an SH section
23 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
33 .\" SH - level-one heading that works better for non-TTY output
34 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
36 .\" put an extra blank line of space above the head in non-TTY output
43 .nr an-prevailing-indent \\n[IN]
47 .HTML-TAG ".NH \\n[an-level]"
49 .nr an-no-space-flag 1
51 \." make the size of the head bigger
56 .\" if n (TTY output), use uppercase
61 .\" if not n (not TTY), use normal case (not uppercase)
65 .\" if not n (not TTY), put a border/line under subheading
70 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
71 .\" SS - level-two heading that works better for non-TTY output
72 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
77 .nr an-prevailing-indent \\n[IN]
82 .nr an-no-space-flag 1
85 \." make the size of the head bigger
91 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
92 .\" BB/BE - put background/screen (filled box) around block of text
93 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
106 .if "\\$2"adjust-for-leading-newline" \{\
114 .nr BW \\n(.lu-\\n(.i
117 .ie "\\$2"adjust-for-leading-newline" \{\
118 \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
121 \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
132 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
133 .\" BM/EM - put colored marker in margin next to block of text
134 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
151 \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
159 .\" -----------------------------------------------------------------
160 .\" * set default formatting
161 .\" -----------------------------------------------------------------
162 .\" disable hyphenation
164 .\" disable justification (adjust text to left margin only)
166 .\" -----------------------------------------------------------------
167 .\" * MAIN CONTENT STARTS HERE *
168 .\" -----------------------------------------------------------------
170 amlabel \- label an \fIAmanda\fR tape
173 .HP \w'\fBamlabel\fR\ 'u
174 \fBamlabel\fR [\-f] \fIconfig\fR \fIlabel\fR [slot\ \fIslot\fR] [\-o\ \fIconfigoption\fR]...
180 tapes must be pre\-labeled before they are used\&.
182 verifies the label in
186 before writing to make sure the proper tape is loaded\&.
191 label on the tape in the device specified by the
193 file in /usr/local/etc/amanda/\fIconfig\fR\&.
195 may be any string that does not contain whitespace and that matches the
198 regular expression option\&. It is up to the system administrator to define a naming convention\&.
201 appends the new tape to the
203 file so it will be used by
205 before it reuses any other tapes\&. When you
207 multiple tapes, they will be used in the order you
212 will not write the label if the tape contains an active
214 tape or if the label specified is on an active tape\&. The
216 (force) flag bypasses these verifications\&.
220 may be specified after the tape label\&. If a tape changer is in use,
222 will label the tape in the specified slot instead of the currently loaded tape\&.
226 man page for more details about
230 \fB\-o\fR \fIconfigoption\fR
232 See the "\fBCONFIGURATION OVERRIDE\fR" section in
239 label with the string "DMP000" on the tape loaded in the device named in the
241 option in /usr/local/etc/amanda/daily/amanda\&.conf:
243 % amlabel daily DMP000
246 Label the tape in slot 3 of the currently configured tape changer with the string "DMP003":
248 % amlabel daily DMP003 slot 3
252 label \fIlabel\fR doesn\'t match labelstr \fIstr\fR
256 on the command line does not match the
261 \fIamanda\&.conf\fR\&.
264 label \fIlabel\fR already on a tape
268 is already listed as an active
273 no tpchanger specified in \fIpath\fR , so slot command invalid
275 The command line has the
281 does not have a tape changer configured\&.
284 reading label \fIlabel\fR, tape is in another amanda configuration
286 This tape appears to be a valid
288 tape, but label does not match
290 for this configuration so it is probably part of a different
295 reading label \fIlabel\fR, tape is active
299 appears to already be part of this
301 configuration and active, i\&.e\&. has valid data on it\&.
304 no label found, are you sure \fItape\fR is non\-rewinding?
306 While checking that the label was written correctly,
308 got an error that might be caused by mis\-configuring
310 with a rewinding tape device name instead of a non\-rewinding device name for
318 : http://wiki.zmanda.com
321 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
323 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>