startrsrc 命令

用途

启动已定义的资源（即，让该资源联机）。

描述

startrsrc 命令请求资源监视和控制 (RMC) 子系统使一个或多个资源联机。 由相应的资源管理器完成该请求。

要启动一个或多个资源，请使用 -s标志使所有与指定选择字符串匹配的资源联机。

您可以使用 -N node_file 标志来指示节点名在文件中，而不是在 selection_string中指定多个节点名。 使用 -N "-" 从标准输入中读取节点名。

要启动一个特定资源，请使用 -r 标志指定表示该特定资源的资源句柄。

使用 -l 标志来确定指定的资源类是否接受任何其他命令参数。

如果系统上安装了 Cluster Systems Management (CSM)，可以将 CSM 定义的节点组用作节点名值来引用多个节点。 有关使用 CSM 节点组和使用 CSM nodegrp 命令的信息，请参阅 CSM: Administration Guide 和 CSM: Command and Technical Reference。

 lsrsrc -s 'Name == "/filesys1"' -t IBM.FileSystem Name OpState

参数

资源类

指定内含您要让其联机的资源的资源类名。

资源句柄

指定对应于您要让其联机的资源的资源句柄。 使用 lsrsrc 命令可获取有效资源句柄的列表。 必须使用双引号将资源句柄引起来，例如：

"0x4017 0x0001 0x00000000 0x0069684c 0x0d4715b0 0xe9635f69"

arg=值 ...

指定一个或多个命令参数名称/值对。

参数

指定参数名称。

值

为此参数指定值。 值数据类型必须与参数数据类型的定义匹配。

命令参数是可选的。 如果输入了任何 arg=value 对，那么对于为指定资源类的联机函数定义的每个命令参数，必须有一个 arg=value 对。

使用 startrsrc -l 来获取特定资源类的命令参数名称和数据类型的列表。

标志

--f 资源数据输入文件

指定内含资源参数信息的文件的名称。 该文件的内容与以下内容相似：

PersistentResourceArguments::                            
argument1 = value1                                    
argument2 = value2 

-l

列出命令参数和数据类型。 有些资源管理器会接受传递至联机请求的其他参数。 使用此标志来列出所有已定义的命令参数和命令参数值的数据类型。

--n 节点名称

指定要在其中让资源联机的节点的名称。 node_name 是 NodeNameList 属性值。 如果浮动资源联机后所在的节点当机，那么使用此标志可以让浮动资源在其他节点上联机。

如果要在知道该资源的节点上让该资源联机，请不要指定此标志。

--N { 节点文件 │"-"}

指定从文件或标准输入读取节点名。 使用 -N node_file 来指示节点名在文件中。

• node_file 中的每行包含一个节点名
• 列 1 中的数字符号 (#) 指示该行是注释
• 忽略节点名左侧的所有空白字符
• 忽略节点名右侧的所有字符

使用 -N "-" 从标准输入中读取节点名。

CT_MANAGEMENT_SCOPE 环境变量决定集群的作用域。 如果未设置 CT_MANAGEMENT_SCOPE，那么首先会选择管理域作用域（如果存在），其次选择对等域作用域（如果存在），最后选择本地作用域，直到作用域对于命令有效。 该命令对找到的第一个有效域运行一次。 例如，如果同时存在管理域和对等域，并且未设置 CT_MANAGEMENT_SCOPE，那么该命令适用于管理域。 如果要将此命令应用于对等域，请将 CT_MANAGEMENT_SCOPE 设置为 2。

--s"selection_string"

指定选择字符串。 所有选择字符串必须在双引号或单引号内。 如果选择字符串包含有双引号，可以将整个选择字符串写在单引号内。 例如：

           
-s 'Name == "testing"'                                   
           
-s 'Name ?= "test"'                                      

只有持久属性才可在选择字符串中列出。

-h

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

-T

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

-V

将命令的详细消息（如果有的话）写到标准输出。

环境变量

CT_CONTACT

当 CT_CONTACT 环境变量设置为主机名或 IP 地址时，该命令将联系指定的主机上的资源监视和控制 (RMC) 守护程序。 如果没有设置该环境变量，那么该命令会联系其运行所在的本地系统上的 RMC 守护程序。 由该命令显示或修改的资源类或资源位于建立了连接的系统上。

CT_IP_AUTHENT

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

CT_MANAGEMENT_SCOPE

确定用来与 RMC 守护程序进行会话的管理作用域，以监视和控制资源和资源类。 管理作用域确定了能够监视和控制资源和资源类的可能的目标节点集。 有效值为：

0

指定本地作用域。

1

指定本地作用域。

2

指定对等域作用域。

3

指定管理域作用域。

如果此环境变量未设置，那么使用本地作用域。

标准输出

当指定 -h 标志时，会将此命令用法语句写入标准输出。 当指定了 -V 标志时，会将此命令详细消息 (如果有任何可用消息) 写入标准输出。

标准错误

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

退出状态

0

命令成功运行。

1

RMC 发生错误。

2

命令行接口 (CLI) 脚本发生错误。

3

在命令行上指定了不正确的标志。

4

在命令行上指定了不正确的参数。

5

发生了一个由于不正确的命令行输入而导致的 RMC 错误。

6

找不到与所指定选择字符串匹配的资源。

安全性

您需要 startrsrc 中指定的 resource_class 的写许可权才能运行 startrsrc。 许可权在联系系统的访问控制表 (ACL) 文件中指定。 有关 ACL 文件以及如何修改该文件的信息，请参阅 管理 RSCT 指南。

实现细节

该命令是 "AIX®操作系统 "rsct.core.rmc文件集和 "Linux®、Solaris 和 Windows 操作系统 "rsct.core-3.1.0.0-0."、"平台"、".rpm"软件包的一部分，其中 "平台为 "i386"、"ppc"、"ppc64"、"s390"或 "x86_64。

位置

/opt/rsct/bin/startrsrc

示例