stoprsrc 命令

用途

停止资源(即,让该资源脱机)。

语法

要使用在命令行上输入的数据来停止一个或多个资源,请输入:

stoprsrc -s "selection_string" [ -N { node_file | "-" }] [-h] [-TV] resource_class [arg=value ...]

stoprsrc -r [-h] [-TV] resource_handle [arg=value ...]

要使用在输入文件中预定义的命令参数来停止一个或多个资源,请输入:

stoprsrc -f resource_data_input_file -s "selection_string" [ -N { node_file | "-" }] [-h] [-TV] resource_class

stoprsrc -f 资源数据输入文件 -r [-h][-TV] 资源句柄

要列出命令参数的名称和数据类型,请输入:

stoprsrc -l [-h] 资源类别

描述

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

要停止一个或多个资源,请使用 -s 标志 使所有与指定选择字符串匹配的资源脱机。

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

要停止一个特定资源,请使用 -r 标志 来指定表示该特定资源的资源句柄。

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

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

此命令成功完成并不保证资源已脱机,只能保证资源管理器成功收到让此资源脱机的请求。 监视资源动态属性 OpState 以确定资源何时脱机。 通过指定 OpState 属性来注册资源的事件,以了解资源何时处于脱机状态。 或者,间歇地运行 lsrsrc 命令,直到您看到资源处于脱机状态 ( OpState 的值为 2)。 例如:
      
lsrsrc -s 'Name == "/filesys1"' -t IBM.FileSystem Name OpState

参数

资源类
指定内含您要让其脱机的资源的资源类名。
资源句柄
指定对应于您要让其脱机的资源的资源句柄。 使用 lsrsrc 命令可获取有效资源句柄的列表。 必须使用双引号将资源句柄引起来,例如:
"0x4017 0x0001 0x00000000 0x0069684c 0x0d4715b0 0xe9635f69"
arg=值 ...
指定一个或多个命令参数名称/值对。
参数
指定参数名称。
为此参数指定值。 值数据类型必须与参数数据类型的定义匹配。
命令参数是可选的。 如果输入了任何 arg=value 对,那么对于为指定资源类的脱机函数定义的每个命令参数,应该有一个 arg=value 对。

使用 stoprsrc -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

--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
找不到与所指定选择字符串匹配的资源。

安全性

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

实现细节

此命令是 AIX® 操作系统的 rsct.core.rmc 文件集的一部分。

位置

/opt/rsct/bin/stoprsrc

示例

假设您有一个名为 foo 的对等域,其中包含三个已定义的节点: nodeAnodeBnodeCnodeA 有两个以太网卡: ent0ent1
  1. 假设 nodeA 处于联机状态, ent0 (在 nodeA上) 也处于联机状态。 要使 ent0nodeA上脱机,请在 nodeA上运行以下命令:
    stoprsrc -s 'Name == "ent0"' IBM.EthernetDevice
  2. 假设 nodeAnodeB 处于联机状态, ent0 (在 nodeA上) 也处于联机状态,并且您当前已登录到 nodeB。 要使 ent0nodeA上脱机,请在 nodeB上运行以下命令:
    stoprsrc -s 'NodeName == "A" AND Name == "ent0"' IBM.EthernetDevice
  3. 假设 nodeAnodeB 处于联机状态,并且文件系统 /filesys1 已定义并安装在 nodeB上。 要使 /filesys1nodeB上脱机,请在 nodeA上运行以下命令:
    stoprsrc -s 'NodeName == "B" AND Name == "/filesys1"' IBM.FileSystem
  4. 假设 nodeAent0 的资源句柄为:
    0x406b 0x0001 0x00000000 0x0069564c 0x0dc1f272 0xb9de145e   
    要使 ent0nodeA上脱机,请在 nodeA上运行以下命令:
    stoprsrc -r "0x406b 0x0001 0x00000000 0x0069564c 0x0dc1f272 0xb9de145e"