1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
<HTML><HEAD>
<TITLE>Administration Reference</TITLE>
<!-- Begin Header Records ========================================== -->
<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
</HEAD><BODY>
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
<BODY bgcolor="ffffff">
<!-- End Header Records ============================================ -->
<A NAME="Top_Of_Page"></A>
<H1>Administration Reference</H1>
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf083.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf085.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
<P>
<H2><A NAME="HDRBK_READLABEL" HREF="auarf002.htm#ToC_98">backup readlabel</A></H2>
<A NAME="IDX4386"></A>
<A NAME="IDX4387"></A>
<A NAME="IDX4388"></A>
<A NAME="IDX4389"></A>
<A NAME="IDX4390"></A>
<A NAME="IDX4391"></A>
<A NAME="IDX4392"></A>
<A NAME="IDX4393"></A>
<P><STRONG>Purpose</STRONG>
<P>Reads and displays a tape's label
<P><STRONG>Synopsis</STRONG>
<PRE><B>backup readlabel</B> [<B>-portoffset</B> <<VAR>TC port offset</VAR>>]
[<B>-localauth</B>] [<B>-cell</B> <<VAR>cell name</VAR>>] [<B>-help</B>]
<B>backup rea</B> [<B>-p</B> <<VAR>TC port offset</VAR>>] [<B>-l</B>] [<B>-c</B> <<VAR>cell name</VAR>>] [<B>-h</B>]
</PRE>
<P><STRONG>Description</STRONG>
<P>The <B>backup readlabel</B> command displays information from the
magnetic tape label of a tape. The information includes the tape's
name (either a <I>permanent name</I>, or an <I>AFS tape name</I> that
reflects the tape's contents in a prescribed format) and its
capacity.
<P>If the <B>FILE YES</B> instruction appears in the
<B>/usr/afs/backup/CFG_</B><VAR>device_name</VAR> file associated with the
specified port offset, then the <B>backup readlabel</B> command reads the
label information from the first 16 KB block in the backup data file listed
for that port offset in the Tape Coordinator's
<B>/usr/afs/backup/tapeconfig</B> file, rather than from the beginning of
a tape.
<P>The Tape Coordinator's default response to this command is to access
the tape by invoking the <B>MOUNT</B> instruction in the local
<B>/usr/afs/backup/CFG_</B><VAR>device_name</VAR> file, or by prompting the
backup operator to insert the tape if there is no <B>MOUNT</B>
instruction. However, if the <B>AUTOQUERY NO</B> instruction
appears in the <B>CFG_</B><VAR>device_name</VAR> file, or if the issuer of
the <B>butc</B> command included the <B>-noautoquery</B> flag, the
Tape Coordinator instead expects the tape to be in the device already.
If it is not, the Tape Coordinator invokes the <B>MOUNT</B> instruction or
prompts the operator.
<P><STRONG>Options</STRONG>
<DL>
<P><DT><B>-portoffset
</B><DD>Specifies the port offset number of the Tape Coordinator handling the
tapes for this operation.
<P><DT><B>-localauth
</B><DD>Constructs a server ticket using a key from the local
<B>/usr/afs/etc/KeyFile</B> file. The <B>backup</B> command
interpreter presents it to the Backup Server, Volume Server and VL Server
during mutual authentication. Do not combine this flag with the
<B>-cell</B> argument. For more details, see the introductory
<B>backup</B> reference page.
<P><DT><B>-cell
</B><DD>Names the cell in which to run the command. Do not combine this
argument with the <B>-localauth</B> flag. For more details, see the
introductory <B>backup</B> reference page.
<P><DT><B>-help
</B><DD>Prints the online help for this command. All other valid options
are ignored.
</DL>
<P><STRONG>Output</STRONG>
<P>Output from this command appears in both the shell window where the command
is issued, and in the Tape Coordinator window.
<P>If the tape is unlabeled or if the specified tape device is empty, the
output reads
<PRE> Failed to read tape label.
</PRE>
<P>Otherwise, the output in the shell window has the following format:
<PRE> Tape read was labelled: <VAR>tape name</VAR> (<VAR>dump id</VAR>)
size: <VAR>size</VAR> Kbytes
</PRE>
<P>where <VAR>tape name</VAR> is the permanent name if the tape has one, or the
AFS tape name otherwise. The <VAR>dump ID</VAR> is dump ID of the initial
dump on the tape, and <VAR>size</VAR> is the recorded capacity of the tape in
kilobytes.
<P>The output in the Tape Coordinator windows is bounded by an underlined
<TT>Tape</TT> <TT>label</TT> header at the top, and the following string
at the bottom:
<PRE> -- End of tape label --
</PRE>
<P>In between are lines reporting the following information:
<DL>
<P><DT><B><TT>tape name</TT>
</B><DD>The permanent name assigned by using the <B>-pname</B> argument of the
<B>backup labeltape</B> command. This name remains on the tape
until that argument is used again, no matter how many times the tape is
recycled or otherwise relabeled. If the tape does not have a permanent
name, the value <TT><NULL></TT> appears in this field.
<P><DT><B><TT>AFS tape name</TT>
</B><DD>A tape name in one of the following prescribed formats. The Backup
System automatically writes the appropriate AFS tape name to the label as part
of a <B>backup dump</B> or <B>backup savedb</B> operation, or the
operator can assign it with the <B>-name</B> argument to the <B>backup
labeltape</B> command.
<UL>
<P><LI><VAR>volume_set_name</VAR><B>.</B><VAR>dump_level_name</VAR><B>.</B><VAR>tape_index</VAR>,
if the tape contains volume data. The <VAR>volume_set_name</VAR> is the
name of the volume set that was dumped to create the initial dump in the dump
set of to which this tape belongs; <VAR>dump_level_name</VAR> is the last
pathname element of the dump level at which the initial dump was backed
up; and <VAR>tape_index</VAR> is the numerical position of the tape in the
dump set.
<P><LI><TT>Ubik.db.dump.</TT><VAR>tape_index</VAR> if the
tape contains a dump of the Backup Database, created with the <B>backup
savedb</B> command. The <VAR>tape_index</VAR> is the ordinal of the
tape in the dump set.
<P><LI><TT><NULL></TT> if the tape has no AFS tape name. This is
normally the case if the <B>-name</B> argument was not included the last
time the <B>backup labeltape</B> command was used on this tape, and no
data has been written to it since.
</UL>
<P><DT><B><TT>creationTime</TT>
</B><DD>The date and time at which the Backup System started performing the dump
operation that created the initial dump.
<P><DT><B><TT>cell</TT>
</B><DD>The cell in which the dump set was created. This is the cell whose
Backup Database contains a record of the dump set.
<P><DT><B><TT>size</TT>
</B><DD>The tape's capacity (in kilobytes) as recorded on the label, rather
than the amount of data on the tape. The value is assigned by the
<B>-size</B> argument to the <B>backup labeltape</B> command or
derived from the <B>/usr/afs/backup/tapeconfig</B> file on the Tape
Coordinator machine, not from a measurement of the tape.
<P><DT><B><TT>dump path</TT>
</B><DD>The dump level of the initial dump in the dump set
<P><DT><B><TT>dump id</TT>
</B><DD>The dump ID number of the initial dump in the dump set, as recorded in the
Backup Database
<P><DT><B><TT>useCount</TT>
</B><DD>The number of times a dump has been written to the tape, or it has been
relabeled
</DL>
<P>The message <TT>ReadLabel: Finished</TT> indicates the completion
of the output.
<P><STRONG>Examples</STRONG>
<P>The following example shows the output for the tape with permanent name
<B>oct.guest.dump</B> and capacity 2 MB, expressed in
kilobyte units (2097152 equals 2 times 1024<SUP>2</SUP>).
<PRE> % <B>backup readlabel -portoffset 6</B>
Tape read was labelled: oct.guest.dump (907215000)
size: 2097152 Kbytes
</PRE>
<P>The output in the Tape Coordinator window reads:
<PRE> Tape label
----------
tape name = oct.guest.dump
AFS tape name = guests.monthly.3
creationTime = Thu Oct 1 00:10:00 1998
cell = abc.com
size = 2097152 Kbytes
dump path = /monthly
dump id = 907215000
useCount = 5
---- End of tape label ----
</PRE>
<P>The following example is for a tape that does not have a permanent
tape.
<PRE> % backup readlabel -portoffset 6
Tape read was labelled: guests.monthly.2 (909899900)
size: 2097152 Kbytes
</PRE>
<P>The output in the Tape Coordinator window reads:
<PRE> Tape label
----------
tape name = <NULL>
AFS tape name = guests.monthly.2
creationTime = Sun Nov 1 00:58:20 1998
cell = abc.com
size = 2097152 Kbytes
dump path = /monthly
dump id = 909899900
useCount = 1
---- End of tape label ----
</PRE>
<P><STRONG>Privilege Required</STRONG>
<P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
every machine where the Backup Server is running, or must be logged onto a
server machine as the local superuser <B>root</B> if the
<B>-localauth</B> flag is included.
<P><STRONG>Related Information</STRONG>
<P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
<P><A HREF="auarf079.htm#HDRBK_LABELTAPE">backup labeltape</A>
<P><A HREF="auarf126.htm#HDRBUTC">butc</A>
<P>
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf083.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf085.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
<!-- Begin Footer Records ========================================== -->
<P><HR><B>
<br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
</B>
<!-- End Footer Records ============================================ -->
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
|
