Railo 3: JBoss and Apache

In order for you to get Apache and Railo to work on JBoss a few modules need to be able to communicate with each other. The installation and setup of those modules is described below.

Foundation

Required Software:

Railo (3.0.0.6), Apache, JBoss, and finally MOD_JK

Environment:

Install JBoss, Railo and Apache. For instructions on how to install Railo on Jboss you can see my blog post Deploying Railo 3 to JBoss.

Installation/Configuration

With Jboss installed to c:\Jboss and Apache installed to c:\APACHE we can load the MOD_JK connector. After getting the correct version for your environment, in my case version mod_jk-1.2.26-httpd-2.0.59.so, drop it into the c:\APACHE\modules directory and rename it to mod_jk.so

That's it for required software now we can concentrate on the configuration.

Configuring Apache:

Open the httpd.conf file located in the c:\APACHE\conf folder and look for the loadModules block and add the following:

# JBOSS Connector
LoadModule jk_module modules/mod_jk.so

Add the following to the end of the httpd.conf file:

# Include mod_jk configuration file
Include conf/mod_jk.conf

Don't forget to save the file!

Configuring the Connector

Still in the c:\APACHE\conf create a file called mod_jk.conf. Copy the following into your emtpy mod_jk.conf file and save it.

# Where to find workers.properties
JkWorkersFile conf/worker.properties
# Where to put jk logs
JkLogFile logs/mod_jk.log
# Set the jk log level [debug/error/info]
JkLogLevel info
# Select the log format
JkLogStampFormat "[%a %b %d %H:%M:%S %Y]"
# JkOptions indicates to send SSK KEY SIZE
# Note: Changed from +ForwardURICompat.
# See http://tomcat.apache.org/security-jk.html 
JkOptions +ForwardKeySize +ForwardURICompatUnparsed -ForwardDirectories
# JkRequestLogFormat
JkRequestLogFormat "%w %V %T"
# You can use external file for mount points.
# It will be checked for updates each 60 seconds.
# The format of the file is: /url=worker
# /examples/*=loadbalancer
JkMountFile conf/uriworkermap.properties
# Add shared memory.
# This directive is present with 1.2.10 and
# later versions of mod_jk, and is needed for
# for load balancing to work properly
# Note: Replaced JkShmFile logs/jk.shm due to SELinux issues. Refer to
# https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=225452
JkShmFile run/jk.shm

worker.list=node1
# Define Node1# modify the host as your host IP or DNS name.
worker.node1.port=8009
worker.node1.host=localhost
worker.node1.type=ajp13
worker.node1.lbfactor=1

# Mount your applications
/jmx-console=node1
/jmx-console/*=node1
/web-console=node1
/web-console/*=node1
/railo=node1
/railo/*=node1