第十二章 配置 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 静态文件，如下所示：
-
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 的模块）无法访问系统管理表单。
- HyperEvents组件
CSPBroker.jsCSPxmlhttp.js
这些文件的默认位置是 install-dir\csp\broker
-
CSP示例使用的各种静态资源
CSP 示例需要许多静态 Web 资源（例如图像文件）。这些文件的默认位置是 install-dir\csp\samples
- 管理门户使用的各种静态资源
管理门户需要大量静态 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
-
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>
- 更改
httpd.conf后重新启动Apache。 - 如果需要，请参阅配置
Apache以传递其他文件类型。
现在可以使用 Web Gateway 管理页面来进一步配置 Web Gateway。
