afsmonitor-document-stat-entries-correctly-20040729
[openafs.git] / doc / html / AdminReference / auarf020.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="auarf019.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="auarf021.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_CSDB" HREF="auarf002.htm#ToC_18">CellServDB (server version)</A></H2>
19 <P><STRONG>Purpose</STRONG>
20 <A NAME="IDX3920"></A>
21 <A NAME="IDX3921"></A>
22 <A NAME="IDX3922"></A>
23 <A NAME="IDX3923"></A>
24 <A NAME="IDX3924"></A>
25 <A NAME="IDX3925"></A>
26 <A NAME="IDX3926"></A>
27 <A NAME="IDX3927"></A>
28 <P>Lists the local cell's database server machines
29 <P><STRONG>Description</STRONG>
30 <P>The server version of the <B>CellServDB</B> file lists the local
31 cell's database server machines. These machines run the
32 Authentication Server, Backup Server, Protection Server, and Volume Location
33 (VL) Server (the <B>kaserver</B>, <B>buserver</B>,
34 <B>ptserver</B>, and <B>vlserver</B>) processes, which maintain the
35 cell's administrative AFS databases. The initial version of the
36 file is created with the <B>bos setcellname</B> command during the
37 installation of the cell's server machine, which is automatically
38 recorded as the cell's first database server machine. When adding
39 or removing database server machines, be sure to update this file
40 appropriately. It must reside in the <B>/usr/afs/etc</B> directory
41 on each AFS server machine.
42 <P>The database server processes consult the <B>CellServDB</B> file to
43 learn about their peers, with which they must maintain constant connections in
44 order to coordinate replication of changes across the multiple copies of each
45 database. The other AFS server processes consult the file to learn
46 which machines to contact for information from the databases when they need
47 it.
48 <P>Although the <B>CellServDB</B> file is in ASCII format, do not use a
49 text editor to alter it. Instead always use the appropriate commands
50 from the <B>bos</B> command suite:
51 <UL>
52 <P><LI>The <B>bos addhost</B> command to add a machine to the file
53 <P><LI>The <B>bos listhosts</B> command to display the list of machines from
54 the file
55 <P><LI>The <B>bos removehost</B> command to remove a machine from the file
56 </UL>
57 <P>In cells that run the United States edition of AFS and use the Update
58 Server to distribute the contents of the <B>/usr/afs/etc</B> directory, it
59 is customary to edit only the copy of the file stored on the system control
60 machine. In cells that run the international version of AFS, edit the
61 file on each server machine individually. For instructions on adding
62 and removing database server machine, see the <I>IBM AFS Quick
63 Beginnings</I> chapter on installing additional server machines.
64 <P>The server version of the <B>CellServDB</B> file is distinct from the
65 client version, which resides in the <B>/usr/vice/etc</B> directory on
66 each AFS client machine. The server version lists only the local
67 cell's database server machines, whereas the client version lists the
68 database server machines in every AFS cell that the cell administrator wants
69 the machine's users to be able to access.
70 <P><STRONG>Related Information</STRONG>
71 <P><A HREF="auarf019.htm#HDRCLI_CSDB">CellServDB (client version)</A>
72 <P><A HREF="auarf094.htm#HDRBOS_ADDHOST">bos addhost</A>
73 <P><A HREF="auarf106.htm#HDRBOS_LISTHOSTS">bos listhosts</A>
74 <P><A HREF="auarf110.htm#HDRBOS_REMOVEHOST">bos removehost</A>
75 <P><A HREF="auarf116.htm#HDRBOS_SETCELLNAME">bos setcellname</A>
76 <P><A HREF="auarf125.htm#HDRBUSERVER">buserver</A>
77 <P><A HREF="auarf198.htm#HDRKASERVER">kaserver</A>
78 <P><A HREF="auarf227.htm#HDRPTSERVER">ptserver</A>
79 <P><A HREF="auarf249.htm#HDRVLSERVER">vlserver</A>
80 <P><A HREF="auarf240.htm#HDRUPCLIENT">upclient</A>
81 <P><A HREF="auarf241.htm#HDRUPSERVER">upserver</A>
82 <P><I>IBM AFS Quick Beginnings</I>
83 <P>
84 <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="auarf019.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="auarf021.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> 
85 <!-- Begin Footer Records  ========================================== -->
86 <P><HR><B> 
87 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved 
88 </B> 
89 <!-- End Footer Records  ============================================ -->
90 <A NAME="Bot_Of_Page"></A>
91 </BODY></HTML>