Installing Railo 3 on Linux (CentOS): Part 2

In my previous post we started installing Railo on the CentOS Linux distribution. As most of us know installing applications on a Linux system sometimes requires more than one step. This installation is just that type.

mod_caucho

In order for your cfml pages to be processed the requests need to be routed from Apache to Caucho Resin, a J2EE open source application server, who then hands off the work to Railo. This isn't a problem under the Windows operating system since they already have a compiled DLL, but with all the different Linux distributions you need to "roll your own" binary.

Compiling mod_caucho

The first thing we need to do is installed the Development Tools for Apache HTTP server or httpd-devel.

-bash-3.2# yum install httpd-devel

After the install is finished change directories into your Railo directory.

-bash-3.2# cd /opt/railo
-bash-3.2# /configure --with-apxs=/usr/sbin/apxs --with-java-home=/railo/jre
<---- a bunch of stuff happens here ---->
-bash-3.2# make
-bash-3.2# make install
<---- some more stuff happens here ---->

Once the above is complete and didn't throw any errors the make and install should have added a LoadModule entry into your Apache httpd.conf file pointing to your newly compiled mod_caucho.so

LoadModule caucho_module /usr/lib/httpd/modules/mod_caucho.so

Virtual Hosts

If you have a control panel on your CentOS box it is most likely that you will have a separate .conf file for every Virtual Host that you create. You "could" add code into each of these .conf files to pass off the control to resin or you could do it in the main httpd.conf file. Since my VPS is a Railo box and most if not all of the Sites I will be hosting will be cfml based I decided to put the resin config in the Httpd.conf file.

# ----- resin START

ResinConfigServer localhost 6802
SetHandler caucho-request
CauchoStatus yes

SetHandler caucho-status


# ----- resin END

Congratulations you are Done...Honest!

You should now be good to go. Your server will now be able to process Coldfusion code using the Railo CFML Engine with Resin, Apache on a CentOS Linux distribution.