第十二章 配置 Apache 以与 Web 网关配合使用 (Windows)

第十二章 配置 Apache 以与 Web 网关配合使用 (Windows)

本页介绍如何配置 Apache Web 服务器以与 Windows 上的 InterSystems Web Gateway 一起使用。 （在 Windows 上，其他选项是 IIS 和 Nginx；其他操作系统上的选项有所不同。）

如果通过 InterSystems IRIS® 安装程序安装了 Web Gateway，或者如果您想要配置 Apache 服务器以与 CSP 配合使用，请按照本页中的说明进行操作。

如果使用的是 Apache Web 服务器，请按照以下说明使用本机模块配置 Apache。本机模块是作为动态链接模块 (DLL) 实现的扩展。它们使能够利用 Internet 服务器应用程序编程接口 (ISAPI) 扩展。 ISAPI是为微软的Web服务器开发的高性能API。

Apache 由 Apache Group 提供，可以从以下网址免费下载：http://www.apache.org。

Apache 的完整源代码以及构建服务器的明确说明可以从 Apache 下载。要在 Windows 下构建 Apache，必须具有 Microsoft C 编译器 (Visual C++) 5.0 或更高版本。可以下载适用于 Windows 的预构建套件，而不是自行构建服务器。预构建的工具包通常是最新 Apache 源代码后面的一些构建。

首先按照 Apache 服务器的安装位置（所有配置）中的说明进行操作，然后按照推荐选项：Apache API 模块 (CSPa24.dll) 中的说明进行操作（或者，如果要安装非典型配置，请参阅 Windows Apache 的替代选项）。

Assumptions

此页面假设：

• Web Gateway 组件安装在 C:\Program Files\Apache Group\Apache\WebGateway 中
• Web 服务器安装在 C:\Program Files\Apache Group\Apache\

如果系统上的布局不同，请根据需要修改配置指令。

Apache 服务器的安装位置（所有配置）

Apache 服务器的所有用户都应遵循本节中的说明。安装 Web Gateway 组件和 CSP 静态文件，如下所示：

1. CGI和其他动态链接模块：

所有 Apache 版本的通用文件是：

• CSPcgi.exe (Runtime module)

• nph-CSPcgi.exe (Copy of CSPcgi.exe)

• CSPcgiSys.exe (Systems-Management module)

• nph-CSPcgiSys.exe (Copy of CSPcgiSys.exe)

Apache 版本 2.4.x 的单独二进制文件是：

• mod_csp24.dll（作为 DLL 的 Apache 内置模块，如果提供）
• CSPa24.dll（运行时模块，如果提供）
• CSPa24Sys.dll（网关系统管理模块，如果提供）

这些二进制文件的默认位置是 C:\Program Files\Apache Group\Apache\WebGateway\bin

原始位置 (install-dir\csp\bin) 用于保存为特定 InterSystems IRIS 实例的管理门户提供服务所需的 Web Gateway 组件。

非基于 NSD 的连接选项的配置和日志文件写入此目录。

附加Sys 的模块是用于访问Web Gateway 管理页面的特殊模块。运行时模块（即那些没有 Sys 的模块）无法访问系统管理表单。

1. HyperEvents组件

• CSPBroker.js

• CSPxmlhttp.js

这些文件的默认位置是 install-dir\csp\broker

1. CSP 示例使用的各种静态资源

CSP 示例需要许多静态 Web 资源（例如图像文件）。这些文件的默认位置是 install-dir\csp\samples

1. 管理门户使用的各种静态资源

管理门户需要大量静态 Web 资源（例如图像文件）。这些文件的默认位置是 install-dir\csp\sys

推荐选项：Apache API 模块 (CSPa24.dll)

这是为管理门户提供服务的专用 Web 服务器使用的选项。

此连接选项相对较新，提供最佳性能且最容易配置。 Windows 下的 Apache 完全是多线程的，其模块从 Apache 启动时起就一直保留在内存中。这两个基本特征使得将 Web Gateway 的功能作为一组独立模块来实现成为可能。

如果要安装非典型配置，请参阅 Apache 的替代选项 (Windows)。

模块 CSPap*.dll（运行时）和 CSPapSys*.dll（Web 网关系统管理）是动态链接模块，其设计方式与相应的 Microsoft ISAPI DLL 的工作方式相同。对于 Apache 2.4.x，这些模块被命名为：CSPa24.dll 和 CSPa24Sys.dll。

配置 Web 服务器，使其识别 InterSystems 文件类型并将它们传递到 Web 网关模块进行处理。

Web 服务器配置文件 (httpd.conf) 位于 C:\Program Files\Apache Group\Apache\conf

1. Apache 2.4.x：将以下部分添加到 httpd.conf 的末尾。

LoadModule csp_module_sa c:/iris/csp/bin/CSPa24.dll 
CSPFileTypes csp cls zen cxw 
Alias /csp/ c:/iris/csp/ 
<Directory "c:/iris/csp"> 
    AllowOverride None 
    Options MultiViews FollowSymLinks ExecCGI 
    Require all granted
    <FilesMatch "\.(log|ini|pid|exe)$"> 
    Require all denied 
    </FilesMatch>
</Directory> 

1. 更改 httpd.conf 后重新启动 Apache。
2. 如果需要，请参阅配置 Apache 以传递其他文件类型。

现在可以使用 Web Gateway 管理页面来进一步配置 Web Gateway。