From bemoko developer wiki

Configuring Tomcat and IIS 7 using ISAPI Filters

Prerequisites

These instructions assume that you have already installed and deployed bemokoLive onto Tomcat

IIS Configuration

1. Install IIS7
   • Make sure IIS is installed with ISAPI Entensions and ISAPI Filters enabled
2. Download isapi-redirect.dll from the tomcat-connectors project
   • Distributions are available from http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/ choose the version to match the Windows platform
   • The dlls are named after the current latest stable version, for example isapi_redirect-1.2.27.dll
   • Save this dll to a new directory called $TOMCAT_HOME/isapi

3. Create the filter properties file
   • Create a .properties file within $TOMCAT_HOME/isapi with the same name as the downloaded .dll file, for example isapi_redirect-1.2.27.properties

   # Configuration file for the Jakarta ISAPI Redirector
    
   # The path to the ISAPI Redirector Extension, relative to the website
   # This must be in a virtual directory with execute privileges
   extension_uri=/tomcat/isapi_redirect.dll
    
   # Full path to the log file for the ISAPI Redirector
   log_file=C:\development\apache-tomcat-6.0.16\logs\isapi_redirect.log
    
   # Log level (debug, info, warn, error or trace)
   log_level=info
    
   # Full path to the workers.properties file
   worker_file=C:\development\apache-tomcat-6.0.16\conf\workers.properties
    
   # Full path to the uriworkermap.properties file
   worker_mount_file=C:\development\apache-tomcat-6.0.16\conf\uriworkermap.properties

4. Create workers.properties

   • This file configures the properties of the tomcat server instance. This is where clusters are configured if appropriate.
   • Create the file $TOMCAT_HOME/conf/workers.properties with the following content, changed to match your environment:

   # An entry that lists all the workers defined
   worker.list=worker1
   # Entries that define the host and port associated with these workers
   worker.worker1.host=localhost
   worker.worker1.port=8009
   worker.worker1.type=ajp13

5. Create uriworkermap.properties

   • This file configures the URL patterns to forward to specific tomcat worker processing named above
   • Create the file $TOMCAT_HOME/conf/uriworkermap.properties with the following content

   /live/*=worker1

IIS Administration

7. ISAPI and CGI Restictions

   • Select ISAPI and CGI Restirctions from the main server configuration

   

   • Add a new restriction with the followig properties

   ISAPI or CGI path = C:\development\apache-tomcat-6.0.16\isapi\isapi_redirect-1.2.27.dll 
     (use the value for your system)
   Description = Tomcat
   Select "Allow extension path to execute"

8. Create a new virtual directory

   • Right click on the "Default Web Site", or the Site you are using.
   • Select "Add Virtual Directory..." and create a new virtual directory with the following properties:

   Alias = tomcat
   Physical path = C:\development\apache-tomcat-6.0.16\isapi 
     (use the value for your system)

9. Tell IIS about isapi-redirect.dll

   • Within the Default Web Site (or alternative - see point 7) click ISAPI Filters

   

   • Add a new filter with the following values:

   Filter name = tomcat
   Executable = C:\development\apache-tomcat-6.0.16\isapi\isapi_redirect-1.2.27.dll 
     (use the value for your system)

10. Enable the ISAPI-dll handler

    • Within the Default Web Site (or alternative - see point 7) click Handler Mappings

    

    • If ISAPI-dll is in the disabled group:

    • Right click on ISAPI-dll and select Edit Feature Permissions
    • Make sure Read, Script and Execute are all checked

11. Restart IIS service and test

    • Test a bemokoLive url, for example http://localhost/live/bemoko/i

Further Reading

1. bemokoLive Minimum Hardware Requirements