doc/html/AdminReference/auarf279.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="auarf278.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="auarf280.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_UNLOCKVLDB" HREF="auarf002.htm#ToC_293">vos unlockvldb</A></H2>
  19 <A NAME="IDX5859"></A>
  20 <A NAME="IDX5860"></A>
  21 <A NAME="IDX5861"></A>
  22 <A NAME="IDX5862"></A>
  23 <P><STRONG>Purpose</STRONG>
  24 <P>Unlocks several locked VLDB entries
  25 <P><STRONG>Synopsis</STRONG>
  26 <PRE><B>vos unlockvldb</B> [<B>-server</B> &lt;<VAR>machine&nbsp;name</VAR>>]  [<B>-partition</B> &lt;<VAR>partition&nbsp;name</VAR>>]
  27                [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]  [<B>-localauth</B>]
  28                [<B>-verbose</B>]  [<B>-help</B>]
  29
  30 <B>vos unlockv</B> [<B>-s</B> &lt;<VAR>machine&nbsp;name</VAR>>]  [<B>-p</B> &lt;<VAR>partition&nbsp;name</VAR>>]
  31             [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-n</B>]  [<B>-l</B>]  [<B>-v</B>]  [<B>-h</B>]
  32 </PRE>
  33 <P><STRONG>Description</STRONG>
  34 <P>The <B>vos unlockvldb</B> command releases the lock on the Volume
  35 Location Database (VLDB) entries indicated by the combination of arguments
  36 provided:
  37 <UL>
  38 <P><LI>To unlock all entries in the VLDB, provide no arguments
  39 <P><LI>To unlock all entries that mention a file server machine in a site
  40 definition, provide its name with the <B>-server</B> argument
  41 <P><LI>To unlock all entries that mention a partition on any file server machine
  42 in a site definition, provide the partition name with the
  43 <B>-partition</B> argument
  44 <P><LI>To unlock all entries that mention a specific site, provide both the
  45 <B>-server</B> and <B>-partition</B> arguments.
  46 </UL>
  47 <P>To unlock a single volume, use the <B>vos unlock</B> command
  48 instead.
  49 <P><STRONG>Cautions</STRONG>
  50 <P>Do not use this command under normal circumstances.
  51 <P>It is useful if VLDB entries for volumes at a certain site are locked but
  52 there is no reason to suspect inconsistency within the volume or between it
  53 and the VLDB. Note that it is possible to list information from locked
  54 VLDB entries, even though they cannot be manipulated in other ways.
  55 <P>The <B>vos lock</B> command locks a VLDB entry so that no one else can
  56 perform an action that requires writing the VLDB.
  57 <P><STRONG>Options</STRONG>
  58 <DL>
  59 <P><DT><B>-server
  60 </B><DD>Identifies the file server machine for which to unlock VLDB
  61 entries. Provide the machine's IP address or its host name (either
  62 fully qualified or using an unambiguous abbreviation). For details, see
  63 the introductory reference page for the <B>vos</B> command suite.
  64 <P><DT><B>-partition
  65 </B><DD>Identifies the partition (on the file server machine specified by the
  66 <B>-server</B> argument) for which to unlock VLDB entries. Provide
  67 the partition's complete name with preceding slash (for example,
  68 <B>/vicepa</B>) or use one of the three acceptable abbreviated
  69 forms. For details, see the introductory reference page for the
  70 <B>vos</B> command suite.
  71 <P><DT><B>-cell
  72 </B><DD>Names the cell in which to run the command. Do not combine this
  73 argument with the <B>-localauth</B> flag. For more details, see the
  74 introductory <B>vos</B> reference page.
  75 <P><DT><B>-noauth
  76 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  77 issuer. Do not combine this flag with the <B>-localauth</B>
  78 flag. For more details, see the introductory <B>vos</B> reference
  79 page.
  80 <P><DT><B>-localauth
  81 </B><DD>Constructs a server ticket using a key from the local
  82 <B>/usr/afs/etc/KeyFile</B> file. The <B>vos</B> command
  83 interpreter presents it to the Volume Server and Volume Location Server during
  84 mutual authentication. Do not combine this flag with the
  85 <B>-cell</B> argument or <B>-noauth</B> flag. For more details,
  86 see the introductory <B>vos</B> reference page.
  87 <P><DT><B>-verbose
  88 </B><DD>Produces on the standard output stream a detailed trace of the
  89 command's execution. If this argument is omitted, only warnings
  90 and error messages appear.
  91 <P><DT><B>-help
  92 </B><DD>Prints the online help for this command. All other valid options
  93 are ignored.
  94 </DL>
  95 <P><STRONG>Examples</STRONG>
  96 <P>The following command unlocks all locked entries in the VLDB.
  97 <PRE>   % <B>vos unlockvldb</B>
  98
  99 </PRE>
 100 <P>The following command unlocks all locked VLDB entries that mention the
 101 <B>/vicepa</B> partition in a site definition.
 102 <PRE>   % <B>vos unlockvldb -partition a</B>
 103
 104 </PRE>
 105 <P>The following command unlocks all locked VLDB entries that refer to volumes
 106 on the <B>/vicepc</B> partition of the file server machine
 107 <B>fs3.abc.com</B>.
 108 <PRE>   % <B>vos unlockvldb -server fs3.abc.com -partition c</B>
 109
 110 </PRE>
 111 <P><STRONG>Privilege Required</STRONG>
 112 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
 113 the machine specified with the <B>-server</B> argument and on each
 114 database server machine. If the <B>-localauth</B> flag is included,
 115 the issuer must instead be logged on to a server machine as the local
 116 superuser <B>root</B>.
 117 <P><STRONG>Related Information</STRONG>
 118 <P><A HREF="auarf252.htm#HDRVOS_INTRO">vos</A>
 119 <P><A HREF="auarf267.htm#HDRVOS_LOCK">vos lock</A>
 120 <P><A HREF="auarf278.htm#HDRVOS_UNLOCK">vos unlock</A>
 121 <P>
 122 <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="auarf278.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="auarf280.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>
 123 <!-- Begin Footer Records  ========================================== -->
 124 <P><HR><B>
 125 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 126 </B>
 127 <!-- End Footer Records  ============================================ -->
 128 <A NAME="Bot_Of_Page"></A>
 129 </BODY></HTML>