13.6.2. Configure Microsoft IIS to Use the ISAPI Redirector

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

1. Open the IIS manager by clicking Start → Run , 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 Sites → Default 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 Start → Run , 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.