Apache Compile HOWTO (Linux edition)

Luc de Louw

luc at delouw.ch



This document describes howto compile the Apache Webserver with the most
important modules like mod_perl, mod_dav, mod_auth_ldap, mod_dynvhost,
mod_roaming, mod_jserv, and mod_php

-----------------------------------------------------------------------------
Table of Contents
1. Introduction
    1.1. Contributors and Contacts
    1.2. Why this document was written
    1.3. What this document is supposed to be
    1.4. What this document doesn't do for you
    1.5. Platforms
    1.6. Copyright Information
    1.7. Disclaimer
    1.8. New Versions
    1.9. Revision History
    1.10. Credits
    1.11. Feedback
    1.12. Translations
    1.13. About the author
   
   
2. Prerequisites
    2.1. General
    2.2. Distribution specific
    2.3. OpenSSL
    2.4. MySQL
    2.5. Building mm
   
   
3. Getting, build and install Apache with its basic modules
    3.1. Get and untar the Apache Source
    3.2. mod_ssl
    3.3. mod_perl
    3.4. Configure and build Apache
    3.5. mod_dav
    3.6. auth_ldap
    3.7. mod_auth_mysql
    3.8. mod_dynvhost
    3.9. mod_roaming
   
   
4. mod_php and its prerequisites
    4.1. What is mod_php
    4.2. Prerequisites
    4.3. php>
   
   
5. PHP extensions
    5.1. APC (Alternative PHP-cache)
    5.2. Zend-Optimizer (Do _NOT_ combine with APC-Cache!)
   
   
6. Server Side Java
    6.1. mod_jserv
    6.2. jakarta-tomcat
   
   
7. Further Information
    7.1. News groups
    7.2. Mailing Lists
    7.3. HOWTO
    7.4. Local Resources
    7.5. Web Sites
   
   
8. Questions and Answers

1. Introduction

1.1. Contributors and Contacts

First I would thank all those people who send questions and suggestions that
made a further development of this document possible. It shows me, sharing
knowledge is the right way. I would encourage you to send me more suggestion,
just write me an email <luc at delouw.ch>
-----------------------------------------------------------------------------

1.2. Why this document was written

All Linux-distributions I tested had a non-optimal defaultsetup of Apache.
Additionally all major distributions dont have current versions of Apache.

Finally no commercial Unix are delivered with preinstalled Apache

Since I am installing a lot of customized webservers on different Un*xes
therefor I wrote a plaintext document and placed it on my website so I can
access it at work. Later a friend posted the URL to a mailinglist, and the
first questions arrived. So I decided to put more information on the page.

After a lot of people requested the document as an ??official?? HOWTO, I
decided to prepare it to be one
-----------------------------------------------------------------------------

1.3. What this document is supposed to be

Compiling all the items described below needs a lot of configure-options that
nobody can memorize. This is supposed to be a ??copy-paste-ready?? text to
compile apache and friends

Also, people should lern how to build a full-featured Apache-webserver by
themself to be independant from any Linux distributors.
-----------------------------------------------------------------------------

1.4. What this document doesn't do for you

It is just a Document, not a script that makes the work for you. You have to
do all the steps by yourself.
-----------------------------------------------------------------------------

1.5. Platforms

The original document was for all major Un*x plattforms. Now the HOWTOs are
separated for each plattform. You will find the same document adapted for:

*Linux (This Document)
   
*IBM AIX 4.3 and 5.1L
   
*Sun Solaris 6/7/8
   
*Hewlett-Packard HPUX 11
   
*{Free|Net|Open}-BSD
   

Important Notice for users running Linux on IBM S/390 (zSeries): postgres and
Jserv wont compile on that system. All other programms and modules mentioned
in the HOWTO are working perfectly

Other Un*x-platforms: Feel free to create a guest-account for me on your Un*x
platform, so I can have a look at the differences.

Windows-Users: I'm sorry, I'm too young for a heart-attack, You will need to
upgrade your machine to a ??real?? operating system ;-)
-----------------------------------------------------------------------------

1.6. Copyright Information

This document is copyrighted (c) 2000, 2001, 2002 Luc de Louw and is
distributed under the terms of the Linux Documentation Project (LDP) license,
stated below.

Unless otherwise stated, Linux HOWTO documents are copyrighted by their
respective authors. Linux HOWTO documents may be reproduced and distributed
in whole or in part, in any medium physical or electronic, as long as this
copyright notice is retained on all copies. Commercial redistribution is
allowed and encouraged; however, the author would like to be notified of any
such distributions.

All translations, derivative works, or aggregate works incorporating any
Linux HOWTO documents must be covered under this copyright notice. That is,
you may not produce a derivative work from a HOWTO and impose additional
restrictions on its distribution. Exceptions to these rules may be granted
under certain conditions; please contact the Linux HOWTO coordinator at the
address given below.

In short, we wish to promote dissemination of this information through as
many channels as possible. However, we do wish to retain copyright on the
HOWTO documents, and would like to be notified of any plans to redistribute
the HOWTOs.

If you have any questions, please contact <linux-howto at metalab.unc.edu>
-----------------------------------------------------------------------------

1.7. Disclaimer

No liability for the contents of this documents can be accepted. Use the
concepts, examples and other content at your own risk. As this is a new
edition of this document, there may be errors and inaccuracies, that may of
course be damaging to your system. Proceed with caution, and although this is
highly unlikely, the author(s) do not take any responsibility for that.

All copyrights are held by their by their respective owners, unless
specifically noted otherwise. Use of a term in this document should not be
regarded as affecting the validity of any trademark or service mark.

Naming of particular products or brands should not be seen as endorsements.

You are strongly recommended to take a backup of your system before major
installation and backups at regular intervals.
-----------------------------------------------------------------------------

1.8. New Versions

This is the 9th Revision

New revisions of this document will be announced at [http://freshmeat.net/
apacompile] http://freshmeat.net/apacompile

The latest version of this document is to be found at [http://www.delouw.ch/
linux] http://www.delouw.ch/linux

