doc/html/AdminReference/auarf033.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="auarf032.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="auarf034.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="HDRSV_THISCELL" HREF="auarf002.htm#ToC_31">ThisCell (server version)</A></H2>
  19 <P><STRONG>Purpose</STRONG>
  20 <A NAME="IDX3980"></A>
  21 <A NAME="IDX3981"></A>
  22 <A NAME="IDX3982"></A>
  23 <A NAME="IDX3983"></A>
  24 <A NAME="IDX3984"></A>
  25 <P>Defines server machine's cell membership
  26 <P><STRONG>Description</STRONG>
  27 <P>The server version of the <B>ThisCell</B> file defines the complete
  28 Internet domain-style name (for example, <B>abc.com</B>) of the
  29 cell to which the server machine belongs. It must reside in the
  30 <B>/usr/afs/etc</B> directory on every AFS server machine.
  31 <P>The file is in ASCII format and contains a character string on a single
  32 line. The initial version of the file is created with the <B>bos
  33 setcellname</B> command during the installation of the cell's first
  34 file server machine, and the <I>IBM AFS Quick Beginnings</I> includes
  35 instructions for copying it over to additional server machine during their
  36 installation.
  37 <P>The only reason to edit the file is as part of changing the cell's
  38 name, which is strongly discouraged because of the large number of
  39 configuration changes involved. In particular, changing the cell name
  40 requires rebuilding the entire Authentication Database, because the
  41 Authentication Server combines the cell name it finds in this file with each
  42 user and server password and converts the combination into an encryption key
  43 before recording it in the Database.
  44 <P>The server version of the <B>ThisCell</B> file is distinct from the
  45 client version, which resides in the <B>/usr/vice/etc</B> directory on
  46 each AFS client machine. If a server machine also runs as a client, it
  47 is acceptable for the server and client versions of the file on the same
  48 machine to name different cells. However, the behavior that results
  49 from this configuration can be more confusing than useful.
  50 <P><STRONG>Related Information</STRONG>
  51 <P><A HREF="auarf032.htm#HDRCLI_THISCELL">ThisCell (client version)</A>
  52 <P><A HREF="auarf116.htm#HDRBOS_SETCELLNAME">bos setcellname</A>
  53 <P>
  54 <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="auarf032.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="auarf034.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>
  55 <!-- Begin Footer Records  ========================================== -->
  56 <P><HR><B>
  57 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  58 </B>
  59 <!-- End Footer Records  ============================================ -->
  60 <A NAME="Bot_Of_Page"></A>
  61 </BODY></HTML>