Tomcat/JBoss IIS Jakarta connector1. 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 |
IIS >