SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

bos_setcellname

Section: AFS Command Reference (8)
Updated: OpenAFS
Index 

NAME

bos setcellname - Sets the cell's name in ThisCell and CellServDB 

SYNOPSIS

bos setcellname << -server <machine name >>> << -name <cell name >>>
    << [-cell <cell name] >>> [-noauth] [-localauth] [-help]

bos setc << -s <machine name >>> << -n <cell name >>>
    << [-c <cell name] >>> [-n] [-l] [-h] 

DESCRIPTION

The bos setcellname command establishes the cell's name and makes theserver machine named by the -server argument a member of it, byrecording the value of the -name argument in two files which it createson the local disk:
*
/usr/afs/etc/ThisCell
*
/usr/afs/etc/CellServDB. The cell name appears on the first line in thefile, preceded by the required < >> symbol. The machine namespecified with the -server argument appears on the second line alongwith its IP address as obtained from the cell's naming service. Themachine is thus designated as the cell's first database server machine.
 

CAUTIONS

Issue this command only when the installing the cell's first AFS servermachine. The IBM AFS Quick Beginnings explains how to copy over theThisCell and CellServDB files from this or another appropriatemachine 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, itrequires changing every password in the Authentication Database. Consultthe IBM AFS Administration Guide for advice on choosing a cell name. 

OPTIONS


-server <machine name>
Indicates the server machine on which to set the cell name in theThisCell and CellServDB file. It is always the first machineinstalled in a cell. Identify the machine by IP address or its host name(either fully-qualified or abbreviated unambiguously). For details, seethe bos(8) manpage.
-name <cell name>
Defines the cell name, using standard Internet domain name format (theactual domain name is usually appropriate). Examples are abc.com forthe ABC Corporation and stateu.edu for the State University. It mustmatch the value of the -cell argument, if that is provided.
-cell <cell name>
Names the cell in which to run the command. Do not combine this argumentwith the -localauth flag. For more details, see the bos(8) manpage.
-noauth
Assigns the unprivileged identity anonymous to the issuer. Do notcombine this flag with the -localauth flag. For more details, seethe bos(8) manpage.
-localauth
Constructs a server ticket using a key from the local/usr/afs/etc/KeyFile file. The bos command interpreter presents theticket to the BOS Server during mutual authentication. Do not combine thisflag with the -cell or -noauth options. For more details, seethe bos(8) manpage.
-help
Prints the online help for this command. All other valid options areignored.
 

EXAMPLES

The following command defines the cell name abc.com in the ThisCelland CellServDB files on the machine fs1.abc.com as it is installedas the cell's first server machine.

   % bos setcellname -server fs1.abc.com -name abc.com
 

PRIVILEGE REQUIRED

Authorization checking is normally turned off during installation, whichis the only recommended time to use this command; in this case noprivilege is required. If authorization checking is turned on, the issuermust be listed in the /usr/afs/etc/UserList file on the machine namedby the -server argument, or must be logged in as the local superuserroot if the -localauth flag is included. 

SEE ALSO

the CellServDB(5) manpage,the KeyFile(5) manpage,the ThisCell(5) manpage,the UserList(5) manpage,the bos(8) manpage

IBM AFS Quick Beginnings

IBM AFS Administration Guide 

COPYRIGHT

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It wasconverted from HTML to POD by software written by Chas Williams and RussAllbery, based on work by Alf Wachsmann and Elizabeth Cassell.


 

Index

NAME
SYNOPSIS
DESCRIPTION
CAUTIONS
OPTIONS
EXAMPLES
PRIVILEGE REQUIRED
SEE ALSO
COPYRIGHT

This document was created byman2html,using the manual pages.