Installing Railo Express

To install Railo 3.1 Open Source express is very easy to do. It's just a matter of downloading and unpacking a file and executing a shell script or a batch file.

Installation

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.

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

Download Railo Express Version (Zip File) in the Customer Center
Unpack the zip file somewhere onto your local file system e.g. under c:/railo-express-3-1-x-xxx/
Start the start.bat (Linux start.sh) in the Railo directory
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 coresponding 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.

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

Default