mkcomg 命令

在线编辑

用途

为对等域建立一个新的通信组定义。

语法

mkcomg [-s 敏感性] [-p 时间 ] [ -g 风度 ] [-t 优先权] [ -x b | r | br ] [ -N UseForNodeMembership ] [-e NIM_path] [-m NIM 参数 ] [ -M 媒体类型 ] [ -i {h | n}:接口1[:节点1][,接口2[:节点2]...] | -S {h | n}:"接口选择字符串" [ -6 ] [-h] [-TV] 通讯组

描述

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

mkcomg 命令必须在要定义通信组的对等域中当前联机的节点上运行。 要为域创建新的通信组，半数以上的节点必须联机。

-e 和 -m 标志用于设置网络接口模块 (NIM) 路径和参数。 NIM 的路径是在通信组中使用的支持适配器类型的 NIM 的路径。 当 NIM 路径已启动时，NIM 参数就被传递到 NIM。 如果未指定 -m ，那么将使用拓扑服务预定义的参数。

可以将通信组分配到一个或多个接口资源。 使用 -i 标志将通信组分配给特定接口资源名称。 可以将接口资源限制到一个特定节点上的通信组。 还可以使用 -S 标志和选择字符串来指定接口资源。 在指定接口资源名称尚显不足时使用此方法。 -i 和 -S 标志不能一起使用。 chcomg 命令还可用于将通信组分配给接口资源。

标志

-敏感度
指定脉动信号的灵敏度。 这是丢失的脉动信号（造成失败）的个数。 敏感度值是大于或等于 2 的整数。 缺省值为 4。
--p 期
指定脉动信号之间的时间量。 指定时间段（以秒计），而且时间段精度可达毫秒级。 时间段可以指定为整数，也可以指定为浮点数。
--g 优雅
指定不再接收脉动信号时使用的宽限期。 当丢失脉动信号时，会向发生故障的节点发送一个因特网控制报文协议 (ICMP) 回送信号数据包。 如果返回回送信号，那么将启动宽限期。
指定宽限期（以秒计），而且宽限期精度可达毫秒级。 宽限期可以指定为整数、浮点数或者下列其中一个值：
0
指定宽限期处于禁用状态。
-1 | D
指定拓扑服务子系统控制宽限期。 这是缺省情况。
--t 优先
指定优先级。 这个值表示本通信组相对于其他通信组的重要性。 它用于排序脉动信号。 数字越小，优先级越高。 最高优先级为 1。 对于 IP 网络，缺省值为 1 ，对于 RS232 网络，缺省值为 255。
-x b | r | br
排除脉动信号机制的控制。 该标志表示不应该使用一个或多个脉动信号机制的控制，即使基础介质支持。 可以排除以下功能：
b
指定不应该使用广播功能，即使基础的介质支持。 如果未指定 -x b ，那么将在底层媒体支持广播功能时使用该功能。
r
指定不应该使用源路由功能，即使基础的介质支持。 如果未指定 -x r ，那么将使用源路由功能 (如果底层介质支持)。
要排除多个控件，请连续指定功能部件字符: -x br。
-N UseForNodeMembership
指定组服务是否将使用通信组来计算节点成员资格。 为通信组资源设置 UseForNodeMembership 持久资源属性。 有效值是：
0
指出不论对 NetworkInterface 资源（为此通信组的成员）运行的活跃度检查结果为何，组服务都将不使用那些结果来计算拥有这些接口的节点是否联机。
1
指出组服务将使用对 NetworkInterface 资源运行的活跃度检查的结果来计算拥有这些接口的节点的联机状态。
--e NIM_path
指定网络接口模块 (NIM) 的路径名。 这个字符串指定在通信组中支持适配器类型的 NIM 的路径。
--m NIM_参数
指定 NIM 的启动参数。 启动时，将这个字符串传递到 NIM。
--M 媒体类型
指定构成 communication_group 的接口的类型。 有效值是：
0
指出 communication_group 由 IP 或磁盘之外的接口资源组成。
1
指出 communication_group 由 IPv4 或 IPv6 接口资源组成。

如果不指定 -M 标志，那么这是缺省值。

2
指出 communication_group 由磁盘接口资源组成。
--i {h | n}:interface1[:node1] [,interface2[:node2]...
将 communication_group 指定给一个或多个脉动信号或网络接口资源，以及（可选）指定给可以找到这些资源的节点。 为脉动信号接口资源指定 -i h，或者为网络接口资源指定 -i n。

缺省情况下，-i n 标志会将具有 IPv4 地址的网络接口资源添加至 communication_group。 如果指定 -6 标志，那么 -i n 标志会将具有 IPv6 地址的网络接口资源添加至 communication_group。

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

--S {h | n}："网络选择字符串"
将 communication_group 指定给由 interface_selection_string 确定的脉动信号或网络接口。 为脉动信号接口指定 -S h，或者为网络接口指定 -S n。

缺省情况下，-S n 标志会将具有 IPv4 地址的网络接口资源添加至 communication_group。 如果指定 -6 标志，那么 -S n 标志会将具有 IPv6 地址的网络接口资源添加至 communication_group。

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

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

缺省情况下（在不指定 -6 的情况下），反过来是成立的。 只有表示为接口上的资源的 IPv4 地址才会更改其通信组。

-h
将命令的用法语句写到标准输出。
-T
将命令的跟踪消息写到标准错误。 仅供您的软件服务组织使用。
-V
将命令的详细消息写到标准输出。

参数

通信组
指定为联机对等域创建的新的通信组的名称。 名称可以包含任何可打印的字符。

安全性

mkcomg 命令的用户需要 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 标志时，此命令的用法语句将写入标准输出。 所有详细消息都写到标准输出。

标准错误

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

示例

  1. 要为对等域 ApplDomain 和 nodeA 定义通信组 ComGrp1 并使其与 ApplDomain联机，请在 nodeA上运行以下命令:
    mkcomg ComGrp1
  2. 要为对等域 ApplDomain定义通信组 ComGrp1 (使用敏感度 1 和周期 3) ，并且定义了 nodeA 并使其与 ApplDomain联机，请在 nodeA上运行以下命令:
    mkcomg -s 1 -p 3 ComGrp1
  3. 要为对等域 "ApplDomain定义通信组 "ComGrp1，不使用广播，优先级为 3，且 "nodeA已定义并与 "ApplDomain联机，请在nodeA:上运行此命令：
    mkcomg -x b -t 3 ComGrp1
  4. 要为对等域 ApplDomain定义通信组 ComGrp1 ，不使用广播，不使用源路由，并且定义了 nodeA 并使其与 ApplDomain联机，请在 nodeA上运行以下命令:
    mkcomg -x br ComGrp1
  5. 要为对等域 ApplDomain定义通信组 ComGrp1 ，使用 NIM 路径 /opt/rsct/bin/hats_nim， NIM 参数 -l 5 来设置日志记录级别，并且 nodeA 已定义并与 ApplDomain联机，请在 nodeA上运行此命令:
    mkcomg -e /opt/rsct/bin/hats_nim -m "-l 5" ComGrp1
  6. 要为 ApplDomain 定义通信组 ComGrp1 并将 ComGrp1 指定给 nodeC 上名为 hbi0 的脉动信号接口资源，请在 nodeA 上运行此命令：
    mkcomg -i h:hbi0:nodeC ComGrp1
  7. 要为对等域 ApplDomain定义通信组 ComGrp1 ，请将 ComGrp1 分配给 nodeB上名为 eth0 的网络接口资源，并将 nodeA 定义为与 ApplDomain联机，请在 nodeA上运行以下命令:
    mkcomg -i n:eth0:nodeB ComGrp1
  8. 要为 ApplDomain 定义通信组 ComGrp1 并将 ComGrp1 指定给使用子网 9.345.67.812 的脉动信号接口资源，请在 nodeA 上运行此命令：
    mkcomg -S h:"Subnet == 9.345.67.812" ComGrp1
  9. 要为对等域 ApplDomain定义通信组 ComGrp1 ，请将 ComGrp1 分配给使用子网 9.123.45.678的网络接口资源，并将 nodeA 定义为与 ApplDomain联机，请在 nodeA上运行以下命令:
    mkcomg -S n:"Subnet == 9.123.45.678" ComGrp1
  10. 要使用时间段 500 毫秒为 ApplDomain 定义通信组 ComGrp1，请在 nodeA 上运行此命令：
    mkcomg -p 0.5 ComGrp1

位置

/opt/rsct/bin/mkcomg