Installation guide
C:\> net stop iisadmin /Y
C:\> net start w3svc
IIS 7
C:\> net stop was /Y
C:\> net start w3svc
6. Verify the Logs
Ensure you check the ISAPI logs once IIS has restarted. T he logs are saved to the file location
specified in the log_file property in isapi_redirect.properties. You should also check IIS logs
and the Event Viewer for other events of type Warning or Error.
14.6. Configure a load-balancing cluster with ISAPI
Task: Configure ISAPI to serve a Load- Balancing Clust er
Complete this task to configure ISAPI to manage applications common to all servers, route requests to
JBoss Enterprise Application Platform instances, and redirect requests to live nodes when some nodes
are not online or experiencing connectivity issues.
Use the configuration as an example when configuring your ISAPI cluster.
Prerequisit es
Complete the relevant Microsoft IIS clustering setup procedure. Refer to Section 14.3, “Microsoft IIS 6
initial clustering configuration” or Section 14.4, “Microsoft IIS 7 initial clustering configuration” for more
information.
The following steps assume that the C:\connectors directory is used to store logs, properties files,
and NSAPI locks.
1. Creat e isapi_redirect .propert ies file
Create a new file named isapi_redirect.properties in the NATIVE\sbin\ directory.
Important
The isapi_redirect.properties file must be in the same directory as the
isapi_redirect.dll file.
Append the following configuration block to the file:
# 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
#OPTIONAL: 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/
56 Chapter 14. Configuring the ISAPI connector on Windows