Configuring IIS6 with Railo

Many times we have installed Railo on IIS. Here's a guideline on how to install Railo on Win2K3 with IIS6. You can also watch the video on how to install Railo and IIS6.

The Video is found at the bottom of this page. It has been converted with the new tag <cfvideo> and is displayed with the new tag <cfvideoplayer>.

1. Download Railo and execute the setup executable file
   
   
2. Check if Railo runs correctly by calling http://localhost:8600/index.cfm you should see the following:
   
   
   
3. If Railo runs correctly IIS has to be configured. Go to Step 4.
   If Railo does not start, or you don't see the above screen, please try the following:
   
   • Check whether the service Railo 2.0 runs
   • If the service runs, please check whether the firewall is blocking the server to run
   • If the service does not run, please execute the following command in the {railo installation directory}
     
     C:\Program Files\Railo>httpd.exe -Xms512M -Xmx512M -conf conf/resin.conf -java_home jre -java_exe jre\bin\java
     
     Then the reason for Railo failing to start should be displayed
   • If Railo still does not run function properly, it is time to write an email to railo railo_talk@yahoogroups.com
   
   
   
4. IIS and Resin need to mirror their configuration. So every host entry in the IIS (website) needs to reflect in the resin.conf found in the directory C:\Program Files\Railo\conf You might need to enter following lines inside the tag of the file:
   
   <host id="myweb.com"> <root-directory>d:/webroots/myweb.com</root-directory> <web-app id="/" document-directory="d:/webroots/myweb.com"/> </host>
   
   
   or to make it much more comfortable:
   
   <host regexp="(.+)">
   <host-name>${host.regexp[1]}</host-name>
   <root-directory>d:/webroots/${host.regexp[1]}</root-directory>
   <web-app id="/" document-directory="d:/webroots/${host.regexp[1]}"/>
   </host>
   
   
   In the second case resin determines with the help of a regular expression where to locate a certain webroot. So you only need to create a directory named d:\webroots\hostname and the setting is valid without having to restart the application server service. But I wouldn't recommend this kind of definition, because it can grant access to webroots without manually allowing it.
   
   
5. Set up a new website according to your needs by using the according wizard.
   
   
6. If not already existent, create a folder named scripts inside a common directory (eg. D:\webroots\).
   
   
7. Copy the file C:\Program Files\Railo\Wind32\isapi_srun.dll into the created directory
   
   
8. Inside the IIS management console navigate to the Web Service Extensions
   
   
   
9. Click on Add new Web service extension
   
   
   
10. Add the dll as a named extension and set it's status to Allowed
    Now your dll is a allowed extension you can use within the web site.
    
    
11. If you want to use Railo globally with every website you create, right click on websites and follow the instructions below.
    • Click on "Web Sites" Properties
      
    • Click on Home Directory/Configuration
      
    • Add two Application Extension Mappings for .cfm and .cfc pointing to D:\webroots\scripts\isapi_srun.dll Please uncheck the Verify that file exists checkbox.
      
    
    
12. If you only want a certain webhost to act on .cfm and .cfc files with Railo, you need to execute the above actions for the respective Website.
    
    
13. Save the configuration of the IIS to disk, by selection All tasks/Save Configuration to disk in the context menu of the IIS server
    
    
14. restart the IIS service All tasks/Restart IIS... Now the website should run with Railo.
    
    
15. If you experience any issues with Railo, please follow the instructions on the following documentation page: http://www.caucho.com/resin-3.1/doc/install-iis.xtp