<cfset PO = 'Pierre-Olivier'/>

How to install Railo:

Why another blog entry on the subject: because I was needed to read 5 different blogs to get it work properly.

Thanks to Railo Blog, Gary Gilbert, Chris aka hockeypFeF, Mike Benner and Mark Mcaulay for posting their own experiences how to install it.

To start you will need these tools

-bash-3.2# yum install make nano httpd-devel openssl-devel lynx

First of all we will need to get the latest jdk from Sun and install it

-bash-3.2# cd opt
-bash-3.2# mkdir soft
-bash-3.2# cd soft
-bash-3.2# curl -L -O
'http://cds.sun.com/is-bin/INTERSHOP.enfinity/WFS/CDS-CDS_Developer-Site/en_US/-/USD/VerifyItem-Start/jdk-6u13-linux-i586.bin?BundledLineItemUUID=BXlIBe.p1iMAAAEgGLURNnCV&OrderID=r6lIBe.pMTMAAAEgCLURNnCV&ProductID=RGtIBe.ou1AAAAEfpVYcydOO&FileName=/jdk-6u13-linux-i586.bin'
-bash-3.2# chmod +x jdk-6u13-linux-i586.bin
-bash-3.2# ./jdk-6u13-linux-i586.bin 

You will need to press "enter" a couple of time to acknowledge the liscence and press "Y" at the end.

When it's done we need to add Java to our path

-bash-3.2#  nano /etc/profile.d/java.sh

In this file add these 2 lines:

export JAVA_HOME=/opt/soft/jdk1.6.0_13/
export PATH=$JAVA_HOME/bin:$PATH

Save your file and make it executable like that:

-bash-3.2# chmod +x /etc/profile.d/java.sh

Now you have to log off of SSH and comeback in

You will be able to test if java is properly install with this command line

java -version

If Java is properly install you will have the java version intall

Now we need to download Railo

-bash-3.2# cd opt


-bash-3.2# wget http://www.getrailo.org/down.cfm?item=/railo/remote/download/3.1.0.012/server/all/railo-3.1.0.012-resin-3.1.2-without-jre.tar.gz

We extract Railo with this command line

-bash-3.2# tar xzf railo-3.1.0.012-resin-3.1.2-without-jre.tar.gz

Making a relative path to the folder extract to simplify the writing

-bash-3.2# ln -s railo-3.1.0.012-resin-3.1.2-without-jre railo

Now the interesting part the compiling of the module Caucho

-bash-3.2# cd railo


-bash-3.2# ./configure --with-java-home=/opt/soft/jdk1.6.0_13/ --with-apxs=/usr/sbin/apxs


-bash-3.2# make 


-bash-3.2# make install

if everything is fine no errors occurs during the last 3 steps

You can look into your httpd.conf file these new lines will be at the end of your file

-bash-3.2# nano /etc/httpd/conf/httpd.conf

#
# mod_caucho Resin Configuration
#

LoadModule caucho_module /usr/lib/httpd/modules/mod_caucho.so

ResinConfigServer localhost 6800
CauchoConfigCacheDirectory /tmp
CauchoStatus yes

Now we need a script to railo start automatically at the startup

-bash-3.2# nano /etc/init.d/resin

##############################################
#!/bin/sh
#
# Linux startup script for Resin
# chkconfig: 345 85 15
# description: Resin is a Java Web server.
# processname: wrapper.pl
#
#
JAVA_HOME=/your/java/path for me it's /opt/soft/jdk1.6.0_13
RESIN_HOME=/your/resin path for me it's /opt/railo

export JAVA_HOME RESIN_HOME

JAVA=$JAVA_HOME/bin/java
#
# If you want to start the entire Resin process as a different user,
# set this to the user name. If you need to bind to a protected port,
# e.g. port 80, you can't use USER, but will need to use bin/resin.
#
USER=
#
# Set to the server id to start
#
#SERVER="-server app-a"
#
ARGS="-resin-home $RESIN_HOME $SERVER"

if test -r /lib/lsb/init-functions; then
. /lib/lsb/init-functions
else

log_daemon_msg () {
if [ -z "$1" ]; then
return 1
fi

if [ -z "$2" ]; then
echo -n "$1:"
return
fi

echo -n "$1: $2"
}

log_end_msg () {
[ -z "$1" ] && return 1

if [ $1 -eq 0 ]; then
echo " ."
else
echo " failed!"
fi

return $1
}

fi

case "$1" in
start)
logger "Starting resin"
if test -n "$USER"; then
su $USER -c "$JAVA -jar $RESIN_HOME/lib/resin.jar $ARGS start" 1>/dev/null 2>/dev/null
else
$JAVA -jar $RESIN_HOME/lib/resin.jar $ARGS start 1>/dev/null 2>/dev/null
fi
logger $?
;;
stop)
logger "Stopping resin"
if test -n "$USER"; then
su $USER -c "$JAVA -jar $RESIN_HOME/lib/resin.jar $ARGS stop" 1>/dev/null 2>/dev/null
else
$JAVA -jar $RESIN_HOME/lib/resin.jar $ARGS stop 1>/dev/null 2>/dev/null
fi
logger $?
;;
restart)
$0 stop
$0 start
;;
*)
echo "Usage: $0 {start|stop|restart}"
exit 1
esac

exit 0

Save the your file and we need to made it executable and bootable at the startup

We do that with these 3 lines

chmod +x /etc/init.d/resin
chkconfig --add resin
chkconfig resin on

You can configure your differents website in the resin.conf

-bash-3.2# nano /opt/railo/conf/resin.conf

<host id="www.mysite-two.com">
<host-alias>mysite-two.com</host-alias>
<root-directory>/path/to/web/files</root-directory>
<web-app id="/">
<document-directory></document-directory>
 </web-app>
</host>

you will find the server admin of railo here

http://you.ip/railo-context/admin.cfm

and the webserver admin for each domain you add in your resin.conf here

http://host/railo-context/admin.cfm

Cleanup

You can now delete the 2 files you download the jdk-6u13-linux-i586.bin and the railo-3.1.0.012-resin-3.1.2-without-jre.tar.gz

also in the directory /opt/railo you can delete that

-bash-3.2# rm -rf httpd.exe install-service.bat remove-service.bat setup.exe win32