doc/html/QuickStartUnix/auqbg004.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Quick Beginnings</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3574/auqbg000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 2 Oct 2000 at 12:25:35                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Mon, 02 Oct 2000 12:25:35">
   8 <META HTTP-EQUIV="review" CONTENT="Tue, 02 Oct 2001 12:25:35">
   9 <META HTTP-EQUIV="expires" CONTENT="Wed, 02 Oct 2002 12:25:35">
  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>Quick Beginnings</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auqbg002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auqbg003.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="auqbg005.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auqbg009.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <HR><H1><A NAME="HDRWQ6" HREF="auqbg002.htm#ToC_7">Installation Overview</A></H1>
  18 <P>This chapter describes the type of instructions provided in
  19 this guide and the hardware and software requirements for installing
  20 AFS<SUP><SUP>(R)</SUP></SUP>.
  21 <P>Before beginning the installation of your cell's first machine, read
  22 this chapter and the material from the <I>IBM AFS Administration Guide</I>
  23 listed in <A HREF="#HDRWQ8">Recommended Reading List</A>. It is also best to read through <A HREF="auqbg005.htm#HDRWQ17">Installing the First AFS Machine</A> before beginning the installation, so that
  24 you understand the overall scope of the installation procedure.
  25 Similarly, before installing additional server or client machines it is best
  26 to read through <A HREF="auqbg006.htm#HDRWQ99">Installing Additional Server Machines</A> and <A HREF="auqbg007.htm#HDRWQ133">Installing Additional Client Machines</A>.
  27 <P>If you are already running a version of AFS, consult the upgrade
  28 instructions in the <I>IBM AFS Release Notes</I> or contact the AFS
  29 Product Support group before proceeding with the installation.
  30 <HR><H2><A NAME="HDRWQ7" HREF="auqbg002.htm#ToC_8">The Procedures Described in this Guide</A></H2>
  31 <P>This guide describes two types of installation
  32 procedures: initial procedures (such as installing the first AFS machine
  33 or incorporating AFS into the kernel) and as-needed procedures (such as
  34 installing additional server machines or client machines).
  35 <P><H3><A NAME="Header_9" HREF="auqbg002.htm#ToC_9">Required Initial Procedures</A></H3>
  36 <P>You must perform the following basic procedures to start using
  37 AFS.
  38 <P><H4><A NAME="Header_10">Incorporating AFS Into the Kernel</A></H4>
  39 <P>You must incorporate AFS modifications into the kernel of every AFS
  40 file server and client machine. Depending on the operating system, you
  41 either use a program for dynamic kernel loading, build a new static kernel, or
  42 can choose between the two. For your convenience, the instructions for
  43 incorporating AFS into the kernel appear in full in every chapter where you
  44 need to use them.
  45 <A NAME="IDX2197"></A>
  46 <A NAME="IDX2198"></A>
  47 <P><H4><A NAME="Header_11">Installing the First AFS Machine</A></H4>
  48 <P>You install the first AFS machine in your cell to function as both an
  49 AFS server and client machine. You can disable the client functionality
  50 after completing the installation, if you wish.
  51 <P>The first server machine in a cell performs several functions:
  52 <UL>
  53 <P><LI>It acts as the <I>system control machine</I> (if your AFS distribution
  54 includes the required encryption files), distributing certain configuration
  55 files to the other server machines in the cell
  56 <P><LI>It acts as the <I>binary distribution machine</I> for its system type,
  57 distributing AFS binaries to other server machines of its system type
  58 <P><LI>It acts as the first <I>database server machine</I>, running the
  59 server processes that maintain the AFS administrative databases
  60 </UL>
  61 <P>After you install server and client functionality, you complete other
  62 procedures specific to the first machine, including setting up the top levels
  63 of your cell's AFS filespace.
  64 <P><H3><A NAME="Header_12" HREF="auqbg002.htm#ToC_12">As-needed Procedures</A></H3>
  65 <P><H4><A NAME="Header_13">Upgrading the Operating System</A></H4>
  66 <P>Upgrading the operating system requires you to take several steps to
  67 protect data and AFS-modified binaries from being lost or overwritten.
  68 For guidelines, see <A HREF="#HDRWQ14">About Upgrading the Operating System</A>.
  69 <P><H4><A NAME="Header_14">Installing Additional File Server Machines</A></H4>
  70 <P>See <A HREF="auqbg006.htm#HDRWQ100">Installing an Additional File Server Machine</A>.
  71 <P><H4><A NAME="Header_15">Configuring or Decommissioning Database Server Machines</A></H4>
  72 <P>See <A HREF="auqbg006.htm#HDRWQ114">Installing Database Server Functionality</A> and <A HREF="auqbg006.htm#HDRWQ125">Removing Database Server Functionality</A>.
  73 <P><H4><A NAME="Header_16">Installing Additional AFS Client Machines</A></H4>
  74 <P>See <A HREF="auqbg007.htm#HDRWQ133">Installing Additional Client Machines</A>.
  75 <P><H4><A NAME="Header_17">Building AFS from Source Code</A></H4>
  76 <P>See <A HREF="auqbg008.htm#HDRWQ163">Appendix A,  Building AFS from Source Code</A>.
  77 <A NAME="IDX2199"></A>
  78 <A NAME="IDX2200"></A>
  79 <HR><H2><A NAME="HDRWQ8" HREF="auqbg002.htm#ToC_18">Recommended Reading List</A></H2>
  80 <P>To develop the best understanding of the overall scope of an
  81 installation procedure, read through the entire chapter or section that
  82 describes it before performing any actions.
  83 <P>In addition, familiarity with some basic AFS concepts can make the
  84 installation more efficient, because you understand better the purpose of the
  85 steps. The following is a prioritized list of material to read before
  86 installing the first AFS machine. At minimum, read the first chapter of
  87 the <I>IBM AFS Administration Guide</I>. Then continue your reading
  88 in the indicated order, as extensively as you can. It is more important
  89 at this point to read the conceptual material in each section than the
  90 instructions.
  91 <P><B>Selected Topics in the <I>IBM AFS Administration Guide</I></B>
  92 <UL>
  93 <P><LI>The chapter titled <I>An Overview of AFS Administration</I>
  94 <P><LI>Selected sections in the <I>Administering Server Machines</I>
  95 chapter: <I>Local Disk Files on a Server Machine</I>, <I>The Four
  96 Roles for a Server Machine</I>, <I>Maintaining the Server CellServDB
  97 File</I>
  98 <P><LI>Selected sections in the <I>Monitoring and Controlling Server
  99 Processes</I> chapter: <I>Controlling and Checking Process
 100 Status</I>
 101 <P><LI>Selected sections in the <I>Managing Server Encryption Keys</I>
 102 chapter: <I>About Server Encryption Keys</I>
 103 <P><LI>Selected sections in the <I>Managing Volumes</I> chapter:
 104 <I>About Volumes</I>, <I>Creating Read/write Volumes</I>, <I>Clones
 105 and Cloning</I>, <I>Mounting Volumes</I>
 106 <P><LI>Selected sections in the <I>Administering Client Machines and the Cache
 107 Manager</I> chapter: <I>Overview of Cache Manager
 108 Customization</I>, <I>Configuration and Cache-related Files on the Local
 109 Disk</I>, <I>Determining the Cache Type, Size, and Location</I>
 110 <P><LI>Selected sections in the <I>Managing Access Control Lists</I>
 111 chapter: <I>Protecting Data in AFS</I>
 112 </UL>
 113 <P><B>More Selected Topics in the <I>IBM AFS Administration
 114 Guide</I></B>
 115 <UL>
 116 <P><LI>Selected sections in the <I>Managing Volumes</I> chapter:
 117 <I>Creating and Releasing Read-only Volumes (Replication)</I>,
 118 <I>Creating Backup Volumes</I>
 119 <P><LI>Selected sections in the <I>Administering the Protection Database</I>
 120 chapter: <I>About the Protection Database</I>
 121 <P><LI>Selected sections in the <I>Administering User Accounts</I>
 122 chapter: <I>The Components of an AFS User Account</I>
 123 <P><LI>Selected sections in the <I>Managing Administrative Privilege</I>
 124 chapter: <I>An Overview of Administrative Privilege</I>
 125 </UL>
 126 <HR><H2><A NAME="HDRWQ9" HREF="auqbg002.htm#ToC_19">Requirements</A></H2>
 127 <P>You must comply with the following requirements to install AFS
 128 successfully.
 129 <A NAME="IDX2201"></A>
 130 <P><H3><A NAME="Header_20" HREF="auqbg002.htm#ToC_20">Login Identity</A></H3>
 131 <P>Log into the machine you are installing as the local superuser
 132 <B>root</B>. When instructed, also authenticate with AFS as the
 133 administrative user <B>admin</B>.
 134 <A NAME="IDX2202"></A>
 135 <A NAME="IDX2203"></A>
 136 <P><H3><A NAME="HDRWQ10" HREF="auqbg002.htm#ToC_21">General Requirements</A></H3>
 137 <UL>
 138 <P><LI>You must have the AFS Binary Distribution for each system type you are
 139 installing. Unless otherwise noted, the Binary Distribution includes
 140 software for both client and server machines. If you are using the
 141 CD-ROM version of the distribution, the machine you are installing must be
 142 able to access the CD-ROMs, either through a local CD drive or via an
 143 NFS<SUP><SUP>(R)</SUP></SUP> mount of a CD drive attached to a machine that is
 144 accessible by network.
 145 <P><LI>All AFS machines that belong to a cell must be able to access each other
 146 via the network.
 147 <P><LI>The machine must be running the standard, vendor-supplied version of the
 148 operating system supported by the current version of AFS. The operating
 149 system must already be installed on the machine's root partition.
 150 <P><LI>You must be familiar with the current operating system and disk
 151 configuration of the machine you are installing.
 152 <P><LI>All hardware and non-AFS software on the machine must be functioning
 153 normally.
 154 <P><LI>No critical processes can be running on the machine you are installing,
 155 because you must reboot it during the installation.
 156 </UL>
 157 <A NAME="IDX2204"></A>
 158 <A NAME="IDX2205"></A>
 159 <P><H3><A NAME="HDRWQ11" HREF="auqbg002.htm#ToC_22">File Server Machine Requirements</A></H3>
 160 <UL>
 161 <P><LI>Cell configuration is simplest if the first machine you install has the
 162 lowest IP address of any database server machine you currently plan to
 163 install. If you later configure a machine with a lower IP address as a
 164 database server machine, you must update the
 165 <B>/usr/vice/etc/CellServDB</B> file on all of your cell's client
 166 machines before the installation. For further discussion, see <A HREF="auqbg006.htm#HDRWQ114">Installing Database Server Functionality</A>.
 167 <P><LI>The partition mounted on the <B>/usr</B> directory must have at least
 168 18 MB of disk space available for storing the AFS server binaries (stored by
 169 convention in the <B>/usr/afs/bin</B> directory). If the machine is
 170 also a client, there must be additional local disk space available, as
 171 specified in <A HREF="#HDRWQ12">Client Machine Requirements</A>. The complete set of AFS binaries requires yet more
 172 space, but they are normally stored in an AFS volume rather than on a
 173 machine's local disk.
 174 <P>More significant amounts of space on the partition are required by the
 175 administrative databases stored in the <B>/usr/afs/db</B> directory and
 176 the server process log files stored in the <B>/usr/afs/logs</B>
 177 directory. The exact requirement depends on many factors, such as the
 178 size of your cell and how often you truncate the log files.
 179 <P><LI>There must be at least one partition (or logical volume, if the operating
 180 system and AFS support them) dedicated exclusively to storing AFS
 181 volumes. The total number and size of server partitions on all file
 182 server machines in the cell determines how much space is available for AFS
 183 files.
 184 </UL>
 185 <A NAME="IDX2206"></A>
 186 <A NAME="IDX2207"></A>
 187 <P><H3><A NAME="HDRWQ12" HREF="auqbg002.htm#ToC_23">Client Machine Requirements</A></H3>
 188 <UL>
 189 <P><LI>The partition mounted on the <B>/usr</B> directory must have at least
 190 4 MB of disk space available for storing the AFS client binaries and kernel
 191 library files (stored by convention in the <B>/usr/vice/etc</B>
 192 directory). The complete set of AFS binaries requires more space, but
 193 they are normally stored in an AFS volume rather than on a machine's
 194 local disk. For most system types, the instructions have you copy only
 195 the one kernel library file appropriate for the machine you are
 196 installing. If you choose to store all of the library files on the
 197 local disk, the space requirement can be significantly greater.
 198 <P><LI>On a client machine that uses a disk cache, there must be enough free
 199 space on the cache partition (by convention, mounted on the
 200 <B>/usr/vice/cache</B> directory) to accommodate the cache. The
 201 minimum recommended cache size is 10 MB, but larger caches generally perform
 202 better.
 203 <P><LI>On a client machine that uses a memory cache, there must be at least 5 MB
 204 of machine memory to devote to caching, but again more memory generally leads
 205 to better performance. For further discussion, see the sections in <A HREF="auqbg007.htm#HDRWQ133">Installing Additional Client Machines</A> about configuring the cache.
 206 </UL>
 207 <A NAME="IDX2208"></A>
 208 <A NAME="IDX2209"></A>
 209 <HR><H2><A NAME="HDRWQ13" HREF="auqbg002.htm#ToC_24">Supported System Types</A></H2>
 210 <P>The <I>IBM AFS Release Notes</I> for each AFS release
 211 list the supported system types. Support for subsequent revisions of an
 212 operating system often becomes available between AFS releases. The AFS
 213 Product Support group can provide details.
 214 <P>It is the goal of the AFS Development and Product Support groups to support
 215 AFS on a wide range of popular system types. Furthermore, each time an
 216 operating system vendor releases a new general availability version of a
 217 supported operating system, it is a goal to certify and support AFS on it
 218 within a short time. Support can be delayed a bit longer if it is
 219 necessary to generate completely new binaries.
 220 <P>It is not always possible to support AFS on every intermediate version of
 221 an operating system or for certain processor types. In some cases,
 222 platform limitations make certain AFS functionality (such as file server or
 223 NFS/AFS translator functionality) unavailable on one or more platforms.
 224 For a list of limitations, see the <I>IBM AFS Release Notes</I> or ask the
 225 AFS Product Support group.
 226 <A NAME="IDX2210"></A>
 227 <A NAME="IDX2211"></A>
 228 <A NAME="IDX2212"></A>
 229 <A NAME="IDX2213"></A>
 230 <HR><H2><A NAME="HDRWQ14" HREF="auqbg002.htm#ToC_25">About Upgrading the Operating System</A></H2>
 231 <P>Whenever you upgrade an AFS machine to a different operating
 232 system, you must take several actions to maintain proper AFS
 233 functionality. These actions include, but are not necessarily limited
 234 to, the following.
 235 <UL>
 236 <P><LI>Unmount the AFS server partitions (mounted at <B>/vicep</B><VAR>xx</VAR>
 237 directories) on all file server machines, to prevent the vendor-supplied
 238 <B>fsck</B> program from running on them when you reboot the machine
 239 during installation of the new operating system. Before upgrading the
 240 operating system, it is prudent to comment out commands in the machine's
 241 initialization file that remount the server partitions, to prevent them from
 242 being remounted until you can replace the standard <B>fsck</B> program
 243 with the AFS-modified version. The instructions in this guide for
 244 installing AFS server machines explain how to replace the <B>fsck</B>
 245 program.
 246 <P><LI>Protect the AFS-modified versions of commands and configuration files from
 247 being overwritten by vendor-supplied versions. These include
 248 <B>vfsck</B> (the AFS version of <B>fsck</B>), binaries for the UNIX
 249 remote services such as <B>inetd</B>, and configuration files such as the
 250 one for the Pluggable Authentication Module (PAM). After you have
 251 successfully installed the operating system, remember to move the AFS-modified
 252 commands and files back to the locations where they are accessed during normal
 253 functioning.
 254 <P><LI>Reformat the server partitions to accommodate AFS-specific information, in
 255 certain cases. The upgrade instructions that accompany the new AFS
 256 binaries for an affected platform always detail the required procedure.
 257 </UL>
 258 <A NAME="IDX2214"></A>
 259 <A NAME="IDX2215"></A>
 260 <A NAME="IDX2216"></A>
 261 <A NAME="IDX2217"></A>
 262 <HR><H2><A NAME="HDRWQ15" HREF="auqbg002.htm#ToC_26">The AFS Binary Distribution</A></H2>
 263 <P>The AFS Binary Distribution includes a separate CD-ROM for
 264 each supported system type, containing all AFS binaries and files for both
 265 server and client machines. The instructions in this guide specify when
 266 to mount the CD-ROM and which files or directories to copy to the local disk
 267 or into an AFS volume.
 268 <HR><H2><A NAME="HDRWQ16" HREF="auqbg002.htm#ToC_27">How to Continue</A></H2>
 269 <P>If you are installing the first AFS machine in your cell,
 270 proceed to <A HREF="auqbg005.htm#HDRWQ17">Installing the First AFS Machine</A>.
 271 <P>If you are installing an additional file server machine, or configuring or
 272 decommissioning a database server machine, proceed to <A HREF="auqbg006.htm#HDRWQ99">Installing Additional Server Machines</A>.
 273 <P>If you are installing an additional client machine, proceed to <A HREF="auqbg007.htm#HDRWQ133">Installing Additional Client Machines</A>.
 274 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auqbg002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auqbg003.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="auqbg005.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auqbg009.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 275 <!-- Begin Footer Records  ========================================== -->
 276 <P><HR><B>
 277 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 278 </B>
 279 <!-- End Footer Records  ============================================ -->
 280 <A NAME="Bot_Of_Page"></A>
 281 </BODY></HTML>