Support

Railo is an open source, and free, CFML (Coldfusion) compiler. Railo translates CFML (Coldfusion Markup Language) into Java classes, which are then executed by a Java server. The default Java server used by the standard Railo installer, is Tomcat.

As of the latest release, Railo is mostly compatible with Coldfusion 9.0.1. You can refer to the Railo web site for details on supported and unsupported tags and functions.

Installing Railo in Linux (with Apache)

Firstly, obtain the Railo installer. The latest installer can be found here, which you can find the URLs for and use 'wget' to fetch them. Below is an example, using the latest version as of this writing.

32 bit (i386/i686)

wget http://www.getrailo.org/down.cfm?item=/railo/remote/download/3.2.1.000/tomcat/linux/railo-3.2.1.000-pl0-linux-installer.run

64 bit (x86_64)

wget http://www.getrailo.org/down.cfm?item=/railo/remote/download/3.2.1.000/tomcat/linux/railo-3.2.1.000-pl0-linux-x64-installer.run

Once the installer is downloaded, give it execute permissions.

chmod +x *.run

Then execute the file.

./railo-*-installer.run

The installer will prompt a serious of questions, for which you can use the default values for. However, for the setting 'Tomcat System User', it would be best to set this as the 'apache' user, to ensure .cfm pages are executed the same as Apache, instead of 'root'.

Now restart apache (service httpd restart), and the Railo Administrator should be accessible.

http://<server ip>/railo-context/admin/server.cfm

Add a Site

For a site to load CFML (.cfm, .cfc, etc) pages, the site must be added to the Tomcat server. To do this, open the file /opt/railo/tomcat/conf/web.xml in a text editor scroll to the bottom of the file. There, you'll find a commented out example host.

Copy this example (minutes the comment tags) just below it. Specify the domain name (name=), web root (docBase=), and any aliases (<Alias>). For example, for a site 'domain.com', located under '/var/www/domain.com/html' insert the following under the above example (but above the closing </Engine> tag.

<Host name="domain.com" appBase="webapps" unpackWARs="true" autoDeploy="true" xmlValidation="false" xmlNamespaceAware="false"> <Context path="" docBase="/var/www/domain.com/html" /> <Alias>www.domain.com</Alias> </Host>

Once the file has been updated, Railo's Tomcat server must be restarted.

/etc/init.d/railo_ctl restart

To test this, we can create and access a test.cfm file on the site with the following content.

Today's Date: <CFOUTPUT>#DateFormat(Now(),"dddd,m/d/yy")#</CFOUTPUT>

Permissions

Because Railo was installed as the apache user, we must be sure that the site's directory and it's contents, are owned (or at the least readable and listable) by the user.

chown -R apache.apache /var/www/domain.com/html