Section: AFS Command Reference (8)
bos setcellname - Sets the cell's name in ThisCell and CellServDB
>>> << -name
] >>> [-noauth
bos setc << -s <machine name >>> << -n <cell name >>>
<< [-c <cell name] >>> [-n] [-l] [-h]
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/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.
Issue this command only when the installing the cell's first AFS servermachine. The IBM AFS Quick Beginnings
explains how to copy over theThisCell
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.
- -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.
- Assigns the unprivileged identity anonymous to the issuer. Do notcombine this flag with the -localauth flag. For more details, seethe bos(8) manpage.
- 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.
- Prints the online help for this command. All other valid options areignored.
The following command defines the cell name abc.com
in the ThisCell
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
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.
IBM AFS Quick Beginnings
IBM AFS Administration Guide
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.
- PRIVILEGE REQUIRED
- SEE ALSO
This document was created byman2html,using the manual pages.