doc/html/AdminReference/auarf253.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="auarf252.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="auarf254.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_ADDSITE" HREF="auarf002.htm#ToC_267">vos addsite</A></H2>
  19 <A NAME="IDX5587"></A>
  20 <A NAME="IDX5588"></A>
  21 <A NAME="IDX5589"></A>
  22 <A NAME="IDX5590"></A>
  23 <A NAME="IDX5591"></A>
  24 <A NAME="IDX5592"></A>
  25 <P><STRONG>Purpose</STRONG>
  26 <P>Adds a read-only site definition to a volume's VLDB entry
  27 <P><STRONG>Synopsis</STRONG>
  28 <PRE><B>vos addsite -server</B> &lt;<VAR>machine&nbsp;name&nbsp;for&nbsp;new&nbsp;site</VAR>>
  29             <B>-partition</B> &lt;<VAR>partition&nbsp;name&nbsp;for&nbsp;new&nbsp;site</VAR>>
  30             <B>-id</B> &lt;<VAR>volume&nbsp;name&nbsp;or&nbsp;ID</VAR>>  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]
  31             [<B>-noauth</B>]  [<B>-localauth</B>]  [<B>-verbose</B>]  [<B>-help</B>]
  32
  33 <B>vos ad -s</B> &lt;<VAR>machine&nbsp;name&nbsp;for&nbsp;new&nbsp;site</VAR>>  <B>-p</B> &lt;<VAR>partition&nbsp;name&nbsp;for&nbsp;new&nbsp;site</VAR>>
  34        <B>-i</B> &lt;<VAR>volume&nbsp;name&nbsp;or&nbsp;ID</VAR>>  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-n</B>]  [<B>-l</B>]  [<B>-v</B>]  [<B>-h</B>]
  35 </PRE>
  36 <P><STRONG>Description</STRONG>
  37 <P>The <B>vos addsite</B> command defines a new read-only site (partition
  38 on a file server machine, specified by the <B>-server</B> and
  39 <B>-partition</B> arguments) in the Volume Location Database (VLDB) entry
  40 of the read/write volume named by the <B>-id</B> argument. When the
  41 <B>vos release</B> command is next issued against the read/write volume, a
  42 read-only copy of it is distributed to all of the read-only sites, including
  43 the newly defined one.
  44 <P><STRONG>Cautions</STRONG>
  45 <P>A volume's VLDB entry accommodates a maximum number of site
  46 definitions, as defined in the <I>IBM AFS Release Notes</I>. The
  47 site housing the read/write and backup versions of the volume counts as one
  48 site, and each read-only site counts as an additional site (even the read-only
  49 site defined on the same file server machine and partition as the read/write
  50 site counts as a separate site). The limit in the VLDB entry
  51 effectively determines the maximum number of copies of the volume that are
  52 available to AFS clients.
  53 <P>Attempts to create additional sites by using this command fail with an
  54 error.
  55 <P><STRONG>Options</STRONG>
  56 <DL>
  57 <P><DT><B>-server
  58 </B><DD>Identifies the file server machine where the read-only volume is to
  59 reside. Provide the machine's IP address or its host name (either
  60 fully qualified or using an unambiguous abbreviation). For details, see
  61 the introductory reference page for the <B>vos</B> command suite.
  62 <P><DT><B>-partition
  63 </B><DD>Identifies the partition where the read-only volume is to reside, on the
  64 file server machine named by the <B>-server</B> argument. Provide
  65 the partition's complete name with preceding slash (for example,
  66 <B>/vicepa</B>) or use one of the three acceptable abbreviated
  67 forms. For details, see the introductory reference page for the
  68 <B>vos</B> command suite.
  69 <P><DT><B>-id
  70 </B><DD>Specifies either the complete name or volume ID number of the read/write
  71 source volume.
  72 <P><DT><B>-cell
  73 </B><DD>Names the cell in which to run the command. Do not combine this
  74 argument with the <B>-localauth</B> flag. For more details, see the
  75 introductory <B>vos</B> reference page.
  76 <P><DT><B>-noauth
  77 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  78 issuer. Do not combine this flag with the <B>-localauth</B>
  79 flag. For more details, see the introductory <B>vos</B> reference
  80 page.
  81 <P><DT><B>-localauth
  82 </B><DD>Constructs a server ticket using a key from the local
  83 <B>/usr/afs/etc/KeyFile</B> file. The <B>vos</B> command
  84 interpreter presents it to the Volume Server and Volume Location Server during
  85 mutual authentication. Do not combine this flag with the
  86 <B>-cell</B> argument or <B>-noauth</B> flag. For more details,
  87 see the introductory <B>vos</B> reference page.
  88 <P><DT><B>-verbose
  89 </B><DD>Produces on the standard output stream a detailed trace of the
  90 command's execution. If this argument is omitted, only warnings
  91 and error messages appear.
  92 <P><DT><B>-help
  93 </B><DD>Prints the online help for this command. All other valid options
  94 are ignored.
  95 </DL>
  96 <P><STRONG>Examples</STRONG>
  97 <P>The following example, appropriate in the State University cell, defines a
  98 read-only site for the cell's <B>root.afs</B> volume.
  99 <PRE>   % <B>vos addsite -server sv7.stateu.edu -partition /vicepb -id root.afs</B>
 100
 101 </PRE>
 102 <P><STRONG>Privilege Required</STRONG>
 103 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
 104 the machine specified with the <B>-server</B> argument and on each
 105 database server machine. If the <B>-localauth</B> flag is included,
 106 the issuer must instead be logged on to a server machine as the local
 107 superuser <B>root</B>.
 108 <P><STRONG>Related Information</STRONG>
 109 <P><A HREF="auarf252.htm#HDRVOS_INTRO">vos</A>
 110 <P><A HREF="auarf261.htm#HDRVOS_EXAMINE">vos examine</A>
 111 <P><A HREF="auarf270.htm#HDRVOS_RELEASE">vos release</A>
 112 <P>
 113 <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="auarf252.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="auarf254.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>
 114 <!-- Begin Footer Records  ========================================== -->
 115 <P><HR><B>
 116 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 117 </B>
 118 <!-- End Footer Records  ============================================ -->
 119 <A NAME="Bot_Of_Page"></A>
 120 </BODY></HTML>