mirror of
https://git.openafs.org/openafs.git
synced 2025-01-31 13:38:01 +00:00
136 lines
4.2 KiB
Plaintext
136 lines
4.2 KiB
Plaintext
|
=head1 NAME
|
||
|
|
||
|
bos addhost - Adds a database server machine to the /usr/afs/etc/CellServDB
|
||
|
file
|
||
|
|
||
|
=head1 SYNOPSIS
|
||
|
|
||
|
B<bos addhost -server> <I<machine name>> -host <I<host name>>+
|
||
|
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-help>]
|
||
|
|
||
|
B<bos addh -s> <I<machine name>> -ho <I<host name>>+
|
||
|
[B<-c> <I<cell name>>] [B<-n>] [B<-l>] [B<-he>]
|
||
|
|
||
|
=head1 DESCRIPTION
|
||
|
|
||
|
The bos addhost command adds an entry for each database server
|
||
|
machine specified with the B<-host> argument to the
|
||
|
B</usr/afs/etc/CellServDB> file on the machine named by the
|
||
|
B<-server> argument.
|
||
|
|
||
|
=head1 CAVEATS
|
||
|
|
||
|
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 B</usr/afs/etc/CellServDB>
|
||
|
file. The I<IBM AFS Quick Beginnings> explains in more detail
|
||
|
how to add and remove database server machines.
|
||
|
|
||
|
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 B<gethostbyname( )> routine to obtain the IP address
|
||
|
associated with the hostname specified by the B<-host>
|
||
|
argument. If there is more than one address, the BOS Server records in
|
||
|
the B<CellServDB> 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.
|
||
|
|
||
|
=head1 OPTIONS
|
||
|
|
||
|
=over 4
|
||
|
|
||
|
=item -server
|
||
|
>
|
||
|
|
||
|
Identifies the server machine on which to change the
|
||
|
B</usr/afs/etc/CellServDB> file. Identify the machine by IP
|
||
|
address or its host name (either fully-qualified or abbreviated
|
||
|
unambiguously). For details, see the introductory reference page for
|
||
|
the B<bos> command suite.
|
||
|
|
||
|
In cells that run the United States edition of AFS and use the Update
|
||
|
Server to distribute the contents of the B</usr/afs/etc> directory, it
|
||
|
is conventional to specify only the system control machine as a value for the
|
||
|
B<-server> argument. In cells that run the international
|
||
|
version of AFS, repeat the command for each file server machine. For
|
||
|
further discussion, see the introductory reference page for the B<bos>
|
||
|
command suite.
|
||
|
|
||
|
=item -host
|
||
|
>
|
||
|
|
||
|
Specifies the fully-qualified host name (such as
|
||
|
B<db1.abc.com>) of each database server machine to
|
||
|
register in the B<CellServDB> file.
|
||
|
|
||
|
=item -cell
|
||
|
>
|
||
|
|
||
|
Names the cell in which to run the command. Do not combine this
|
||
|
argument with the B<-localauth> flag. For more details, see the
|
||
|
introductory B<bos> reference page.
|
||
|
|
||
|
=item -noauth
|
||
|
>
|
||
|
|
||
|
Assigns the unprivileged identity anonymous to the
|
||
|
issuer. Do not combine this flag with the B<-localauth>
|
||
|
flag. For more details, see the introductory B<bos> reference
|
||
|
page.
|
||
|
|
||
|
=item -localauth
|
||
|
>
|
||
|
|
||
|
Constructs a server ticket using a key from the local
|
||
|
B</usr/afs/etc/KeyFile> file. The B<bos> command
|
||
|
interpreter presents the ticket to the BOS Server during mutual
|
||
|
authentication. Do not combine this flag with the B<-cell> or
|
||
|
B<-noauth> options. For more details, see the introductory
|
||
|
B<bos> reference page.
|
||
|
|
||
|
=item -help
|
||
|
|
||
|
Prints the online help for this command. All other valid options
|
||
|
are ignored.
|
||
|
|
||
|
=back
|
||
|
|
||
|
=head1 EXAMPLES
|
||
|
|
||
|
The following command adds the database server machines
|
||
|
B<db2.abc.com> and B<db3.abc.com>
|
||
|
to the B</usr/afs/etc/CellServDB> file on the machine
|
||
|
B<fs1.abc.com> (the system control machine).
|
||
|
|
||
|
% bos addhost -server fs1.abc.com -host db2.abc.com db3.abc.com
|
||
|
|
||
|
=head1 PRIVILEGE REQUIRED
|
||
|
|
||
|
The issuer must be listed in the /usr/afs/etc/UserList file on
|
||
|
the machine named by the B<-server> argument, or must be logged onto a
|
||
|
server machine as the local superuser B<root> if the
|
||
|
B<-localauth> flag is included.
|
||
|
|
||
|
=head1 SEE ALSO
|
||
|
|
||
|
L<CellServDB (server version)(1)>
|
||
|
|
||
|
L<KeyFile(1)>,
|
||
|
L<UserList(1)>,
|
||
|
L<bos(1)>,
|
||
|
L<bos_listhosts(1)>,
|
||
|
L<bos_removehost(1)>
|
||
|
|
||
|
I<IBM AFS Quick Beginnings>
|
||
|
|
||
|
=head1 COPYRIGHT
|
||
|
|
||
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
||
|
|
||
|
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.
|