*[http://www.delouw.ch/linux/Apche-Compile-HOWTO/html/index.html] HTML.
   
*[http://www.delouw.ch/linux/Apche-Compile-HOWTO/Apache-Compile-HOWTO.ps]
    Postscript (ISO A4 format).
   
*[http://www.delouw.ch/linux/Apche-Compile-HOWTO/Apache-Compile-HOWTO.pdf]
    Acrobat PDF.
   
*[http://www.delouw.ch/linux/Apche-Compile-HOWTO/
    Apache-Compile-HOWTO.sgml] SGML Source.
   
*[http://www.delouw.ch/linux/Apche-Compile-HOWTO/
    Apache-Compile-HOWTO.html.tar.gz] HTML gzipped tarball.
   

-----------------------------------------------------------------------------
1.9. Revision History

Revision History                                                             
Revision 1.9.10                             2002-03-09                       
Corrected some grammar, updates of software mentioned in the HOWTO           
Revision 1.9.9                              2002-02-11                       
Fixed a major bug in openssl config, restructured the document, added sources
for further informations                                                     
Revision 1.9.8                              2002-02-08                       
Updates of software mentioned in the HOWTO, and fixed some bugs              
Revision 1.9.7                              2001-12-26                       
Updates of software mentioned in the HOWTO, tested the HOWTO procedures on   
Linux running on IBM S/390 (zSeries) Machines (See "platforms" for more      
info), Added some basic support for Tomcat (Binaries only)                   
Revision 1.9.6                              2001-10-27                       
Updates of software mentioned in the HOWTO, and fixed some bugs              
Revision 1.9.5                              2001-08-27                       
Yet another rewrite in Docbook 3.1                                           
Revision 1.9.4                              2001-08-26                       
Updated the Software-Versions metioned in the document, corrected some typos 
Revision 1.9.3                              2001-06-23                       
Current Version 2.0.0-pre3 in Linux DocBook format                           
Revision 1.0.0                              2000-08-05                       
First publication of the html-based document                                 
-----------------------------------------------------------------------------

1.10. Credits

I would thank all the nice people at < discuss (at) linuxdoc.org> for
supporting me in writing HOWTOs
-----------------------------------------------------------------------------

1.11. Feedback

Feedback is most certainly welcome for this document. Without your
submissions and input, this document wouldn't exist. Please send your
additions, comments and criticts to the following email address : <luc at
delouw.ch>.
-----------------------------------------------------------------------------

1.12. Translations

At the moment there are translations available for:

*[http://www.delouw.ch/linux/DE-Apache-Compile-HOWTO/html/index.html]
    German
   
*[http://www.delouw.ch/linux/FR-Apache-Compile-HOWTO/html/index.html]
    French (Draft)
   

Translations to other languages are always welcome. If you translated this
document, please let me know, so I can set a link here
-----------------------------------------------------------------------------

1.13. About the author

Luc (in english Luke) is 29 years old, playing around with computers since
20years. Currently he is working as Unix System Engineer for an
IT-corporation located in Kloten (Zurich), Switzerland. Main-focus is
developping all flavours of innovative Systems running on Linux (and other Un
*xes) . Further, for all major Un*x platforms all the ??impossible?? tasks
will end up on his desk (yes, its funny and he loves it!)
-----------------------------------------------------------------------------

2. Prerequisites

2.1. General

*flex
   
*bison
   
*autoconf
   
*libtool
   
*freetype2-devel
   

To be continiued

All major distributions will include this general prerequisites  
-----------------------------------------------------------------------------

2.2. Distribution specific

2.2.1. SuSE Linux

2.2.1.1. SuSE Linux 7.1 (maybe applicable to other distributions)

SuSE 7.1 and maybe other distributions have problems to build apache 1.3.19
(1.3.20 and later are okay) with mod_rewrite

To correct this misbehaviour create a symlink:
+---------------------------------------------------------------------------+
|cd /usr/include/db1                                                        |
|ln -s ../ndbm.h ndbm.h                                                     |
+---------------------------------------------------------------------------+

In SuSE 7.2 and later this issue is fixed
-----------------------------------------------------------------------------

2.3. OpenSSL

2.3.1. What is OpenSSL

Quoting www.openssl.org

The OpenSSL Project is a collaborative effort to develop a robust,
commercial-grade, full-featured, and Open Source toolkit implementing the
Secure Sockets Layer (SSL v2/v3) and Transport Layer Security (TLS v1)
protocols as well as a full-strength general purpose cryptography library.
The project is managed by a worldwide community of volunteers that use the
Internet to communicate, plan, and develop the OpenSSL toolkit and its
related documentation.

OpenSSL is based on the excellent SSLeay library developed by Eric A. Young
and Tim J. Hudson. The OpenSSL toolkit is licensed under an Apache-style
licence, which basically means that you are free to get and use it for
commercial and non-commercial purposes subject to some simple license
conditions.

From authors poinns of view, its the basic to build a secure Unix-Server with
Opensource Software, its needed for all major products like mod_ssl, OpenSSH
and lot of other stuff that provides encrypted Data-processing

OpenSSL provides the libraries and include-files needed be the products
mentioned above and also provides a Application to build Server and
client-Certificates.
-----------------------------------------------------------------------------

2.3.2. Download the source

Origin-Site [http://www.openssl.org] http://www.openssl.org
-----------------------------------------------------------------------------

2.3.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|tar -xvzf openssl-0.9.6c.tar.gz                                            |
|                                                                           |
|cd openssl-0.9.6c                                                          |
|                                                                           |
|./config shared                                                            |
|                                                                           |
|make                                                                       |
|make test                                                                  |
|make install                                                               |
|                                                                           |
|echo "/usr/local/ssl/lib" >> /etc/ld.so.conf                               |
|ldconfig                                                                   |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

2.4. MySQL

2.4.1. What is MySQL

Mysql is a very fast, powerful and very nice to handle Database.

Especially for Webapplication where most access is read and few write, MySQL
is the first choice. The newest Version is also transaction-capable. If you
plan a Webapplication, that writes a lot of Data into the DB, maybe Postgres
is better suited for your project

You need the C-API from Mysql for compiling php if you wish MySQL-Support in
php. It is also needed if you want to use mod_authmysql, See Section 3.7 for
more information
-----------------------------------------------------------------------------

2.4.2. Download

Origin-Site: [http://www.mysql.com/downloads/] http://www.mysql.com/downloads
/
-----------------------------------------------------------------------------

2.4.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|tar -xvzf mysql-3.23.49a.tar.gz                                            |
|cd mysql-3.23.49a                                                          |
|                                                                           |
|./configure \                                                              |
|--prefix=/usr/local/mysql \                                                |
|--enable-assembler \                                                       |
|--with-innodb                                                              |
|                                                                           |
|make                                                                       |
|make install                                                               |
|                                                                           |
|/usr/local/mysql/bin/mysql_install_db                                      |
|echo /usr/local/mysql/lib/mysql >> /etc/ld.so.conf                         |
|ldconfig                                                                   |
+---------------------------------------------------------------------------+

For security-improvement add a mysql-user on your system i.e. "mysql", then
+---------------------------------------------------------------------------+
|chown -R mysql /usr/local/mysql/var                                        |
+---------------------------------------------------------------------------+

and change the line user=root to user=mysql in the file /usr/local/mysql/bin/
safe_mysqld

you may wish to start mysql automatically at boottime, copy /usr/local/mysql/
share/mysql/mysql.server to /etc/init.d/ (or wherever your rc-script are
located) and create the corresponding symbolic link in the runlevel
directories.
+---------------------------------------------------------------------------+
|cp /usr/local/mysql/share/mysql/mysql.server /etc/init.d/                  |
|                                                                           |
|ln -s /etc/init.d/mysql.server /etc/init.d/rc3.d/S20mysql                  |
|ln -s /etc/init.d/mysql.server /etc/init.d/rc3.d/K20mysql                  |
+---------------------------------------------------------------------------+
 
-----------------------------------------------------------------------------

2.5. Building mm

2.5.1. What is mm

Quoting www.engelschall.com

The MM library is a 2-layer abstraction library which simplifies the usage of
shared memory between forked (and this way strongly related) processes under
Unix platforms. On the first layer it hides all platform dependent
implementation details (allocation and locking) when dealing with shared
memory segments and on the second layer it provides a high-level malloc(3)
-style API for a convenient and well known way to work with data-structures
inside those shared memory segments.

From the authors point of view:

It is a common lib that enables Unix-Programers to simplify shm accesses. It
is used by many products, i.e. PHP and mod_ssl

Since the author is not a programmer, he is unable to explain the exact usage
of that lib
-----------------------------------------------------------------------------

2.5.2. Download

Origin Site: [http://www.engelschall.com/sw/mm/mm-1.1.3.tar.gz] http://
www.engelschall.com/sw/mm/mm-1.1.3.tar.gz
-----------------------------------------------------------------------------

2.5.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf mm-1.1.3.tar.gz                                                  |
|                                                                           |
|cd mm-1.1.3                                                                |
|                                                                           |
|./configure                                                                |
|make                                                                       |
|make test                                                                  |
|make install                                                               |
|                                                                           |
|ldconfig                                                                   |
|                                                                           |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

3. Getting, build and install Apache with its basic modules

3.1. Get and untar the Apache Source

3.1.1. What is Apache

Quoting www.apache.org

The Apache Project is a collaborative software development effort aimed at
creating a robust, commercial-grade, featureful, and freely-available source
code implementation of an HTTP (Web) server. The project is jointly managed
by a group of volunteers located around the world, using the Internet and the
Web to communicate, plan, and develop the server and its related
documentation. These volunteers are known as the Apache Group. In addition,
hundreds of users have contributed ideas, code, and documentation to the
project. This file is intended to briefly describe the history of the Apache
Group and recognize the many contributors.

From the authors point of view:

It is simply the best Webserver-Software, it is very flexible to configure to
match your needs, and its E-X-T-R-E-M-E stable! I personally never
experienced a crash in a productive (=non-experimental stuff) enviroment
-----------------------------------------------------------------------------

3.1.2. Download the source

Origin-Site [http://www.apache.org/dist/httpd/] http://www.apache.org/dist/
httpd/
+---------------------------------------------------------------------------+
|cd /usr/local/                                                             |
|                                                                           |
|tar -xvzf apache_1.3.23.tar.gz                                             |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

3.1.3. Patch for largescale sites

If your webserver should answer very much requests at the same time, and your
machine is strong enought to serv such an amount of requests, you can change
the limit of maximum running processes

Download the patch from: [http://www.delouw.ch/linux/
apache-patch_HARD_SERVER_LIMIT.txt] http://www.delouw.ch/linux/
apache-patch_HARD_SERVER_LIMIT.txt
+---------------------------------------------------------------------------+
|--- httpd.h-old Wed Jan 31 00:58:19 2001                                   |
|+++ httpd.h Wed Jan 31 01:09:25 2001                                       |
|@@ -314,7 +314,7 @@                                                        |
|#ifdef WIN32                                                               |
|#define HARD_SERVER_LIMIT 1024                                             |
|#else                                                                      |
|-#define HARD_SERVER_LIMIT 256                                             |
|+#define HARD_SERVER_LIMIT 512                                             |
|#endif                                                                     |
|#endif                                                                     |
+---------------------------------------------------------------------------+

This patch does increase the maximum concurrent accessing clients to 512.
Feel free to increase it further, if you hacked your kernel and edited your /
etc/security/limits.conf (this is ONLY for experienced users! With wrong
settings this could end as a ??self-denial-of-service-attack??!! Be sure you
have enought processes left for root)

Apply the patch using:
+---------------------------------------------------------------------------+
|cd /usr/local/apache_1.3.23/src/include                                    |
|                                                                           |
|patch -p0 < apache-patch_HARD_SERVER_LIMIT.txt                             |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

3.2. mod_ssl

3.2.1. What is mod_ssl

Quoting www.modssl.org

This module provides strong cryptography for the Apache 1.3 webserver via the
Secure Sockets Layer (SSL v2/v3) and Transport Layer Security (TLS v1)
protocols by the help of the Open Source SSL/TLS toolkit OpenSSL, which is
based on SSLeay from Eric A. Young and Tim J. Hudson.

From the authors point of view:

This module is needed to enable Apache for SSL-Requests (https). It applies a
patch to the Apache source-code and extends its API (EAPI)

Make sure any module for your Apache-Server is compiled with the
compiler-flag -DEAPI, or your Webserver might crash or can not be started

Allmost all modules I know adds the -DEAPI flag by themself execpt mod_jserv
and mod_jk
-----------------------------------------------------------------------------

3.2.2. Download the source

Origin-Site:[http://www.modssl.org] http://www.modssl.org
-----------------------------------------------------------------------------

3.2.3. Applying the patch to the apache source

+---------------------------------------------------------------------------+
|cd /usr/local/                                                             |
|                                                                           |
|tar -xvzf mod_ssl-2.8.7-1.3.23.tar.gz                                      |
|cd mod_ssl-2.8.7-1.3.23/                                                   |
|                                                                           |
|./configure \                                                              |
|--with-apache=/usr/local/apache_1.3.23 \                                   |
|--with-ssl=/usr/local/ssl \                                                |
|--enable-shared=ssl \                                                      |
|--with-mm=/usr/local/mm-1.1.3                                              |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

3.3. mod_perl

3.3.1. What is mod_perl

Quoting perl.apache.org

With mod_perl it is possible to write Apache modules entirely in Perl. In
addition, the persistent interpreter embedded in the server avoids the
overhead of starting an external interpreter and the penalty of Perl start-up
time.

From the authors point of view:

mod_perl is a kind of substitute for cgi-bin's. cgi's typically forks a new
process for each request, and produces overhead. With mod_perl the
perl-interpreter is loaded persistant in the apache-server and does not need
to fork processes for each request
-----------------------------------------------------------------------------

3.3.2. Download the source

Origin-Site: [http://www.apache.org/dist/perl] http://www.apache.org/dist/
perl
-----------------------------------------------------------------------------

3.3.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf mod_perl-1.26.tar.gz                                             |
|                                                                           |
|cd mod_perl-1.26                                                           |
|                                                                           |
|perl Makefile.PL \                                                         |
|EVERYTHING=1 \                                                             |
|APACHE_SRC=../apache_1.3.23/src \                                          |
|USE_APACI=1 \                                                              |
|PREP_HTTPD=1 \                                                             |
|DO_HTTPD=1                                                                 |
|                                                                           |
|make                                                                       |
|make install                                                               |
+---------------------------------------------------------------------------+

Notice: Do not compile mod_perl as dso (Dynamic Shared Object)! According to
various sources, apache will crash (I never tried)
-----------------------------------------------------------------------------

3.4. Configure and build Apache

Now the two static modules mod_ssl and mod_perl are configured and the Apache
Source has been patched, and we can proceed with building Apache.
-----------------------------------------------------------------------------

3.4.1. Building and installing

+---------------------------------------------------------------------------+
|EAPI_MM="/usr/local/mm-1.1.3" SSL_BASE="/usr/local/ssl" \                  |
|./configure \                                                              |
|--enable-module=unique_id \                                                |
|--enable-module=rewrite \                                                  |
|--enable-module=speling \                                                  |
|--enable-module=expires \                                                  |
|--enable-module=info \                                                     |
|--enable-module=log_agent \                                                |
|--enable-module=log_referer \                                              |
|--enable-module=usertrack \                                                |
|--enable-module=proxy \                                                    |
|--enable-module=userdir \                                                  |
|--enable-module=so \                                                       |
|--enable-shared=ssl \                                                      |
|--enable-module=ssl \                                                      |
|--activate-module=src/modules/perl/libperl.a \                             |
|--enable-module=perl                                                       |
|                                                                           |
|make                                                                       |
|make install                                                               |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

3.4.2. Create self-signed SSL-certificate

+----------------------------------------------------------------------------------------+
|cd /usr/local/ssl/bin                                                                   |
|                                                                                        |
|./openssl req -new > new.cert.csr                                                       |
|./openssl rsa -in privkey.pem -out new.cert.key                                         |
|./openssl x509 -in new.cert.csr -out new.cert.cert -req -signkey new.cert.key -days 999 |
|                                                                                        |
|cp new.cert.key /usr/local/apache/conf/ssl.key/server.key                               |
|cp new.cert.cert /usr/local/apache/conf/ssl.crt/server.crt                              |
+----------------------------------------------------------------------------------------+

Notice: OpenSSL asks for different things. A common error is to enter a wrong
"common name". This should be the FQHN (Fully Qualified HostName) of your
Server, i.e www.foo.org
-----------------------------------------------------------------------------

3.5. mod_dav

3.5.1. What is mod_dav

Quoting www.webdav.org

mod_dav is an Apache module to provide DAV capabilities (RFC 2518) for your
Apache web server. It is an Open Source module, provided under an
Apache-style license.

mod_dav is maintained by gstein at lyra.org

From the authors point of view:

DAV means: "Distributed authoring and Versioning". It allows you to manage
your Website similar to a filesystem. It is meant to replace ftp-uploads to
your Webserver.

DAV is supported by all major Web-developpment-Tools (newer versions) and is
going to be a widly accepted standard for Web-publishing
-----------------------------------------------------------------------------

3.5.2. Download the source

Origin-Site: [http://www.webdav.org/mod_dav/] http://www.webdav.org/mod_dav/
-----------------------------------------------------------------------------

3.5.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf mod_dav-1.0.3-1.3.6.tar.gz                                       |
|cd mod_dav-1.0.3-1.3.6                                                     |
|                                                                           |
|./configure --with-apxs=/usr/local/apache/bin/apxs                         |
|                                                                           |
|make                                                                       |
|make install                                                               |
+---------------------------------------------------------------------------+

Notice: the filename mod_dav-1.0.3-1.3.6 suggests that it will only run with
apache 1.3.6 but it actually will run with all apaches >= 1.3.6
-----------------------------------------------------------------------------

3.6. auth_ldap

3.6.1. What is auth_ldap

Quoting www.rudedog.org

auth_ldap is an LDAP authentication module for Apache, the world's most
popular web server. auth_ldap has excellent performance, and supports Apache
on both Unix and Windows NT. It also has support for LDAP over SSL, and a
mode that lets Micros??1 Frontpage clients manage their web permissions while
still using LDAP for authentication.

From the authors point of view:

If you like to consolidate your login-facilities to a common user/passwd
base, LDAP is the right way. LDAP is an open standard and widely supported.

Login-facilities for LDAP:

Unix-Logins for Linux, Solaris (others?) FTP-Logins (some ftp-daemons) http
Basic Authentication Tarantella Authentication and Role-Management Samba
Authentication (2.2.x should support this) LDAP is role based. That means,
i.e. you can define a role "manager" assign a user as member and that user
can login wherever a manager is allowed to login
-----------------------------------------------------------------------------

3.6.2. Download the source

Origin-Site: [http://www.rudedog.org/auth_ldap/] http://www.rudedog.org/
auth_ldap/
-----------------------------------------------------------------------------

3.6.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf auth_ldap-1.6.0.tar.gz                                           |
|                                                                           |
|cd auth_ldap-1.6.0                                                         |
|                                                                           |
|./configure --with-apxs=/usr/local/apache/bin/apxs \                       |
|--with-sdk=openldap                                                        |
|                                                                           |
|make                                                                       |
|make install                                                               |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

3.7. mod_auth_mysql

3.7.1. What is mod_auth_mysql

It is a http-Basic Authentication Module. It allows to maintain your user
comfortable in a MySQL-Database
-----------------------------------------------------------------------------

3.7.2. Download the source

Origin-Site: [ftp://ftp.kciLink.com/pub/mod_auth_mysql.c.gz] ftp://
ftp.kciLink.com/pub/mod_auth_mysql.c.gz
-----------------------------------------------------------------------------

3.7.3. Building and installing

+---------------------------------------------------------------------------+
|gunzip mod_auth_mysql.c.gz                                                 |
|                                                                           |
|/usr/local/apache/bin/apxs \                                               |
|-c -I/usr/local/mysql/include \                                            |
|-L/usr/local/mysql/lib/mysql \                                             |
|-lmysqlclient -lm mod_auth_mysql.c                                         |
|                                                                           |
|cp mod_auth_mysql.so /usr/local/apache/libexec/                            |
+---------------------------------------------------------------------------+

Add this line in your httpd.conf:
+---------------------------------------------------------------------------+
|LoadModule mysql_auth_module libexec/mod_auth_mysql.so                     |
+---------------------------------------------------------------------------+

And where the other modules are added:
+---------------------------------------------------------------------------+
|AddModule mod_auth_mysql.c                                                 |
+---------------------------------------------------------------------------+

Take care that the path of Mysql libs and includes are correct!

Notice: Be sure that /usr/local/mysql/lib/mysql is in /etc/ld.so.conf befor
compiling

Use AuthMySQLCryptedPasswords Off or it does not work! (under investigation
why not)
-----------------------------------------------------------------------------

3.7.4. Sample configuration

3.7.4.1. /usr/local/apache/conf/httpd.conf

+---------------------------------------------------------------------------+
|<location /manual/>                                                        |
|  AuthType Basic                                                           |
|  AuthUserfile /dev/null                                                   |
|  AuthName Testing                                                         |
|  AuthGroupFile /dev/null                                                  |
|  AuthMySQLHost localhost                                                  |
|  AuthMySQLCryptedPasswords Off                                            |
|  AuthMySQLUser root                                                       |
|  AuthMySQLDB users                                                        |
|  AuthMySQLUserTable user_info                                             |
|  <Limit GET POST>                                                         |
|    require valid-user                                                     |
|  </limit>                                                                 |
|</location>                                                                |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

3.7.4.2. Script for creating the MySQL-Database

just type:
+---------------------------------------------------------------------------+
|mysql < authmysql.sql                                                      |
+---------------------------------------------------------------------------+

The File authmysql.sql contents:
+---------------------------------------------------------------------------+
|  create database http_users;                                              |
|  connect http_users;                                                      |
|                                                                           |
|  CREATE TABLE user_info (                                                 |
|  user_name CHAR(30) NOT NULL,                                             |
|  user_passwd CHAR(20) NOT NULL,                                           |
|  user_group CHAR(10),                                                     |
|  PRIMARY KEY (user_name);                                                 |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

3.8. mod_dynvhost

3.8.1. What is mod_dynvhost

It is a module that allows to define new Vritual Host "on-the-fly". Just
create a new Directoy in your vhost-path, thats it. It is not need to restart
your Webserver

It is a good solution for Mass-Virtual-hosting for ISP's
-----------------------------------------------------------------------------

3.8.2. Download the source

Origin-Site: [http://funkcity.com/0101/projects/dynvhost/mod_dynvhost.tar.gz]
http://funkcity.com/0101/projects/dynvhost/mod_dynvhost.tar.gz
-----------------------------------------------------------------------------

3.8.3. Builing and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf mod_dynvhost.tar.gz                                              |
|                                                                           |
|cd dynvhost/                                                               |
|                                                                           |
|/usr/local/apache/bin/apxs -i -a -c mod_dynvhost.c                         |
+---------------------------------------------------------------------------+

Notice: Take a look at httpd.conf if mod_dynvhost.so is loaded at startup:
+---------------------------------------------------------------------------+
|LoadModule dynvhost_module libexec/mod_dynvhost.so                         |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

3.8.4. Sample configuration

3.8.4.1. /usr/local/apache/conf/httpd.conf

+---------------------------------------------------------------------------+
|<DynamicVirtualHost /usr/local/apache/htdocs/vhosts/>                      |
|  HomeDir /                                                                |
|</DynamicVirtualHost>                                                      |
+---------------------------------------------------------------------------+

Now create a Directory for each virtualhost in /usr/local/apache/htdocs/
vhosts/

i.e.

/usr/local/apache/htdocs/vhosts/foo.bar.org

You dont need to restart your Webserver
-----------------------------------------------------------------------------

3.9. mod_roaming

3.9.1. What is mod_roaming

Quoting www.klomp.org/mod_roaming/

With mod_roaming you can use your Apache webserver as a Netscape Roaming
Access server. This allows you to store your Netscape Communicator 4.5
preferences, bookmarks, address books, cookies etc. on the server so that you
can use (and update) the same settings from any Netscape Communicator 4.5
that can access the server.

From the authors point of view:

This is really cool stuff! Unfortunately it does not work over
proxy-connection. You kan keep your Netscape 4.x bookmarks etc. synchronized
on different machines. It is not supported by any other browsers, including
Mozilla and Netscape 6.x
-----------------------------------------------------------------------------

3.9.2. Download the source

Origin-Site: [http://www.klomp.org/mod_roaming/] http://www.klomp.org/
mod_roaming/
-----------------------------------------------------------------------------

3.9.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf mod_roaming-1.0.2.tar.gz                                         |
|                                                                           |
|cd mod_roaming-1.0.2                                                       |
|                                                                           |
|/usr/local/apache/bin/apxs -i -a -c mod_roaming.c                          |
+---------------------------------------------------------------------------+

Notice: Check httpd.conf if mod_roaming is loaded at startup:
+---------------------------------------------------------------------------+
|LoadModule roaming_module libexec/mod_roaming.so                           |
+---------------------------------------------------------------------------+

Should be installed automatically
-----------------------------------------------------------------------------

3.9.4. Sample configuration

3.9.4.1. /usr/local/apache/conf/httpd.conf

+---------------------------------------------------------------------------+
|RoamingAlias /roaming /usr/local/apache/roaming                            |
|<Directory /usr/local/apache/roaming>                                      |
|  AuthUserFile /usr/local/apache/conf/roaming-htpasswd                     |
|  AuthType Basic                                                           |
|  AuthName "Roaming Access"                                                |
|  <Limit GET PUT MOVE DELETE>                                              |
|    require valid-user                                                     |
|  </Limit>                                                                 |
|</Directory>                                                               |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

4. mod_php and its prerequisites

4.1. What is mod_php

Quoting www.php.net

PHP is a server-side, cross-platform, HTML embedded scripting language.

In the beginning it was just a simple guestbook-processor, and it was growing
and growing Since Version 3 it is really powerful Webdevelopment-language

From the authors point of view:

Since Version 4 PHP capable and robust enough for enterprise webapplications.
It is powerful, supports almost all important Databases natively, and other
throught ODBC. It a few times faster than ASP on M$-Systems on the same
Hardware.

There are other extensions available like apc which speed up processing about
50-400% (depends on the php-code you wrote)
-----------------------------------------------------------------------------

4.2. Prerequisites

Depending on your needs there are some software to install first. One already
installed Software according this document is MySQL, because its needed by
mod_auth_mysql.
-----------------------------------------------------------------------------

4.2.1. IMAP client

4.2.1.1. What is IMAP client

IMAP means "Internet Mail Application Protocol" and is a substitute for the
POP protocol. It allows to keep all Mails in different folders on the server,
which (should) be backed up - Never again lose important email, because your
local harddrive crashed
-----------------------------------------------------------------------------

4.2.2. Download the source

Origin-Site:

Origin-Site: [http://www.washington.edu/imap/] http://www.washington.edu/imap
/
-----------------------------------------------------------------------------

4.2.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvfz imap.tar.Z                                                       |
|                                                                           |
|cd imap                                                                    |
|                                                                           |
|make slx SSLTYPE=unix                                                      |
|                                                                           |
|                                                                           |
+---------------------------------------------------------------------------+

Notice:

imap.tar.Z is usually a symlink to the latest release, today its linked to
imap-2001a.tar.Z

If you dont need SSL-Support, remove the "SSLTYPE=unix" behind the make
command
-----------------------------------------------------------------------------

4.2.4. Postgres

4.2.4.1. What is Postgres

Postgres is a very Powerful and fast Database

Like MySQL wonderful for Webapplications. From my Point of view, not as
comfortable to handle as MySQL. If your Webapplication performs mostly
writes, or you need proofed transaction-capabilities, Postgres is your friend
-----------------------------------------------------------------------------

4.2.4.2. Download the source

Origin-Site: [http://www.postgresql.org] http://www.postgresql.org (Select a
mirror close to you)
-----------------------------------------------------------------------------

4.2.4.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf postgresql-7.2.tar.gz                                            |
|                                                                           |
|cd postgresql-7.2                                                          |
|                                                                           |
|./configure \                                                              |
|--with-perl \                                                              |
|--enable-odbc \                                                            |
|--with-unixodbc  \                                                         |
|--with-pam \                                                               |
|--with-openssl \                                                           |
|                                                                           |
|                                                                           |
|make                                                                       |
|make install                                                               |
|                                                                           |
|echo /usr/local/pgsql/lib >> /etc/ld.so.conf                               |
|                                                                           |
|ldconfig                                                                   |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

4.2.5. pdflib

4.2.5.1. What is pdflib

Quoting www.pdflib.com

PDFlib: A library for generating PDF on the fly PDFlib is the premier
software component if you want to generate PDF on your server, convert text
and graphics, or implement PDF output in your own products.

From the authors point of view:

This is a commercial Procduct. Read the licence carefully to see if you need
a commercial licence or not
-----------------------------------------------------------------------------

4.2.5.2. Download the source

Origin-Site: [http://www.pdflib.com/pdflib/download/pdflib-4.0.2.tar.gz]
http://www.pdflib.com/pdflib/download/pdflib-4.0.2.tar.gz
-----------------------------------------------------------------------------

4.2.5.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local/                                                             |
|tar -xvzf pdflib-4.0.2.tar.gz                                              |
|                                                                           |
|cd pdflib-4.0.2                                                            |
|                                                                           |
|./configure --enable-shared-pdflib --enable-cxx                            |
|                                                                           |
|make                                                                       |
|make install                                                               |
|                                                                           |
|ldconfig                                                                   |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

4.2.6. gettext

4.2.6.1. What is gettext

gettext is a library for i18n (Internationalization, "I", 18 chars and "n")
of software, and needed by php
-----------------------------------------------------------------------------

4.2.6.2. Download the source

Origin-Site: [ftp://ftp.gnu.org/gnu/gettext] ftp://ftp.gnu.org/gnu/gettext
(select a mirror close to you)
-----------------------------------------------------------------------------

4.2.6.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf gettext-0.10.40.tar.gz                                           |
|                                                                           |
|cd gettext-0.10.40                                                         |
|                                                                           |
|./configure                                                                |
|                                                                           |
|make                                                                       |
|make check                                                                 |
|make install                                                               |
|                                                                           |
|ldconfig                                                                   |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

4.2.7. zlib

4.2.7.1. What is zlib

zlib is a lossless data-compression library for use on virtually any computer
hardware and operating system
-----------------------------------------------------------------------------

4.2.7.2. Download the source

Origin-Site: [//ftp.info-zip.org/pub/infozip/zlib/zlib.tar.gz] ftp://
ftp.info-zip.org/pub/infozip/zlib/zlib.tar.gz (select a mirror close to you)
-----------------------------------------------------------------------------

4.2.7.3. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf zlib.tar.gz                                                      |
|                                                                           |
|cd zlib-1.1.3/                                                             |
|                                                                           |
|./configure                                                                |
|                                                                           |
|make                                                                       |
|make test                                                                  |
|make install                                                               |
|                                                                           |
|ldconfig                                                                   |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

4.3. php>

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf php-4.1.2.tar.gz                                                 |
|                                                                           |
|cd php-4.1.2                                                               |
|                                                                           |
|                                                                           |
|./configure \                                                              |
|--with-apxs=/usr/local/apache/bin/apxs \                                   |
|--with-mysql=/usr/local/mysql \                                            |
|--with-pgsql=/usr/local/pgsql \                                            |
|--enable-track-vars \                                                      |
|--with-openssl=/usr/local/ssl \                                            |
|--with-imap-ssl=/usr/local/imap-2001a \                                    |
|--with-gd --with-ldap \                                                    |
|--enable-ftp \                                                             |
|--enable-sysvsem \                                                         |
|--enable-sysvshm \                                                         |
|--enable-sockets \                                                         |
|--with-pdflib=/usr/local \                                                 |
|--with-gettext \                                                           |
|--with-mm=/usr/local/mm-1.1.3 \                                            |
|--with-jpeg-dir=/usr/lib \                                                 |
|--with-zlib-dir=/usr/local \                                               |
|                                                                           |
|make                                                                       |
|make install                                                               |
+---------------------------------------------------------------------------+

After installing your httpd.conf is modified by axps. It should now look as
follows:
+---------------------------------------------------------------------------+
|<IfDefine SSL>                                                             |
|LoadModule ssl_module         libexec/libssl.so                            |
|LoadModule php4_module        libexec/libphp4.so                           |
|</IfDefine>                                                                |
+---------------------------------------------------------------------------+

If you compiled Apache with mod_ssl then the php-module will only be loaded
when staring Apache with ssl (apachectl startssl). If you will start Apache
without ssl support (but compiled like described in this document) you need
to change this:
+---------------------------------------------------------------------------+
|<IfDefine SSL>                                                             |
|LoadModule ssl_module         libexec/libssl.so                            |
|</IfDefine>                                                                |
|LoadModule php4_module        libexec/libphp4.so                           |
+---------------------------------------------------------------------------+

Copy the sample php.ini to /usr/local/lib/php.ini
+---------------------------------------------------------------------------+
|cp /usr/local/php-4.1.2/php.ini-dist /usr/local/lib/php.ini                |
+---------------------------------------------------------------------------+

uncomment (remove the # at begin of line) the following lines in /usr/local/
apache/conf/httpd.conf

Apache 1.3.23 default httpd.conf does lack of this entries. You have to add
them instead of uncommenting
+---------------------------------------------------------------------------+
|AddType application/x-httpd-php .php                                       |
|AddType application/x-httpd-php-source .phps                               |
+---------------------------------------------------------------------------+

you may wish to add the following:
+---------------------------------------------------------------------------+
|AddType application/x-httpd-php .phtml                                     |
|AddType application/x-httpd-php .php3                                      |
+---------------------------------------------------------------------------+

Restart apache by issuing the following command:
+---------------------------------------------------------------------------+
|/usr/local/apache/bin/apachectl restart                                    |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

5. PHP extensions

There are many different extensions available for php, which can be added in
your php.ini
-----------------------------------------------------------------------------

5.1. APC (Alternative PHP-cache)

5.1.1. What is APC

Quoting www.apc.communityconnect.com/

APC is the Alternative PHP Cache. It was conceived of to provide a free,
open, and robust framework for compiling and caching php scripts. APC was
conceived of to provide a way of boosting the performance of PHP on heavily
loaded sites by providing a way for scripts to be cached in a compiled state,
so that the overhead of parsing and compiling can be almost completely
eliminated. There are commercial products which provide this functionality,
but they are neither open-source nor free. Our goal was to level the playing
field by providing an implementation that allows greater flexibility and is
universally accessible. We also wanted the cache to provide visibility into
it's own workings and those of PHP, so time was invested in providing
internal diagnostic tools which allow for cache diagnostics and maintenance.
Thus arrived APC. Since we were committed to developing a product which can
easily grow with new version of PHP, we implemented it as a zend extension,
allowing it to either be compiled into PHP or added post facto as a drop in
module. As with PHP, it is available completely free for commercial and
non-commercial use, under the same terms as PHP itself. APC has been tested
under PHP 4.0.3, 4.0.3pl1 and 4.0.4. It currently compiles under Linux and
FreeBSD. Patches for ports to other OSs/ PHP versions are welcome.

From the authors point of view:

The author made some performance-Tests with apc and it was real surprise. A
PHP-Webpage with mysql-queries in a loop (total 10 queries) was more than 50%
faster

Contra APC: If you have other users on the system coding php they maybe are
not comfortable with APC, because the changes are all ignored unless you
reset the cache or restart Apache. The other way, namly that APC checks the
php-script for a newer version befor every run costs speed.
-----------------------------------------------------------------------------

5.1.2. Download the source

Origin-Site: [http://apc.communityconnect.com/sources/apc-1.1.0pl1.tar.gz]
http://apc.communityconnect.com/sources/apc-1.1.0pl1.tar.gz
-----------------------------------------------------------------------------

5.1.3. Building and installing

+-------------------------------------------------------------------------------------------+
|cd /usr/local                                                                              |
|                                                                                           |
|tar -xvzf apc-1.1.0pl1.tar.gz                                                              |
|                                                                                           |
|cd apc-1.1.0pl1                                                                            |
|                                                                                           |
|./configure --enable-apc --with-php-config=/usr/local/bin/php-config                       |
|                                                                                           |
|make                                                                                       |
|make install                                                                               |
|                                                                                           |
|cp modules/php_apc.so /usr/local/lib/php/extensions                                        |
|                                                                                           |
|echo 'zend_extension="/usr/local/lib/php/extensions/php_apc.so"' >> /usr/local/lib/php.ini |
|echo ??apc.mode = shm?? >> apc.mode = shm                                                  |
+-------------------------------------------------------------------------------------------+

Restart your Apache-Webserver. Try it out, create a php-file with the
following content:
+---------------------------------------------------------------------------+
|<?php                                                                      |
|apcinfo();                                                                 |
|?>                                                                         |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

5.2. Zend-Optimizer (Do _NOT_ combine with APC-Cache!)

5.2.1. What is Zend-optimizer

Quoting www.zend.com

The Zend Optimizer goes over the intermediate code generated by the standard
Zend run-time compiler located in the Zend Engine, and then optimizes it for
faster execution.

From the authors point of view:

Zend-Optimizer is a freeware closed source product. On the same testcode used
for the APC-test, there was speed-decrease of about 5% compared to PHP
without APC

You have to make your own test, to see, if you have some improvements with
your own code. Be sure not to NOT use Zend Optimizer together with APC, or
your whole setup will not work
-----------------------------------------------------------------------------

5.2.2. Download the binary

Origin-Site: [https://www.zend.com/store/free_download.php?pid=13] https://
www.zend.com/store/free_download.php?pid=13

You have to register yourself at zend.com to get access to the download-page
-----------------------------------------------------------------------------

5.2.3. Installing

There is noting to build, this product is closed-source and so only available
as binary for different platforms. The filename varies according your
platform, the sample is for Linux on IA32.
+-----------------------------------------------------------------------------------------------+
|cd /usr/local                                                                                  |
|                                                                                               |
|tar -xvzf ZendOptimizer-1.2.0-PHP_4.1.0-Linux_glibc21-i386.tar.gz                              |
|                                                                                               |
|cd ZendOptimizer-1.2.0-PHP_4.1.0-Linux_glibc21-i386.tar.gz                                     |
|                                                                                               |
|cp ZendOptimizer.so /usr/local/lib/php/extensions                                              |
|                                                                                               |
|echo 'zend_optimizer.optimization_level=15' >> /usr/local/lib/php.ini                          |
|echo'zend_extension="/usr/local/lib/php/extensions/ZendOptimizer.so"'>> /usr/local/lib/php.ini |
+-----------------------------------------------------------------------------------------------+
-----------------------------------------------------------------------------

6. Server Side Java

6.1. mod_jserv

6.1.1. What is mod_jserv

Quoting java.apache.org

Apache JServ is a 100% pure Java servlet engine fully compliant with
theJavaSoft Java Servlet APIs 2.0 specification. Since we believe in the
great value complete portability between different servlet platforms,
together with portability of Java binary code, we worked very close with
JavaSoft and other JVM implementers to provide correct interpretations or
Java specifications both for servlets and for the Java language itself.

From the authors point of view:

mod_jserv is very comfortable to maintain

Unfortunatly mod_jserv is no longer actively developped, only bugfixes if
bugs where found. Tomcat is the successor of mod_jserv As soon as the author
gets enought time and experiance with Tomcat he will extend this HOWTO.

JDSK2.0 is out of Date too. It is needed for mod_jserv only.
-----------------------------------------------------------------------------

6.1.2. Prerequisites

6.1.2.1. JSDK 2.0 (mod_jserv req.)

6.1.2.1.1. What is JSDK

It is the API from Sun Microsystems for developping Servlets
-----------------------------------------------------------------------------

6.1.2.1.2. Download

Origin-Site: [http://java.sun.com/products/servlet/archive.html] http://
java.sun.com/products/servlet/archive.html
-----------------------------------------------------------------------------

6.1.2.1.3. Building and installing

Since JSDK is closedsource there is nothing to build.

Notice: The filename ??jsdk20-solaris2-sparc.tar.Z?? suggests to be a binary
for sparc platform -> ignore it, it will work on all platforms
+---------------------------------------------------------------------------+
|cd /usr/local/                                                             |
|                                                                           |
|uncompress jsdk20-solaris2-sparc.tar.Z                                     |
|tar -xvf jsdk20-solaris2-sparc.tar                                         |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

6.1.3. Download the source

Origin-Site: [http://java.apache.org/jserv/dist/] http://java.apache.org/
jserv/dist/
-----------------------------------------------------------------------------

6.1.4. Building and installing

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf ApacheJServ-1.1.2.tar.gz                                         |
|cd ApacheJServ-1.1.2                                                       |
|                                                                           |
|./configure \                                                              |
|--prefix=/usr/local/jserv \                                                |
|--with-apxs=/usr/local/apache/bin/apxs \                                   |
|--with-JSDK=/usr/local/JSDK2.0 \                                           |
|--enable-EAPI \                                                            |
|                                                                           |
|make                                                                       |
|make install                                                               |
+---------------------------------------------------------------------------+

It is important to use flag --enable-EAPI if apache is compiled with mod_ssl!
-----------------------------------------------------------------------------

6.2. jakarta-tomcat

6.2.1. What is Tomcat

Quoting jakarta.apache.org

Tomcat is the servlet container that is used in the official Reference
Implementation for the Java Servlet and JavaServer Pages technologies. The
Java Servlet and JavaServer Pages specifications are developed by Sun under
the Java Community Process.

From the authors point of view:

Tomcat is the successor of jserv which is no longer developped. Tomcat
supports the latest jsp and servlet-API's defined by sun. Unfortunatly Tomcat
is very difficult to build from source, because it is using its own
building-system called "ant". There is also a very long list of prerequesits
if you want to build from source. See [http://jakarta.apache.org/tomcat/
tomcat-4.0-doc/BUILDING.txt] http://jakarta.apache.org/tomcat/tomcat-4.0-doc/
BUILDING.txt for more details - Good luck, and give some feedback to the
author.

In the meantime the HOWTO is providing some basic support for Tomcat
installed from binaries.

The Author is searching for some volunteers who tries to build Tomcat from
source and tells what steps are required
-----------------------------------------------------------------------------

6.2.2. Prerequisites

6.2.2.1. Java2

6.2.2.1.1. What is Java2>

Quoting java.sun.com

Too much for this HOWTO, please see [http://java.sun.com/j2se/1.3/docs/
relnotes/features.html] http://java.sun.com/j2se/1.3/docs/relnotes/
features.html
-----------------------------------------------------------------------------

6.2.2.2. Download the binaries

Go to [http://java.sun.com/j2se/1.3/] http://java.sun.com/j2se/1.3/ ,choose
your platform and follow the steps on the site.
-----------------------------------------------------------------------------

6.2.2.3. Installing the binaries

Execute the binary:
+---------------------------------------------------------------------------+
|chown +x j2sdk-1_3_1_02-linux-i386.bin                                     |
|                                                                           |
|./2sdk-1_3_1_02-linux-i386.bin                                             |
+---------------------------------------------------------------------------+
 

Notice: There is a newer version of java available, if you do not care about
possible instability you can downloads version 1.4.0

After accepting the license, unpack the stuff and move the resulting
directory to "/usr/lib"
-----------------------------------------------------------------------------

6.2.3. Download the binaries

Origin-Site: [http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/
v4.0.1/bin/jakarta-tomcat-4.0.1.tar.gz] http://jakarta.apache.org/builds/
jakarta-tomcat-4.0/release/v4.0.1/bin/jakarta-tomcat-4.0.1.tar.gz/
-----------------------------------------------------------------------------

6.2.4. Installing the binaries

+---------------------------------------------------------------------------+
|cd /usr/local                                                              |
|                                                                           |
|tar -xvzf jakarta-tomcat-4.0.3.tar.gz                                      |
|                                                                           |
|cd jakarta-tomcat-4.0.3                                                    |
|                                                                           |
|cd bin                                                                     |
|                                                                           |
|rm *.bat                                                                   |
|                                                                           |
|echo export JAVA_HOME=/usr/lib/java/ >> /etc/profile                       |
|. /etc/profile                                                             |
+---------------------------------------------------------------------------+

Now you should be able to startup tomcat:
+---------------------------------------------------------------------------+
|/usr/local/apache/jakarta-tomcat-4.0.3/bin/startup.sh                      |
+---------------------------------------------------------------------------+
 

You should now be able to connect to: [http://localhost:8080/index.html]
http://localhost:8080/index.html

For the further steps like installing your servlets and jps-files, you are
responsible by youself...

Notice: Since the author is NOT a Java-Programmer he will not be able to help
you with Java-Problems! The author is an experienced SysAdmin and could you
give some hints: Be sure your CLASSPATH Variable is set right. This is the
most common error done. Have fun, and as metioned above, the author welcomes
some feedback to be able to provide more information to the community.
-----------------------------------------------------------------------------

7. Further Information

Here are some other resources available on the internet
-----------------------------------------------------------------------------

7.1. News groups

Some of the most interesting news groups are:

*[news:alt.apache.configuration] alt.apache.configuration
   
*[news:comp.infosystems.www.servers.unix]
    comp.infosystems.www.servers.unix
   
*[news:alt.comp.lang.php] alt.comp.lang.php
   
*[news:alt.php] alt.php
   
*[news:comp.databases] comp.databases
   

Also check out your country newsgroups e.g ch.comp.os.linux

Most newsgroups have their own FAQ that are designed to answer most of your
questions, as the name Frequently Asked Questions indicate. Fresh versions
should be posted regularly to the relevant newsgroups. If you cannot find it
in your news spool you could go directly to the [ftp://rtfm.mit.edu/] FAQ
main archive FTP site. The WWW versions can be browsed at the FAQ main
archive WWW site.
-----------------------------------------------------------------------------

7.2. Mailing Lists

-----------------------------------------------------------------------------
7.2.1. <users@httpd.apache.org>

Send an empty email to <users-subscribe@httpd.apache.org>

Before writing to the list, check out the archive: [http://
marc.theaimsgroup.com/?l=apache-httpd-users] http://marc.theaimsgroup.com/?l=
apache-httpd-users
-----------------------------------------------------------------------------

7.2.2. <modperl@apache.org>

Send an mail to <modperl@apache.org> with the content (not subject):
+---------------------------------------------------------------------------+
|   subscribe modperl                                                       |
+---------------------------------------------------------------------------+

Before writing to the list, check out the archive: [http://
outside.organic.com/mail-archives/modperl/] http://outside.organic.com/
mail-archives/modperl/
-----------------------------------------------------------------------------

7.2.3. <openssl-users@openssl.org>

Send an mail to <majordomo@openssl.org> with the content (not subject):
+---------------------------------------------------------------------------+
|   subscribe openssl-users                                                 |
+---------------------------------------------------------------------------+

Before writing to the list, check out the archive: [http://
www.mail-archive.com/openssl-users@openssl.org/] http://www.mail-archive.com/
openssl-users@openssl.org/
-----------------------------------------------------------------------------

7.2.4. <modssl-users@modssl.org>

Send an mail to <majordomo@modssl.org> with the content (not subject):
+---------------------------------------------------------------------------+
|   subscribe modssl-users                                                  |
+---------------------------------------------------------------------------+

Before writing to the list, check out the archive: [http://
www.mail-archive.com/modssl-users@modssl.org/] http://www.mail-archive.com/
modssl-users@modssl.org/
-----------------------------------------------------------------------------

7.2.5. <mysql@lists.mysql.com>

Send an empty mail to <mysql-subscribe@lists.mysql.com>

Before writing to the list, check out the archive: [http://lists.mysql.com/
cgi-ez/ezmlm-cgi/] http://lists.mysql.com/cgi-ez/ezmlm-cgi/
-----------------------------------------------------------------------------

7.2.6. <pgsql-general@postgres.org>

Fill out the subscription form at [http://developer.postgresql.org/
mailsub.php] http://developer.postgresql.org/mailsub.php

Before writing to the list, check out the archive: [http://
archives.postgresql.org/pgsql-general/] http://archives.postgresql.org/
pgsql-general/
-----------------------------------------------------------------------------

7.2.7. <pgsql-general@postgres.org>

Fill out the subscription form at [http://www.php.net/mailing-lists.php]
http://www.php.net/mailing-lists.php

There are several php related mailinglist to subscribe, some of them are also
available on php.net's newsserver

Before writing to the list, check out the archive that are linked also on the
subscription-page

-----------------------------------------------------------------------------
7.2.8. <apc-cache@lists.communityconnect.com>

Send an mail to <apc-cache-request@lists.communityconnect.com> with the
content (not subject):
+---------------------------------------------------------------------------+
|   subscribe                                                               |
+---------------------------------------------------------------------------+
-----------------------------------------------------------------------------

7.3. HOWTO

These are intended as the primary starting points to get the background
information. They also show you how to solve a specific problem. Some
relevant HOWTOs are

[http://www.linuxdoc.org/HOWTO/Apache-Overview-HOWTO.html]
Apache-Overview-HOWTO , [http://www.linuxdoc.org/HOWTO/
Apache-WebDAV-LDAP-HOWTO/index.html] Apache-WebDAV-LDAP-HOWTO , [http://
www.linuxdoc.org/HOWTO/LDAP-HOWTO.html] LDAP-HOWTO , [http://www.linuxdoc.org
/HOWTO/LDAP-Implementation-HOWTO/index.html] LDAP-Implementation-HOWTO and
the [http://www.linuxdoc.org/HOWTO/PHP-HOWTO.html] PHP-HOWTO

The main site for these is the [http://www.linuxdoc.org/] LDP archive
-----------------------------------------------------------------------------

7.4. Local Resources

Usually distributions install some documentation on your system. Usually they
are located in /usr/share/doc/packages or /usr/local/share/doc

The software products mentioned here provide a lot of documentation in their
source-directories. Apache does install its documentation in the default
DocumentRoot /usr/local/apache/htdocs/manual

  
-----------------------------------------------------------------------------

7.5. Web Sites

There are a large number of informative web sites available. By their very
nature they change quickly, so do not be surprised if these links become
outdated very fast.

A good starting point is of course the Linux Documentation Project home page,
a central information repository for documentation, project pages and much
more.

To get more information about the Software mentioned in this document, then
the following sites are good starting points.

*[http://httpd.apache.org] http://httpd.apache.org
   
   

*[http://www.openssl.org] http://www.openssl.org
   
   

*[http://www.modssl.org] http://www.modssl.org
   
   

*[http://http://perl.apache.org/] http://perl.apache.org/
   
   

*[http://www.webdav.org] http://www.webdav.org
   
   

*[http://www.mysql.com] http://www.mysql.com
   
   

*[http://www.postgresql.org] http://www.postgresql.org
   
   

*[http://www.pdflib.com] http://www.pdflib.com
   
   

*[http://www.php.net] http://www.php.net
   
   

*[http://www.phpbuilder.com] http://www.phpbuilder.com
   
   

Please let me know if you have any other leads that can be of interest.
-----------------------------------------------------------------------------

8. Questions and Answers

Here I answer the questions which I got from users. If you dont find an
answer feel free to contact me

*Q: Why you dont add a describtion howto compile and setup mod_xyz?
   
    A: Because nobody requested it yet and I eighter did not know about a
    mod_xyz, or I did not found it useful. Feel free to write me some
    suggestions what to add to the HOWTO. If there is more than one request,
    and it makes sense, it will maybe added in further releases.
   
*Q: If my clients are connecting to https://myserver.org an errormessage
    similar to this appears "Certificate not valid"
   
    A: The certificate produced like descibed in this HOWTO is just a
    self-signed certificate. This means the CA (Certification Authority) is
    you. Your CA is not recognized as a valid CA by your users browser. You
    can eighter install the certificate on your users machines (Makes sense
    in small Intranet enviroments) or buy a certificate from a CA that is
    recognized by all major browsers. An example of such a CA is Verisign
    [http://www.verisign.com] http://www.verisign.com. Such a certificate
    cost approx. 300 USD a year, depending on the strenght of the key (56 or
    128 Bits)
   
*Q: When I request a php file, the browser want to download it. Whats
    wrong?
   
    A: You forgot to tell apache what to do with the php files. So the php
    files are not processed by the php engine. To do so, add the application
    type like descibed in
   
*Q: Does this HOWTO also work on other platforms?
   
    A: Not sure, Solaris should work, AIX and HP-UX do not. I did not got the
    time to try FreeBSD yet. My goal is to provide a version of the HOWTO for
    all major Un*x platforms.
   

