Installation guide

Chapter 14. Configuring the ISAPI connector on Windows

Read this chapter to learn how to configure the ISAPI connector to use JBoss Enterprise Application

Platform as a worker node for a Windows Server 2003 or 2008 master node.

14.1. Prerequisites and configuration assumptions

Complete the following prerequisites before continuing with the tasks that follow:

On the master node install one of the following technology combinations, and the appropriate Native

binary for its operating system and architecture.

Windows Server 2003 (32-bit) with Microsoft IIS 6

Windows Server 2003 (64-bit) with Microsoft IIS 6

Windows Server 2008 (32-bit) with Microsoft IIS 7.0

Windows Server 2008 (64-bit) with Microsoft IIS 7.0

On the worker nodes install JBoss Enterprise Application Platform 5.1 or later. T he Native

components are optional for worker nodes.

Refer to the Installation Guide for assistance with these installation prerequisites.

14.2. Configure server instance as a worker node

Task: Configure Server Inst ance as a Worker Node

Complete this task to correctly configure your JBoss Enterprise Application Platform instance as a

worker node for use with Microsoft Internet Information Services (IIS).

Prerequisit es

Section 14.1, “Prerequisites and configuration assumptions”

1. Creat e a se rve r profile for each worker node

Make a copy of the server profile you want to configure as a worker node, and rename it -

worker-01 for example.

2. Give each inst a nce a unique na me

Edit the following line in the PROFILE\deploy\jbossweb.sar\server.xml file of each new

worker instance:

Add a unique jvmRoute value, as shown. This value is the identifier for this node in the cluster.

3. Enable session handling

Uncomment the following line in the PROFILE\deployers\jbossweb.deployer\META-INF\war-

deployers-jboss-beans.xml file of each worker node:

<property name="useJK">false</property>

This property controls whether special session handling is used to coordinate with mod_jk and

other connector variants. Set this property to true in both worker nodes:

4. Start worker nodes

Start each worker node in a separate command line interface. Ensure that each node is bound to

a different IP address with the --host switch and that the profile is specified with the -c switch.

JBOSS_EAP_DIST\bin\run.bat --host=127.0.0.1 -c worker-01

14.3. Microsoft IIS 6 initial clustering configuration

Microsoft IIS 6 contains basic ISAPI filters and ISAPI mapping as part of the default installation. Here we

create a filter to direct web requests to JBoss Enterprise Application Platform.

Task: Define ISAPI Filt er

Complete this task to define the ISAPI Filter on the Master server using the management console.

1. On the master server, open IIS Manager:

JBoss Enterprise Application Platform 5 HTTP Connectors Load Balancing Guide 51