doc/html/AdminReference/auarf094.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="auarf093.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="auarf095.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_ADDHOST" HREF="auarf002.htm#ToC_108">bos addhost</A></H2>
  19 <A NAME="IDX4451"></A>
  20 <A NAME="IDX4452"></A>
  21 <A NAME="IDX4453"></A>
  22 <A NAME="IDX4454"></A>
  23 <A NAME="IDX4455"></A>
  24 <P><STRONG>Purpose</STRONG>
  25 <P>Adds a database server machine to the <B>/usr/afs/etc/CellServDB</B>
  26 file
  27 <P><STRONG>Synopsis</STRONG>
  28 <PRE><B>bos addhost -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 addh -s</B> &lt;<VAR>machine&nbsp;name</VAR>>  <B>-ho</B> &lt;<VAR>host&nbsp;name</VAR>><SUP>+</SUP>
  32          [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-n</B>]  [<B>-l</B>]  [<B>-he</B>]
  33 </PRE>
  34 <P><STRONG>Description</STRONG>
  35 <P>The <B>bos addhost</B> command adds an entry for each database server
  36 machine specified with the <B>-host</B> argument to the
  37 <B>/usr/afs/etc/CellServDB</B> file on the 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>It is best to maintain a one-to-one mapping between hostnames and IP
  47 addresses on a multihomed database server machine (this is actually the
  48 conventional configuration for any AFS machine). The BOS Server uses
  49 the <B>gethostbyname(&nbsp;)</B> routine to obtain the IP address
  50 associated with the hostname specified by the <B>-host</B>
  51 argument. If there is more than one address, the BOS Server records in
  52 the <B>CellServDB</B> entry the one that appears first in the list of
  53 addresses returned by the routine. The routine possibly returns
  54 addresses in a different order on different machines, which can create
  55 inconsistency.
  56 <P><STRONG>Options</STRONG>
  57 <DL>
  58 <P><DT><B><B>-server</B>
  59 </B><DD>Identifies the server machine on which to change the
  60 <B>/usr/afs/etc/CellServDB</B> file. Identify the machine by IP
  61 address or its host name (either fully-qualified or abbreviated
  62 unambiguously). For details, see the introductory reference page for
  63 the <B>bos</B> command suite.
  64 <P>In cells that run the United States edition of AFS and use the Update
  65 Server to distribute the contents of the <B>/usr/afs/etc</B> directory, it
  66 is conventional to specify only the system control machine as a value for the
  67 <B>-server</B> argument. In cells that run the international
  68 version of AFS, repeat the command for each file server machine. For
  69 further discussion, see the introductory reference page for the <B>bos</B>
  70 command suite.
  71 <P><DT><B><B>-host</B>
  72 </B><DD>Specifies the fully-qualified host name (such as
  73 <B>db1.abc.com</B>) of each database server machine to
  74 register in the <B>CellServDB</B> file.
  75 <P><DT><B><B>-cell</B>
  76 </B><DD>Names the cell in which to run the command. Do not combine this
  77 argument with the <B>-localauth</B> flag. For more details, see the
  78 introductory <B>bos</B> reference page.
  79 <P><DT><B><B>-noauth</B>
  80 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  81 issuer. Do not combine this flag with the <B>-localauth</B>
  82 flag. For more details, see the introductory <B>bos</B> reference
  83 page.
  84 <P><DT><B><B>-localauth</B>
  85 </B><DD>Constructs a server ticket using a key from the local
  86 <B>/usr/afs/etc/KeyFile</B> file. The <B>bos</B> command
  87 interpreter presents the ticket to the BOS Server during mutual
  88 authentication. Do not combine this flag with the <B>-cell</B> or
  89 <B>-noauth</B> options. For more details, see the introductory
  90 <B>bos</B> reference page.
  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 adds the database server machines
  97 <B>db2.abc.com</B> and <B>db3.abc.com</B>
  98 to the <B>/usr/afs/etc/CellServDB</B> file on the machine
  99 <B>fs1.abc.com</B> (the system control machine).
 100 <PRE>   % <B>bos addhost -server fs1.abc.com -host db2.abc.com db3.abc.com</B>
 101
 102 </PRE>
 103 <P><STRONG>Privilege Required</STRONG>
 104 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
 105 the machine named by the <B>-server</B> argument, or must be logged onto a
 106 server machine as the local superuser <B>root</B> if the
 107 <B>-localauth</B> flag is included.
 108 <P><STRONG>Related Information</STRONG>
 109 <P><A HREF="auarf020.htm#HDRSV_CSDB">CellServDB (server version)</A>
 110 <P><A HREF="auarf023.htm#HDRKEYFILE">KeyFile</A>
 111 <P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
 112 <P><A HREF="auarf093.htm#HDRBOS_INTRO">bos</A>
 113 <P><A HREF="auarf106.htm#HDRBOS_LISTHOSTS">bos listhosts</A>
 114 <P><A HREF="auarf110.htm#HDRBOS_REMOVEHOST">bos removehost</A>
 115 <P><I>IBM AFS Quick Beginnings</I>
 116 <P>
 117 <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="auarf093.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="auarf095.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>
 118 <!-- Begin Footer Records  ========================================== -->
 119 <P><HR><B>
 120 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 121 </B>
 122 <!-- End Footer Records  ============================================ -->
 123 <A NAME="Bot_Of_Page"></A>
 124 </BODY></HTML>