* JBoss Basic Configuration Guide *
* June 2003 Edition*
* *
* How to configure Apache HTTP Server 2.0.45 to communicate *
* with JBoss 3.2.1's integrated Catalina 4.1.24 implementation *
* via AJP13 with MOD_JK2 *
* *
* How to configure JBoss 3.2.1 with integrated Catalina 4.1.24 *
* as a Windows Service *
* *
* Author: Alexander Petty of Warrenton, Virginia, USA *
* Date: 06/05/03 *
* Time: 12:30:00 EST *
* *
* by the way: *
* *
* if you require software development and/or application *
* integration consulting services,*
* my firm :: the jaxara group :: can help.*
* look us up at: www.jaxara.com *
* *
* if you like music, check out my music at www.drumfish.com *
* there you can listen to mp3's of all my records in their*
* entirety for free!! please help me get the word out about *
* drumfish (my band) and thanks! *
* *
* *
***
** Configuration Guide for Apache HTTPd/Tomcat AJP13 Connector configuration using the
JK2 Connector **
***
Assumed OS: Windows NT/2K/XP
Assumed Environment:
JAVA_HOME c:\lib\java
JBOSS_HOME c:\jboss
APACHE_HOME c:\apache2
(How to set up the basic environment)
-- download and setup
Download JavaTM 2 Platform, Standard Edition, v 1.4.1_02 from
http://java.sun.com/j2se/1.4.1/download.html
run installer exe, change destination path to c:\lib\java
Download jboss-3.2.1_tomcat-4.1.24 from
http://prdownloads.sourceforge.net/jboss/jboss-3.2.1_tomcat-4.1.24.zip
decompress zip and copy to c:\jboss
Download Apache 2.0.45 from from
http://www.apache.org/dist/httpd/binaries/win32/apache_2.0.45-win32-x86-no_ssl.exe
run installer exe, change destination path to c:\, configure to run as
a service on port 80
-- set your environment in control panel | system | advanced | environment variables |
system variables
JAVA_HOME c:\lib\java
JBOSS_HOME c:\jboss
APACHE_HOME c:\apache2
1) acquire win32 binary of the jk2 connector module (mod_jk2-2.0.43.dll)
from
http://jakarta.apache.org/builds/jakarta-tomcat-connectors/jk2/release/v2.0.2/bin/win32/
copy to C:\apache2\modules
Note: although the connector's file name explicitly references apache version
2.0.43, it works
perfectly well with versions of apache higher than 2.0.43 (such as
2.0.45)
Also Note: if you are using apache 1.3.27 or higher you must use
mod_jk2-1.3.27.dll
2) in the path: c:\apache2\logs create an empty file called: shm.file
3) add file C:\apache2\conf\workers2.properties
add the entire file contents below
--- start (do not cut this line to clipboard)
# BOF - workers2.properties
# $Date: 2003/06/05 12:30:00
# $Author: Alexander Petty
# $Application: (Apache 2.0.45) --ajp13-- (JBoss 3.2.1 and Jakarta-Tomcat 4.1.24)
#
# comment out for production server
# [logger.apache2]
# level=DEBUG
[shm]
file=c:/apache2/logs/shm.file
size=1048576
# Example socket channel, override port and host.
[channel.socket:localhost:8009]
port=8009
host=localhost
# define the worker
[ajp13:localhost:8009]
channel=channel.socket:localhost:8009
# Uri mapping
[uri:[your_machines_ip_address]/*.jsp]
worker=ajp13:localhost:8009
[uri:[your_machines_ip_address]/servlet/*]
worker=ajp13:localhost:8009
[uri:[your_machines_ip_address]/[desired_uri]/*]
worker=ajp13:localhost:8009
[uri:[your_machines_hostname]/*.jsp]
worker=ajp13:localhost:8009