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' {文件名| '"-"' }

指定从文件或标准输入读取节点名。

使用 -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 或 !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 命令来指定对等域的所有联机节点的名称。这向联机节点提供在将添加的节点上执行操作的所需权限。

退出状态

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_IP_AUTHENT 只有在 CT_CONTACT 设为 IP 地址时才有意义；CT_IP_AUTHENT 并不依赖于域名系统 (DNS) 服务。

限制

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

实现细节

该命令是AIX® 的Reliable Scalable Cluster Technology(RSCT) 文件集的一部分。

标准输入

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

标准输出

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

标准错误

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

示例

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

位置

/opt/rsct/bin/addrpnode