1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
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">
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="auarf109.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="auarf111.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="HDRBOS_REMOVEHOST" HREF="auarf002.htm#ToC_124">bos removehost</A></H2>
19 <A NAME="IDX4588"></A>
20 <A NAME="IDX4589"></A>
21 <A NAME="IDX4590"></A>
22 <A NAME="IDX4591"></A>
23 <A NAME="IDX4592"></A>
24 <P><STRONG>Purpose</STRONG>
25 <P>Removes a database server machine from the
26 <B>/usr/afs/etc/CellServDB</B> file
27 <P><STRONG>Synopsis</STRONG>
28 <PRE><B>bos removehost -server</B> <<VAR>machine name</VAR>> <B>-host</B> <<VAR>host name</VAR>><SUP>+</SUP>
29 [<B>-cell</B> <<VAR>cell name</VAR>>] [<B>-noauth</B>] [<B>-localauth</B>] [<B>-help</B>]
31 <B>bos removeh -s</B> <<VAR>machine name</VAR>> <B>-ho</B> <<VAR>host name</VAR>><SUP>+</SUP> [<B>-c</B> <<VAR>cell name</VAR>>]
32 [<B>-n</B>] [<B>-l</B>] [<B>-he</B>]
34 <P><STRONG>Description</STRONG>
35 <P>The <B>bos removehost</B> command removes the entry for each database
36 server machine specified with the <B>-host</B> argument from the
37 <B>/usr/afs/etc/CellServDB</B> file on the server machine named by the
38 <B>-server</B> argument.
39 <P><STRONG>Cautions</STRONG>
40 <P>After executing this command (and waiting for the Update Server to
41 propagate the changes, if it is used), restart the database server processes
42 on all database server machines to force election of a quorum that includes
43 the new set of machines listed in the <B>/usr/afs/etc/CellServDB</B>
44 file. The <I>IBM AFS Quick Beginnings</I> explains in more detail
45 how to add and remove database server machines.
46 <P><STRONG>Options</STRONG>
48 <P><DT><B><B>-server</B>
49 </B><DD>Indicates the server machine on which to change the
50 <B>/usr/afs/etc/CellServDB</B> file. Identify the machine by IP
51 address or its host name (either fully-qualified or abbreviated
52 unambiguously). For details, see the introductory reference page for
53 the <B>bos</B> command suite.
54 <P>In cells that run the United States edition of AFS and use the Update
55 Server to distribute the contents of the <B>/usr/afs/etc</B> directory, it
56 is conventional to specify only the system control machine as a value for the
57 <B>-server</B> argument. In cells that run the international
58 version of AFS, repeat the command for each file server machine. For
59 further discussion, see the introductory reference page for the <B>bos</B>
61 <P><DT><B><B>-host</B>
62 </B><DD>Specifies the fully-qualified host name (such as
63 <B>fs2.abc.com</B>) of each database server machine to
64 remove from the <B>CellServDB</B> file.
65 <P><DT><B><B>-cell</B>
66 </B><DD>Names the cell in which to run the command. Do not combine this
67 argument with the <B>-localauth</B> flag. For more details, see the
68 introductory <B>bos</B> reference page.
69 <P><DT><B><B>-noauth</B>
70 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
71 issuer. Do not combine this flag with the <B>-localauth</B>
72 flag. For more details, see the introductory <B>bos</B> reference
74 <P><DT><B><B>-localauth</B>
75 </B><DD>Constructs a server ticket using a key from the local
76 <B>/usr/afs/etc/KeyFile</B> file. The <B>bos</B> command
77 interpreter presents the ticket to the BOS Server during mutual
78 authentication. Do not combine this flag with the <B>-cell</B> or
79 <B>-noauth</B> options. For more details, see the introductory
80 <B>bos</B> reference page.
82 </B><DD>Prints the online help for this command. All other valid options
85 <P><STRONG>Examples</STRONG>
86 <P>The following command removes the former database server machine
87 <B>db2.abc.com</B> from the <B>CellServDB</B> file on
88 the system control machine <B>fs1.abc.com</B>.
89 <PRE> % <B>bos removehost -server fs1.abc.com -host db2.abc.com</B>
92 <P><STRONG>Privilege Required</STRONG>
93 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
94 the machine named by the <B>-server</B> argument, or must be logged onto a
95 server machine as the local superuser <B>root</B> if the
96 <B>-localauth</B> flag is included.
97 <P><STRONG>Related Information</STRONG>
98 <P><A HREF="auarf023.htm#HDRKEYFILE">KeyFile</A>
99 <P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
100 <P><A HREF="auarf093.htm#HDRBOS_INTRO">bos</A>
101 <P><A HREF="auarf094.htm#HDRBOS_ADDHOST">bos addhost</A>
102 <P><A HREF="auarf106.htm#HDRBOS_LISTHOSTS">bos listhosts</A>
103 <P><I>IBM AFS Quick Beginnings</I>
105 <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="auarf109.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="auarf111.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>
106 <!-- Begin Footer Records ========================================== -->
108 <br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
110 <!-- End Footer Records ============================================ -->
111 <A NAME="Bot_Of_Page"></A>