src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf276.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
   8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58: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&#39;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&#39;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&#39;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>