+++ /dev/null
-<?xml version="1.0" encoding="UTF-8"?>
-<refentry id="bos_addhost8">
- <refmeta>
- <refentrytitle>bos addhost</refentrytitle>
- <manvolnum>8</manvolnum>
- </refmeta>
- <refnamediv>
- <refname>bos addhost</refname>
- <refpurpose>Adds a database server machine to the CellServDB file</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Synopsis</title>
- <para><emphasis role="bold">bos addhost</emphasis> <emphasis role="bold">-server</emphasis> <<emphasis>machine name</emphasis>> <emphasis role="bold">-host</emphasis> <<emphasis>host name</emphasis>>+
- [<emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>>] [<emphasis role="bold">-noauth</emphasis>] [<emphasis role="bold">-localauth</emphasis>] [<emphasis role="bold">-help</emphasis>]</para>
-
- <para><emphasis role="bold">bos addh</emphasis> <emphasis role="bold">-s</emphasis> <<emphasis>machine name</emphasis>> <emphasis role="bold">-ho</emphasis> <<emphasis>host name</emphasis>>+
- [<emphasis role="bold">-c</emphasis> <<emphasis>cell name</emphasis>>] [<emphasis role="bold">-n</emphasis>] [<emphasis role="bold">-l</emphasis>] [<emphasis role="bold">-he</emphasis>]</para>
-
- </refsect1>
- <refsect1>
- <title>Description</title>
- <para>The <emphasis role="bold">bos addhost</emphasis> command adds an entry for each database server machine
- specified with the <emphasis role="bold">-host</emphasis> argument to the <replaceable>/usr/afs/etc/CellServDB</replaceable>
- file on the machine named by the <emphasis role="bold">-server</emphasis> argument.</para>
-
- </refsect1>
- <refsect1>
- <title>Cautions</title>
- <para>After executing this command (and waiting for the Update Server to
- propagate the changes, if it is used), restart the database server
- processes on all database server machines to force election of a quorum
- that includes the new set of machines listed in the
- <replaceable>/usr/afs/etc/CellServDB</replaceable> file. The <emphasis>IBM AFS Quick Beginnings</emphasis> explains
- in more detail how to add and remove database server machines.</para>
-
- <para>It is best to maintain a one-to-one mapping between hostnames and IP
- addresses on a multihomed database server machine (this is actually the
- conventional configuration for any AFS machine). The BOS Server uses the
- gethostbyname() routine to obtain the IP address associated with the
- hostname specified by the <emphasis role="bold">-host</emphasis> argument. If there is more than one
- address, the BOS Server records in the <replaceable>CellServDB</replaceable> entry the one that
- appears first in the list of addresses returned by the routine. The
- routine possibly returns addresses in a different order on different
- machines, which can create inconsistency.</para>
-
- </refsect1>
- <refsect1>
- <title>Options</title>
- <variablelist>
- <varlistentry>
- <term><emphasis role="bold">-server</emphasis> <<emphasis>machine name</emphasis>></term>
- <listitem>
- <para>Identifies the server machine on which to change the
- <replaceable>/usr/afs/etc/CellServDB</replaceable> file. Identify the machine by IP address or its
- host name (either fully-qualified or abbreviated unambiguously). For
- details, see <link linkend="bos8">bos(8)</link>.</para>
-
- <para>In cells that use the Update Server to distribute the contents of the
- <replaceable>/usr/afs/etc</replaceable> directory, it is conventional to specify only the system
- control machine as a value for the <emphasis role="bold">-server</emphasis> argument. Otherwise, repeat
- the command for each file server machine. For further discussion, see
- <link linkend="bos8">bos(8)</link>.</para>
-
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><emphasis role="bold">-host</emphasis> <<emphasis>host name</emphasis>>+</term>
- <listitem>
- <para>Specifies the fully-qualified host name (such as <computeroutput>db1.abc.com</computeroutput>) of each
- database server machine to register in the <replaceable>CellServDB</replaceable> file.</para>
-
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>></term>
- <listitem>
- <para>Names the cell in which to run the command. Do not combine this
- argument with the <emphasis role="bold">-localauth</emphasis> flag. For more details, see <link linkend="bos8">bos(8)</link>.</para>
-
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><emphasis role="bold">-noauth</emphasis></term>
- <listitem>
- <para>Assigns the unprivileged identity <computeroutput>anonymous</computeroutput> to the issuer. Do not combine
- this flag with the <emphasis role="bold">-localauth</emphasis> flag. For more details, see <link linkend="bos8">bos(8)</link>.</para>
-
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><emphasis role="bold">-localauth</emphasis></term>
- <listitem>
- <para>Constructs a server ticket using a key from the local
- <replaceable>/usr/afs/etc/KeyFile</replaceable> file. The <emphasis role="bold">bos</emphasis> command interpreter presents the
- ticket to the BOS Server during mutual authentication. Do not combine this
- flag with the <emphasis role="bold">-cell</emphasis> or <emphasis role="bold">-noauth</emphasis> options. For more details, see
- <link linkend="bos8">bos(8)</link>.</para>
-
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><emphasis role="bold">-help</emphasis></term>
- <listitem>
- <para>Prints the online help for this command. All other valid options are
- ignored.</para>
-
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
- <refsect1>
- <title>Examples</title>
- <para>The following command adds the database server machines <computeroutput>db2.abc.com</computeroutput> and
- <computeroutput>db3.abc.com</computeroutput> to the <replaceable>/usr/afs/etc/CellServDB</replaceable> file on the machine
- <computeroutput>fs1.abc.com</computeroutput> (the system control machine).</para>
-
-<programlisting>
- % bos addhost -server fs1.abc.com -host db2.abc.com db3.abc.com
-
-</programlisting>
- </refsect1>
- <refsect1>
- <title>Privilege Required</title>
- <para>The issuer must be listed in the <replaceable>/usr/afs/etc/UserList</replaceable> file on the
- machine named by the <emphasis role="bold">-server</emphasis> argument, or must be logged onto a server
- machine as the local superuser <computeroutput>root</computeroutput> if the <emphasis role="bold">-localauth</emphasis> flag is
- included.</para>
-
- </refsect1>
- <refsect1>
- <title>See Also</title>
- <para><link linkend="CellServDB5">CellServDB(5)</link>,
- <link linkend="KeyFile5">KeyFile(5)</link>,
- <link linkend="UserList5">UserList(5)</link>,
- <link linkend="bos8">bos(8)</link>,
- <link linkend="bos_listhosts8">bos_listhosts(8)</link>,
- <link linkend="bos_removehost8">bos_removehost(8)</link></para>
-
- <para><emphasis>IBM AFS Quick Beginnings</emphasis></para>
-
- </refsect1>
- <refsect1>
- <title>Copyright</title>
- <para>IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.</para>
-
- <para>This documentation is covered by the IBM Public License Version 1.0. It was
- converted from HTML to POD by software written by Chas Williams and Russ
- Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>
-
- </refsect1>
- </refentry>