(no commit message)

[openafs-wiki.git] / AFSLore / HowToBuildOpenAFSFromSource.mdwn

diff --git a/AFSLore/HowToBuildOpenAFSFromSource.mdwn b/AFSLore/HowToBuildOpenAFSFromSource.mdwn
index ead2fd6..10cad42 100644 (file)
--- a/AFSLore/HowToBuildOpenAFSFromSource.mdwn
+++ b/AFSLore/HowToBuildOpenAFSFromSource.mdwn
@@ -9,7 +9,7 @@ These are notes on how to build [[OpenAFS]] from source code. Note that [[OpenAF
 - automake
 - perl 5.6
 - make
-- compiler/linker (e.g. gcc tool chain on linux)
+- compiler/linker (e.g. gcc tool chain)
 - lex/yacc (flex/bison)
 
 #### <a name="Libraries"></a> Libraries
@@ -17,6 +17,7 @@ These are notes on how to build [[OpenAFS]] from source code. Note that [[OpenAF
 - libc
 - kerberos, optional, but recommended
 - ncurses
+- pam
 - kernel headers
 
 The required packages to build [[OpenAFS]] on Debian-based linux distributions can be installed with,
@@ -27,7 +28,7 @@ The required packages to build [[OpenAFS]] on Debian-based linux distributions c
 On RPM based linux distributions, the packages required are,
 
      yum install gcc autoconf automake make flex bison rpm-build
-     yum install glibc-devel krb5-devel ncurses-devel pam-devel kernel-devel
+     yum install glibc-devel krb5-devel ncurses-devel pam-devel kernel-devel-$(uname -r)
 
 ### <a name="Getting the Source Code"></a> Getting the Source Code
 
@@ -43,7 +44,7 @@ To build [[OpenAFS]] with Kerberos 5 support, and with a custom install path. Be
 
        cd openafs-stable-1_4_x.
        ./regen.sh
-       ./configure --prefix=/usr/local/openafs --with-krb5-conf=(full path to krb5-config script)
+       ./configure --prefix=/usr/local/openafs --with-krb5-conf=(full path to krb5-config script) --with-linux-kernel-headers=(full path to desired kernel headers)
        make
        sudo make install
 
@@ -82,10 +83,22 @@ The makesrpm.pl script, available in the directory src/packaging/RedHat, is used
 
     makesrpm.pl openafs-<version>-src.tar.bz2 openafs-<version>-doc.tar.bz2
 
-This will create the srpm file openafs-.src.rpm. Use rpmbuld with the --rebuild option, which will run configure and then make to build the binaries, and create the rpm files. The rpm files will be placed into /usr/src/redhat/
+This will create the srpm file openafs-<version>.src.rpm. Use rpmbuld with the --rebuild option, which will run configure and then make to build the binaries, and create the rpm files. The rpm files will be placed into /usr/src/redhat/
 
     rpmbuild --rebuild openafs-<version>.src.rpm
 
+#### If You are Working with a Git Clone and Would Like to Make Your Own tar.bz2 Files
+Start by making sure the root directory of your openafs clone is named to match the version you have checked out.  For instance, if you have checked out openafs-stable-1_4_14 from git, then the directory should be named "openafs-1.4.14".
+
+NOTE: If your have checked out a newer version of openafs (1.6), you may want to make sure that a .version file exists in the openafs root directory.  It simply holds a bit of text equivalent to the tag on your checkout.
+
+Now tar and compress <afsroot> and <afsroot>/doc like so.
+
+    tar -cvjf openafs-<version>-src.tar.bz2 <afsroot>
+    tar -cvjf openafs-<version>-doc.tar.bz2 <afsroot>/doc
+
+After that, you can run makesrpm.pl as stated above.
+
 ### <a name="Running the Test Suite"></a> Running the Test Suite
 
 [[OpenAFS]] includes a suite of basic test scripts in the src/tests directory. The tests directory also contains a utility called afs-newcell.pl to create a test cell on a single host. You will need to already have a kerberos server running with an AFS principal and an admin principal. You should also have a partitions mounted as /vicepa and /vicepb for the test volumes. See the src/tests/afs-newcell.pl for details.