doc/html/AdminReference/auarf276.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="auarf275.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="auarf277.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_SYNCSERV" HREF="auarf002.htm#ToC_290">vos syncserv</A></H2>
  19 <A NAME="IDX5838"></A>
  20 <A NAME="IDX5839"></A>
  21 <A NAME="IDX5840"></A>
  22 <A NAME="IDX5841"></A>
  23 <A NAME="IDX5842"></A>
  24 <A NAME="IDX5843"></A>
  25 <A NAME="IDX5844"></A>
  26 <A NAME="IDX5845"></A>
  27 <P><STRONG>Purpose</STRONG>
  28 <P>Verifies VLDB entries that mention a specified site
  29 <P><STRONG>Synopsis</STRONG>
  30 <PRE><B>vos syncserv -server</B> &lt;<VAR>machine&nbsp;name</VAR>>  [<B>-partition</B> &lt;<VAR>partition&nbsp;name</VAR>>]
  31              [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]  [<B>-localauth</B>]
  32              [<B>-verbose</B>]  [<B>-help</B>]
  33
  34 <B>vos syncs -s</B> &lt;<VAR>machine&nbsp;name</VAR>>  [<B>-p</B> &lt;<VAR>partition&nbsp;name</VAR>>]
  35           [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-n</B>]  [<B>-l</B>]  [<B>-v</B>]  [<B>-h</B>]
  36 </PRE>
  37 <P><STRONG>Description</STRONG>
  38 <P>The <B>vos syncserv</B> command verifies that each volume mentioned in
  39 a VLDB entry actually exists at the site indicated in the entry. It
  40 checks all VLDB entries that mention a read/write, read-only, or backup site
  41 either on any partition on the file server machine specified by the
  42 <B>-server</B> argument, or on the one partition specified by the
  43 <B>-server</B> and <B>-partition</B> arguments. Note that the
  44 command can end up inspecting sites other than those specified by the
  45 <B>-server</B> and <B>-partition</B> arguments, if there are versions
  46 of the volume at sites other than the one specified.
  47 <P>The command alters any incorrect information in the VLDB, unless there is
  48 an irreconcilable conflict with other VLDB entries. In that case, it
  49 writes a message to the standard error stream instead. The command
  50 never removes volumes from file server machines.
  51 <P>To achieve complete VLDB consistency, first run the <B>vos syncvldb</B>
  52 command on all file server machines in the cell, then run this command on all
  53 file server machines in the cell.
  54 <P><STRONG>Options</STRONG>
  55 <DL>
  56 <P><DT><B>-server
  57 </B><DD>Identifies the file server machine mentioned in each VLDB entry to
  58 check. Provide the machine's IP address or its host name (either
  59 fully qualified or using an unambiguous abbreviation). For details, see
  60 the introductory reference page for the <B>vos</B> command suite.
  61 <P><DT><B>-partition
  62 </B><DD>Identifies the partition mentioned in each VLDB entry to check.
  63 Provide the partition's complete name with preceding slash (for example,
  64 <B>/vicepa</B>) or use one of the three acceptable abbreviated
  65 forms. For details, see the introductory reference page for the
  66 <B>vos</B> command suite.
  67 <P><DT><B>-cell
  68 </B><DD>Names the cell in which to run the command. Do not combine this
  69 argument with the <B>-localauth</B> flag. For more details, see the
  70 introductory <B>vos</B> reference page.
  71 <P><DT><B>-noauth
  72 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  73 issuer. Do not combine this flag with the <B>-localauth</B>
  74 flag. For more details, see the introductory <B>vos</B> reference
  75 page.
  76 <P><DT><B>-localauth
  77 </B><DD>Constructs a server ticket using a key from the local
  78 <B>/usr/afs/etc/KeyFile</B> file. The <B>vos</B> command
  79 interpreter presents it to the Volume Server and Volume Location Server during
  80 mutual authentication. Do not combine this flag with the
  81 <B>-cell</B> argument or <B>-noauth</B> flag. For more details,
  82 see the introductory <B>vos</B> reference page.
  83 <P><DT><B>-verbose
  84 </B><DD>Produces on the standard output stream a detailed trace of the
  85 command's execution. If this argument is omitted, only warnings
  86 and error messages appear.
  87 <P><DT><B>-help
  88 </B><DD>Prints the online help for this command. All other valid options
  89 are ignored.
  90 </DL>
  91 <P><STRONG>Examples</STRONG>
  92 <P>The following example verifies the VLDB entries in which a site definition
  93 mentions the file server machine <B>fs3.abc.com</B>.
  94 <PRE>   % <B>vos syncserv -server fs3.abc.com</B>
  95
  96 </PRE>
  97 <P><STRONG>Privilege Required</STRONG>
  98 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
  99 the machine specified with the <B>-server</B> argument and on each
 100 database server machine. If the <B>-localauth</B> flag is included,
 101 the issuer must instead be logged on to a server machine as the local
 102 superuser <B>root</B>.
 103 <P><STRONG>Related Information</STRONG>
 104 <P><A HREF="auarf252.htm#HDRVOS_INTRO">vos</A>
 105 <P><A HREF="auarf277.htm#HDRVOS_SYNCVLDB">vos syncvldb</A>
 106 <P>
 107 <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="auarf275.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="auarf277.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>
 108 <!-- Begin Footer Records  ========================================== -->
 109 <P><HR><B>
 110 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 111 </B>
 112 <!-- End Footer Records  ============================================ -->
 113 <A NAME="Bot_Of_Page"></A>
 114 </BODY></HTML>