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 or x86_64. Unzip the file, which includes the ISAPI redirect DLL in the sbin/ directory.
    Extract the Native Components zip file and copy the contents of the sbin/ directory to a location on your server. The rest of this task assumes that you used C:\Connectors\.
Depending on your version of IIS, choose one of the following procedures:

Procedure 13.11. Configure the IIS Redirector Using the IIS Manager (IIS 7)

  1. Open the IIS manager by clicking StartRun , and typing inetmgr.
  2. In the tree view pane at the left, expand IIS 7.
  3. Double-click ISAPI and CGI Registrations to open it in a new window.
  4. In the Actions pane, click Add. The Add ISAPI or CGI Restriction window opens.
  5. Specify the following values:
    • ISAPI or CGI Path: c:\connectors\isapi_redirect.dll
    • Description: jboss
    • Allow extension path to execute: select the check box.
  6. Click OK to close the Add ISAPI or CGI Restriction window.
  7. Define a JBoss Native virtual directory

    1. Right-click Default Web Site, and click Add Virtual Directory. The Add Virtual Directory window opens.
    2. Specify the following values to add a virtual directory:
      • Alias: jboss
      • Physical Path: C:\connectors\
    3. Click OK to save the values and close the Add Virtual Directory window.
  8. Define a JBoss Native ISAPI Redirect Filter

    1. In the tree view pane, expand SitesDefault Web Site.
    2. Double-click ISAPI Filters. The ISAPI Filters Features view appears.
    3. In the Actions pane, click Add. The Add ISAPI Filter window appears.
    4. Specify the following values in the Add ISAPI Filter window:
      • Filter name: jboss
      • Executable: C:\connectors\isapi_redirect.dll
    5. Click OK to save the values and close the Add ISAPI Filters window.
  9. Enable the ISAPI-dll handler

    1. Double-click the IIS 7 item in the tree view pane. The IIS 7 Home Features View opens.
    2. Double-click Handler Mappings. The Handler Mappings Features View appears.
    3. In the Group by combo box, select State. The Handler Mappings are displayed in Enabled and Disabled Groups.
    4. Find ISAPI-dll. If it is in the Disabled group, right-click it and select Edit Feature Permissions.
    5. Enable the following permissions:
      • Read
      • Script
      • Execute
    6. 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)

  1. Open the IIS manager by clicking StartRun , and typing inetmgr.
  2. 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.
  3. Click the ISAPI Filters tab.
  4. Click the Add button. Name your filter jboss, and specify C:\connectors\isapi_redirect.dll as the executable.
  5. Click OK, and close all dialogs. Leave the IIS Manager open.
  6. Define the ISAPI virtual directory.

    1. Right-click the Default website again. Select NewAdd Virtual Directory.
    2. Specify jboss as the alias, and C:\connectors\jboss-ep-6.0\native\sbin\ as the physical path.
    3. Click OK to save the values and close the Add Virtual Directory window.
    4. In the tree view, expand Web Sites/Default Web Site.
    5. Right-click the jboss virtual directory, and click Properties.
    6. Click the Virtual Directory tab, and make the following changes.

      Execute permission

      • Scripts and Executables

      Read Access

      • Activate Read Access by checking the box.
    7. Click OK to save the changes and close the JBoss Properties window.
  7. Define ISAPI web service extensions

    1. Click Web Service Extensions. In the Tasks group, select Add a new Web service extension. The New Web Service Extension window opens.
    2. Add the following values:
      • Extension name: jboss
      • Required files: C:\connectors\isapi_redirect.dll
      • Extension Status: allowed
    3. Click OK to save the changes and close the New Web Service Extension window.
    4. Confirm that the jboss Web Service Extension displays in the list.