文章目录
- [第十二章 配置 Apache 以与 Web 网关配合使用 (Windows)](#第十二章 配置 Apache 以与 Web 网关配合使用 (Windows))
- [`Apache` 服务器的安装位置(所有配置)](#
Apache服务器的安装位置(所有配置)) -
- [推荐选项:`Apache API` 模块 (`CSPa24.dll`)](#推荐选项:
Apache API模块 (CSPa24.dll))
- [推荐选项:`Apache API` 模块 (`CSPa24.dll`)](#推荐选项:
第十二章 配置 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.js -
CSPxmlhttp.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的末尾。
xml
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。