mirror of
https://git.openafs.org/openafs.git
synced 2025-01-31 13:38:01 +00:00
e3dfba8e6c
This is the initial conversion of the AFS Adminstrators Reference into POD for use as man pages. The man pages are now generated via pod2man from regen.sh so that only those working from CVS have to have pod2man available. The Makefile only installs. The pages have also been sorted out into pod1, pod5, and pod8 directories, making conversion to the right section of man page easier without maintaining a separate list and allowing for names to be duplicated between pod5 and pod1 or pod8 (which will likely be needed in a few cases). This reconversion is done with a new script based on work by Chas Williams. In some cases, the output is worse than the previous POD pages, but this is a more comprehensive conversion. This is only the first step, and this initial conversion has various problems. In addition, the file man pages that didn't have simple names have not been converted in this pass and will be added later. Some of the man pages have syntax problems and all of them have formatting errors. The next editing pass, coming shortly, will clean up most of the remaining mess.
148 lines
4.3 KiB
Plaintext
148 lines
4.3 KiB
Plaintext
=head1 NAME
|
|
|
|
bos setcellname - Sets the cell's name in the /usr/afs/etc/ThisCell and
|
|
B</usr/afs/etc/CellServDB> files
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<bos setcellname -server> <I<machine name>> -name <I<cell name>>
|
|
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-help>]
|
|
|
|
B<bos setc -s> <I<machine name>> B<-n> <I<cell name>> [B<-c> <I<cell name>>] [B<-n>] [B<-l>] [-h]
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The bos setcellname command establishes the cell's name and
|
|
makes the server machine named by the B<-server> argument a member of
|
|
it, by recording the value of the B<-name> argument in two files which
|
|
it creates on the local disk:
|
|
|
|
=over 4
|
|
|
|
=item *
|
|
|
|
/usr/afs/etc/ThisCell
|
|
|
|
|
|
=item *
|
|
|
|
/usr/afs/etc/CellServDB. The cell name appears on the
|
|
first line in the file, preceded by the required C<>> symbol.
|
|
The machine name specified with the B<-server> argument appears on the
|
|
second line along with its IP address as obtained from the cell's naming
|
|
service. The machine is thus designated as the cell's first
|
|
database server machine.
|
|
|
|
|
|
=back
|
|
|
|
=head1 CAVEATS
|
|
|
|
Issue this command only when the installing the cell's first AFS
|
|
server machine. The I<IBM AFS Quick Beginnings> explains how to
|
|
copy over the B<ThisCell> and B<CellServDB> files from this or
|
|
another appropriate machine during installation of additional server
|
|
machines.
|
|
|
|
Be sure to choose a satisfactory cell name when issuing this command,
|
|
because changing a cell's name is very complicated; for one thing,
|
|
it requires changing every password in the Authentication Database.
|
|
Consult the I<IBM AFS Administration Guide> for advice on choosing a
|
|
cell name. If changing the cell's name is absolutely necessary,
|
|
contact AFS Product Support for complete instructions.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 4
|
|
|
|
=item -server
|
|
>
|
|
|
|
Indicates the server machine on which to set the cell name in the
|
|
B<ThisCell> and B<CellServDB> file. It is always the
|
|
first machine installed in a cell. 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.
|
|
|
|
=item -name
|
|
>
|
|
|
|
Defines the cell name, using standard Internet domain name format (the
|
|
actual domain name is usually appropriate). Examples are
|
|
B<abc.com> for the ABC Corporation and
|
|
B<stateu.edu> for the State University. It must match
|
|
the value of the B<-cell> argument, if that is provided.
|
|
|
|
=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 defines the cell name abc.com in
|
|
the B<ThisCell> and B<CellServDB> files on the machine
|
|
B<fs1.abc.com> as it is installed as the cell's
|
|
first server machine.
|
|
|
|
% bos setcellname -server fs1.abc.com -name abc.com
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
Authorization checking is normally turned off during installation, which is
|
|
the only recommended time to use this command; in this case no privilege
|
|
is required. If authorization checking is turned on, the issuer must be
|
|
listed in the B</usr/afs/etc/UserList> file on the machine named by
|
|
the B<-server> argument, or must be logged in 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<ThisCell (server version)(1)>
|
|
|
|
L<UserList(1)>,
|
|
L<bos(1)>
|
|
|
|
I<IBM AFS Quick Beginnings>
|
|
|
|
I<IBM AFS Administration Guide>
|
|
|
|
=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.
|