cthagsctrl 命令

在线编辑

用途

控制组服务子系统。

语法

cthagsctrl { -a [-p port-number ] -s | -k | -d | -r | -z | -h | -t | -o }

描述

cthagsctrl 控制命令在系统资源控制器 (SRC) 的控制下控制组服务子系统 (cthags) 的操作。

集群的每个节点上都运行着组服务子系统的实例。

从视图的操作点，组服务的子系统组按如下组织：

子系统

组服务

子系统组

cthags

SRC 子系统

cthags

cthags 子系统与 hagsd 守护程序相关联。

节点上的子系统名称为 cthags。每个节点有一个子系统，且这些子系统中的每一个都与该节点所属的集群相关联。

守护程序

hagsd

提供分组服务功能。

通常，不会从命令行发出 cthagsctrl 命令。通常由cthactrl 命令在创建集群期间调用。

cthagsctrl 命令提供了用于操作组服务子系统的各种控件:

添加、启动、停止和删除子系统
清除子系统（将它们从集群删除）
从集群取消配置子系统
打开和关闭跟踪功能

Adding the subsystem

当指定 -a 标志时，控制命令将组服务子系统添加到 SRC。控制命令：

确保 cthags 子系统已停止。
从集群数据获取 cthags 子系统的端口号。
从 SRC 中除去 cthags 子系统 (如果它仍然存在)。
将 cthags 子系统添加到 SRC。
当前不向 /etc/inittab 文件添加 cthags 组的条目。因此，需要时，需要由另一个子系统启动 cthags 。

Starting the subsystem

当指定 -s 标志时，控制命令使用 startsrc 命令来启动组服务子系统 cthags。

Stopping the subsystem

当指定 -k 标志时，控制命令使用 stopsrc 命令来停止组服务子系统 cthags。

Deleting or cleaning the subsystem

当指定 -d 标志时，控制命令使用 rmssys 命令从 SRC 中除去组服务子系统。控制命令：

确保 cthags 子系统已停止。
使用 rmssys 命令从 SRC 中除去 cthags 子系统。
从 /etc/services 文件中除去端口号。

Turning tracing on

当指定了 -t 标志时，控制命令使用 traceson 命令对 hagsd 守护程序开启跟踪。

Turning tracing off

当指定 -o 标志时，控制命令使用 tracesoff 命令对 hagsd 守护程序关闭跟踪 (将其返回到其缺省级别)。

Refreshing the subsystem

-r 标志将刷新 cthags 子系统。

Logging

组服务守护程序在运行时，通过在 /var/ct/cluster_name/log/cthags 目录中的三个日志文件中写入条目来提供有关其操作和错误的信息。这些日志文件是：

/var/ct/集群./log/cthags名称节点编号实例编号集群名称
/var/ct/集群名称/log/cthags_nodenum_instnum.cluster_name.long
/var/ct/集群/log/cthags.default.名称节点数实例数

日志文件包含节点上 hagsd 守护程序的日志。

日志文件的名称包含这些变量：

nodenum 是守护程序在其上运行的节点号。
instnum 是守护程序的实例号。
cluster_name 是守护程序在其中运行的集群名称。

每个守护程序都按照预先设定的行数来限制日志的大小。缺省值为 5000 行。达到限制时，守护程序会将字符串 .bak 附加到当前日志文件的名称并开始新的日志。如果 .bak 版本已存在，那么将在重命名当前日志之前除去该版本。

标志

-a [-p 端口编号]: 添加子系统。
-s: 启动子系统。
-k: 停止子系统。
-d: 删除子系统。
-t: 打开子系统跟踪功能。
-o: 关闭子系统跟踪功能。
-r: 刷新子系统。
-z: 卸载 cthags 子系统。
-h: 将命令的用法语句写到标准输出。

安全性

您必须具有 root 权限才能运行此命令。

退出状态

0: 表示命令成功完成。
非零值: 表示发生错误。

限制

此命令仅在对等域中有效。

仅在 IBM® 支持中心的指导下使用此命令。

标准输出

当指定 -h 标志时，此命令的用法语句将写入标准输出。

标准错误

必要时此命令会将错误消息写至标准错误。

示例

要在当前集群中添加组服务子系统至 SRC，请输入：
```
cthagsctrl -a
```
要添加端口号为 12347 的组服务子系统，请输入：
```
cthagsctrl -a -p 12347
```
要在当前集群中启动组服务子系统，请输入：
```
cthagsctrl -s
```
要在当前集群中停止组服务子系统，请输入：
```
cthagsctrl -k
```
要在当前集群中从 SRC 删除组服务子系统，请输入：
```
cthagsctrl -d
```
要在当前集群中打开分组服务守护程序的跟踪，请输入：
```
cthagsctrl -t
```
要在当前集群中关闭分组服务守护程序的跟踪，请输入：
```
cthagsctrl -o
```

位置

/opt/rsct/bin/cthagsctrl: 包含 cthagsctrl 命令