chcomg 命令

用途

更改为对等域先前定义的通信组。

语法

要更改通信组的属性：

chcomg[ '-s 灵敏度] [ '-p 周期] [-g grace] [ '-t 优先级] [ '-b' ] [ '-r' ] [ '-x'b' | 'r' | 'br] [ '-e NIM_path] [ '-m NIM_parameters] [-N UseForNodeMembership] [ '-h] [ '-TV]communication_group

要将脉动信号接口资源中的引用更改为其他通信组：

奇科姆 [ I h:脉动信号接口 1[:节点 1 ] [ ,脉动信号接口 2[:节点 2]...] | -S h: "heartbeat_interface_selection_string" ] [ - ] [ -电视 ] 通信组

要将网络接口资源中的引用更改为其他通信组：

chcomg [-i n:network_interface1[:node1] [,network_interface2[:node2] ...] | -S n:"network_interface_selection_string"] [ -6 ] [-h] [-TV] 通信组

描述

chcomg 命令使用联机对等域的 communication_group 参数指定的名称来更改现有通信组定义。 通信组是用来定义拓扑结构服务使用的波动信号环以及定义每个波动信号环的调谐。 通信组确定在对等域中波动信号使用哪些设备。

chcomg 命令必须在定义了通信组的对等域中当前处于联机状态的节点上运行。 可以使用一个 chcomg 命令来更改一个或多个属性，但至少需要进行一个更改。

-e 和 -m 标志用于设置网络接口模块 (NIM) 路径和参数。 NIM 的路径是在通信组中使用的支持适配器类型的 NIM 的路径。 当 NIM 路径已启动时，NIM 参数就被传递到 NIM。

chcomg 命令还可用于将通信组分配给接口资源。 使用 -i 标志将通信组分配给特定接口资源名称。 可以将接口资源限制到一个特定节点上的通信组。 还可以使用 -S 标志和选择字符串来指定接口资源。 在指定接口资源名称尚显不足时使用此方法。 在除去通信组之前，任何引用它的接口资源都必须被重新指定。

一大半节点都必须联机以更改域中的通信组。

标志

-敏感度

指定脉动信号的灵敏度。 这是丢失的脉动信号（造成失败）的个数。 灵敏度是大于或等于 4 的整数。

--p 期

指定周期，这是两次脉动信号之间的秒数。 句点 的值可以是大于或等于 1的整数或浮点数。

--g 优雅

指定不再接收脉动信号时使用的宽限期。 当丢失脉动信号时，会向发生故障的节点发送一个因特网控制报文协议 (ICMP) 回送信号数据包。 如果返回回送信号，那么将启动宽限期。

指定宽限期（以秒计），而且宽限期精度可达毫秒级。 宽限期可以指定为整数、浮点数或者下列其中一个值：

0

指定宽限期处于禁用状态。

-1 | d

指定拓扑服务子系统控制宽限期。 这是缺省值。

--t 优先

指定优先级。 优先级表示了考虑到其他通信组时该通信组的重要性。 它用于排序脉动信号。 数字越低，优先级越高。 最高优先级为 1。

-b

指定将使用广播（如果底层介质支持它）。 指定 -x b时不能使用 -b 标志。

-r

指定将使用源路由（如果底层介质支持它）。 指定 -x r时不能使用 -r 标志。

--xb|r|br

排除对脉动型号机制的控制。 这表示不应使用对脉动型号机制的一个或多个控制（即使底层介质支持它）。 以下各项可被排除：

b

指定即使底层介质支持它，也不应该使用广播。

r

指定即使底层介质支持它，也不应该使用源路由。

通过连续列出功能部件选项字母 (-x br) 来指定排除多个控件。

--ih | n:network_interface1[:node1] [,network_interface2[:node2]...

将此通信组指定给由网络接口资源名或者可以找到该通信组的节点名定义的网络接口资源。 为脉动信号接口资源指定 -i h，或者为网络接口资源指定 -i n。 缺省情况下，-i n 标志会将具有 IPv4 地址的网络接口资源添加至 communication_group。 如果指定 -6 标志，-i n 标志会将具有 IPv6 地址的网络接口资源添加到 communication_group。

如果指定了 -i ，那么无法指定 -S 。

-Sh | n: "网络接口选择字符串"

将此通信组指定给由网络接口选择字符串指定的接口。 为脉动信号接口指定 -S h，或者为网络接口指定 -S n。 缺省情况下，-S n 标志会将具有 IPv4 地址的网络接口资源添加至 communication_group。 如果指定 -6 标志，-S n 标志会将具有 IPv6 地址的网络接口资源添加到 communication_group。

如果指定了 -S ，那么无法指定 -i 。

--e NIM_path

指定网络接口模块 (NIM) 的路径名。 这个字符串指定在通信组中支持适配器类型的 NIM 的路径。

--m NIM_参数

指定 NIM 的启动参数。 这是当启动 NIM 时，传递给 NIM 的字符串。

-N UseForNodeMembership

指定组服务是否使用计算节点成员资格中的通信组。 为通信组资源设置 UseForNodeMembership 持久资源属性。 有效值是：

0

指示无论在属于此通信组成员的 NetworkInterface 资源上运行的活性检查结果如何，组服务都不会将这些结果用于计算拥有接口的节点是否联机。

1

指示组服务将在 NetworkInterface 资源上运行的活性检查结果用于计算器拥有节点的联机状态。

-6

指定表示为每个接口上的资源的 IPv6 地址将其通信组更改为指定的通信组。 表示为接口上资源的 IPv4 地址不受影响。

缺省情况下（未指定 -6 标志），反之亦然。 只有在接口上表示为资源的 IPv4 地址已更改其通信组。

-h

将命令的用法语句写到标准输出。

-T

将命令的跟踪消息写到标准错误。 仅供您的软件服务组织使用。

-V

将命令的详细消息写到标准输出。

参数

通信组

指定在对等域中，所要更改的现有通信组的名称。

安全性

chcomg 命令的用户需要 IBM.CommunicationGroup 资源类的写许可权。 需要 IBM.NetworkInterface 资源类的写许可权才能设置网络接口资源的通信组。 缺省情况下，对等域中任何节点上的 root 都具有通过配置资源管理器对这些资源类的读写访问权。

退出状态

0

命令成功运行。

1

RMC 发生错误。

2

命令行界面脚本发生错误。

3

命令行中输入错误标志。

4

命令行中输入错误参数。

5

不正确的命令行输入导致出错。

环境变量

CT_CONTACT

确定与资源监视和控制 (RMC) 守护程序发生会话的系统。 当 CT_CONTACT 设置为主机名或 IP 地址时，该命令会与指定主机上的 RMC 守护程序联系。 如果未设置 CT_CONTACT，那么该命令会与运行它的本地系统的 RMC 守护程序联系。 RMC 守护程序会话的目标和管理作用域确定了处理的资源类或资源。

CT_IP_AUTHENT

如果存在 CT_IP_AUTHENT 环境变量，那么 RMC 守护程序将使用基于 IP 的网络认证，与 CT_CONTACT 环境变量中的 IP 地址所指定系统上的 RMC 守护程序联系。 仅当 CT_CONTACT 设为 IP 地址时，CT_IP_AUTHENT 才有意义；它不依赖于域名系统（DNS）服务。

限制

此命令必须在某一节点上运行，而此节点被定义并联机至即将更改的通信组所在的对等域。

实现细节

该命令是AIX Reliable Scalable Cluster Technology（RSCT）文件集的一部分。

标准输入

当指定 -f "-" 或 -F "-" 标志时，此命令从标准输入读取一个或多个节点名。

标准输出

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

标准错误

所有跟踪消息都写到标准错误。

示例

位置

/opt/rsct/bin/chcomg