myRailo » Installation Railo 3.0 in JBoss 4.2.2

SEPTEMBER 8TH, 2008
By MARKUS SKRABAL

Installation Railo 3.0 in JBoss 4.2.2

In einer Demonstration muss ich heute Railo in Verbindung mit JBoss vorführen. Da ich gerade keinen anderen Rechner als mein Notebook frei zur Verfügung habe installiere ich also die komplette Konfiguration auf Windows XP.

Ich besorge mir als erstes alle benötigten Softwarekomponenten:

1. JBoss 4.2.2 - Download unter: http://www.jboss.org/jbossas/downloads/
2. Java 1.6 Update X JRE oder JDK - Download unter: http://java.sun.com/javase/downloads/?intcmp=1281
3. Railo 3.0 WAR - Download unter: http://www.railo-technologies.com/en/index.cfm?treeID=361

Alle Komponenten aus dem Netz gezogen? Dann kanns losgehen:

1. Installation Java 1.6 JRE oder JDK
Wichtig ist, dass die Umgebungsvariable JAVA_HOME auf das Installationsverzeichnis der 1.6 verweist. Die Umgebungsvariablen könnt Ihr einstellen unter: Rechtsklick Arbeitsplatz -> Eigenschaften -> Lasche Erweitert -> Umgebungsvariablen. Bei mir steht dann folgender Eintrag drin. JAVA_HOME = C:\Program Files\Java\jdk1.6.0_07\jre (Ich habe die JDK installiert)

2. Installation JBoss
Die Installation von JBoss ist total einfach. Einfach das Zip File nehmen und in einen beliebigen Ordner entpacken. ( Ich habe das Zip-File nach c:\JBoss_4.2.2 enpackt.)

3. Installation Railo
Geht in das Installationsverzeichnis von JBoss. Dort sind im Verzeichnis server drei Konfigurationen zu finden: all, minimal, default. Ich nutze für mich die default Konfiguration von JBoss, deshalb gehe ich in diesen Ordner. Darunter ist ein Verzeichnis deploy zu finden. Unter dem Ordner deploy, lege ich ein Verzeichnis mit dem Namen railo.ear an.

In diesem Verzeichnis lege ich das Railo Webarchiv (war-file) ab und bennene es in railo.zip um, welches ich anschließend in ein Verzeichnis railo.war ebenfalls im Ordner railo.ear entpacke. Das ZIP File benötigen wir jetzt nicht mehr und können es löschen.

Jetzt fehlt nur noch der Verzeichnis META-INF unterhalb des Ordners railo.ear. Legt dieses an und geht anschließend in dieses Verzeichnis. Legt dort eine Datei mit dem Namen application.xml an.
Editiert diese Datei und kopiert folgenden Inhalt rein.

<?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>

Speichert die Datei. Railo ist jetzt fertig in JBoss konfiguriert.

Das ganze hat jetzt folgende Ordnerstruktur:
JBOSS_4.2.2
JBOSS_4.2.2–server
JBOSS_4.2.2–server–default
JBOSS_4.2.2–server–default–deploy
JBOSS_4.2.2–server–default–deploy–railo.ear
JBOSS_4.2.2–server–default–deploy–railo.ear–META-INF
JBOSS_4.2.2–server–default–deploy–railo.ear–META-INF–application.xml
JBOSS_4.2.2–server–default–deploy–railo.ear–railo.war
JBOSS_4.2.2–server–default–deploy–railo.ear–railo.war–Files from WAR (WEB-INF…)

4. Start von JBoss
Geht in den Order JBOSS 4.2.2/bin und führt die Datei run.bat aus. JBoss startet jetzt und sollte dann folgende Meldung anzeigen:

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

5. Test der Installation
Wenn alles richtig funktioniert hat müsste Railo unter http://localhost:8080/railo ansprechbar sein.

Installation, Railo 2.0