HelmaWithApache2

Setting up Helma 1.6 with Apache 2 using AJP13 (mod_jk) module on Linux

These instructions are for Linux but procedure should be similar for OSX, BSD, etc.

Firstly even though they are for Apache 1.x, read the excellent instructions at http://helma.org/docs/howtos/mod_jk/

Next use your Linux distributions preferred way of installing the mod_jk Apache module.

For example for Fedora Core 4 (and so RedHat Enterprise 4, but just be sure you are subscribed to channel "Red Hat Application Server")

  yum install mod_jk

If you are running Helma from an "rc" start script (e.g. /etc/init.d/helma) you need to edit /etc/helma.conf and not start.sh.

Depending on where the mod_jk module is placed on your system, set that directory in your httpd.conf file.
For exaample, if you store the apache modules in the apache install directory modules directory, you need to use:

  LoadModule    jk_module  modules/mod_jk.so

You DONT need to use the 'AddModule mod_jk.c' line in the httpd.conf file (that is an Apache 1.x thing).

But DO include the config parameters surrounded in an IfModule tag like so:

  <IfModule mod_jk.c>
        # Configure mod_jk
        JkWorkersFile /usr/local/helma-1.6.0/workers.properties
        JkLogFile     /var/log/httpd/mod_jk.log
        JkLogLevel    error
        # mount on default host
        JkMount /forms/*  helma
  </IfModule>

of course the above assumes you have helma installed in:

  /user/local/helma-1.6.0

directory and you want the mod_jk log to go into:

  /var/log/httpd directory.

more information on configuring mod_jk can be found at:

http://tomcat.apache.org/tomcat-3.3-doc/mod_jk-howto.html
http://tomcat.apache.org/tomcat-3.3-doc/Tomcat-Workers-HowTo.html

TODO: Notes on using mod_jk2 with Helma and Apache 2.