| 1 | == Setting up Helma 1.6 with Apache 2 using AJP13 (mod_jk) module on Linux == |
| 3 | These instructions are for Linux but procedure should be similar for OSX, BSD, etc. |
| 4 | |
| 5 | Firstly even though they are for Apache 1.x, read the excellent instructions at http://helma.org/docs/howtos/mod_jk/ |
| 6 | |
| 7 | Next use your Linux distributions preferred way of installing the mod_jk Apache module. |
| 8 | |
| 9 | For example for Fedora Core 4 (and so RedHat Enterprise 4, but just be sure you are subscribed to channel "Red Hat Application Server") |
| 10 | |
| 11 | yum install mod_jk |
| 12 | |
| 13 | 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. |
| 14 | |
| 15 | Depending on where the mod_jk module is placed on your system, set that directory in your httpd.conf file. |
| 16 | For exaample, if you store the apache modules in the apache install directory modules directory, you need to use: |
| 17 | |
| 18 | LoadModule jk_module modules/mod_jk.so |
| 19 | |
| 20 | You DONT need to use the 'AddModule mod_jk.c' line in the httpd.conf file (that is an Apache 1.x thing). |
| 21 | |
| 22 | But DO include the config parameters surrounded in an IfModule tag like so: |
| 23 | |
| 24 | <IfModule mod_jk.c> |
| 25 | # Configure mod_jk |
| 26 | JkWorkersFile /usr/local/helma-1.6.0/workers.properties |
| 27 | JkLogFile /var/log/httpd/mod_jk.log |
| 28 | JkLogLevel error |
| 29 | # mount on default host |
| 30 | JkMount /forms/* helma |
| 31 | </IfModule> |
| 32 | |
| 33 | of course the above assumes you have helma installed in |
| 34 | /user/local/helma-1.6.0 |
| 35 | directory and you want the mod_jk log to go into |
| 36 | /var/log/httpd directory. |
| 37 | |
| 38 | more information on configuring mod_jk can be found at: |
| 39 | |
| 40 | http://tomcat.apache.org/tomcat-3.3-doc/mod_jk-howto.html |
| 41 | http://tomcat.apache.org/tomcat-3.3-doc/Tomcat-Workers-HowTo.html |
| 42 | |
| 43 | TODO: Notes on using mod_jk2 with Helma and Apache 2. |