Installation guide
# Configuration file for the ISAPI Redirector
# Extension uri definition
extension_uri=/jboss/isapi_redirect.dll
# Full path to the log file for the ISAPI Redirector
log_file=c:\connectors\isapi_redirect.log
# Log level (debug, info, warn, error or trace)
# Use debug only testing phase, for production switch to info
log_level=debug
# Full path to the workers.properties file
worker_file=c:\connectors\workers.properties
# Full path to the uriworkermap.properties file
worker_mount_file=c:\connectors\uriworkermap.properties
#Full path to the rewrite.properties file
rewrite_rule_file=c:\connectors\rewrite.properties
2. Opt ional: Create rewrit e.propertie s file
The rewrite.properties file allows you to specify simple URL rewrites specific to an
application. This configuration file is optional, and can be excluded from the
isapi_redirect.properties file if URL rewrites are not required.
The functionality offered is similar to Apache mod_rewrite, but is less powerful. You specify the
rewrite path using name-value pairs. A simple example is where the app_01 application has an
abstract directory name, containing images, and you want to remap that directory to something
more intuitive.
#Simple example, images are accessible under abc path
/app-01/abc/=/app-01/images/
3. Creat e uriworkermap.propertie s file
The uriworkermap.properties file contains deployed application mapping configuration
information. Append the following lines to the file.
# images and css files for path /status are provided by worker01
/status=worker01
/images/*=worker01
/css/*=worker01
# Path /web-console is provided by worker02
# IIS (customized) error page is used for http errors with number greater
or equal to 400
# css files are provided by worker01
/web-console/*=worker02;use_server_errors=400
/web-console/css/*=worker01
# Example of exclusion from mapping, logo.gif will not be displayed
# !/web-console/images/logo.gif=*
# Requests to /app-01 or /app-01/something will be routed to worker01
/app-01|/*=worker01
# Requests to /app-02 or /app-02/something will be routed to worker02
/app-02|/*=worker02
4. Creat e worke rs.propertie s file
The worker.properties file contains mapping definitions between worker labels and server
instances. Append the following lines to the file.
# An entry that lists all the workers defined
worker.list=worker01, worker02
# Entries that define the host and port associated with these workers
# First EAP server definition, port 8009 is standard port for AJP in EAP
worker.worker01.host=127.0.0.1
worker.worker01.port=8009
worker.worker01.type=ajp13
# Second EAP server definition
worker.worker02.host= 127.0.0.100
worker.worker02.port=8009
worker.worker02.type=ajp13
5. Re start IIS
Restart your IIS server to implement the changes. Execute the following commands for the IIS
version you are running:
IIS 6
JBoss Enterprise Application Platform 5 HTTP Connectors Load Balancing Guide 55