AIX命令参考大全，卷 5，s - u - topsvcsctrl 命令

[ 页的底部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]

AIX命令参考大全，卷 5，s - u

topsvcsctrl 命令

用途

启动拓扑服务子系统。

语法

topsvcsctrl { -a | -s | -k | -d | -c | -u | -t | -o | -r | -h }

描述

topsvcsctrl 控制脚本控制拓扑服务子系统的运行。此子系统由系统资源控制器（SRC）进行控制，并属于一个称为 topsvcs 的子系统组。此脚本通常由 HACMP/ES 启动进程来启动。

拓扑服务子系统的一个实例运行在群集的每一个节点上。

从操作观点来看，拓扑服务子系统组采取如下组织：

子系统: 拓扑服务
子系统组: topsvcs
SRC 子系统: topsvcs
topsvcs 子系统与 hatsd 守护进程和 topsvcs 脚本关联。topsvcs 脚本配置并启动 hatsd 守护进程。节点上的子系统名为 topsvcs。每个节点都有一个子系统并与节点所属的群集关联。
守护进程: hatsd
提供拓扑服务。topsvcs 脚本配置并启动 hatsd 守护进程。

topsvcsctrl 脚本通常不能从命令行执行。它通常被 HACMP/ES 启动命令调用。

topsvcsctrl 脚本提供了多种拓扑服务子系统的操作控制：

添加、启动、停止和删除子系统
清除子系统，即从所有系统分区将其删除
打开和关闭跟踪功能
刷新子系统

在执行任一这些功能之前，脚本获取当前群集名（使用 cllsclstr 命令）和节点号（使用 clhandle 命令）。如果节点号为 0，控制脚本就在控制工作站上运行。

除了清除与取消配置这两个功能，其余功能都可在当前系统分区作用域内执行。

添加子系统：如果指定了 -a 标志，此控制命令将使用 mkssys 命令把该拓扑服务子系统添加到 SRC。控制脚本操作如下：

确保 topsvcs 子系统已停止。
从 SRC 中除去 topsvcs 子系统（以防它仍在那儿）。
将 topsvcs 子系统添加到 SRC 中。

启动子系统：当指定 -s 标志时，控制脚本使用 startsrc 命令来启动拓扑服务子系统 topsvcs。

停止子系统：当指定 -k 标志时，控制脚本使用 stopsrc 命令来停止拓扑服务子系统 topsvcs。

删除子系统：当指定 -d 标志时，控制脚本使用 rmssys 命令将拓扑服务子系统从 SRC 中除去。控制脚本操作如下：

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

清除子系统：当指定 -c 标志时，控制脚本停止并从 SRC 的所有群集分区中除去拓扑服务子系统。控制脚本操作如下：

使用 stopsrc -g topsvcs 命令停止群集中子系统的所有实例。
从 /etc/services 文件中将 topsvcs 子系统的所有项都除去。

打开跟踪功能：当指定 -t 标志时，控制脚本使用 traceson 命令为 hatsd 守护进程打开跟踪功能。

关闭跟踪功能：当指定 -o 标志，控制脚本使用 tracesoff 命令为 hatsd 守护进程关闭跟踪功能（返回其缺省级别）。

刷新子系统：当指定 -r 标志时，控制脚本使用 topsvcs refresh 命令和 refresh 命令刷新子系统。在全局对象数据管理器（ODM）中重建有关节点和适配器配置的信息，并给守护进程发信号去读取重建信息。

记录：当拓扑服务守护进程（hatsd）运行时，它通过将项写入一个称为 /var/ha/log/topsvcscluster_name 的日志文件来提供有关其操作和错误的信息。

标志

-a	添加子系统。
-s	启动子系统。
-k	停止子系统。
-d	删除子系统。
-c	清除子系统。
-u	从所有分区删除此拓扑服务子系统。
-t	打开子系统跟踪功能。
-o	关闭子系统跟踪功能。
-r	刷新子系统。
-h	将脚本的用法语句写入标准输出。

安全性

必须拥有有效的 root 用户标识才能使用此脚本。

退出状态

0: 指示脚本成功完成。
1: 表明有错误发生。

环境变量

HB_SERVER_SOCKET: 此环境变量应在此命令执行前进行设置。它必须被设置为拓扑服务客户机用来连接到拓扑服务守护进程的 UNIX 域套接字的位置。此环境变量必须设置为 /var/ha/soc/hats/server_socket.partition name。
HA_SYSPAR_NAME: 如果 HB_SERVER_SOCKET 未设置，那么 HA_SYSPAR_NAME 必须被设置为分区名。

限制

此命令只在 HACMP 环境中有效。

只有在“IBM 支持中心”的指导下才能使用此命令。

标准输出

当指定 -h 标志时，将该命令的用法语句写入标准输出。所有详细信息写入标准输出。

标准错误

必要时此脚本将错误消息写入标准错误。

示例

要将拓扑服务子系统添加到 SRC 中，请输入：
```
topsvcsctrl -a
```
要启动拓扑服务子系统，请输入：
```
topsvcsctrl -s
```
要停止拓扑服务子系统，请输入：
```
topsvcsctrl -k
```
要从 SRC 中删除拓扑服务子系统，请输入：
```
topsvcsctrl -d
```
要清除拓扑服务子系统，请输入：
```
topsvcsctrl -c
```
要打开拓扑服务守护进程的跟踪功能，请输入：
```
topsvcsctrl -t
```
要关闭拓扑服务守护进程的跟踪功能，请输入：
```
topsvcsctrl -o
```

位置

/usr/sbin/rsct/bin/topsvcsctrl: 包含 topsvcsctrl 脚本

文件

/var/ha/log/topsvcs.cluster_name: 包含名为 cluster_name 的群集上的 hatsd 守护进程的记录。