第十二章 配置 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 FilesApache GroupApacheWebGatewa
y 中 -
Web
服务器安装在C:Program FilesApache GroupApache
如果系统上的布局不同,请根据需要修改配置指令。
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 FilesApache GroupApacheWebGatewayin
原始位置 (install-dircspin
) 用于保存为特定 InterSystems IRIS
实例的管理门户提供服务所需的 Web Gateway
组件。
非基于 NSD
的连接选项的配置和日志文件写入此目录。
附加Sys
的模块是用于访问Web Gateway
管理页面的特殊模块。运行时模块(即那些没有 Sys 的模块)无法访问系统管理表单。
- HyperEvents组件
-
CSPBroker.js
-
CSPxmlhttp.js
这些文件的默认位置是 install-dircsproker
-
CSP
示例使用的各种静态资源
CSP
示例需要许多静态 Web 资源(例如图像文件)。这些文件的默认位置是 install-dircspsamples
- 管理门户使用的各种静态资源
管理门户需要大量静态 Web
资源(例如图像文件)。这些文件的默认位置是 install-dircspsys
推荐选项: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 FilesApache GroupApacheconf
-
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
。