none
authorMichael Meffie <mmeffie@sinenomine.net>
Mon, 12 Nov 2007 19:46:40 +0000 (19:46 +0000)
committerMichael Meffie <mmeffie@sinenomine.net>
Mon, 12 Nov 2007 19:46:40 +0000 (19:46 +0000)
AFSLore/HowToBuildOpenAFSFromSource.mdwn
AFSLore/ResourcesFAQ.mdwn

index d4a8ebf..db9c63d 100644 (file)
@@ -35,23 +35,25 @@ First you need to run cvs login. This step is normally only done once. A ~/.cvsp
        cvs -d :pserver:anonymous@cvs.openafs.org:/cvs  login
        password is anonymous
 
-To check out the 1.4 branch:
+Before doing a CVS check out, you'll need to decide which branch you want to check out. The trunk is for bleeding edge development and may not even build. The current stable series is openafs-stable-1\_4\_x and the current development work is going on the openafs-devel-1\_5\_x branch.
 
-       cvs -d :pserver:anonymous@cvs.openafs.org:/cvs co -r openafs-stable-1_4_x openafs
+See the CVSWeb interface at <http://www.openafs.org/frameset/cgi-bin/cvsweb.cgi/openafs/> for the full list of available branches and tags.
 
-To check out the 1.5 development branch:
+To check out the stable branch:
 
-       cvs -d :pserver:anonymous@cvs.openafs.org:/cvs co -r openafs-devel-1_5_x openafs
+       cvs -d :pserver:anonymous@cvs.openafs.org:/cvs checkout -r openafs-stable-1_4_x openafs
 
-See the CVSWeb interface at <http://www.openafs.org/frameset/cgi-bin/cvsweb.cgi/openafs/> to see a full list of available branches and tags
+To check out the development branch:
 
-CVS snapshots do not include files generated by autoconf; You can run regen.sh at the top level to create these files. You will need to have autoconf and automake installed on your system.
+       cvs -d :pserver:anonymous@cvs.openafs.org:/cvs checkout -r openafs-devel-1_5_x openafs
+
+This will create a source tree in a directory named openafs.
 
 ### <a name="Building the Binaries"></a> Building the Binaries
 
 #### <a name="Transarc Paths"></a> Transarc Paths
 
-By convention, [[OpenAFS]] server binaries and related files are located in /usr/afs, and client binaries and related files are located in /usr/vice. These are known as Transarc paths, so called because that is is the convention used by Transarc, the company that first commercized AFS.
+By convention, [[OpenAFS]] server binaries and related files are located in /usr/afs, and client binaries and related files are located in /usr/vice. These are known as Transarc paths, so called because that is is the convention used by Transarc, the company that first commercialized AFS.
 
 To build [[OpenAFS]] with Kerberos 5 support and the traditional, Transarc paths:
 
index db8516a..40376ba 100644 (file)
@@ -20,7 +20,7 @@ The Administration Section of the [[AFSFrequentlyAskedQuestions]].
         <li><a href="#4.08  Where can I find AFS relat"> 4.08 Where can I find AFS related GIFs?</a></li>
         <li><a href="#4.09  Gibt es eine deutsche AFS"> 4.09 Gibt es eine deutsche AFS Benutzer Gruppe?</a></li>
         <li><a href="#4.10  Donde puedo encontrar info"> 4.10 Donde puedo encontrar informacion en Espanol sobre AFS?</a></li>
-        <li><a href="#4.11 Is there a book on AFS ??"> 4.11 Is there a book on AFS ??</a></li>
+        <li><a href="#4.11 Are there books on AFS?"> 4.11 Are there books on AFS?</a></li>
         <li><a href="#4.12 Where can I find tools to u"> 4.12 Where can I find tools to use with AFS?</a></li>
         <li><a href="#4.13 Where can I find stuff from"> 4.13 Where can I find stuff from the old transarc.com web site?</a></li>
       </ul>
@@ -97,9 +97,11 @@ Ueber diese Adresse werden "subscribe" und "unsubscribe" Requests bearbeitet.
 
 Hay algunas notas en Espanol sobre AFS en: <http://w3.ing.puc.cl/~cet/afs.html>
 
-### <a name="4.11 Is there a book on AFS ??"></a> 4.11 Is there a book on AFS ??
+### <a name="4.11 Are there books on AFS?"></a> 4.11 Are there books on AFS?
 
-Yes, though now it is out of print. "Managing AFS: The Andrew File System" by Richard Campbell was published by Prentice Hall in February, 1998. You may be able to find copies at on-line stores such as Amazon, <http://www.amazon.com/exec/obidos/ASIN/0138027293/qid%3D1023720253/ref%3Dsr%5F11%5F0%5F1/104-0953845-2989550>.
+"Managing AFS: The Andrew File System" by Richard Campbell was published by Prentice-Hall in February, 1998. It is supposedly out of print, but somehow there is always a copy or two available from Amazon [here.](http://www.amazon.com/exec/obidos/ASIN/0138027293/qid%3D1023720253/ref%3Dsr%5F11%5F0%5F1/104-0953845-2989550.)
+
+Recently a new book has come out, "Distributed Services with [[OpenAFS]]: for Enterprise and Education" by Wolfgang A. Gehrke and Franco Milicchio. It's also available [through Amazon](http://www.amazon.com/Distributed-Services-OpenAFS-Enterprise-Education/dp/3540366334/ref=pd_sim_b) and probably through most other on-line and brick-and-mortar stores. I ([[SteveSimmons]]) checked with a co-worker who has read it. He describes it as good for people who've not seen AFS before and might be setting up from scratch.
 
 ### <a name="4.12 Where can I find tools to u"></a> 4.12 Where can I find tools to use with AFS?