1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
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">
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="auqbg007.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="auqbg009.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>
18 <HR><H1><A NAME="HDRWQ163" HREF="auqbg002.htm#ToC_153">Appendix A. Building AFS from Source Code</A></H1>
19 <P>This chapter describes how to build AFS from source
21 <A NAME="IDX3090"></A>
22 <A NAME="IDX3091"></A>
23 <A NAME="IDX3092"></A>
24 <A NAME="IDX3093"></A>
25 <A NAME="IDX3094"></A>
26 <HR><H2><A NAME="HDRWQ164" HREF="auqbg002.htm#ToC_154">Loading the Source Files</A></H2>
27 <P>Working on an AFS client machine, perform these steps to
28 load the AFS source tree from the AFS Source Distribution.
30 <A NAME="IDX3095"></A>
31 <A NAME="IDX3096"></A>
32 <A NAME="IDX3097"></A>
33 <A NAME="IDX3098"></A>
34 <A NAME="IDX3099"></A>
35 <P><LI>Create and mount a volume for housing the AFS source tree. These
36 instructions name the volume <B>src.afs</B> and mount it at the
37 <B>/afs/</B><VAR>cellname</VAR><B>/afs/src</B> directory.
38 <P>Setting the <B>-maxquota</B> argument to <B>0</B> (zero) sets an
39 unlimited quota on the volume, which enables you to copy all of the files into
40 the volume without exceeding its quota. If you wish, you can set the
41 volume's quota to a finite value after you complete the copying
42 operation. At that point, use the <B>vos examine</B> command to
43 determine how much space the volume is occupying. Then issue the
44 <B>fs setquota</B> command to set a quota that is slightly larger.
46 # <B>vos create</B> <<VAR>machine name</VAR>> <<VAR>partition name</VAR>> <B>src.afs -maxquota 0</B>
48 # <B>cd /afs/.</B><VAR>cellname</VAR>
52 # <B>fs mkmount afs/src src.afs</B>
54 # <B>vos release root.cell</B>
56 # <B>fs checkvolumes</B>
59 <P><LI>On the local <B>/cdrom</B> directory, mount the CD-ROM that contains
60 the AFS source files. For instructions on mounting CD-ROMs (either
61 locally or remotely via NFS), consult the operating system
63 <A NAME="IDX3100"></A>
64 <A NAME="IDX3101"></A>
65 <P><LI>Copy the source files from the CD-ROM into the newly created
68 # <B>cd /cdrom/src</B>
70 # <B>cp -rp * /afs/.</B><VAR>cellname</VAR>/<B>afs/src</B>
74 <A NAME="IDX3102"></A>
75 <A NAME="IDX3103"></A>
76 <A NAME="IDX3104"></A>
77 <HR><H2><A NAME="HDRWQ165" HREF="auqbg002.htm#ToC_155">Compiling AFS Binaries Using the washtool Program</A></H2>
78 <P>The AFS distribution includes the <B>washtool</B>
79 program for managing a hierarchy of software development projects. The
80 program builds project trees for program editing, compilation, and
83 <P><LI>Create a subdirectory under the
84 <B>/afs/.</B><VAR>cellname</VAR><B>/afs</B> directory for each
85 system type for which you will build AFS binaries. Creating and
86 mounting a volume for each system type is recommended, but you can also simply
87 use the <B>mkdir</B> command. If you create a new volume, grant it
88 an unlimited quota to avoid running out of space during the build
91 # <B>cd /afs/.</B><VAR>cellname</VAR><B>/afs</B>
93 <P>If creating a new volume:
95 # <B>vos create</B> <<VAR>machine name</VAR>> <<VAR>partition name</VAR>> <VAR>sysname</VAR> <B>-maxquota 0</B>
97 # <B>fs mkmount</B> <VAR>sysname</VAR> <VAR>sysname</VAR>
99 <P>If not creating a new volume:
101 # <B>mkdir</B> <VAR>sysname</VAR>
104 <P><LI>In the directory for each system type, create subdirectories called
105 <B>dest</B>, <B>dest/bin</B>, and <B>obj</B>. If you plan
106 to use the <I>@sys</I> variable in pathnames that refer to these
107 directories, then you must use the conventional system names listed in the
108 <I>IBM AFS Release Notes</I>.
110 # <B>cd</B> <VAR>sysname</VAR>
114 # <B>mkdir dest/bin</B>
119 <P><LI>Create the indicated directories and symbolic links in the
120 <B>/afs/.</B><VAR>cellname</VAR><B>/afs</B> directory.
122 # <B>cd /afs/.</B><VAR>cellname</VAR><B>/afs</B>
124 # <B>ln -s @sys/dest dest</B>
126 # <B>ln -s @sys/obj obj</B>
128 # <B>ln -s . PARENT</B>
130 # <B>ln -s src/Makefile Makefile</B>
132 <P>The following is an example directory listing for the
133 <B>/afs/.</B><VAR>cellname</VAR><B>/afs</B> directory after
134 completing the preceding steps. It includes two example system
137 lrwxr-xr-x admin 12 Jun 18 11:26 Makefile->src/Makefile
138 lrwxr-xr-x admin 1 Jun 18 11:26 PARENT -> .
139 lrwxr-xr-x admin 9 Jun 18 11:25 dest -> @sys/dest
140 lrwxr-xr-x admin 8 Jun 18 11:25 obj -> @sys/obj
141 drwxrwxrwx admin 4096 Jun 18 11:24 rcs
142 drwxrwxrwx admin 2048 Jun 18 11:27 rs_aix42
143 drwxrwxrwx admin 2048 Jun 18 11:10 src
144 drwxrwxrwx admin 2048 Jun 18 11:27 sun4x_56
147 <P><LI><B>(Optional)</B> By default, the build procedure writes its results
148 into a destination directory for each system type called
149 <B>/afs/.</B><VAR>cellname</VAR><B>/afs/</B><VAR>sysname</VAR><B>/dest</B>.
150 To write the results to a different destination directory, create a link from
151 the <B>dest</B> directory to it.
153 # <B>cd /afs/.</B><VAR>cellname</VAR><B>/afs/</B><VAR>sysname</VAR>
155 # <B>ln -s</B> <VAR>full_path_of_alternate_directory</VAR> <B>dest</B>
158 <A NAME="IDX3105"></A>
159 <A NAME="IDX3106"></A>
160 <P><LI>For each system type you plan to build, copy the binary for the
161 <B>washtool</B> program to the directory specified in the AFS
162 <B>Makefile</B>, which is
163 <B>/afs/</B><VAR>cellname</VAR><B>/afs/</B><VAR>sysname</VAR><B>/dest/bin</B>.
164 If you prefer to store the program in a different directory, you can use the
165 WASHTOOL variable on the <B>make</B> command line as described in Step <A HREF="#LIWQ166">6</A>.
166 <P>If there is a volume that houses the AFS binaries for each system type (as
167 recommended), the conventional location for the <B>washtool</B> binary is
169 <B>/afs/</B><VAR>cellname</VAR><B>/</B><VAR>sysname</VAR><B>/usr/afsws/bin</B>
170 directory. Use the following instruction to copy it.
172 # <B>cd /afs/</B><VAR>cellname</VAR><B>/</B><VAR>sysname</VAR><B>/usr/afsws/bin</B>
174 # <B>cp washtool</B> <B>/afs/.</B><VAR>cellname</VAR><B>/afs/</B><VAR>sysname</VAR><B>/dest/bin</B>
176 <P>Otherwise, mount the (binary) AFS CD-ROM for this system type on the local
177 <B>/cdrom</B> directory, and copy the <B>washtool</B> binary directly
180 # <B>cd /cdrom/</B><VAR>sysname</VAR><B>/bin</B>
182 # <B>cp washtool</B> <B>/afs/.</B><VAR>cellname</VAR><B>/afs/</B><VAR>sysname</VAR><B>/dest/bin</B>
185 <A NAME="IDX3107"></A>
186 <A NAME="IDX3108"></A>
187 <A NAME="IDX3109"></A>
188 <A NAME="IDX3110"></A>
189 <A NAME="IDX3111"></A>
190 <A NAME="IDX3112"></A>
191 <P><LI><A NAME="LIWQ166"></A>Working in the
192 <B>/afs/.</B><VAR>cellname</VAR><B>/afs</B> directory on a
193 machine of the system type for which you are building AFS, issue the <B>make
194 install</B> command. Set the SYS_NAME variable to the appropriate
196 <P>If the <B>washtool</B> binary is not in the conventional directory
197 (<B>/afs/</B><VAR>cellname</VAR><B>/afs/</B><VAR>sysname</VAR><B>/dest/bin</B>),
198 set the WASHTOOL variable to the alternate full pathname of the binary.
200 # <B>cd /afs/.</B><VAR>cellname</VAR><B>/afs</B>
202 # <B>make SYS_NAME=</B><VAR>sysname</VAR> [<B>WASHTOOL=</B><VAR>alternate_washtool_directory</VAR>] <B>install</B>
206 <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="auqbg007.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="auqbg009.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>
207 <!-- Begin Footer Records ========================================== -->
209 <br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
211 <!-- End Footer Records ============================================ -->
212 <A NAME="Bot_Of_Page"></A>