mirror of
https://git.openafs.org/openafs.git
synced 2025-01-22 00:41:08 +00:00
341 lines
16 KiB
HTML
341 lines
16 KiB
HTML
|
<!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="auarf073.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="auarf075.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_DUMPINFO" HREF="auarf002.htm#ToC_88">backup dumpinfo</A></H2>
|
||
|
|
<A NAME="IDX4316"></A>
|
||
|
|
<A NAME="IDX4317"></A>
|
||
|
|
<A NAME="IDX4318"></A>
|
||
|
|
<A NAME="IDX4319"></A>
|
||
|
|
<A NAME="IDX4320"></A>
|
||
|
|
<A NAME="IDX4321"></A>
|
||
|
|
<A NAME="IDX4322"></A>
|
||
|
|
<A NAME="IDX4323"></A>
|
||
|
|
<P><STRONG>Purpose</STRONG>
|
||
|
|
<P>Displays a dump record from the Backup Database
|
||
|
|
<P><STRONG>Synopsis</STRONG>
|
||
|
|
<PRE><B>backup dumpinfo</B> [<B>-ndumps</B> <<VAR>no. of dumps</VAR>>] [<B>-id</B> <<VAR>dump id</VAR>>]
|
||
|
|
[<B>-verbose</B>] [<B>-localauth</B>] [<B>-cell</B> <<VAR>cell name</VAR>>] [<B>-help</B> ]
|
||
|
|
|
||
|
|
<B>backup dumpi</B> [<B>-n</B> <<VAR>no. of dumps</VAR>>] [<B>-i</B> <<VAR>dump id</VAR>>]
|
||
|
|
[<B>-v</B>] [<B>-l</B>] [<B>-c</B> <<VAR>cell name</VAR>>] [<B>-h</B>]
|
||
|
|
</PRE>
|
||
|
|
<P><STRONG>Description</STRONG>
|
||
|
|
<P>The <B>backup dumpinfo</B> command formats and displays the Backup
|
||
|
|
Database record for the specified dumps. To specify how many of the
|
||
|
|
most recent dumps to display, starting with the newest one and going back in
|
||
|
|
time, use the <B>-ndumps</B> argument. To display more detailed
|
||
|
|
information about a single dump, use the <B>-id</B> argument. To
|
||
|
|
display the records for the 10 most recent dumps, omit both the
|
||
|
|
<B>-ndumps</B> and <B>-id</B> arguments.
|
||
|
|
<P>The <B>-verbose</B> flag produces very detailed information that is
|
||
|
|
useful mostly for debugging purposes. It can be combined only with the
|
||
|
|
<B>-id</B> argument.
|
||
|
|
<P><STRONG>Options</STRONG>
|
||
|
|
<DL>
|
||
|
|
<P><DT><B>-ndumps
|
||
|
|
</B><DD>Displays the Backup Database record for each of the specified number of
|
||
|
|
dumps that were most recently performed. If the database contains fewer
|
||
|
|
dumps than are requested, the output includes the records for all existing
|
||
|
|
dumps. Do not combine this argument with the <B>-id</B> or
|
||
|
|
<B>-verbose</B> options; omit all options to display the records for
|
||
|
|
the last 10 dumps.
|
||
|
|
<P><DT><B>-id
|
||
|
|
</B><DD>Specifies the dump ID number of a single dump for which to display the
|
||
|
|
Backup Database record. Precede the <VAR>dump id</VAR> value with the
|
||
|
|
<B>-id</B> switch; otherwise, the command interpreter interprets it
|
||
|
|
as the value of the <B>-ndumps</B> argument. Combine this argument
|
||
|
|
with the <B>-verbose</B> flag, but not with the <B>-ndumps</B>
|
||
|
|
argument; omit all options to display the records for the last 10
|
||
|
|
dumps.
|
||
|
|
<P><DT><B>-verbose
|
||
|
|
</B><DD>Provides more detailed information about the dump specified with the
|
||
|
|
<B>-id</B> argument, which must be provided along with it. Do not
|
||
|
|
combine this flag with the <B>-ndumps</B> argument.
|
||
|
|
<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>If the <B>-ndumps</B> argument is provided, the output presents the
|
||
|
|
following information in table form, with a separate line for each dump:
|
||
|
|
<DL>
|
||
|
|
<P><DT><B><TT>dumpid</TT>
|
||
|
|
</B><DD>The dump ID number.
|
||
|
|
<P><DT><B><TT>parentid</TT>
|
||
|
|
</B><DD>The dump ID number of the dump's parent dump. A value of
|
||
|
|
<TT>0</TT> (zero) identifies a full dump.
|
||
|
|
<P><DT><B><TT>lv</TT>
|
||
|
|
</B><DD>The depth in the dump hierarchy of the dump level used to create the
|
||
|
|
dump. A value of <TT>0</TT> (zero) identifies a full dump, in which
|
||
|
|
case the value in the <TT>parentid</TT> field is also <TT>0</TT>. A
|
||
|
|
value of <TT>1</TT> or greater indicates an incremental dump made at the
|
||
|
|
corresponding level in the dump hierarchy.
|
||
|
|
<P><DT><B><TT>created</TT>
|
||
|
|
</B><DD>The date and time at which the Backup System started the dump operation
|
||
|
|
that created the dump.
|
||
|
|
<P><DT><B><TT>nt</TT>
|
||
|
|
</B><DD>The number of tapes that contain the data in the dump. A value of
|
||
|
|
<TT>0</TT> (zero) indicates that the dump operation was terminated or
|
||
|
|
failed. Use the <B>backup deletedump</B> command to remove such
|
||
|
|
entries.
|
||
|
|
<P><DT><B><TT>nvols</TT>
|
||
|
|
</B><DD>The number of volumes from which the dump includes data. If a
|
||
|
|
volume spans tapes, it is counted twice. A value of <TT>0</TT> (zero)
|
||
|
|
indicates that the dump operation was terminated or failed; the value in
|
||
|
|
the <TT>nt</TT> field is also <TT>0</TT> in this case.
|
||
|
|
<P><DT><B><TT>dump name</TT>
|
||
|
|
</B><DD>The dump name in the form
|
||
|
|
<PRE> <VAR>volume_set_name</VAR>.<VAR>dump_level_name</VAR> (<VAR>initial_dump_ID</VAR>)
|
||
|
|
|
||
|
|
</PRE>
|
||
|
|
<P>
|
||
|
|
<P>where <VAR>volume_set_name</VAR> is the name of the volume set, and
|
||
|
|
<VAR>dump_level_name</VAR> is the last element in the dump level pathname at
|
||
|
|
which the volume set was dumped.
|
||
|
|
<P>The <VAR>initial_dump_ID</VAR>, if displayed, is the dump ID of the initial
|
||
|
|
dump in the dump set to which this dump belongs. If there is no value
|
||
|
|
in parentheses, the dump is the initial dump in a dump set that has no
|
||
|
|
appended dumps.
|
||
|
|
</DL>
|
||
|
|
<P>If the <B>-id</B> argument is provided alone, the first line of output
|
||
|
|
begins with the string <TT>Dump</TT> and reports information for the entire
|
||
|
|
dump in the following fields:
|
||
|
|
<DL>
|
||
|
|
<P><DT><B><TT>id</TT>
|
||
|
|
</B><DD>The dump ID number.
|
||
|
|
<P><DT><B><TT>level</TT>
|
||
|
|
</B><DD>The depth in the dump hierarchy of the dump level used to create the
|
||
|
|
dump. A value of <TT>0</TT> (zero) identifies a full dump. A
|
||
|
|
value of <TT>1</TT> (one) or greater indicates an incremental dump made at
|
||
|
|
the specified level in the dump hierarchy.
|
||
|
|
<P><DT><B><TT>volumes</TT>
|
||
|
|
</B><DD>The number of volumes for which the dump includes data.
|
||
|
|
<P><DT><B><TT>created</TT>
|
||
|
|
</B><DD>The date and time at which the dump operation began.
|
||
|
|
</DL>
|
||
|
|
<P>If an XBSA server was the backup medium for the dump (rather than a tape
|
||
|
|
device or backup data file), the following line appears next:
|
||
|
|
<PRE> Backup Service: <VAR>XBSA_program</VAR>: Server: <VAR>hostname</VAR>
|
||
|
|
</PRE>
|
||
|
|
<P>where <VAR>XBSA_program</VAR> is the name of the XBSA-compliant program and
|
||
|
|
<VAR>hostname</VAR> is the name of the machine on which the program runs.
|
||
|
|
<P>Next the output includes an entry for each tape that houses volume data
|
||
|
|
from the dump. Following the string <TT>Tape</TT>, the first two
|
||
|
|
lines of each entry report information about that tape in the following
|
||
|
|
fields:
|
||
|
|
<DL>
|
||
|
|
<P><DT><B><TT>name</TT>
|
||
|
|
</B><DD>The tape's permanent name if it has one, or its AFS tape name
|
||
|
|
otherwise, and its tape ID number in parentheses.
|
||
|
|
<P><DT><B><TT>nVolumes</TT>
|
||
|
|
</B><DD>The number of volumes for which this tape includes dump data.
|
||
|
|
<P><DT><B><TT>created</TT>
|
||
|
|
</B><DD>The date and time at which the Tape Coordinator began writing data to this
|
||
|
|
tape.
|
||
|
|
</DL>
|
||
|
|
<P>Following another blank line, the tape-specific information concludes with
|
||
|
|
a table that includes a line for each volume dump on the tape. The
|
||
|
|
information appears in columns with the following headings:
|
||
|
|
<DL>
|
||
|
|
<P><DT><B><TT>Pos</TT>
|
||
|
|
</B><DD>The relative position of each volume in this tape or file. On a
|
||
|
|
tape, the counter begins at position 2 (the tape label occupies position 1),
|
||
|
|
and increments by one for each volume. For volumes in a backup data
|
||
|
|
file, the position numbers start with 1 and do not usually increment only by
|
||
|
|
one, because each is the ordinal of the 16 KB offset in the file at which the
|
||
|
|
volume's data begins. The difference between the position numbers
|
||
|
|
therefore indicates how many 16 KB blocks each volume's data
|
||
|
|
occupies. For example, if the second volume is at position 5 and the
|
||
|
|
third volume in the list is at position 9, that means that the dump of the
|
||
|
|
second volume occupies 64 KB (four 16-KB blocks) of space in the file.
|
||
|
|
<P><DT><B><TT>Clone time</TT>
|
||
|
|
</B><DD>For a backup or read-only volume, the time at which it was cloned from its
|
||
|
|
read/write source. For a Read/Write volume, it is the same as the dump
|
||
|
|
creation date reported on the first line of the output.
|
||
|
|
<P><DT><B><TT>Nbytes</TT>
|
||
|
|
</B><DD>The number of bytes of data in the dump of the volume.
|
||
|
|
<P><DT><B><TT>Volume</TT>
|
||
|
|
</B><DD>The volume name, complete with <TT>.backup</TT> or
|
||
|
|
<TT>.readonly</TT> extension if appropriate.
|
||
|
|
</DL>
|
||
|
|
<P>If both the <B>-id</B> and <B>-verbose</B> options are provided,
|
||
|
|
the output is divided into several sections:
|
||
|
|
<UL>
|
||
|
|
<P><LI>The first section, headed by the underlined string <TT>Dump</TT>,
|
||
|
|
includes information about the entire dump. The fields labeled
|
||
|
|
<TT>id</TT>, <TT>level</TT>, <TT>created</TT>, and <TT>nVolumes</TT>
|
||
|
|
report the same values (though in a different order) as appear on the first
|
||
|
|
line of output when the <B>-id</B> argument is provided by itself.
|
||
|
|
Other fields of potential interest to the backup operator are:
|
||
|
|
<DL>
|
||
|
|
<P><DT><B><TT>Group id</TT>
|
||
|
|
</B><DD>The dump's <I>group ID number</I>, which is recorded in the
|
||
|
|
dump's Backup Database record if the <B>GROUPID</B> instruction
|
||
|
|
appears in the Tape Coordinator's <B>
|
||
|
|
/usr/afs/backup/CFG_</B><VAR>tcid</VAR> file when the dump is created.
|
||
|
|
<P><DT><B><TT>maxTapes</TT>
|
||
|
|
</B><DD>The number of tapes that contain the dump set to which this dump
|
||
|
|
belongs.
|
||
|
|
<P><DT><B><TT>Start Tape Seq</TT>
|
||
|
|
</B><DD>The ordinal of the tape on which this dump begins in the set of tapes that
|
||
|
|
contain the dump set.
|
||
|
|
</DL>
|
||
|
|
<P><LI>For each tape that contains data from this dump, there follows a section
|
||
|
|
headed by the underlined string <TT>Tape</TT>. The fields labeled
|
||
|
|
<TT>name</TT>, <TT>written</TT>, and <TT>nVolumes</TT> report the same
|
||
|
|
values (though in a different order) as appear on the second and third lines
|
||
|
|
of output when the <B>-id</B> argument is provided by itself. Other
|
||
|
|
fields of potential interest to the backup operator are:
|
||
|
|
<DL>
|
||
|
|
<P><DT><B><TT>expires</TT>
|
||
|
|
</B><DD>The date and time when this tape can be recycled, because all dumps it
|
||
|
|
contains have expired.
|
||
|
|
<P><DT><B><TT>nMBytes Data</TT> and <TT>nBytes Data</TT>
|
||
|
|
</B><DD>Summed together, these fields represent the total amount of dumped data
|
||
|
|
actually from volumes (as opposed to labels, filemarks, and other
|
||
|
|
markers).
|
||
|
|
<P><DT><B><TT>KBytes Tape Used</TT>
|
||
|
|
</B><DD>The number of kilobytes of tape (or disk space, for a backup data file)
|
||
|
|
used to store the dump data. It is generally larger than the sum of the
|
||
|
|
values in the <TT>nMBytes Data</TT> and <TT>nBytes Data</TT> fields,
|
||
|
|
because it includes the space required for the label, file marks and other
|
||
|
|
markers, and because the Backup System writes data at 16 KB offsets, even if
|
||
|
|
the data in a given block doesn't fill the entire 16 KB.
|
||
|
|
</DL>
|
||
|
|
<P><LI>For each volume on a given tape, there follows a section headed by the
|
||
|
|
underlined string <TT>Volume</TT>. The fields labeled
|
||
|
|
<TT>name</TT>, <TT>position</TT>, <TT>clone</TT>, and <TT>nBytes</TT>
|
||
|
|
report the same values (though in a different order) as appear in the table
|
||
|
|
that lists the volumes in each tape when the <B>-id</B> argument is
|
||
|
|
provided by itself. Other fields of potential interest to the backup
|
||
|
|
operator are:
|
||
|
|
<DL>
|
||
|
|
<P><DT><B><TT>id</TT>
|
||
|
|
</B><DD>The volume ID.
|
||
|
|
<P><DT><B><TT>tape</TT>
|
||
|
|
</B><DD>The name of the tape containing this volume data.
|
||
|
|
</DL>
|
||
|
|
</UL>
|
||
|
|
<P><STRONG>Examples</STRONG>
|
||
|
|
<P>The following example displays information about the last five dumps:
|
||
|
|
<PRE> % <B>backup dumpinfo -ndumps 5</B>
|
||
|
|
dumpid parentid lv created nt nvols dump name
|
||
|
|
924424000 0 0 04/18/1999 04:26 1 22 usr.sun (924424000)
|
||
|
|
924685000 924424000 1 04/21/1999 04:56 1 62 usr.wed (924424000)
|
||
|
|
924773000 924424000 1 04/22/1999 05:23 1 46 usr.thu (924424000)
|
||
|
|
924860000 924424000 1 04/23/1999 05:33 1 58 usr.fri (924424000)
|
||
|
|
925033000 0 0 04/25/1999 05:36 2 73 sys.week
|
||
|
|
|
||
|
|
</PRE>
|
||
|
|
<P>The following example displays a more detailed record for a single
|
||
|
|
dump.
|
||
|
|
<PRE> % <B>backup dumpinfo -id 922097346</B>
|
||
|
|
Dump: id 922097346, level 0, volumes 1, created Mon Mar 22 05:09:06 1999
|
||
|
|
Tape: name monday.user.backup (922097346)
|
||
|
|
nVolumes 1, created 03/22/1999 05:09
|
||
|
|
Pos Clone time Nbytes Volume
|
||
|
|
1 03/22/1999 04:43 27787914 user.pat.backup
|
||
|
|
|
||
|
|
</PRE>
|
||
|
|
<P>The following example displays even more detailed information about the
|
||
|
|
dump displayed in the previous example (dump ID 922097346). This
|
||
|
|
example includes only one exemplar of each type of section (<TT>Dump</TT>,
|
||
|
|
<TT>Tape</TT>, and <TT>Volume</TT>):
|
||
|
|
<PRE> % <B>backup dumpinfo -id 922097346 -verbose</B>
|
||
|
|
Dump
|
||
|
|
----
|
||
|
|
id = 922097346
|
||
|
|
Initial id = 0
|
||
|
|
Appended id = 922099568
|
||
|
|
parent = 0
|
||
|
|
level = 0
|
||
|
|
flags = 0x0
|
||
|
|
volumeSet = user
|
||
|
|
dump path = /monday1
|
||
|
|
name = user.monday1
|
||
|
|
created = Mon Mar 22 05:09:06 1999
|
||
|
|
nVolumes = 1
|
||
|
|
id = 0
|
||
|
|
tapeServer =
|
||
|
|
format= user.monday1.%d
|
||
|
|
maxTapes = 1
|
||
|
|
Start Tape Seq = 1
|
||
|
|
name = pat
|
||
|
|
instance =
|
||
|
|
cell =
|
||
|
|
Tape
|
||
|
|
----
|
||
|
|
tape name = monday.user.backup
|
||
|
|
AFS tape name = user.monday1.1
|
||
|
|
flags = 0x20
|
||
|
|
written = Mon Mar 22 05:09:06 1999
|
||
|
|
expires = NEVER
|
||
|
|
kBytes Tape Used = 121
|
||
|
|
nMBytes Data = 0
|
||
|
|
nBytes Data = 19092
|
||
|
|
nFiles = 0
|
||
|
|
nVolumes = 1
|
||
|
|
seq = 1
|
||
|
|
tapeid = 0
|
||
|
|
useCount = 1
|
||
|
|
dump = 922097346
|
||
|
|
Volume
|
||
|
|
------
|
||
|
|
name = user.pat.backup
|
||
|
|
flags = 0x18
|
||
|
|
id = 536871640
|
||
|
|
server =
|
||
|
|
partition = 0
|
||
|
|
nFrags = 1
|
||
|
|
position = 2
|
||
|
|
clone = Mon Mar 22 04:43:06 1999
|
||
|
|
startByte = 0
|
||
|
|
nBytes = 19092
|
||
|
|
seq = 0
|
||
|
|
dump = 922097346
|
||
|
|
tape = user.monday1.1
|
||
|
|
|
||
|
|
</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="auarf068.htm#HDRBK_DELETEDUMP">backup deletedump</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="auarf073.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="auarf075.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>
|