connectors/jk/native2/BUILD.txt

Information on building mod_jk2:

  Starting with 2.0.4, APR is mandatory for jk2. For Apache 2.0
  or greater jk2 will use APR that was used to build Apache 2.0.
  For Apache 1.3, jk2 must build APR and APR_UTIL from source. 

DSO build instructions for Unix-like systems:

  The compiler used to build jk2 must match the one used to build
  Apache. You may need to set an environment variable before 
  configuring such as CC=cc. `apxs -q CC` will tell you what 
  compiler was used for Apache.

  The most straightforward way to configure jk2 is to use apxs 
  that comes with Apache. Linux distributions may need to have 
  additional rpm's installed such as Apache2 devel rpm, 
  httpd-devel or apache2-devel or for Apache 13, Apache devel 
  rpm, httpd-devel or apache-devel depending on your 
  distribution.

  Example Apache2 build and install:

    cd jakarta-tomcat-connectors/jk/native2
    ./configure --with-apxs2=/your/path/to/apxs
    make
    cd ../build/jk2/apache2
    apxs -n jk2 -i mod_jk2.so

  Example Apache13 build and install:

    apr and apr-util will be configured and built for you while
    configuring and building jk2. There is no need to separately
    configure and build them. 

      cd jakarta-tomcat-connectors/jk/native2
      ./configure --with-apxs=/your/path/to/apxs \
                  --with-apr=/absolute/path/to/apr-source \
                  --with-apr-util=/absolute/path/to/apr-util-source
      make
      cd ../build/jk2/apache13
      apxs -n jk2 -i mod_jk2.so

    NOTE: pthread support may be automatically detected and built
    into apr. If apache13 was not built with pthread support, you
    can either disable it by adding --disable-apr-threads while
    configuring, or load the pthread library in httpd.conf using
    the LoadFile directive.

  Optional configure arguments (for 1.3 and 2.0):

    If you want to have JNI support, add --with-jni and be sure
    to have the JAVA_HOME environment variable point to your Java
    Environment. This will build inprocess jni support into
    mod_jk2.so and additionally build libjkjni.so. libjkjni.so
    can be used by tomcat to provide support for channel unix and
    should be installed in the apache libexec dir. Use 
    `apxs -q LIBEXECDIR` if you are unsure of its location. 
    Libjkjni.so will be located in the same directory as 
    mod_jk2.so after building with this option.

    If you want to have PCRE (Perl Compatible Regular
    Expressions) support for jk2 uri directives, add --with-pcre
    while configuring.


Quick information on building mod_jk2 :

* IIS 

There is a known issue with the latest APR 1.0 and MSVC6.
If you want to use MSVC6, please use APR 0.9.x for now.
MSVC7 doesn't have this issue, and could be used with APR 1.0.

Isapi redirector requires the following libraries to build:
apr, apr-util, apr-iconv and pcre.
The easiest way to obtain all those libraries is to download
the httpd-2.0.49-win32-src.zip from http://www.apache.org/dist/httpd or
from any of the mirror sites.
You will only need the srclib part (apr, apr-util, apr-iconv and pcre)
Unzip the entire srclib folder to j-t-c native2 folder.
Now open the isapi.dsw from MSVC6 and build.

Building using VS.NET:
Make sure that the required libraries are inside native2/srclib.
Open the idapi.dsw and select 'Yes to all' when prompted to convert the project.
During conversion the custom build adds extra quotations for
jk_logger_win32_message.mc. Right click on that file and select Properties.
For Custom Build Step remove all the quotations around ${InputDir}
and ${InputPath}.



* Netware

Buid the JK2 connector for NetWare platform.

The current NWNGUmakefile uses the same build system as Apache2 self for NetWare target.
Simply extract the downloaded archive, and follow the guideline which describes compilation of Apache2 self. 

After you have compiled Apache2 (this is mandatory for now since the prebuild process must have finished) 
you can simply call the makefile with 'make -f NWGNUmakefile', this builds the connector for Apache2 in a 
release or debug subdirectory, dependent if you specify to build a debug version or not.

It is recommended to use Metrowerks CodeWarrior compiler for now; although the connector builds with GCC 
for NetWare, it is not tested yet if it works - there are known issues with a bitfied and alignment which 
have to be solved.