24.9. Microsoft ISAPI Connector

Internet 服务器 API(ISAPI)是一组 API,用于为 Web 服务器(如 Microsoft 的 Internet Information Services(IIS))编写 OLE 服务器扩展和过滤器。isapi_redirect.dllmod_jk 的扩展,调整为 IIS。isapi_redirect.dll 允许您将 JBoss EAP 实例配置为将 IIS 用作负载平衡器的 worker 节点。

注意

如需有关 Windows Server 和 IIS 支持的配置的信息,请参阅 JBoss EAP 支持的配置。

24.9.1. 将 Microsoft IIS 配置为使用 ISAPI 连接器

从红帽客户门户网站下载 ISAPI 连接器:

  1. 打开浏览器并登录红帽客户门户 JBoss 软件下载页面
  2. Product 下拉菜单中选择 Web Connectors
  3. Version 下拉菜单中选择最新的 JBoss Core Services 版本。
  4. 在列表中找到 Red Hat JBoss Core Services ISAPI Connector,然后单击 Download 链接。
  5. 提取存档,并将 sbin 目录的内容复制到服务器的一个位置。以下说明假定内容已复制到 C:\connectors\

使用 IIS Manager(IIS 7)配置 IIS 重定向器:

  1. StartRun 并输入 inetmgr 来打开 IIS 管理器。
  2. 在左侧的树视图窗格中,展开 IIS 7
  3. 双击 ISAPI 和 CGI 注册以在新窗口中将其打开
  4. Actions 窗格中,单击 Add。此时将打开 Add ISAPI 或 CGI Restriction 窗口。
  5. 指定以下值:

    • ISAPI 或 CGI 路径C:\connectors\isapi_redirect.dll
    • 描述jboss
    • 允许执行扩展路径 :选中复选框。
  6. 单击确定以关闭 添加 ISAPI 或 CGI Restriction 窗口。
  7. 定义 JBoss 原生虚拟目录

    • 右键单击 Default Web Site,再单击 Add Virtual Directory。此时将打开 Add Virtual Directory 窗口。
    • 指定以下值来添加虚拟目录:

      • 别名jboss
      • 物理路径C:\connectors\
    • 单击 OK 以保存这些值并关闭 Add Virtual Directory 窗口。
  8. 定义 JBoss 原生 ISAPI 重定向过滤器

    • 在树视图窗格中,展开 SitesDefault Web Site
    • 双击 ISAPI 过滤器此时会显示 ISAPI 过滤器功能视图
    • Actions 窗格中,单击 Add。此时将显示 Add ISAPI Filter 窗口。
    • Add ISAPI Filter 窗口中指定以下值:

      • 过滤器名称jboss
      • 可执行C:\connectors\isapi_redirect.dll
    • 单击 OK 以保存这些值并关闭 Add ISAPI Filters 窗口。
  9. 启用 ISAPI-dll 处理程序

    • 双击树视图窗格中的 IIS 7 项目。IIS 7 Home Features View 将打开。
    • 双击 Handler 映射。Handler 映射功能视图显示
    • Group by combo 框中,选择 StateHandler Mappings 显示在 Enabled 和 Disabled Groups 中。
    • 查找 ISAPI-dll.如果它位于 Disabled 组中,请右键单击它,然后选择 Edit Feature Permissions
    • 启用以下权限:

      • 脚本
      • 执行
    • 单击 OK 以保存这些值,然后关闭 Edit Feature Permissions 窗口。

Microsoft IIS 现已配置为使用 ISAPI 连接器。