Tomcat/JBoss IIS Jakarta connector

1. Create necessary directories D:\isapi_redirect D:\isapi_redirect\conf D:\isapi_redirect\bin D:\isapi_redirect\log

2. Download/Install mod_jk 1.2.x from http://tomcat.apache.org/download-connectors.cgi and place the .dll file in D:\isapi_redirect\bin. Make sure you rename it to isapi_redirect.dll (get rid of the version in the name of the file).

3. In the registry, create a new registry key named "HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0"

4. Add a string value with the name extension_uri and a value of /jakarta/isapi_redirect.dll

5. Add a string value with the name log_file and a value pointing to where you want your log file to be (for example D:\isapi_redirect\log\isapi.log).

6. Add a string value with the name log_level and a value for your log level (can be debug, info, error or emerg).

7. Add a string value with the name worker_file and a value which is the full path to your workers.properties file (for example D:\isapi_redirect\conf\workers.properties)

8. Add a string value with the name worker_mount_file and a value which is the full path to your uriworkermap.properties file (for example D:\isapi_redirect\conf\uriworkermap.properties)

9. Using the IIS management console, add a new virtual directory to your IIS/PWS web site. The name of the virtual directory must be jakarta. Its physical path should be the directory where you placed isapi_redirect.dll (in our example it is D:\isapi_redirect\bin). While creating this new virtual directory assign it with execute access.

10. Using the IIS management console, add isapi_redirect.dll as a filter in your IIS/PWS web site. The name of the filter should reflect its task (I use the name tomcat), its executable must be our c:\isapi_redirect\bin\isapi_redirect.dll. For PWS, you'll need to use regedit and add/edit the "Filter DLLs" key under HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\W3SVC\Parameters. This key contains a "," separated list of dlls (full paths) - you need to insert the full path to isapi_redirect.dll.

11. If you're using IIS 6.0 you must also do the following:

Using the IIS management console, add the Jakarta Isapi Redirector to the Web Service Extensions.

a. Right-click on Web Service Extensions and choose Add a new Web Service Extension.

b. Enter tomcat for the Extension Name.

c. Add the isapi_redirect.dll to the required files.

d. Check the Set extension status to Allowed.

e. Click on OK.

f. Restart IIS (stop + start the IIS service), make sure that the tomcat filter is marked with a green up-pointing arrow. Under Win98 you may need to cd WINDOWS\SYSTEM\inetsrv and type PWS /stop ( the DLL and log files are locked - even if you click the stop button, PWS will still keep the DLLs in memory. ). Type pws to start it again.

12. Create workers.properties in D:\isapi_redirect\conf with the following

# Define list of workers that will be used
# for mapping requests
              
# Define Node1
worker.node1.port=8009
worker.node1.host=node1.mydomain.com
worker.node1.type=ajp13
worker.node1.lbfactor=1 
worker.node1.cachesize=10
#worker.node1.local_worker=1 (1)

# Define Node2
worker.node2.port=8009
worker.node2.host=node2.mydomain.com
worker.node2.type=ajp13
worker.node2.lbfactor=1 
worker.node2.cachesize=10
#worker.node2.local_worker=1 (1)

# Load-balancing behaviour
worker.loadbalancer.type=lb
worker.loadbalancer.balance_workers=node1, node2
worker.loadbalancer.sticky_session=0
worker.list=loadbalancer

# Status worker for managing load balancer
worker.status.type=status

13. Create D:\isapi_redirect\conf\uriworkermap.properties with the following content.

# Simple worker configuration file
#

# Mount the Servlet context to the ajp13 worker
/jmx-console=loadbalancer
/jmx-console/*=loadbalancer