更新日期：2024年09月11日
当用户需要查看集群锁信息时，
可以通过点击集群监管进入某个集群界面，
然后点击集群锁链接，进入集群锁信息界面。如下图：
图3.3-40
集群锁信息
上图中的查询条件描述如下：
统一数据平台监控与运维系统用户手册
南大通用数据技术股份有限公司
- 137 -
服务器：gcluster 类型的服务器列表，为单选菜单，按升序排列。默
认为第一个地址。此下拉框禁止用户编辑。
内容：集群锁信息的内容，最大长度是30 字符，有效字符为：数字、
字母、下划线。
上图中的查询结果描述如下：
进入页面后，页面表格默认显示第一台服务器的锁信息，查询结果默
认按照创建时间升序排列。集群锁信息不分页。
点击查询按钮，系统将符合查询条件的锁信息展示到集群锁信息列表
中。
输入查询条件，点击查询按钮后，系统将符合查询条件的锁信息展示
到集群锁信息列表中，查询结果默认按照创建时间升序排列。点击表
格表头后，可以按当前列进行升序或降序排列。
要配置连接管理器，必须设置加密的密码文件、服务级别协议和故障转移参数，并配置
sqlhosts 文件。
先决条件：
仅限 UNIX： 只有用户 gbasedbt 才能运行 oncmsm 命令。如果为用户 root 或 DBSA
组的成员授予了连接到 sysadmin 数据库的特权，那么用户 root 或 DBSA 组的该成员也
可运行 oncmsm。
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 422 -
所有操作系统： 仅对于代理方式服务级别协议 (SLA)，设置操作系统允许的最大文件描
述符数（例如，在 UNIX™ 系统上通过使用 ulimit 进行设置）。
GBase 8s Client Software Development Kit (Client SDK) V3.50 或更高版本中随附了连接管
理器。配置和使用连接管理器之前，必须安装 Client SDK。 请参阅《GBase 8s 客户机产
品安装指南》。
要配置和启动连接管理器，请执行以下操作：
1.
创建密码文件并将其加密。
2.
设置 GBASEDBTDIR 环境变量。
3.
在要运行连接管理器的计算机上创建连接管理器配置文件。
配置文件定义了连接管理器实例名称、服务级别协议和连接管理选项。
4.
通过编辑 sqlhosts 文件（在 UNIX 上），为主服务器和所有 SLA 创建条目。
创建要由连接管理器使用的加密密码文件
如果连接单元中的任何服务器不属于安全网络环境，那么必须创建加密密码文件，以便连
接管理器可创建与集群中的每台服务器的安全连接。
要创建加密的密码文件，请执行以下操作：
1. 使用文本编辑器创建 ASCII 文本文件，其中包含集群内所有服务器的服务器名
称、用户名和密码。
对于高可用性集群和 Enterprise Replication 域，如果要通过在 sqlhosts 文件中设
置 s=6 选项来使用安全端口，并且客户机应用程序使用 DBSERVERALIASES 配
置参数来指定备用数据库服务器名称列表，那么必须在密码文件中为这些安全端
口定义备用服务器别名。
2. 要保护加密文件，请指定密钥。
密钥可包含任何顺序的字符或数字，但是不得包含空格。
重要： 要在以后解密密码文件，必须提供用于加密该文件的相同密钥。
3. 通过指定密钥名称和密码文件名称，使用 onpassword 实用程序加密密码文件：
onpassword -k key -e ./password_file
修改加密的密码文件
如果在连接单元中添加或除去了服务器，更改了密码或密钥，那么您可能希望修改加密的
密码文件。
要编辑加密的密码文件，请执行以下操作：
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 423 -
1. 通过指定密钥和密码文件名，使用 onpassword 实用程序对密码文件解密：
onpassword -k EncryptKey -d ./password_file
2. 如果必要，请使用文本编辑器编辑该文件，以便执行必需的更改。
如果必要，确定一个新密钥。该密钥可包含任何字符或数字序列，但是不能包含空格。为
了在以后解密密码文件，必须提供用于加密该文件的相同密钥。
3. 通过指定密钥和密码文件名，使用 onpassword 实用程序对密码文件加密：
onpassword -k EncryptKey -e ./password_file
为连接管理器配置环境
启动连接管理器之前，GBASEDBTDIR 环境变量必须指向连接管理器的安装目录。
如果使用的是 UNIX™ C shell (csh)，请使用 setenv 命令来设置该环境变量。对于其他
shell，请使用适合该 shell 的方法。
setenv GBASEDBTDIR path
要使用除 sqlhosts 以外的文件来指定连接管理器设置，请将 GBASEDBTSQLHOSTS 环
境变量设置为该文件的名称。
修改连接管理器的 sqlhosts 文件
必须修改连接管理器的 sqlhosts 文件，才能定义网络连接信息。
连接管理器和数据库服务器实例在 sqlhosts 文件中以类似方法进行配置。sqlhosts 文件中
的每个条目表示一个服务级别协议 (SLA) 名称或一个数据库服务器。
连接管理器需要连接到并监视的每台服务器都必须列在连接管理器 sqlhosts 文件中。 如
果要监视高可用性集群，连接管理器 sqlhosts 文件必须包含主服务器和所有辅助服务器。
可以使用 GBASEDBTSQLHOSTS 环境变量来指定 sqlhosts 文件的位置。
1. 编辑将要运行连接管理器的服务器上的 sqlhosts 文件。
2. 添加一行，其中包含名称、网络类型、主服务器的主机名和服务名称，并为连接
管理器需要管理的每个辅助服务器和每个 Enterprise Replication 服务器添加单独
的行。
3. 为每个服务级别协议名称添加一行。
例如，以下条目用于创建 SLA 名称 oltp 和 report：
#dbservername nettype hostname servicename options
oltp onsoctcp cmhost1 cmport1
report onsoctcp cmhost1 cmport3
客户机通过连接管理器使用 SLA 名称连接到服务器。cmhost1 表示正在运行连接
管理器的服务器名称。 cmport1 和 cmport3 是客户机连接到的端口。
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 424 -
为高可用性集群设置 sqlhosts、连接管理器和密码文件的示例
此示例显示如何为较小的高可用性集群设置连接管理器。
您有由以下三个服务器组成的高可用性集群配置：
•
主服务器
•
HDR 辅助服务器
•
SD（共享磁盘）辅助服务器
您希望集群提供以下三种不同的服务来支持不同的应用程序：
•
联机事务处理 (OLTP)，可以在主服务器上运行
•
Payroll 服务，可以在 HDR 辅助服务器或主服务器上运行
•
报告服务，可以在 HDR 辅助服务器或 SD 辅助服务器上运行
下图说明了连接管理器将客户机连接请求路由到相应服务器时所需的服务级别协议。
图: 连接管理器配置
连接管理器计算机和客户端计算机上的 sqlhosts 文件具有以下条目：
#dbservername nettype hostname servicename options
cluster_1 group - - i=10
ifx onsoctcp host1 port1 g=cluster_1
ifx_hdr onsoctcp host2 port2 g=cluster_1
ifx_sds onsoctcp host3 port3 g=cluster_1
oltp onsoctcp cmhost1 cmport1
report onsoctcp cmhost1 cmport2
payroll onsoctcp cmhost1 cmport3
每个数据库服务器上的 sqlhosts 文件具有以下条目：
#dbservername nettype hostname servicename options
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 425 -
ifx onsoctcp host1 port1
ifx_hdr onsoctcp host2 port2
Ifx_sds onsoctcp host3 port3
连接管理器的 sqlhosts 文件定义了一个名为 cluster_1 的服务器组。该服务器组已配置为确
保在主服务器发生故障且重新启动了连接管理器时，连接管理器可以重新连接到集群。该
服务器组包含可用作故障转移目标的所有服务器节点（ifx、ifx_hdr 和 ifx_sds）。
要配置和启动连接管理器，请执行以下操作：
1.
创建密码文件并将其加密。对于此示例，请创建包含以下条目的文
件 passwords.txt：
ifx ifx gbasedbt password1
ifx_hdr ifx_hdr gbasedbt password2
ifx_sds ifx_sds gbasedbt password3
运行以下命令来加密该文件：
onpassword -k SecretKey -e ./passwords.txt
2.
设置 GBASEDBTDIR 环境变量以指向安装了 Client SDK 的目录。
3. 创建连接管理器配置文件。对于此示例，在要运行连接管理器的计算机上，创建
包含以下条目的文件 cmconfig：
NAME cm_example
LOG 1
LOGFILE ${GBASEDBTDIR}/etc/cmlog
CLUSTER cluster_1
{
GBASEDBTSERVER ifx
SLA oltp DBSERVERS=primary
SLA payroll DBSERVERS=HDR,primary
SLA report DBSERVERS=SDS,HDR
FOC ORDER=ifx_sds,ifx_hdr \
TIMEOUT=10 \
RETRY=1
}
此配置文件指定了以下信息和行为：
ₒ
连接管理器实例的名称为 cm_example。
ₒ
已启用日志记录。
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 426 -
ₒ
日志文件的名称为 cmlog，并且该日志文件位于 $GBASEDBTDIR/etc 目录
中。
ₒ
连接管理器管理的是名为 cluster1 的集群。
ₒ
连接管理器启动时，将在 sqlhosts 文件中搜索 ifx 条目，并连接到该数据库
服务器。
ₒ
CONNECT TO @oltp 连接请求将定向到主服务器。
ₒ
CONNECT TO @payroll 连接请求将定向到 HDR 辅助服务器。如果 HDR
辅助服务器不可用，CONNECT TO @payroll 连接请求将定向到主服务器。
ₒ
CONNECT TO @report 连接请求将定向到 SD 辅助服务器。如果 SD 辅助
服务器不可用，CONNECT TO @report 连接请求将定向到 HDR 辅助服务
器。
ₒ
如果主服务器发生故障，ifx_sds 会成为新的主服务器。如果 ifx_sds 不可
用，ifx_hdr 会成为新的主服务器。
ₒ
连接管理器再等待 10 秒，以等待有关连接单元的主服务器故障转移处理开
始的事件。
ₒ
连接管理器在主服务器的 HA_FOC_ORDER 配置参数指定的列表中循环 1
次后，自动故障转移将终止。
某些参数和属性不包含在此配置文件中，因此连接管理器具有以下缺省行为：
ₒ
未设置 EVENT_TIMEOUT 参数，因此连接管理器将等待主服务器事件 60
秒，然后再开始故障转移处理。
ₒ
未设置 SECONDARY_EVENT_TIMEOUT 参数，因此连接管理器将等待辅
助服务器事件 60 秒，然后再与辅助服务器断开连接。
ₒ
未设置 SQLHOSTS 参数，因此连接管理器将依次检查 ifx 的本
地 sqlhosts 文件和远程 sqlhosts 文件以查找 ifx_sds 和 ifx_hdr 的实例。
ₒ
未设置 SLA 参数的 WORKERS 属性，因此将为每个 SLA 分配四个工作
程序线程。
4. 编辑主服务器、HDR 辅助服务器和 SD 辅助服务器上的 sqlhosts 文件：
#dbservername nettype hostname servicename options
ifx onsoctcp host1 port1
ifx_hdr onsoctcp host2 port2
ifx_sds onsoctcp host3 port3
5. 在连接管理器计算机上和每个客户端计算机上，编辑 sqlhosts 文件：
#dbservername nettype hostname servicename options
cluster_1 group - - i=10
ifx onsoctcp host1 port1 g=cluster_1
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 427 -
ifx_hdr onsoctcp host2 port2 g=cluster_1
ifx_sds onsoctcp host3 port3 g=cluster_1
oltp onsoctcp cmhost1 cmport1
report onsoctcp cmhost1 cmport2
payroll onsoctcp cmhost1 cmport3
6. 在连接管理器计算机上，通过运行 oncmsm 命令启动连接管理器：
oncmsm -c cmconfig
7. 检查日志文件以验证连接管理器是否正确启动。
启动连接管理器
可以使用 oncmsm 实用程序来启动连接管理器。
要启动连接管理器，请运行以下命令：
•
UNIX™
使用以下命令在 UNIX 系统上启动连接管理器：
oncmsm -c configuration_file
可以使用对象资源管理器在“属性”窗口中显示表和视图的只读属性。可以在表设计器的“列
属性”选项卡中编辑列属性。
1、在对象资源管理器的“属性”窗口中显示列的只读属性
在对象资源管理器中，在对象资源管理器中，依次展开“服务器”、“数据库”、“表”、“列”
节点，右键需要修改的列，再点击“属性”，即可打开属性窗口。
列属性包括以下内容：
•
名称
列的名称。
•
数据类型
列的数据类型。
•
精度
数据精度。
•
小数位
小数的位数。
•
主键
该列是否为主键。
•
可空
该列是否允许空值。
•
默认值
该列的默认值。
GBase 8s 企业管理器用户手册
南大通用数据技术股份有限公司
23
图：列属性
2、在表设计器的“列属性”选项卡中显示列属性
在对象资源管理器中，在对象资源管理器中，依次展开“服务器”、“数据库”、“表”、“列”
节点，右键需要修改的列，再点击“属性”，即可打开属性窗口。
•
在对象资源管理器中，右击需要查看属性的表，再选择“设计表”。此时，将在表设
计器中打开该表。
•
在表设计器中，
选择要查看或编辑其属性的列。
该列的属性将显示在表设计器的“列
属性”选项卡中。