第八章 CSP 架构 - CSP 网关配置

CSP 网关配置

CSP 网关是安装在 Web 服务器上并由其加载的 DLL 或共享库。 CSP 网关检测对扩展名为 .csp 或 .cls 的文件的任何请求，并将它们发送到定义的 Caché 服务器进行处理。

CSP 网关管理器

可以使用 CSP 网关管理器（CSP Web 网关管理页面）或直接编辑其配置文件 csp.ini 来配置 CSP 网关。

CSP 网关管理器是一个小型 Web 应用程序，可以在浏览器中使用它。您可以通过导航到系统管理 > 配置 > CSP 网关管理来访问 CSP 网关管理器。默认情况下，它会访问专用 Web 服务器的 CSP 网关管理器。

要访问生产 Web 服务器的 CSP 网关管理器，请根据需要通过替换 localhost 或 localhost:<port_no> 来更改 URL。

有关配置 CSP 网关的信息，请导航至系统管理 > 配置 > CSP 网关管理，然后单击帮助。有关更多详细信息，请参阅 CSP 网关配置指南。

注意：CSP Web 网关管理页面的本地化仅基于安装的 CSPres.xml 的内容（如果有）。如果不存在本地化文件，则 CSP Web Gateway 管理页面默认使用嵌入的英文文本。浏览器的语言设置对此机制没有影响。

定义服务器访问

注意：为防止运行时错误，对于通过 CS 运行的高可用性配置， 建议使用启用了粘性会话支持的硬件负载平衡器。

可以定义此 CSP 网关可以访问的服务器列表（可能运行 CSP 应用程序的 Caché 或 Ensemble 服务器）。每个服务器都有一个逻辑名称、一个 TCP/IP 地址、一个 TCP/IP 端口号（默认值为 1972）和一个启用或禁用标志。此外，可以配置与此服务器建立的最小和最大连接数以及超时和日志记录值。

由于每个服务器都有一个逻辑名称，因此 CSP 网关可以很容易地通过名称将应用程序连接到特定服务器，然后在一个地方更改服务器的特性，而无需重新配置使用服务器的每个应用程序。

初始安装后，CSP 网关定义了一个逻辑服务器 LOCAL，它被定义为连接到 Caché 的本地副本。

要添加希望 CSP 网关能够访问的一个或多个服务器，请按照上一节中的说明打开 CSP 网关管理器，然后单击服务器访问。

CSP.ini 文件中的默认 LOCAL 服务器示例：

LOCAL=Enabled
...
[LOCAL]
Ip_Address=127.0.0.1
TCP_Port=1972
Minimum_Server_Connections=3

定义应用程序访问

注意：Caché 安装会创建一个新的 /csp 配置。如果已将 /csp 配置为应用程序，那么当安装新版本的 Caché 时，配置将被覆盖。要维护应用程序配置，请输入 /csp 以外的路径。

/csp 下的任何目录都可以正常工作，例如 /csp/myapplication，但路径不能包含任何点（句点）。这些导致 CSP 网关不明确。在此示例中：/csp/samples/menu.csp/csp/aaa/bbb/ccc.cls，CSP 网关可以将其解释为对 /csp/samples/menu.csp/csp/aaa/bbb/ccc 的请求.cls 或作为 /csp/samples/menu.csp 的 REST 请求（其中 PATH_INFO 是 /csp/aaa/bbb/ccc.cls）。在 Web 服务器环境中工作的网关无法解决这些歧义。

CSP 区分大小写。在配置 CSP 时一致地指定路径名称。

CSP 应用程序是一组使用给定 URL 寻址的页面或类。例如，所有 CSP 示例页面都是 /csp/samples 应用程序的一部分。应用程序可能包含子目录，例如 /csp/samples/cinema。

CSP 网关管理器允许定义 CSP 应用程序用来连接到 Caché 服务器的 URL 路径。 CSP 将特定 URL 目录（或其子目录）中的所有文件视为同一应用程序的一部分。

默认情况下，CSP 网关定义单个应用程序路径 /csp，它将所有 CSP 请求发送到逻辑服务器 LOCAL。对 /csp/samples 和 /csp/user 的请求都发送到本地 Caché 安装。

如果使用以 /csp 开头的 URL 创建新的 CSP 应用程序，则不必更改 CSP 网关配置。新应用程序（例如 /csp/myapp）使用为 /csp 定义的 CSP 应用程序设置。如果不希望 URL 路径以 /csp 开头，那么需要在 CSP 网关中定义一个与 URL 路径相对应的新 CSP 应用程序。

例如，要定义以 URL 路径 /myapp 开头的 CSP 应用程序，请执行以下操作：

1. 通过在管理门户中导航到系统管理 > 配置 > CSP 网关管理来打开 CSP 网关管理器。

2. 选择应用程序访问。

3. 单击添加应用程序。

4. 在应用程序路径字段中输入/myapp。
5. 从列表中选择应用程序所在的默认服务器（这些在“定义服务器访问”部分中定义）。
6. 单击提交以保存 /myapp 应用程序访问配置。

CSP 网关参数

CSP 网关有许多可以调整的参数。其中包括超时值、故障转移和负载平衡特性以及 CGI 环境变量。