1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
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">
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>
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> <<VAR>machine name for new site</VAR>>
29 <B>-partition</B> <<VAR>partition name for new site</VAR>>
30 <B>-id</B> <<VAR>volume name or ID</VAR>> [<B>-cell</B> <<VAR>cell name</VAR>>]
31 [<B>-noauth</B>] [<B>-localauth</B>] [<B>-verbose</B>] [<B>-help</B>]
33 <B>vos ad -s</B> <<VAR>machine name for new site</VAR>> <B>-p</B> <<VAR>partition name for new site</VAR>>
34 <B>-i</B> <<VAR>volume name or ID</VAR>> [<B>-c</B> <<VAR>cell name</VAR>>] [<B>-n</B>] [<B>-l</B>] [<B>-v</B>] [<B>-h</B>]
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>AFS Release Notes</I>. The site
47 housing the read/write and backup versions of the volume counts as one site,
48 and each read-only site counts as an additional site (even the read-only site
49 defined on the same file server machine and partition as the read/write site
50 counts as a separate site). The limit in the VLDB entry effectively
51 determines the maximum number of copies of the volume that are available to
53 <P>Attempts to create additional sites by using this command fail with an
55 <P><STRONG>Options</STRONG>
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.
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.
70 </B><DD>Specifies either the complete name or volume ID number of the read/write
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.
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
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.
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.
93 </B><DD>Prints the online help for this command. All other valid options
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>
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>
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 ========================================== -->
116 <br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
118 <!-- End Footer Records ============================================ -->
119 <A NAME="Bot_Of_Page"></A>