resetrsrc 命令

用途

重置资源，即，强制使该资源转为脱机状态。

描述

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

要重置一个或多个资源，请使用 -s 标志强制所有与指定选择字符串匹配的资源脱机。 要重置一个特定资源，请使用 -r 标志来指定表示该特定资源的资源句柄。

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

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

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

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

参数

资源类别

指定内含您要强制其脱机的资源的资源类名。

资源句柄

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

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

阿尔格=值 ...

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

阿尔格

指定参数名称。

值

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

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

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

标志

-f 资源数据输入文件

指定内含资源参数信息的文件的名称。 将显示文件的以下内容：

PersistentResourceArguments::                            
argument1 = value1                                    
argument2 = value2 

-l

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

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

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

• node_file 中的每行包含一个节点名
• 列 1 中的数字符号 (#) 指示该行是注释
• 忽略节点名之前的任何空白字符
• 忽略节点名后的任何字符

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

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

-r

强制与指定资源句柄匹配的特定资源脱机。

-s “ 选择字符串 ”

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

           
-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_IP_AUTHENT 只有在 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

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

安全性

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

实现细节

此命令是针对 AIX® 和 rsct.core-3.1.0.0-0.platform.rpm package for Linux®， Solaris 和 Windows 的 rsct.core.rmc 文件集的一部分，其中 platform 是 i386， ppc， ppc64， s390或 x86_64。

位置

/opt/rsct/bin/resetrsrc

示例