src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf110.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="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>
  17 <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> &lt;<VAR>machine&nbsp;name</VAR>>  <B>-host</B> &lt;<VAR>host&nbsp;name</VAR>><SUP>+</SUP>
  29                [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]  [<B>-localauth</B>]  [<B>-help</B>]
  30
  31 <B>bos removeh -s</B> &lt;<VAR>machine&nbsp;name</VAR>>  <B>-ho</B> &lt;<VAR>host&nbsp;name</VAR>><SUP>+</SUP>  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]
  32             [<B>-n</B>]  [<B>-l</B>]  [<B>-he</B>]
  33 </PRE>
  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>AFS Quick Beginnings</I> explains in more detail how
  45 to add and remove database server machines.
  46 <P><STRONG>Options</STRONG>
  47 <DL>
  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>
  60 command suite.
  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
  73 page.
  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.
  81 <P><DT><B>-help
  82 </B><DD>Prints the online help for this command. All other valid options
  83 are ignored.
  84 </DL>
  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>
  90
  91 </PRE>
  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>AFS Quick Beginnings</I>
 104 <P>
 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  ========================================== -->
 107 <P><HR><B>
 108 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 109 </B>
 110 <!-- End Footer Records  ============================================ -->
 111 <A NAME="Bot_Of_Page"></A>
 112 </BODY></HTML>