openafs/doc/html/AdminReference/auarf033.htm

62 lines
4.0 KiB
HTML
Raw Normal View History

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
<HTML><HEAD>
<TITLE>Administration Reference</TITLE>
<!-- Begin Header Records ========================================== -->
<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
</HEAD><BODY>
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
<BODY bgcolor="ffffff">
<!-- End Header Records ============================================ -->
<A NAME="Top_Of_Page"></A>
<H1>Administration Reference</H1>
<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>
<P>
<H2><A NAME="HDRSV_THISCELL" HREF="auarf002.htm#ToC_31">ThisCell (server version)</A></H2>
<P><STRONG>Purpose</STRONG>
<A NAME="IDX3980"></A>
<A NAME="IDX3981"></A>
<A NAME="IDX3982"></A>
<A NAME="IDX3983"></A>
<A NAME="IDX3984"></A>
<P>Defines server machine's cell membership
<P><STRONG>Description</STRONG>
<P>The server version of the <B>ThisCell</B> file defines the complete
Internet domain-style name (for example, <B>abc.com</B>) of the
cell to which the server machine belongs. It must reside in the
<B>/usr/afs/etc</B> directory on every AFS server machine.
<P>The file is in ASCII format and contains a character string on a single
line. The initial version of the file is created with the <B>bos
setcellname</B> command during the installation of the cell's first
file server machine, and the <I>IBM AFS Quick Beginnings</I> includes
instructions for copying it over to additional server machine during their
installation.
<P>The only reason to edit the file is as part of changing the cell's
name, which is strongly discouraged because of the large number of
configuration changes involved. In particular, changing the cell name
requires rebuilding the entire Authentication Database, because the
Authentication Server combines the cell name it finds in this file with each
user and server password and converts the combination into an encryption key
before recording it in the Database.
<P>The server version of the <B>ThisCell</B> file is distinct from the
client version, which resides in the <B>/usr/vice/etc</B> directory on
each AFS client machine. If a server machine also runs as a client, it
is acceptable for the server and client versions of the file on the same
machine to name different cells. However, the behavior that results
from this configuration can be more confusing than useful.
<P><STRONG>Related Information</STRONG>
<P><A HREF="auarf032.htm#HDRCLI_THISCELL">ThisCell (client version)</A>
<P><A HREF="auarf116.htm#HDRBOS_SETCELLNAME">bos setcellname</A>
<P>
<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>
<!-- Begin Footer Records ========================================== -->
<P><HR><B>
<br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
</B>
<!-- End Footer Records ============================================ -->
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>