Installing Railo ColdFusion under IIS on Windows

By Kevan Stannard | Published: November 5, 2006

Railo is an alternative ColdFusion application server. The developers have been very generous to release a free Community edition for small business use.

I decided to use a more manual installation rather than use the bundled versions provided by Railo so I could better understand what was going where.

Note that I am only describing setting up a server to host a single website, which will be the default website within IIS.

1. Download the components

To get started you will need the current versions of the following software:

Sun’s JDK

http://java.sun.com/javase/downloads/index.jsp

I used JDK 5.0 Update 6

Resin Application Server

http://www.caucho.com/download/index.xtp

I used the Open Source version 3.0.21

resin-3.0.21.zip (6.3M)

Railo

http://www.railo.ch/en/index.cfm?treeID=224

In this case I download the Railo Custom version 1.0.0.027 JARs only

railo-1.0.0.027-jars.zip (16 MB)

2. Install the JDK

I installed Sun’s JDK 1.5 in the directory

c\:jdk1.5.0_06

Set the JAVA_HOME environment variable to point to this location
(My Computer -> Properties -> Advanced -> Environment Variables)

JAVA_HOME=c:\jdk1.5.0_06

3. Install Resin

I unzipped Resin to the following directory

c:\resin-3.0.21

Set up a RESIN_HOME environment variable to point to this location

RESIN_HOME=c:\resin-3.0.21

4. Test Resin

Open a DOS prompt and change to the Resin install directory and start the server by typing

httpd

This will open a control window that allows you to start and stop the server as required, as well as displaying some start up information in the DOS window:

C:\resin-3.0.21>httpd Resin-3.0.21 (built Thu, 10 Aug 2006 12:03:19 PDT) Copyright(c) 1998-2006 Caucho Technology. All rights reserved. Using Resin(R) Open Source under the GNU Public License (GPL). See http://www.caucho.com for information on Resin Professional, including caching, clustering, JNI acceleration, and OpenSSL integration. Starting Resin on Mon, 06 Nov 2006 10:49:04 +1100 (EST) [10:49:05.437] Server[] starting [10:49:05.437] [10:49:05.437] Windows XP 5.1 x86 [10:49:05.437] Java 1.5.0_06-b05, 32, mixed mode, sharing, Cp1252, en, Sun Microsystems Inc. [10:49:05.437] resin.home = C:\resin-3.0.21 [10:49:05.437] server.root = C:\resin-3.0.21 [10:49:05.437] [10:49:05.515] Host[] starting [10:49:05.656] WebApp[http://localhost:8080] starting [10:49:06.125] WebApp[http://localhost:8080/resin-doc] starting [10:49:06.218] WebApp[http://localhost:8080/resin-admin] starting [10:49:06.281] http listening to *:8080 [10:49:06.328] hmux listening to localhost:6802 [10:49:06.328] Resin started in 1000ms

Test Resin is working by opening a web browser and go to:


http://localhost:8080

This should display the Resin default home page.

The file being displayed in located at the Resin web apps root directory:

c:\resin-3.0.21webapps\ROOT\index.jsp

Next go to


http://localhost:8080/resin-doc

(or click on the Documentation is available here link from the default home page).

This should display the Resin documentation

5. Configuring Resin with IIS

First stop Resin using the Resin control window (you don’t need to Quit the application).

In the Resin /win32 directory is the isapi_srun.dll file.

Copy this file to c:\inetpub\wwwroot\scripts (create the target ‘scripts’ directory if it does not already exist).

Go into IIS and create a virtual directory named ‘scripts’ off the default website that points to this directory.

Ensure the Execute access permission is selected.

Next, go to the properties of your default website within IIS and select the ISAPI Filters tab.

Click ‘Add …’ to add a new filter with the following details:

Filter Name: Resin

Executable: c:\inetpub\wwwroot\scripts\isapi_srun.dll

Next, restart IIS. You can use the following DOS commands:

net stop w3svc net start w3svc

or restart the World Wide Web Publishing service from the Services panel.

Now restart the httpd service from the DOS prompt.

Also, stop and start the default website from within IIS.

Go back into your default website properties again and back to the ISAPI Filters tab. The Resin filter should have a green arrow pointing up beside it. If it is a red arrow pointing down then is it not working. Have a look at the ‘more help’ links at the bottom of this page.

6. Test Resin is working via IIS

Change your IIS default website to point to

c:\resin-3.0.21\webapps\ROOT

This will be the location for your Resin served web application

Create a test.jsp file in this directory containing the line:

2 + 2 = <%= 2 + 2 %>

Now, browse to


http://localhost/test.jsp

This should display the result

2 + 2 = 4

7. Installing Railo

Stop the httpd service

Unzip the railo-1.0.0.027-jars.zip file and copy all of the files in the Resin /lib directory

Next, modify Resin’s /conf/app-default.xml and add the following just before the </web-app-default> tag

<servlet
	servlet-name="CFMLServlet" 
	servlet-class="railo.runtime.servlet.MultiWebCFMLServlet"> 
	<init-param> 
		<param-name>configuration</param-name> 
		<param-value>/WEB-INF/railo/</param-value> 
		<description>Configuraton directory</description> 
	</init-param> 
	<load-on-startup>1</load-on-startup> 
</servlet> 
<servlet-mapping> 
	<servlet-name>CFMLServlet</servlet-name> 
	<url-pattern>*.cfm</url-pattern> 
</servlet-mapping> 
<servlet-mapping> 
	<servlet-name>CFMLServlet</servlet-name> 
	<url-pattern>*.cfml</url-pattern> 
</servlet-mapping> 
<servlet-mapping> 
	<servlet-name>CFMLServlet</servlet-name> 
	<url-pattern>*.cfc</url-pattern> 
</servlet-mapping>

Next, add two additional entries to the <welcome-file-list> section:

<welcome-file>index.cfm</welcome-file>
<welcome-file>index.cfml</welcome-file>

Start the httpd service.

8. Testing Railo

Create a file

c:\resin-3.0.21\webapps\ROOT\test.cfm

Add the following line to the file

<cfoutput>#now()#</cfoutput>

Browse to http://localhost/test.cfm

This should display the current date and time plus some standard Railo debugging messages.

9. Starting Resin as an NT Service

Stop the httpd service and quit the application.

Go to the Resin directory in DOS and enter

httpd -install

Then start the service with

net start resin

From this point onwards you should not need to execute the httpd application any longer.

More Help

For more information you can look at the following sites

Resin with IIS Documentation
http://www.caucho.com/resin-3.0/install/cse-iis.xtp

Installing Railo with Resin
http://www.railo.ch/en/index.cfm?treeID=215

Good luck!

This entry was posted in Railo and tagged IIS, Railo. Bookmark the permalink. Both comments and trackbacks are currently closed.

Installing Railo ColdFusion under IIS on Windows

17 Comments

Search

Pages

Categories

Archives

RSS Links

Installing Railo ColdFusion under IIS on Windows

17 Comments

Search

Pages

Categories

Tags

Archives

RSS Links