mirror of
https://git.openafs.org/openafs.git
synced 2025-01-22 08:50:17 +00:00
125 lines
6.5 KiB
HTML
125 lines
6.5 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="auarf065.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="auarf067.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_DBVERIFY" HREF="auarf002.htm#ToC_80">backup dbverify</A></H2>
|
||
|
|
<A NAME="IDX4264"></A>
|
||
|
|
<A NAME="IDX4265"></A>
|
||
|
|
<A NAME="IDX4266"></A>
|
||
|
|
<P><STRONG>Purpose</STRONG>
|
||
|
|
<P>Checks the integrity of the Backup Database
|
||
|
|
<P><STRONG>Synopsis</STRONG>
|
||
|
|
<PRE><B>backup dbverify</B> [<B>-detail</B>] [<B>-localauth</B>] [<B>-cell</B> <<VAR>cell name</VAR>>] [<B>-help</B>]
|
||
|
|
|
||
|
|
<B>backup db</B> [<B>-d</B>] [<B>-l</B>] [<B>-c</B> <<VAR>cell name</VAR>>] [<B>-h</B>]
|
||
|
|
</PRE>
|
||
|
|
<P><STRONG>Description</STRONG>
|
||
|
|
<P>The <B>backup dbverify</B> command checks the integrity of the Backup
|
||
|
|
Database. The command's output indicates whether the Backup
|
||
|
|
Database is damaged (data is corrupted) or not. If the Backup Database
|
||
|
|
is undamaged, it is safe to continue using it. If it is corrupted,
|
||
|
|
discontinue any backup operations until it is repaired.
|
||
|
|
<P><STRONG>Cautions</STRONG>
|
||
|
|
<P>While this command runs, no other backup operation can access the Backup
|
||
|
|
Database; the other commands do not run until this command
|
||
|
|
completes. Avoid issuing this command when other backup operations are
|
||
|
|
likely to run. The <B>backup savedb</B> command repairs some types
|
||
|
|
of corruption.
|
||
|
|
<P><STRONG>Options</STRONG>
|
||
|
|
<DL>
|
||
|
|
<P><DT><B>-detail
|
||
|
|
</B><DD>Reports the number of orphaned blocks found, any inconsistencies, and the
|
||
|
|
name of the server machine running the Backup Server that is checking its copy
|
||
|
|
of the database.
|
||
|
|
<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>The command displays one of the following two messages:
|
||
|
|
<DL>
|
||
|
|
<P><DT><B><TT>Database OK</TT>
|
||
|
|
</B><DD>The database is undamaged and can be used.
|
||
|
|
<P><DT><B><TT>Database not OK</TT>
|
||
|
|
</B><DD>The database is damaged. You can use the <B>backup savedb</B>
|
||
|
|
command to repair many kinds of corruption as it creates a backup copy.
|
||
|
|
For more detailed instructions, see the <I>IBM AFS Administration
|
||
|
|
Guide</I> chapter about performing backup operations.
|
||
|
|
</DL>
|
||
|
|
<P>The <B>-detail</B> flag provides additional information:
|
||
|
|
<UL>
|
||
|
|
<P><LI>The number of <I>orphan blocks</I> found. These are ranges of
|
||
|
|
memory that the Backup Server preallocated in the database but cannot
|
||
|
|
use. Orphan blocks do not interfere with database access, but do waste
|
||
|
|
disk space. To free the unusable space, dump the database to tape by
|
||
|
|
using the <B>backup savedb</B> command, and then restore it by using the
|
||
|
|
<B>backup restoredb</B> command.
|
||
|
|
<P><LI>Any inconsistencies in the database, such as invalid hostnames for Tape
|
||
|
|
Coordinator machines.
|
||
|
|
<P><LI>The name of the database server machine on which the Backup Database was
|
||
|
|
checked, designated as the <TT>Database checker</TT>. For a detailed
|
||
|
|
trace of the verification operation, see the
|
||
|
|
<B>/usr/afs/logs/BackupLog</B> file on the indicated machine. You
|
||
|
|
can use the <B>bos getlog</B> command to display it.
|
||
|
|
</UL>
|
||
|
|
<P><STRONG>Examples</STRONG>
|
||
|
|
<P>The following command confirms that the Backup Database is undamaged:
|
||
|
|
<PRE> % <B>backup dbverify</B>
|
||
|
|
Database OK
|
||
|
|
|
||
|
|
</PRE>
|
||
|
|
<P>The following command confirms that the Backup Database is undamaged and
|
||
|
|
that it has no orphan blocks or invalid Tape Coordinator entries. The
|
||
|
|
Backup Server running on the machine <B>db1.abc.com</B>
|
||
|
|
checked its copy of the Database.
|
||
|
|
<PRE> % <B>backup dbverify -detail</B>
|
||
|
|
Database OK
|
||
|
|
Orphan blocks 0
|
||
|
|
Database checker was db1.abc.com
|
||
|
|
|
||
|
|
</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="auarf014.htm#HDRBACKUPLOG">BackupLog</A>
|
||
|
|
<P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
|
||
|
|
<P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
|
||
|
|
<P><A HREF="auarf085.htm#HDRBK_RESTOREDB">backup restoredb</A>
|
||
|
|
<P><A HREF="auarf086.htm#HDRBK_SAVEDB">backup savedb</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="auarf065.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="auarf067.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>
|