README
1 # Copyright 2008 Sun Microsystems, Inc. All rights reserved.
2 #
3 # CDDL HEADER START
4 #
5 # The contents of this file are subject to the terms of the
6 # Common Development and Distribution License (the "License").
7 # You may not use this file except in compliance with the License.
8 #
9 # You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10 # or http://www.opensolaris.org/os/licensing.
11 # See the License for the specific language governing permissions
12 # and limitations under the License.
13 #
14 # When distributing Covered Code, include this CDDL HEADER in each
15 # file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16 # If applicable, add the following below this CDDL HEADER, with the
17 # fields enclosed by brackets "[]" replaced with your own identifying
18 # information: Portions Copyright [yyyy] [name of copyright owner]
19 #
20 # CDDL HEADER END
21 #
22 # Use subject to license terms.
23 #
24 #ident "@(#)README 1.5 08/12/12 SMI"
25
26 Contained in this directory are all the various patches and
27 configuration file templates that are applied to the Solaris
28 version of Apache (prior to or during the build). Additional
29 fixes are done to the built image by the install-apache script
30 that is run by the Makefile.sfw.
31
32 apache.sh - the script that goes in etc/init.d to start apache
33 apachectl.patch - patch for contract interface from PSARC/2001/244
34 httpdconf.sed - sed script to "fix" httpd.conf-example
35 manpage.patches - fix apache server manpages for solaris
36 mod_jserv.patch - large file fixes for mod_jserv
37 jk.conf - configuration file for mod_jk
38 workers.properties - worker definition used by mod_jk
39 README.Solaris
1 #
2 # CDDL HEADER START
3 #
4 # The contents of this file are subject to the terms of the
5 # Common Development and Distribution License (the "License").
6 # You may not use this file except in compliance with the License.
7 #
8 # You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 # or http://www.opensolaris.org/os/licensing.
10 # See the License for the specific language governing permissions
11 # and limitations under the License.
12 #
13 # When distributing Covered Code, include this CDDL HEADER in each
14 # file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 # If applicable, add the following below this CDDL HEADER, with the
16 # fields enclosed by brackets "[]" replaced with your own identifying
17 # information: Portions Copyright [yyyy] [name of copyright owner]
18 #
19 # CDDL HEADER END
20 #
21 # Copyright 2008 Sun Microsystems, Inc. All rights reserved.
22 # Use is subject to license terms.
23 #
24 #ident "@(#)README.Solaris 1.6 08/12/12 SMI"
25
26 Solaris specific build/configuration information.
27
28 Source is available on http://opensolaris.org.
29
30 EAPI patches have been applied to the source tree, so things
31 that need it can be dropped in without rebuilding the server.
32
33 Configure options:
34 ./configure --with-layout=Solaris \
35 --prefix=/usr/apache \
36 --with-perl=/usr/perl5/bin/perl \
37 --enable-module=all \
38 --disable-module=auth_db \
39 --enable-rule=EAPI \
40 --bindir=/usr/apache/bin \
41 --sbindir=/usr/apache/bin \
42 --libexecdir=/usr/apache/libexec \
43 --mandir=/usr/apache/man \
44 --sysconfdir=/etc/apache \
45 --datadir=/var/apache \
46 --includedir=/usr/apache/include \
47 --cgidir=/var/apache/cgi-bin \
48 --localstatedir=/usr/apache \
49 --runtimedir=/var/run \
50 --logfiledir=/var/apache/logs \
51 --proxycachedir=/var/apache/proxy \
52 --enable-suexec \
53 --suexec-caller=nobody \
54 --suexec-safepath=/usr/bin \
55 --enable-shared=max \
56 --activate-module=src/modules/perl/libperl.a \
57 --enable-shared=perl
58
59 A sample config file is shipped in /etc/apache/httpd.conf-example.
60 This file can be copied to /etc/apache/httpd.conf, to be used as a
61 starting point for setup. ServerName is set to 127.0.0.1 by default,
62 which makes it easy to enable Tomcat and see the examples and
63 documentation, as well as test httpd locally.
64
65 By default, all supplied modules are enabled, except mod_jserv and
66 mod_jk (see below). This may not be an optimal configuration, as
67 you may not want or need many of the modules. In particular,
68 mod_perl is a memory hog (if you don't need it).
69
70 Java support:
71
72 We include mod_jserv, which supports the Java Servlet API V 2.0 (now
73 obsolete). We also include mod_jk, which is a web connector used
74 to interface httpd to Apache Tomcat, which supports the Servlet API
75 V2.5 as well as Java Server Pages V2.1.
76
77 You may enable either mod_jserv or mod_jk, but not both
78 at the same time. See the comments in the example httpd.conf file.
79
80 If you enable mod_jk, you will probably need to start Apache Tomcat.
81 For more information how to do it see tomcat(1m) man page.
82