# Copyright 2002 Sun Microsystems, Inc.  All rights reserved.
# Use subject to license terms.
#
#ident	"@(#)README.Solaris	1.2	02/01/24 SMI"

Solaris specific build/configuration information.

Source is available in the SUNWapchS package.

EAPI patches have been applied to the source tree, so things
that need it can be dropped in without rebuilding the server.

Configure options:
            ./configure --with-layout=Solaris \
                --prefix=/usr/apache \
                --with-perl=/usr/perl5/bin/perl \
                --enable-module=all \
                --disable-module=auth_db \
                --enable-rule=EAPI \
                --bindir=/usr/apache/bin \
                --sbindir=/usr/apache/bin \
                --libexecdir=/usr/apache/libexec \
                --mandir=/usr/apache/man \
                --sysconfdir=/etc/apache \
                --datadir=/var/apache \
                --includedir=/usr/apache/include \
                --cgidir=/var/apache/cgi-bin \
                --localstatedir=/usr/apache \
                --runtimedir=/var/run \
                --logfiledir=/var/apache/logs \
                --proxycachedir=/var/apache/proxy \
                --enable-suexec \
                --suexec-caller=nobody \
                --suexec-safepath=/usr/bin \
                --enable-shared=max \
                --activate-module=src/modules/perl/libperl.a \
                --enable-shared=perl

A sample config file is shipped in /etc/apache/httpd.conf-example.
This file can be copied to /etc/apache/httpd.conf, to be used as a
starting point for setup. ServerName is set to 127.0.0.1 by default,
which makes it easy to enable Tomcat and see the examples and
documentation, as well as test httpd locally.

By default, all supplied modules are enabled, except mod_jserv and
mod_webapp (see below).  This may not be an optimal configuration, as
you may not want or need many of the modules.  In particular,
mod_perl is a memory hog (if you don't need it).

Java support:

We include mod_jserv, which supports the Java Servlet API V 2.0 (now
obsolete). We also include mod_webapp, which is a web connector used
to interface httpd to Jakarta Tomcat, which supports the Servlet API
V2.3 as well as Java Server Pages V1.2.

You may enable either mod_jserv or mod_webapp, but not both
at the same time.  See the comments in the example httpd.conf file.

If you enable Tomcat, you must also copy
/var/apache/tomcat/conf/server.xml-example to
/var/apache/tomcat/conf/server.xml, and optionally modify it for your
environment.  As supplied, the example file will enable the examples
supplied with Tomcat as a standalone HTTP server on port 8080 as
well as thru apache on port 80.
