第八章 CSP 架构 - CSP 网关配置
第八章 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
应用程序,请执行以下操作:
-
通过在管理门户中导航到系统管理 > 配置 > CSP 网关管理来打开
CSP
网关管理器。 -
选择应用程序访问。
-
单击添加应用程序。
-
在应用程序路径字段中输入
/myapp
。 - 从列表中选择应用程序所在的默认服务器(这些在“定义服务器访问”部分中定义)。
- 单击提交以保存
/myapp
应用程序访问配置。
CSP 网关参数
CSP
网关有许多可以调整的参数。其中包括超时值、故障转移和负载平衡特性以及 CGI
环境变量。