My COPR repo doesn't support 4.5 kernels, but has openafs 1.6.17 packages with backpo...
[openafs-wiki.git] / HowToBuildOpenAFSFromSource.mdwn
index 80d050c..080c4cb 100644 (file)
@@ -131,6 +131,7 @@ The following development libraries are needed:
 
 - libc
 - kerberos 5
+- perl
 - ncurses (optional, needed to build scout/afsmonitor)
 - pam (optional)
 - kernel headers
@@ -141,36 +142,50 @@ support, which is *strongly* recommended.
 
 ### Linux Debian Packages ###
 
+On recent versions of Debian, use the apt-get build-dep command to install the needed
+build dependencies,
+
+    $ sudo apt-get build-dep openafs
+    $ sudo apt-get install linux-headers-$(uname -r)
+
 On a Debian 6, the required packages can be install with the following commands apt-get commands,
 
-    $ apt-get install git autoconf automake libtool make gcc flex bison
-    $ apt-get install libc6-dev libkrb5-dev libncurses5-dev linux-headers-$(uname -r)
+    $ sudo apt-get install git autoconf automake libtool make gcc flex bison
+    $ sudo apt-get install libc6-dev libkrb5-dev libperl-dev libncurses5-dev linux-headers-$(uname -r)
 
 ### Linux RPM Packages ###
 
 On a RedHat-based linux distributions, all of the required packages can be
 installed with the following yum commands,
 
-     $ yum install git-core gcc autoconf automake libtool make flex bison rpm-build
-     $ yum install glibc-devel krb5-devel ncurses-devel pam-devel kernel-devel-$(uname -r)
+     $ yum install git-core gcc autoconf automake libtool make flex bison
+     $ yum install glibc-devel krb5-devel perl-devel ncurses-devel pam-devel kernel-devel-$(uname -r)
+
+The following additional packages are needed to [[build RPM packages|HowToBuildOpenAfsRpmPackages]].
+
+     $ yum install wget perl-devel perl-ExtUtils-Embed rpm-build
 
 ### Solaris Packages ###
 
 [Oracle Solaris Studio][1] can be used to build OpenAFS binaries on the
 solaris platform. Solaris Studio is freely available for the solaris and linux
-platforms with a no-cost Oracle Technology Network (OTN) account. Follow the
-package installer instructions for your platform type and version.
+platforms with a no-cost Oracle Technology Network (OTN) account.  For recent
+versions of Solaris, use the `pkg' command to install Solaris Studio.  Follow the
+package installer instructions on the Solaris Studio download page for
+your platform type and version. This requires you to create and download a key
+and certificate using your OTN account.
 
 [1]: http://www.oracle.com/technetwork/server-storage/solarisstudio
 
-The OpenAFS build process requires the `gencat` program. Verify
-`/usr/bin/gencat` is available, otherwise install the `SUNWloc` package.
+All the tools and libs needed to build OpenAFS are available with the `pkg`
+command on Solaris 11.  Earlier versions of Solaris require third party tools
+and libs.
 
-     $ sudo pkg install SUNWloc
+#### Solaris 10 and earlier ####
 
-The [OpenCSW][2] project provides software packages for solaris which can be
-easily installed.  Follow the [OpenCSW getting started][3] instructions to
-setup the `pkgutil` package manager tool.
+The [OpenCSW][2] project provides software packages for solaris 10 and earlier
+which can be easily installed to build OpenAFS.  Follow the [OpenCSW getting started][3]
+instructions to setup the `pkgutil` package manager tool.
 
 [2]: http://www.opencsw.org
 [3]: http://www.opencsw.org/manual/for-administrators/getting-started.html
@@ -183,6 +198,33 @@ With `pkgutil` installed, install the necessary packages;
      $ sudo pkgutil -y --install gmake flex bison gsed automake autoconf libtool
      $ sudo pkgutil -y --install libkrb5_dev libncurses_dev
 
+Note: Is a perl devel lib needed on solaris?
+
+#### Solaris 11 ####
+
+Install [SolarisStudio][1] using the `pkg' command. You will need an SSL
+certificate and key, which can be created using your OTN account. See the instructions
+on the Solaris Studio download page.
+
+(Alternately, install Solaris Studio from the tar file installer, and then find
+and install any missing dependencies.)
+
+Use the `pkg` tool to install the other necessary packages:
+
+      $ sudo pkg install git
+      $ sudo pkg install text/locale
+      $ sudo pkg install gnu-coreutils gnu-binutils gnu-sed
+      $ sudo pkg install make flex bison
+      $ sudo pkg install automake autoconf libtool
+      $ sudo pkg install onbld
+
+If you have dependency issues with automake, try automake-110
+
+If you have installed Solaris Studio via the tar file, you may need to install
+the `system/header' package manually:
+
+      $ sudo pkg install system/header
+
 
 ## Getting the Source Code ##
 
@@ -377,7 +419,7 @@ See the Quick Start Guide for complete instructions to setup
 the OpenAFS cache manager and servers.
 
 The 'make dest' command places workstation binaries in the sub-directories of
-<sysname>/dest: bin, etc, man, lib, include. Optionally, copy these to you
+&lt;sysname&gt;/dest: bin, etc, man, lib, include. Optionally, copy these to you
 local filesystem or install them in an appropriate path in AFS. To install
 these file into your local filesystem: