(no commit message)
[openafs-wiki.git] / HowToBuildOpenAFSFromSource.mdwn
index 596ed41..c12ded2 100644 (file)
@@ -109,9 +109,9 @@ In addition to the above, the following tools are needed to build OpenAFS
 from a git checkout:
 
 - git
-- libtool
 - autoconf 2.60 or better
 - automake
+- libtool
 
 The compiler used must be capable of building kernel modules for the target
 platform.
@@ -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,33 +142,90 @@ 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 libtool autoconf automake 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 make flex bison rpm-build
-     $ yum install glibc-devel krb5-devel ncurses-devel pam-devel kernel-devel-$(uname -r)
+     $ sudo yum install git-core gcc autoconf automake libtool make flex bison
+     $ sudo yum install glibc-devel krb5-devel perl-devel ncurses-devel pam-devel kernel-devel-$(uname -r)
+     $ sudo yum install perl-devel perl-ExtUtils-Embed
+
+The following additional packages are needed to [[build RPM packages|HowToBuildOpenAfsRpmPackages]].
+
+     $ sudo yum install wget rpm-build redhat-rpm-config
 
 ### Solaris Packages ###
 
-The [OpenCSW](http://www.opencsw.org) project provides software packages for
-solaris which can be easily installed.  Follow the [OpenCSW getting
-started](http://www.opencsw.org/manual/for-administrators/getting-started.html)
+[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.  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
+
+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.
+
+#### Solaris 10 and earlier ####
+
+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
+
 Update your path to include `/opt/csw/bin`.
 
 With `pkgutil` installed, install the necessary packages;
 
-     $ sudo pkgutil --install git
-     $ sudo pkgutil --install gmake gcc4core flex bison automake autoconf libtool
-     $ sudo pkgutil --install libkrb5_dev libncurses_dev
+     $ sudo pkgutil -y --install git
+     $ 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 ##
 
@@ -362,7 +420,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: