doc/html/AdminReference/auarf277.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="auarf276.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="auarf278.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="HDRVOS_SYNCVLDB" HREF="auarf002.htm#ToC_291">vos syncvldb</A></H2>
  19 <A NAME="IDX5846"></A>
  20 <A NAME="IDX5847"></A>
  21 <A NAME="IDX5848"></A>
  22 <A NAME="IDX5849"></A>
  23 <A NAME="IDX5850"></A>
  24 <A NAME="IDX5851"></A>
  25 <A NAME="IDX5852"></A>
  26 <A NAME="IDX5853"></A>
  27 <A NAME="IDX5854"></A>
  28 <P><STRONG>Purpose</STRONG>
  29 <P>Verifies VLDB entries for volumes residing at specified site
  30 <P><STRONG>Synopsis</STRONG>
  31 <PRE><B>vos syncvldb</B> [<B>-server</B> &lt;<VAR>machine&nbsp;name</VAR>>]  [<B>-partition</B> &lt;<VAR>partition&nbsp;name</VAR>>]
  32              [<B>-volume</B> &lt;<VAR>volume&nbsp;name&nbsp;or&nbsp;ID</VAR>>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]
  33              [<B>-localauth</B>]  [<B>-verbose</B>]  [<B>-help</B>]
  34
  35 <B>vos syncv</B> [<B>-s</B> &lt;<VAR>machine&nbsp;name</VAR>>]  [<B>-p</B> &lt;<VAR>partition&nbsp;name</VAR>>]  [<B>-vo</B> &lt;<VAR>volume&nbsp;name&nbsp;or&nbsp;ID</VAR>>]
  36           [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-n</B>]  [<B>-l</B>]  [<B>-ve</B>]  [<B>-h</B>]
  37 </PRE>
  38 <P><STRONG>Description</STRONG>
  39 <P>The <B>vos syncvldb</B> command verifies that the status of the volumes
  40 housed either on all partitions on the file server machine specified by the
  41 <B>-server</B> argument, or on the single partition specified by the
  42 <B>-server</B> and <B>-partition</B> arguments, is recorded correctly
  43 in the VLDB. If the <B>-volume</B> argument is included to indicate
  44 a single volume, the command compares only its status on the file server
  45 machine with its VLDB entry.
  46 <P>If the <B>-volume</B> argument is not included, the command interpreter
  47 obtains from the Volume Server a list of the volumes that reside on each
  48 partition, then changes information in the VLDB as necessary to reflect their
  49 state on the partition. For example, it creates or updates a VLDB entry
  50 when it finds a volume for which the VLDB entry is missing or
  51 incomplete. However, if there is already a VLDB entry that defines a
  52 different location for the volume, or there are irreconcilable conflicts with
  53 other VLDB entries, it instead writes a message about the conflict to the
  54 standard error stream. The command never removes volumes from the file
  55 server machine.
  56 <P>To achieve complete VLDB consistency, run this command on all file server
  57 machines in the cell, and then run the <B>vos syncserv</B> command on all
  58 file server machines in the cell.
  59 <P>Using the <B>-volume</B> argument basically combines the effects of
  60 this command with those of the <B>vos syncserv</B> command, for a single
  61 volume. The command not only verifies that the VLDB entry is correct
  62 for the specified volume type (read/write, backup, or read-only), but also
  63 checks that any related volume types mentioned in the VLDB entry actually
  64 exist at the site listed in the entry. It is not necessary to provide
  65 the <B>-server</B> argument (and optionally, <B>-partition</B>
  66 argument); if one or both is provided, the results are reliable only if
  67 they specify the actual location of the volume indicated by the
  68 <B>-volume</B> argument.
  69 <P><STRONG>Options</STRONG>
  70 <DL>
  71 <P><DT><B>-server
  72 </B><DD>Identifies the file server machine housing the volumes for which to verify
  73 VLDB entries. Provide the machine's IP address or its host name
  74 (either fully qualified or using an unambiguous abbreviation). For
  75 details, see the introductory reference page for the <B>vos</B> command
  76 suite.
  77 <P><DT><B>-partition
  78 </B><DD>Identifies the partition housing the volumes for which to verify VLDB
  79 entries. Provide the <B>-server</B> argument along with this
  80 one. Provide the partition's complete name with preceding slash
  81 (for example, <B>/vicepa</B>) or use one of the three acceptable
  82 abbreviated forms. For details, see the introductory reference page for
  83 the <B>vos</B> command suite.
  84 <P><DT><B>-volume
  85 </B><DD>Specifies the name or volume ID number of a single volume for which to
  86 verify the VLDB entry. This argument can be combined with the
  87 <B>-server</B> (and optionally, the <B>-partition</B>)
  88 argument.
  89 <P><DT><B>-cell
  90 </B><DD>Names the cell in which to run the command. Do not combine this
  91 argument with the <B>-localauth</B> flag. For more details, see the
  92 introductory <B>vos</B> reference page.
  93 <P><DT><B>-noauth
  94 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  95 issuer. Do not combine this flag with the <B>-localauth</B>
  96 flag. For more details, see the introductory <B>vos</B> reference
  97 page.
  98 <P><DT><B>-localauth
  99 </B><DD>Constructs a server ticket using a key from the local
 100 <B>/usr/afs/etc/KeyFile</B> file. The <B>vos</B> command
 101 interpreter presents it to the Volume Server and Volume Location Server during
 102 mutual authentication. Do not combine this flag with the
 103 <B>-cell</B> argument or <B>-noauth</B> flag. For more details,
 104 see the introductory <B>vos</B> reference page.
 105 <P><DT><B>-verbose
 106 </B><DD>Produces on the standard output stream a detailed trace of the
 107 command's execution. If this argument is omitted, only warnings
 108 and error messages appear.
 109 <P><DT><B>-help
 110 </B><DD>Prints the online help for this command. All other valid options
 111 are ignored.
 112 </DL>
 113 <P><STRONG>Examples</STRONG>
 114 <P>The following example command verifies the VLDB entry for each volume
 115 stored on the file server machine <B>fs4.abc.com</B>.
 116 <PRE>   % <B>vos syncvldb fs4.abc.com</B>
 117
 118 </PRE>
 119 <P><STRONG>Privilege Required</STRONG>
 120 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
 121 the machine specified with the <B>-server</B> argument and on each
 122 database server machine. If the <B>-localauth</B> flag is included,
 123 the issuer must instead be logged on to a server machine as the local
 124 superuser <B>root</B>.
 125 <P><STRONG>Related Information</STRONG>
 126 <P><A HREF="auarf252.htm#HDRVOS_INTRO">vos</A>
 127 <P><A HREF="auarf276.htm#HDRVOS_SYNCSERV">vos syncserv</A>
 128 <P>
 129 <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="auarf276.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="auarf278.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>
 130 <!-- Begin Footer Records  ========================================== -->
 131 <P><HR><B>
 132 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 133 </B>
 134 <!-- End Footer Records  ============================================ -->
 135 <A NAME="Bot_Of_Page"></A>
 136 </BODY></HTML>