doc/html/AdminReference/auarf066.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <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>
  17 <P>
  18 <H2><A NAME="HDRBK_DBVERIFY" HREF="auarf002.htm#ToC_80">backup dbverify</A></H2>
  19 <A NAME="IDX4264"></A>
  20 <A NAME="IDX4265"></A>
  21 <A NAME="IDX4266"></A>
  22 <P><STRONG>Purpose</STRONG>
  23 <P>Checks the integrity of the Backup Database
  24 <P><STRONG>Synopsis</STRONG>
  25 <PRE><B>backup dbverify</B> [<B>-detail</B>]  [<B>-localauth</B>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-help</B>]
  26
  27 <B>backup db</B> [<B>-d</B>]  [<B>-l</B>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-h</B>]
  28 </PRE>
  29 <P><STRONG>Description</STRONG>
  30 <P>The <B>backup dbverify</B> command checks the integrity of the Backup
  31 Database. The command's output indicates whether the Backup
  32 Database is damaged (data is corrupted) or not. If the Backup Database
  33 is undamaged, it is safe to continue using it. If it is corrupted,
  34 discontinue any backup operations until it is repaired.
  35 <P><STRONG>Cautions</STRONG>
  36 <P>While this command runs, no other backup operation can access the Backup
  37 Database; the other commands do not run until this command
  38 completes. Avoid issuing this command when other backup operations are
  39 likely to run. The <B>backup savedb</B> command repairs some types
  40 of corruption.
  41 <P><STRONG>Options</STRONG>
  42 <DL>
  43 <P><DT><B>-detail
  44 </B><DD>Reports the number of orphaned blocks found, any inconsistencies, and the
  45 name of the server machine running the Backup Server that is checking its copy
  46 of the database.
  47 <P><DT><B>-localauth
  48 </B><DD>Constructs a server ticket using a key from the local
  49 <B>/usr/afs/etc/KeyFile</B> file. The <B>backup</B> command
  50 interpreter presents it to the Backup Server, Volume Server and VL Server
  51 during mutual authentication. Do not combine this flag with the
  52 <B>-cell</B> argument. For more details, see the introductory
  53 <B>backup</B> reference page.
  54 <P><DT><B>-cell
  55 </B><DD>Names the cell in which to run the command. Do not combine this
  56 argument with the <B>-localauth</B> flag. For more details, see the
  57 introductory <B>backup</B> reference page.
  58 <P><DT><B>-help
  59 </B><DD>Prints the online help for this command. All other valid options
  60 are ignored.
  61 </DL>
  62 <P><STRONG>Output</STRONG>
  63 <P>The command displays one of the following two messages:
  64 <DL>
  65 <P><DT><B><TT>Database OK</TT>
  66 </B><DD>The database is undamaged and can be used.
  67 <P><DT><B><TT>Database not OK</TT>
  68 </B><DD>The database is damaged. You can use the <B>backup savedb</B>
  69 command to repair many kinds of corruption as it creates a backup copy.
  70 For more detailed instructions, see the <I>IBM AFS Administration
  71 Guide</I> chapter about performing backup operations.
  72 </DL>
  73 <P>The <B>-detail</B> flag provides additional information:
  74 <UL>
  75 <P><LI>The number of <I>orphan blocks</I> found. These are ranges of
  76 memory that the Backup Server preallocated in the database but cannot
  77 use. Orphan blocks do not interfere with database access, but do waste
  78 disk space. To free the unusable space, dump the database to tape by
  79 using the <B>backup savedb</B> command, and then restore it by using the
  80 <B>backup restoredb</B> command.
  81 <P><LI>Any inconsistencies in the database, such as invalid hostnames for Tape
  82 Coordinator machines.
  83 <P><LI>The name of the database server machine on which the Backup Database was
  84 checked, designated as the <TT>Database checker</TT>. For a detailed
  85 trace of the verification operation, see the
  86 <B>/usr/afs/logs/BackupLog</B> file on the indicated machine. You
  87 can use the <B>bos getlog</B> command to display it.
  88 </UL>
  89 <P><STRONG>Examples</STRONG>
  90 <P>The following command confirms that the Backup Database is undamaged:
  91 <PRE>   % <B>backup dbverify</B>
  92    Database OK
  93
  94 </PRE>
  95 <P>The following command confirms that the Backup Database is undamaged and
  96 that it has no orphan blocks or invalid Tape Coordinator entries. The
  97 Backup Server running on the machine <B>db1.abc.com</B>
  98 checked its copy of the Database.
  99 <PRE>   % <B>backup dbverify -detail</B>
 100    Database OK
 101    Orphan blocks 0
 102    Database checker was db1.abc.com
 103
 104 </PRE>
 105 <P><STRONG>Privilege Required</STRONG>
 106 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
 107 every machine where the Backup Server is running, or must be logged onto a
 108 server machine as the local superuser <B>root</B> if the
 109 <B>-localauth</B> flag is included.
 110 <P><STRONG>Related Information</STRONG>
 111 <P><A HREF="auarf014.htm#HDRBACKUPLOG">BackupLog</A>
 112 <P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
 113 <P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
 114 <P><A HREF="auarf085.htm#HDRBK_RESTOREDB">backup restoredb</A>
 115 <P><A HREF="auarf086.htm#HDRBK_SAVEDB">backup savedb</A>
 116 <P>
 117 <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>
 118 <!-- Begin Footer Records  ========================================== -->
 119 <P><HR><B>
 120 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 121 </B>
 122 <!-- End Footer Records  ============================================ -->
 123 <A NAME="Bot_Of_Page"></A>
 124 </BODY></HTML>