Checkout and Build Instructions

This page contains instructions on how to get the source code and build Open Web Server. Instructions for installing the libraries and tools required to build Web Server from source are also described in this page. These instructions assume that you are familiar with your operating system's software installation tool such as apt-get, yum, pkg etc.

Operating System Requirements

This page includes instructions for building the source code for Web Server on the various operating systems listed in the following table.

Although, the server code does build on Solaris 10 and on Windows, there currently isn't an easy way to install all the libraries and tools that are needed to build the source code for the server. Therefore, the build instructions for compiling the server on Windows and on Solaris 10 are not available at this time.

Required Libraries and Tools

The following table lists the external libraries and tools that are required to build Web Server from source. The packages (for each operating system) that contain these libraries and tools are also captured in the table.

Mozilla LDAP C SDK

Some Linux distros do not provide packages containing Mozilla's LDAP C SDK. The following describes how to checkout, build and install Mozilla LDAP C SDK for use by Web Server's build framework.

Building LDAP C SDK on Linux

• Checkout Mozilla LDAP C SDK source code
  • cd
  • cvs -d :pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot co -P -rLDAPCSDK_6_0_5_RTM DirectorySDKSourceC
• Configure and build Mozilla LDAP C SDK
  • cd mozilla/directory/c-sdk
  • ./configure --with-sasl --with-nspr-inc=/usr/include/nspr --with-nspr-lib=/usr/lib --with-nspr --with-nss-inc=/usr/include/nss --with-nss-lib=/usr/lib/nss --with-nss --enable-clu
  • make
• Install the Mozilla LDAP C SDK header files and libraries for use by the Web Server build
  • cd ../../dist/
  • sudo mkdir /usr/local/include/mozldap /usr/local/lib/mozldap
  • sudo cp public/ldap/* /usr/local/include/mozldap/
  • sudo cp lib/* /usr/local/lib/mozldap/

Pre-build Instructions

In order to build the source code for Web Server you must install the libraries/tools that it depends on. The following describes the steps to install the libraries/tools described in the previous section.

OpenSolaris 2008.11

1. Update your OpenSolaris installation with all the packages and tools needed to build Web Server
   • pfexec pkg refresh --full
   • pfexec pkg install sunstudioexpress
   • pfexec pkg install SUNWgmake SUNWhea SUNWmercurial SUNWpr SUNWprd SUNWtls SUNWtlsd SUNWant SUNWicu SUNWicud SUNWcvs
2. The SUNWpr package is incomplete and this problem will be fixed in an upcoming update to 2008.11, for now the following kludge is necessary
   • cd
   • mkdir nspr
   • cd nspr
   • cvs -d :pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot get mozilla/nsprpub/pr/include/private/
   • cvs -d :pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot get mozilla/nsprpub/pr/include/obsolete/
   • pfexec mkdir /usr/include/mps/private
   • pfexec cp -r mozilla/nsprpub/pr/include/private/* /usr/include/mps/private/
   • pfexec cp -r mozilla/nsprpub/pr/include/obsolete/* /usr/include/mps/obsolete/
   • cd
3. Add the Web Stack repository to your list of repositories. Assuming you don't already have some other authority called "webstack" (if you do, pick a different name).
   • pfexec pkg set-authority -O http://pkg.opensolaris.org/webstack webstack
   • pfexec pkg refresh
4. Update your OpenSolaris installation with additional libraries (hosted in the Web Stack repository) needed to build Web Server
   • pfexec pkg install SUNWmozldap SUNWxercesc SUNWxalanc

Ubuntu 8.10

1. Update your Ubuntu installation with all the packages and tools needed to build Web Server
   • sudo apt-get install mercurial sun-java5-jdk ant build-essential libnspr4-dev libnss3-dev libnss3-tools libxerces-c2-dev libxalan110-dev libpcre3-dev libicu-dev zlib1g-dev libsasl2-dev perl g++
2. Checkout, build and install Mozilla LDAP C SDK

Fedora 9/10

1. Update your Fedora installation with all the packages and tools needed to build Web Server
   • sudo yum install mercurial java-1.6.0-openjdk ant make gcc-c++ xerces-c-devel xalan-c-devel pcre-devel nss-pkcs11-devel nspr-devel mozldap-devel libicu-devel cyrus-sasl-devel zlib-devel perl
   • sudo /usr/sbin/setenforce 0 (Fedora 10 only)

Debian Lenny

1. Update your Debian installation with all the packages and tools needed to build Web Server
   • sudo apt-get install mercurial sun-java5-jdk ant libnspr4-dev libnss3-dev libnss3-tools libxerces-c2-dev libxalan110-dev libpcre3-dev zlib1g-dev libicu-dev libsasl2-dev make cvs g++ perl
2. Checkout, build and install Mozilla LDAP C SDK

openSUSE 11.0

1. Update your openSUSE installation with all the packages and tools needed to build Web Server
   • zypper install mercurial cvs java-1_5_0-sun-devel make ant mozilla-nspr-devel mozilla-nss-devel mozilla-nss-tools libXerces-c-devel libXalan-c-devel libicu-devel cyrus-sasl-devel zlib-devel pcre-devel gcc gcc-c++
2. Checkout, build and install Mozilla LDAP C SDK

Checking Out, Building and Installing Web Server

The source code for Web Server is released under the BSD License. The Copyright/License block that you will see in the files is here.

Checking out and building the source code for Web Server involves the following simple steps:

By default, the build produces debug bits. To build an optimized binary, specify BUILD_VARIANT=OPTIMIZED to make/gmake. For example,
make BUILD_VARIANT=OPTIMIZED

Once the bits have been built, you can create a Web Server instance by invoking the following command in the top-level directory (webserver of the source tree.

If you specified BUILD_VARIANT=OPTIMIZED while building the server, then you must specify it when installing the bits as well.

make/gmake install creates a Web Server instance under the work sub-directory of your source tree.