diff options
Diffstat (limited to 'rubbos/app/tomcat-connectors-1.2.32-src/native/BUILDING.txt')
| -rw-r--r-- | rubbos/app/tomcat-connectors-1.2.32-src/native/BUILDING.txt | 179 |
1 files changed, 179 insertions, 0 deletions
diff --git a/rubbos/app/tomcat-connectors-1.2.32-src/native/BUILDING.txt b/rubbos/app/tomcat-connectors-1.2.32-src/native/BUILDING.txt new file mode 100644 index 00000000..1e14e898 --- /dev/null +++ b/rubbos/app/tomcat-connectors-1.2.32-src/native/BUILDING.txt @@ -0,0 +1,179 @@ + 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 HTTP Server 1.3 and 2.0 + --------------------------------------------- + + If you want to build mod_jk for Apache HTTP Server + 1.3 and 2.0, you should : + + use configure and indicate Apache HTTP Server 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 HTTP Server 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 + -------- + + Apache HTTP Server 2.0: + + ./configure --with-apxs=/opt/apache2/bin/apxs + + Apache HTTP Server 1.3: + + ./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. + Note that JNI support has been discontinued + +* 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) + |