addrpnode 命令

在线编辑

用途

向对等域定义添加一个或多个节点。

语法

addrpnode [-c] [-h] [-TV] node_name1 [node_name2 ...]
addrpnode [-c] { -f │ -F { file_name │ "-" } } [-h] [-TV] [-M]
addrpnode [-c] [-h] [-TV] node_name1 [@host_name1] [node_name2 [@host_name2] …]

描述

在运行 addrpnode 命令之前:

要安装正确的安全环境，请在要添加到对等域的各节点上运行 preprpnode 命令。

addrpnode 命令将指定节点添加到运行 addrpnode 命令的联机对等域。 此命令必须在与新节点添加到的对等域联机的节点上运行。 尽管一个节点可以在多个对等域中定义，但只能在一个对等域中联机。 要向对等域添加一个或多个节点，必须有超过半数的节点联机。

要使 addrpnode 命令在其中一个节点上出错时继续运行，请使用 -c 标志。

addrpnode 命令不会使所添加的节点在对等域中联机。 要这样做，请使用 startrpnode 命令。

标志

-c
当至少一个节点可以添加至对等域中，将继续处理命令。

缺省情况下，如果 addrpnode 命令在任何节点上失败，那么它将在所有节点上失败。 -c 标志将覆盖此行为，以便即使 addrpnode 命令在某个节点上失败，也可在其他节点上运行。

-f | -F { file_name | "-" }
指定从文件或标准输入读取节点名。

使用 -f file_name 或 -F file_name 从文件中读取节点名。 使用 -f "-" 或 -F "-" 将 STDIN 指定为输入文件。

注意：
  • 每行指定一个节点名。 该命令将忽略节点名左侧的任何空白字符。
  • 使用数字符号 (#) 来指示行的剩余部分（如果 # 位于第 1 列，那么为一整行）是注释。
缺省情况下，file_name 中列示的所有节点：
  • 组服务组组长是否为候选者?
  • 用于仲裁决策。
  • 有访问对等域决胜局机制的权限。
可使用 at 符号 (@) 控制字符并后跟一个或多个特殊字符来定制节点特征：
P | p
指定节点是组服务组引导符候选者。
Q | q
指定节点是定额节点。
B | b
指定该节点有访问对等域决胜局机制的权限。 仅可为定额节点指定 B 或 b。
!
指定该节点没有特定特征。 例如，!Q 指示节点不是定额节点。
定制节点特征时，请考虑以下几点（其中，x 是 P、Q 或 B）：
  • 每行仅使用一个 @ 控制字符，在节点名后和任何注释之前紧跟一个或多个特殊字符。
  • 请勿为节点指定 !QB ; 这将导致错误。
  • 如果使用节点编号，请在节点名之后任何注释之前添加节点编号。 节点编号可以在节点特征指定之前或之后。
  • 如果为一个或多个节点指定了 x ，并且没有为任何节点指定 ，那么假定未指定 x 的节点的值为 !x。
  • 如果为一个或多个节点指定 !x，但没有为任何节点指定 x，那么没有指定 !x 的节点假定具有 x 值。
  • 如果在相同的节点文件中为不同的节点指定 x 和 !x，那么文件中的所有节点必须具有 x 或 !x 的规范。
-h
将命令的用法语句写到标准输出。
-M
验证新节点的安全合规性方式是否与域匹配。 如果方式不匹配，那么不会添加该节点。 如果未指定 -M 选项，并且节点正在使用与域兼容的密钥类型，那么将添加节点并更新其合规性方式以与域匹配。
-T
将命令的跟踪消息写到标准错误。 仅供您的软件服务组织使用。
-V
将命令的详细消息写到标准输出。

参数

node_name1 [node_name2 ... ]
指定要添加至对等域定义中的一个（或多个）节点。 节点名称是 IP 地址或者是 DNS 主机名的详细或简短型式。 节点名必须解析成 IP 地址。
node_name1[@host_name1] [node_name2[@host_name2] ...]

通过对每个节点同时使用节点名和主机名，指定需要添加至 RPD 的节点。 node_name1 参数对应于某个标签，但 host_name1 参数是 IP 地址或 DNS 主机名的长或短版本。 主机名必须是可以连接或 ping 的有效值。

如果未指定 HostName 参数，并且仅为 addrpnode 命令指定了 Name 参数，那么会将 HostName 参数设置为 Name 参数。 在这种情况下，Name 参数必须解析为 IP 地址或 DNS 主机名称的长或短版本。

要向现有对等域添加节点，请使用以下命令：
addrpnode node_name3@host_name3
您还可以运行 addrpnode -f /home/nodelst 命令，其中 /home/nodelst 将节点名称为 node_name3@host_name3.in.ibm.com。

安全性

addrpnode 命令的用户需要 IBM.PeerDomain 资源类和 IBM.PeerNode 资源类。 这通过在将添加的每个节点上运行 preprpnode 命令来设置。 请用 preprpnode 命令来指定对等域的所有联机节点的名称。 这向联机节点提供在将添加的节点上执行操作的所需权限。

退出状态

重大安全事件数量
命令成功运行。
第 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_IP_AUTHENT 只有在 CT_CONTACT 设为 IP 地址时才有意义；CT_IP_AUTHENT 并不依赖于域名系统 (DNS) 服务。

限制

此命令必须在新节点将添加至其中的对等域的联机节点上运行。

实现细节

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

标准输入

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

标准输出

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

标准错误

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

示例

  1. 要将节点 "node_name2和 "node_name3添加到对等域 "应用域（其中 "node_name1已在对等域 "应用域"上定义并联机），请在 "node_name1上运行命令：
    addrpnode node_name2 node_name3
  2. 要将节点 "node_name2和 "node_name3以及主机名添加到对等域ApplDomain（其中 "node_name1已在对等域ApplDomain 上定义并联机），请在 "node_name1上运行命令：
    addrpnode node_name2@host_name2 nodeC_name3@host_name3

位置

/opt/rsct/bin/addrpnode