Contents The Original "Railo Express" powered by Jetty Background Information Installation Configuration

The Original "Railo Express" powered by Jetty

Background Information

Railo 3.1 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 especially interesting if you e.g. would like to get to know Railo better first, or test your applications under Railo or simply use it as development background.

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. under c:/railo-express-3-1-x-xxx/
3. Start the start.bat (Linux start.sh) in the Railo directory
4. Now you can contact the CFML data located under {railo-express}/webroot on the browser (http:/localhost:8888)

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

Configuration

Next to the possibility of configurating Railo with the Web/server administrator, you can adminstrate the application and Webserver of Railo Express under {railo-express-install-dir}/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 railo.xml. Copy this file into mycontext.xml and change it like follows (let's assume you want to create a host (context) called "mycontext"):

<?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>
<-- <The directory is located under the root of the installation. You can enter an absolute path as well -->
<Set name="resourceBase"><SystemProperty name="jetty.home" default="."/>/mycontext/</Set>  <-- <Jetty reacts on the following files -->
  <Set name="welcomeFiles">
    <Array type="String">
      <Item>index.cfm</Item>
      <Item>index.cfml</Item>
      <Item>index.htm</Item>
      <Item>index.html</Item>
    </Array>
  </Set>
<-- <- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
  <-- <Optional context configuration                                  -->
  <-- <- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  <Set name="extractWAR">false</Set>
  <Set name="copyWebDir">false</Set>  -->
  <Set name="defaultsDescriptor"><SystemProperty name="jetty.home" default="."/>/etc/webdefault.xml</Set>
  <-- <virtual hosts  -->
  <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