doc/html/AdminReference/auarf116.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf115.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf117.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRBOS_SETCELLNAME" HREF="auarf002.htm#ToC_130">bos setcellname</A></H2>
  19 <A NAME="IDX4622"></A>
  20 <A NAME="IDX4623"></A>
  21 <A NAME="IDX4624"></A>
  22 <A NAME="IDX4625"></A>
  23 <A NAME="IDX4626"></A>
  24 <A NAME="IDX4627"></A>
  25 <A NAME="IDX4628"></A>
  26 <A NAME="IDX4629"></A>
  27 <P><STRONG>Purpose</STRONG>
  28 <P>Sets the cell's name in the <B>/usr/afs/etc/ThisCell</B> and
  29 <B>/usr/afs/etc/CellServDB</B> files
  30 <P><STRONG>Synopsis</STRONG>
  31 <PRE><B>bos setcellname -server</B> &lt;<VAR>machine&nbsp;name</VAR>>  <B>-name</B> &lt;<VAR>cell&nbsp;name</VAR>>
  32                 [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]  [<B>-localauth</B>]  [<B>-help</B>]
  33
  34 <B>bos setc -s</B> &lt;<VAR>machine&nbsp;name</VAR>>  <B>-n</B> &lt;<VAR>cell&nbsp;name</VAR>>  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-n</B>]  [<B>-l</B>]  [<B>-h</B>]
  35 </PRE>
  36 <P><STRONG>Description</STRONG>
  37 <P>The <B>bos setcellname</B> command establishes the cell's name and
  38 makes the server machine named by the <B>-server</B> argument a member of
  39 it, by recording the value of the <B>-name</B> argument in two files which
  40 it creates on the local disk:
  41 <UL>
  42 <P><LI><B>/usr/afs/etc/ThisCell</B>
  43 <P><LI><B>/usr/afs/etc/CellServDB</B>. The cell name appears on the
  44 first line in the file, preceded by the required <TT>></TT> symbol.
  45 The machine name specified with the <B>-server</B> argument appears on the
  46 second line along with its IP address as obtained from the cell's naming
  47 service. The machine is thus designated as the cell's first
  48 database server machine.
  49 </UL>
  50 <P><STRONG>Cautions</STRONG>
  51 <P>Issue this command only when the installing the cell's first AFS
  52 server machine. The <I>IBM AFS Quick Beginnings</I> explains how to
  53 copy over the <B>ThisCell</B> and <B>CellServDB</B> files from this or
  54 another appropriate machine during installation of additional server
  55 machines.
  56 <P>Be sure to choose a satisfactory cell name when issuing this command,
  57 because changing a cell's name is very complicated; for one thing,
  58 it requires changing every password in the Authentication Database.
  59 Consult the <I>IBM AFS Administration Guide</I> for advice on choosing a
  60 cell name. If changing the cell's name is absolutely necessary,
  61 contact AFS Product Support for complete instructions.
  62 <P><STRONG>Options</STRONG>
  63 <DL>
  64 <P><DT><B><B>-server</B>
  65 </B><DD>Indicates the server machine on which to set the cell name in the
  66 <B>ThisCell</B> and <B>CellServDB</B> file. It is always the
  67 first machine installed in a cell. Identify the machine by IP address
  68 or its host name (either fully-qualified or abbreviated unambiguously).
  69 For details, see the introductory reference page for the <B>bos</B>
  70 command suite.
  71 <P><DT><B><B>-name</B>
  72 </B><DD>Defines the cell name, using standard Internet domain name format (the
  73 actual domain name is usually appropriate). Examples are
  74 <B>abc.com</B> for the ABC Corporation and
  75 <B>stateu.edu</B> for the State University. It must match
  76 the value of the <B>-cell</B> argument, if that is provided.
  77 <P><DT><B><B>-cell</B>
  78 </B><DD>Names the cell in which to run the command. Do not combine this
  79 argument with the <B>-localauth</B> flag. For more details, see the
  80 introductory <B>bos</B> reference page.
  81 <P><DT><B><B>-noauth</B>
  82 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  83 issuer. Do not combine this flag with the <B>-localauth</B>
  84 flag. For more details, see the introductory <B>bos</B> reference
  85 page.
  86 <P><DT><B><B>-localauth</B>
  87 </B><DD>Constructs a server ticket using a key from the local
  88 <B>/usr/afs/etc/KeyFile</B> file. The <B>bos</B> command
  89 interpreter presents the ticket to the BOS Server during mutual
  90 authentication. Do not combine this flag with the <B>-cell</B> or
  91 <B>-noauth</B> options. For more details, see the introductory
  92 <B>bos</B> reference page.
  93 <P><DT><B>-help
  94 </B><DD>Prints the online help for this command. All other valid options
  95 are ignored.
  96 </DL>
  97 <P><STRONG>Examples</STRONG>
  98 <P>The following command defines the cell name <B>abc.com</B> in
  99 the <B>ThisCell</B> and <B>CellServDB</B> files on the machine
 100 <B>fs1.abc.com</B> as it is installed as the cell's
 101 first server machine.
 102 <PRE>   % <B>bos setcellname -server fs1.abc.com -name abc.com</B>
 103
 104 </PRE>
 105 <P><STRONG>Privilege Required</STRONG>
 106 <P>Authorization checking is normally turned off during installation, which is
 107 the only recommended time to use this command; in this case no privilege
 108 is required. If authorization checking is turned on, the issuer must be
 109 listed in the <B>/usr/afs/etc/UserList</B> file on the machine named by
 110 the <B>-server</B> argument, or must be logged in as the local superuser
 111 <B>root</B> if the <B>-localauth</B> flag is included.
 112 <P><STRONG>Related Information</STRONG>
 113 <P><A HREF="auarf020.htm#HDRSV_CSDB">CellServDB (server version)</A>
 114 <P><A HREF="auarf023.htm#HDRKEYFILE">KeyFile</A>
 115 <P><A HREF="auarf033.htm#HDRSV_THISCELL">ThisCell (server version)</A>
 116 <P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
 117 <P><A HREF="auarf093.htm#HDRBOS_INTRO">bos</A>
 118 <P><I>IBM AFS Quick Beginnings</I>
 119 <P><I>IBM AFS Administration Guide</I>
 120 <P>
 121 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf115.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf117.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 122 <!-- Begin Footer Records  ========================================== -->
 123 <P><HR><B>
 124 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 125 </B>
 126 <!-- End Footer Records  ============================================ -->
 127 <A NAME="Bot_Of_Page"></A>
 128 </BODY></HTML>