startrpdomain 命令

用途

使已定义的对等域联机。

语法

startrpdomain [ -A | -L ] [-t timeout] [ -Q quorum_type | quorum_type_name ] [-m fanout] [-h] [-w [-s Seconds]] [-TV] peer_domain

描述

startrpdomain 命令通过启动属于对等域的每个节点上的资源，使定义的对等域联机。

startrpdomain 命令必须在定义到对等域的节点上运行。 每次在对等域中运行此命令时，它都请求定义到对等域中的所有脱机节点在对等域中联机。 可以在对等域中多次运行此命令。 如果在对等域中定义的所有节点已经联机，那么不执行操作。

startrpdomain 命令通过检查定义到对等域的节点上的对等域配置，确定用于使对等域联机的对等域配置。 找到最新版本的对等域配置信息用来使对等域联机。 在缺省情况下，使用在至少一半的节点上找到的最新版本的对等域配置。 指定 -A 标志将导致使用在对等域中定义的所有节点上找到的对等域配置的最新版本。 指定 -L 标志会导致使用本地节点上的配置。

确定最新版本对等域配置信息时，配置超时定义何时停止检查版本并开始将对等域联机。 缺省超时值是 120 秒。 可以使用 -t 标志来更改超时值。 超时值应该至少足以能够从至少一半的节点上找到最新版本的对等域配置信息。

一个节点每次只能在一个对等域上联机。 当另一个对等域已针对某个对等域联机时，无法在该节点上运行 startrpdomain 命令。

标志

-A

从对等域的所有节点中查找并使用最新版对等域配置信息。 如果指定了 -L 标志，那么不能指定此标志。 如果未指定任何标志 (-A 或 -L) ，那么将使用来自对等域中至少一半节点的最新版本的对等域配置信息。

-L

使用在本地节点上的最新版本的对等域配置信息。 如果指定了 -A 标志，那么不能指定此标志。 如果未指定任何标志 (-A 或 -L) ，那么将使用来自对等域中至少一半节点的最新版本的对等域配置信息。

--t 超时

指定超时值（秒）。 该标志限制了用于查找最新版本的对等域配置所需的时间量。 当超过超时值时，使用此时找到的最新版本的对等域配置信息。 超时值应该足够长，以便能够从至少一半的节点上找到最新版本的对等域配置信息。 缺省超时值是 120 秒。

--Q quorum_type | quorum_type_name

使您能够覆盖启动限额方式。 可以指定它作为整数限额类型或限额类型名称。 如果未指定此标志，那么在创建对等域时，将使用 mkrpdomain 命令的 -Q 标志 (或环境的缺省定额方式) 来指定启动定额方式。 仅当定额方式已定义为 normal 或 quick时，才能覆盖定额启动方式。 有效值为：

0 │ normal

指定常规启动限额规则。 将接触配置信息的一半节点。

1 │ quick

指定快速启动限额规则。 将接触配置信息的一个节点。

--m 扇出

指定用于此启动操作的线程的最大数目。 -m 标志覆盖指定对等域的缺省 fanout 值。 此值作为持久属性存储在对等域的 IBM.PeerNode 类中。 扇出 可以是从 16 到 2048的整数。

-h

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

-s

指定 -s 和 -w 标志配合使用时，完成该命令之前同级域联机要等待的时间（以秒计）。 如果等待的时间超过指定的秒数，那么命名将返回，但是联机操作仍然进行。 缺省值为 300 秒（5 分钟）。 使用 0 指定只有直到同级域联机后才能返回命令（等待未超时）。

-T

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

-V

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

-w

完成命令之前，等待同级域联机。 使用 -s 标志指定等待时间（以秒计）。

参数

对等域

指定要联机的预定义对等域的名称。

安全性

startrpdomain 命令的用户需要对定义到对等域的每个节点上的 IBM.PeerDomain 资源类具有写许可权。 缺省情况下，对等域中任何节点上的 root 都具有通过配置资源管理器对此资源类的读写访问权。

退出状态

0

命令成功运行。

1

RMC 发生错误。

2

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

3

命令行中输入错误标志。

4

命令行中输入错误参数。

5

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

6

对等域定义不存在。

环境变量

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 "-" 标志时，此命令从标准输入读取一个或多个节点名。

标准输出

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

标准错误

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

示例

位置

/opt/rsct/bin/startrpdomain