Installing Railo 3 on JBoss 4.2.2

In the previous post I made about Railo I translated an entry from Markus Skrabal from Germany on how to configure Apache for Railo under JBoss. I also referenced an article on how to deploy Railo 3 to Jboss. There was only one problem with referencing that article.

The directions are on how to install the Railo 3 WAR not on how to install Railo as an EAR. The following is the instructions on how to install Railo 3 to JBoss 4.2.2 as an EAR.

Required Software

• Jboss 4.2.2 http://www.jboss.org/jbossas/downloads/
• Java 1.6 Update X JRE or JDK http://java.sun.com/javase/downloads/?intcmp=1281
• Railo 3.0 WAR http://railo.ch/en/index.cfm?treeID=224

Got everything downloaded? Good then lets get going!

Installing Java 1.6

The important bit here is that the JAVA_HOME variable is pointing to your newly installed 1.6 directory. You should already know how to change the environment variables on your machine but if you somehow forgot you can get to it by right-clicking on myComputer>Advanced: Environment Variables (or something similar, I'm currently on a German computer so the words might be a bit different). Once you have opened the environment variable section find the JAVA_HOME and make sure it's pointing to the right directory something like: JAVA_HOME = C:\Program Files\Java\jdk1.6.0_07\jre.

Installing JBoss

The JBoss install is dead easy, just drop the contents of the zip file in a folder and you are done. I extracted it to C:\Jboss_4.2.2

Installing Railo

Go to your JBoss install directory, under the Server folder you will see three additional folders: all, default, minmal. We will be deploying Railo to the default folder. In the default folder is a deploy folder, here we will create a new folder called railo.ear. Rename the railo.war file you downloaded previously into railo.zip and extract the contents of the zip file into the railo.ear folder. Once that is done we need to create a META-INF folder inside the railo.ear folder, then inside the newly created META-INF create a new file called application.xml and paste the following:

<?xml version="1.0? encoding="UTF-8??>
<!DOCTYPE application PUBLIC "-//Sun Microsystems, Inc.//DTD J2EE Application 1.2//EN" "http://java.sun.com/j2ee/dtds/application_1_2.dtd">
<application id="RailoInstance1?>
<display-name>Railo3</display-name>
<description>Railo3</description>
<module id="Module1?>
<web>
<web-uri>railo.war</web-uri>
<context-root>/railo</context-root>
</web>
</module>
</application>

Save the file and that concludes the install of Railo under JBoss. Go into the JBoss 4.2.2/bin directory and double-click the run.bat file to start JBoss. You should get something similar once JBoss is finished starting up.

11:01:16,203 INFO [Server] JBoss (MX MicroKernel) [4.2.2.GA (build: SVNTag=JBos
s_4_2_2_GA date=200710221139)] Started in 38s:16ms

Testing the Install

If JBoss started correctly you should be able to go to http://localhost:8080/railo and get the default index.cfm displayed.