Installation ExpressJetty

Table of Contents The Original "Railo Express" powered by Jetty Background Information Installation Configuration Creating a new web context

The Original "Railo Express" powered by Jetty

Background Information

Railo Express is a live version, which means that it does not need to be installed. Just copy it onto your computer and without further installation you can start. This is useful if, for example, you would like to get to know Railo better, test your applications under Railo, or simply use it as a development environment.

Railo Express can also be especially useful for testing advanced features such as clustering, where you need multiple instances running.

Installation

In order to get Railo Express running just follow these steps:

1. Download Railo Express Version (Zip File)
2. Unpack the zip file somewhere onto your local file system e.g. c:/railo-express-x.x.x.xxx-jre-win64/ (the name of the directory in the zip file normally contains the version number, etc.)
3. Start the start.bat (Linux start.sh) in the Railo directory
4. Now you can test Railo Express by browsing to http://localhost:8888 and you should see the index.cfm page, which is located in {railo-express}/webapps/www

To stop Railo Express again just use the command: {railo-express}/stop.bat, bzw. {railo-express}/stop.sh .

Configuration

You can configure Railo Express with the web/server administrator pages, or you can edit {railo-express-install-dir}\lib\ext\railo-server\context\railo-server.xml

Creating a new web context

You can create a new web context by adding another corresponding XML file to the /contexts folder. In there you'll find a file named "www.xml"

Let's assume you want to create a host (context) called "mycontext". Copy this file into mycontext.xml and change it like follows:

	<?xml version="1.0"  encoding="ISO-8859-1"?>
	<!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" "http://jetty.mortbay.org/configure.dtd">
	
	<Configure class="org.mortbay.jetty.webapp.WebAppContext">
	  <Set name="contextPath">/</set>
	
	<Set name="resourceBase"><SystemProperty name="jetty.home" default="."/>/mycontext/</set>  
	  <Set name="welcomeFiles">
	    <Array type="String">
	      <Item>index.cfm</item>
	      <Item>index.cfml</item>
	      <Item>index.htm</item>
	      <Item>index.html</item>
	    </array>
	  </set>
	
	  
	  
	  <Set name="defaultsDescriptor"><SystemProperty name="jetty.home" default="."/>/etc/webdefault.xml</set>
	  
	  <Set name="virtualHosts">
	    <Array type="String">
	      <Item>mycontext</item>
	    </array>
	  </set>
	</configure>

Then you need to restart Jetty. In order to test it locally, just have 127.0.0.1 point to mycontext in your local system's host file and you should be done. After the restart you can now call http://mycontext:8888/index.cfm and you'll execute the index.cfm from the /mycontext directory.

• Setting the path to your context on windows should be input like: /c:/mycontext/ if the files aren't contained in the railo folder.

For further information and instructions check out http://jetty.mortbay.org