13.6.2. Configure Microsoft IIS to Use the ISAPI Redirector
Prerequisites
- ISAPI runs on Microsoft Windows Server 2003 and newer. Make sure you are using a supported operating system and install the IIS server.
- Download the JBoss Native Components package for Microsoft Windows, from the Customer Support Portal at https://access.redhat.com. Navigate to Downloads, then JBoss Middleware, then Application Platform. Choose either
i386
orx86_64
. Unzip the file, which includes the ISAPI redirect DLL in thesbin/
directory.Extract the Native Components zip file and copy the contents of thesbin/
directory to a location on your server. The rest of this task assumes that you usedC:\Connectors\
.
Procedure 13.11. Configure the IIS Redirector Using the IIS Manager (IIS 7)
- Open the IIS manager by clicking Start → Run , and typing
inetmgr
. - In the tree view pane at the left, expand IIS 7.
- Double-click ISAPI and CGI Registrations to open it in a new window.
- In the Actions pane, click Add. The Add ISAPI or CGI Restriction window opens.
- Specify the following values:
- ISAPI or CGI Path:
c:\connectors\isapi_redirect.dll
- Description:
jboss
- Allow extension path to execute: select the check box.
- Click OK to close the Add ISAPI or CGI Restriction window.
Define a JBoss Native virtual directory
- Right-click Default Web Site, and click Add Virtual Directory. The Add Virtual Directory window opens.
- Specify the following values to add a virtual directory:
- Alias:
jboss
- Physical Path:
C:\connectors\
- Click OK to save the values and close the Add Virtual Directory window.
Define a JBoss Native ISAPI Redirect Filter
- In the tree view pane, expand Sites → Default Web Site.
- Double-click ISAPI Filters. The ISAPI Filters Features view appears.
- In the Actions pane, click Add. The Add ISAPI Filter window appears.
- Specify the following values in the Add ISAPI Filter window:
- Filter name:
jboss
- Executable:
C:\connectors\isapi_redirect.dll
- Click OK to save the values and close the Add ISAPI Filters window.
Enable the ISAPI-dll handler
- Double-click the IIS 7 item in the tree view pane. The IIS 7 Home Features View opens.
- Double-click Handler Mappings. The Handler Mappings Features View appears.
- In the Group by combo box, select State. The Handler Mappings are displayed in Enabled and Disabled Groups.
- Find ISAPI-dll. If it is in the Disabled group, right-click it and select Edit Feature Permissions.
- Enable the following permissions:
- Read
- Script
- Execute
- Click OK to save the values, and close the Edit Feature Permissions window.
Procedure 13.12. Configure the IIS Redirector Using the IIS Manager (IIS 6)
- Open the IIS manager by clicking Start → Run , and typing
inetmgr
. - In the tree view at the left, expand Websites and right-click the website you wish to configure. The rest of this task assumes you are configuring the
Default
website. Click Properties. - Click the ISAPI Filters tab.
- Click the Add button. Name your filter
jboss
, and specifyC:\connectors\isapi_redirect.dll
as the executable. - Click OK, and close all dialogs. Leave the IIS Manager open.
Define the ISAPI virtual directory.
- Right-click the Default website again. Select NewAdd Virtual Directory.
- Specify
jboss
as the alias, andC:\connectors\jboss-ep-6.0\native\sbin\
as the physical path. - Click OK to save the values and close the Add Virtual Directory window.
- In the tree view, expand Web Sites/Default Web Site.
- Right-click the
jboss
virtual directory, and click Properties. - Click the Virtual Directory tab, and make the following changes.
Execute permission
- Scripts and Executables
Read Access
- Activate Read Access by checking the box.
- Click OK to save the changes and close the JBoss Properties window.
Define ISAPI web service extensions
- Click Web Service Extensions. In the Tasks group, select Add a new Web service extension. The New Web Service Extension window opens.
- Add the following values:
- Extension name:
jboss
- Required files:
C:\connectors\isapi_redirect.dll
- Extension Status:
allowed
- Click OK to save the changes and close the New Web Service Extension window.
- Confirm that the jboss Web Service Extension displays in the list.
Microsoft IIS is now configured to use the ISAPI Redirector. Next, Section 13.2.11, “Configure the JBoss Enterprise Application Platform to Accept Requests From an External HTTPD”, then Section 13.6.3, “Configure the ISAPI Redirector to Send Client Requests to the JBoss Enterprise Application Platform” or Section 13.6.4, “Configure ISAPI to Balance Client Requests Across Multiple JBoss Enterprise Application Platform Servers”.