The Apache Tomcat Connector - Reference Guide
Configuring IIS
Requirements |
|
Registry settings |
|
Key Name | Description |
---|---|
extension_uri | A string value pointing to the ISAPI extension /jakarta/isapi_redirect.dll |
log_file | A value pointing to location where log file will be created. (for example c:/tomcat/logs/isapi.log) |
log_level | A string value for log level (can be debug, info, warn, error or trace). |
worker_file | A string value which is the full path to workers.properties file (for example c:/tomcat/conf/workers.properties) |
worker_mount_file | A string value which is the full path to uriworkermap.properties file (for example c:/tomcat/conf/uriworkermap.properties) |
rewrite_rule_file | A string value which is the full path to rewrite.properties file (for example c:/tomcat/conf/rewrite.properties) |
shm_size | A DWORD value size of the shared memory. Set this value to be the number of all defined workers * 400. (Set this value only if you have more then 64 workers) This directive has been added in version 1.2.20 Starting with version 1.2.27 the size of the shared memory is determined automatically, even for large numbers of workers. This attribute is not needed any longer. |
worker_mount_reload | A DWORD value specifying the time in seconds upon which the worker_mount_file will be reloaded. This directive has been added in version 1.2.20 |
strip_session | A string value representing a boolean. If it is set to true, URL session suffixes of the form ";jsessionid=..." get stripped of URLs, even if the are served locally by the web server. A true value can be represented by the string "1" or any string starting with the letters "T" or "t". A false value will be assumed for "0" or any string starting with "F" or "f". The default value is false. This directive has been added in version 1.2.21 |
auth_complete | A DWORD value representing "0" or "1". This is needed because of minor incompatibilities with IIS 5.1. By default its value is 1, which means we use the SF_NOTIFY_AUTH_COMPLETE event. If you set this to 0, then we use SF_NOTIFY_PREPROC_HEADERS. This might be needed for IIS 5.1 when handling requests using the PUT HTTP method. This directive has been added in version 1.2.21 |
uri_select | A string value which influences, how URIs are decoded and re-encoded between IIS and Tomcat. You should leave this at it's default value, unless you have a very good reason to change it. If the value is "parsed", the forwarded URI will be decoded and explicit path components like ".." will already be resolved. This is less spec compliant and is not safe if you are using prefix forwarding rules. If the value is "unparsed", the forwarded URI will be the original request URI. It's spec compliant and also the safest option. Rewriting the URI and then forwarding the rewritten URI will not work. If the value is "escaped", the forwarded URI will be the re-encoded form of the URI used by "parsed". Explicit path components like ".." will already be resolved. This will not work in combination with URL encoded session IDs. If the value is "proxy", the forwarded URI will be a partially re-encoded form of the URI used by "parsed". Explicit path components like ".." will already be resolved. and problematic are re-encoded. The default value since version 1.2.24 is "proxy". Before it was "parsed". |
reject_unsafe | A string value representing a boolean. If it is set to true, URLs containing percent signs '%' or backslashes '/' after decoding will be rejected. Most web apps do not use such URLs. By enabling "reject_unsafe" you can block several well known URL encoding attacks. A true value can be represented by the string "1" or any string starting with the letters "T" or "t". A false value will be assumed for "0" or any string starting with "F" or "f". The default value is false. This directive has been added in version 1.2.24 |
watchdog_interval | A DWORD value representing the watchdog thread interval in seconds. The workers are maintained periodically by a background thread running periodically every watchdog_interval seconds. Worker maintenance checks for idle connections, corrects load status and is able to detect backend health status. The maintenance only happens, if since the last maintenance at least worker.maintain seconds have passed. So setting the watchdog_interval much smaller than worker.maintain is not useful. The default value is 0 seconds, meaning the watchdog thread will not be created, and the maintenance is done in combination with normal requests instead. This directive has been added in version 1.2.27 |
error_page | A string value representing the error page url redirection when backend returns non-200 response. This directive can be used to customise the error messages returned from backend server. The url must point to a valid server url and can contain format string number (%d) that can be used to separate the pages by error number. The redirect url in that case is formatted by replacing %d from error_page to returned error number. This directive has been added in version 1.2.27 |
enable_chunked_encoding | A string value representing a boolean. If it is set to true, chunked encoding is supported by the server. A true value can be represented by the string "1" or any string starting with the letters "T" or "t". A false value will be assumed for "0" or any string starting with "F" or "f". The default value is false. This option is considered experimental and its support must be compile time enabled. Use isapi_redirect.dll with chunked support enabled. This directive has been added in version 1.2.27 |
Using a properties file for configuration |
|
Using a simple rewrite rules |
|
参见 http://tomcat.apache.org/connectors-doc/reference/iis.html
完整说明见 http://tomcat.apache.org/connectors-doc/
isapi_redirect.dll
下载地址 http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/win32/jk-1.2.28/