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。 控制脚本操作如下：
  1. 它确保 topsvcs 子系统已停止。
  2. 它从 SRC 中除去 topsvcs 子系统 (如果它仍然存在)。
  3. 它将 topsvcs 子系统添加到 SRC。

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

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

删除子系统: 当指定 -d 标志 时，控制脚本使用 rmssys 命令从 SRC 中除去拓扑服务子系统。 控制脚本操作如下：
  1. 它确保 topsvcs 子系统已停止。
  2. 它使用 rmssys 命令从 SRC 中除去 topsvcs 子系统。
  3. 它将从 /etc/services 文件中除去端口号。
清除子系统: 当指定 -c 标志 时，控制脚本将停止并从 SRC 中除去所有集群分区的拓扑服务子系统。 控制脚本操作如下：
  1. 它使用 stopsrc -g topsvcs 命令停止集群中子系统的所有实例。
  2. 它将从 /etc/services 文件中除去 topsvcs 子系统的所有条目。

打开跟踪: 当指定 -t 标志 时，控制脚本使用 traceson 命令打开 hatsd 守护程序的跟踪。

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

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

日志记录: 拓扑服务守护程序 (hatsd) 在运行时，通过在名为 /var/ha/log/topsvcs.cluster_name的日志文件中写入条目来提供有关其操作和错误的信息。

标志

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

安全性

您必须使用有效用户标识 root 运行才能使用此脚本。

退出状态

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

环境变量

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

限制

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

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

标准输出

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

标准错误

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

示例

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

位置

/opt/rsct/bin/topsvcsctrl
包含 topsvcsctrl 脚本

文件

/var/ha/log/topsvcs.cluster_name
包含名为 cluster_name 的集群上 hatsd 守护程序的日志