1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
|
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Building from the subversion tree: (for developers only).
-----------------------------------
When using a subversion tree buildconf.sh must be run before configure.
The today version of buildconf.sh build the following files:
libtool files in scripts/build/unix (should copy them?).
Makefile.in from Makefile.am
aclocal.m4 from different m4 files located in the local machine.
configure from configure.in and aclocal.m4.
If you see error message from automake, don't care about them.
Building using configure
------------------------
It is possible to use autoconf for configuration and installation.
To create tomcat-connectors's autoconf script, you will need libtool
1.5.2, automake 1.10 and autoconf 2.59 or newer. The use of more recent
versions is strongly encouraged, e.g. for reliable detection of the
features of recent version of operating systems (e.g. AIX 6.1).
Those tools will not be required if you are just
using a package downloaded from apache.org, they are only required for
developers.
To configure tomcat-connectors run the following commands.
./buildconf.sh (not required unless you are a developer)
./configure [autoconf arguments] [tomcat-connectors arguments]
make
It is possible to set CFLAGS and LDFLAGS to add some platform specifics:
LDFLAGS=-lc \
./configure -with-apxs=/home2/local/apache/bin/apxs
Build for both Apache 1.3 and 2.0
---------------------------------
If you want to build mod_jk for Apache 1.3 and 2.0, you should :
use configure and indicate Apache 1.3 apxs location (--with-apxs)
use make
copy the mod_jk binary to the apache modules location
make clean (to remove all previously compiled modules)
use configure and indicate Apache 2.0 apxs location,
then make.
./configure --with-apxs=/usr/sbin/apxs
make
cp ./apache-1.3/mod_jk.so /usr/lib/apache
make clean
./configure --with-apxs=/usr/sbin/apxs2
make
cp ./apache-2.0/mod_jk.so /usr/lib/apache2
Examples
--------
Apache2.0, JNI support:
./configure --with-apxs=/opt/apache2/bin/apxs --with-java-home=${JAVA_HOME} --with-java-platform=2 -enable-jni
Apache 1.3, no JNI support:
./configure --with-apxs=/usr/sbin/apxs
tomcat-connectors arguments
-----------------------------------
JVM related parameters:
--with-java-home=DIR
DIR is the patch to the JDK root directory. Something like: /opt/java/jdk12
--with-os-type[=SUBDIR]
SUBDIR is the os-type subdirectory, normaly configure should guess it
correctly.
--with-arch-type[=SUBDIR]
SUBDIR is the arch subdirectory, normaly configure should guess it correctly.
--with-java-platform=VAL
VAL is the Java platform 1 is 1.1.x and 2 is 1.2.x. It is guessed correctly.
Apache related parameters:
--with-apxs[=FILE]
FILE is the location of the apxs tool. Default is finding apxs in PATH.
It builds a shared Apache module. It detects automaticly the Apache version.
(2.0 and 1.3)
* --with-apache=DIR
DIR is the path where apache sources are located.
The apache sources should have been configured before configuring mod_jk.
DIR is something like: /home/apache/apache_1.3.19
It builds a static Apache module.
--enable-EAPI
This parameter is needed when using Apache-1.3 and mod_ssl, otherwise you
will get the error message: "this module might crash under EAPI!" when
loading libjk.so in httpd.
JNI support:
--enable-jni
Build the jni_connect.so and the JNI worker.
* Static build need more tests, and we strongly recommand dynamic build
using DSO/APXS.
Installation
------------
The mod_jk binary will be in :
./apache-1.3/mod_jk.so if you select to build mod_jk for apache 1.3
./apache-2.0/mod_jk.so if you select to build mod_jk for apache 2.0
Building for Netscape/iPlanet/SunONE WebServer
----------------------------------------------
make clean (to remove all previously compiled modules)
use configure and indicate that you will be building the
netscape nsapi redirector, then make the redirector plugin:
./configure --enable-netscape
cd netscape
make -f Makefile.solaris
This assumes that SUITSPOT_HOME is defined and points to
your SunONE install path (eg: /opt/SUNWwbsvr/plugins)
and that JAVA_HOME is defined (eg: /opt/SUNWwbsvr/bin/https/jdk).
Misc notes
----------
HP-UX build notes :
If you plan to use GCC on HP-UX to build mod_jk, be sure to
have -DHPUX11GCC defined (usually by setting CLAGS before configure)
Reports are that the stripped down cc version that ships with
HP-UX won't be able to works, you should habe the HP add-on ANSI C
Compiler package.
A good repository for HP-UX gnu tools is :
http://gatekeep.cs.utah.edu/
Solaris build notes :
the build should works with the GNU gcc compiler, on both
SPARC and x86 architecture systems.
A good repository for Solaris gnu tools is :
http://www.sunfreeware.com/
Be carefull when mixing native compiler and gnu compiler, and
ensure that apache and mod_jk will be compiled and linked with
the same tools (ie full Solaris or full GNU)
|
