rmrsrc 命令

用途

除去已定义的资源。

语法

除去一个或多个资源。
  • 在命令行上输入的数据:

    rmrsrc -s "selection_string" [ -a | -N { node_file | "-" }] [-h] [-TV] resource_class

    -rrmrsrc " resource_handle " [-h] [-TV]

  • 在输入文件中预定义:

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

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

要显示命令参数的名称和数据类型:

-lrmrsrc [-h] 资源类

描述

rmrsrc 命令除去或 "undefine" 指定的一个或多个资源实例。 rmrsrc 命令向资源监视和控制 (RMC) 子系统发出请求以取消定义特定资源实例。 该资源的资源管理器除去了该资源。

此命令的第一种格式需要资源类名参数和使用 -s 标志指定的选择字符串。 与指定选择字符串匹配的指定资源类中的所有资源都将被除去。 如果选择字符串标识了多个资源将被除去,这和对选择字符串匹配的每个资源运行该命令相同。

该命令的第二种格式允许指定与具体资源相链接的实际资源句柄作为参数。 预期该命令的这种格式将更可能在脚本内使用。

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

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

标志

-a
指定该命令适用于集群内的所有节点。 集群作用域由 CT_MANAGEMENT_SCOPE 环境变量确定。 如果没有设置此变量,那么首先会选择管理域作用域(若存在),其次选择对等域作用域(若存在),然后选择本地作用域,直到命令作用域有效为止。 该命令对找到的第一个有效域运行一次。 例如,如果同时存在管理域和对等域,那么未设置 CT_MANAGEMENT_SCOPErmrsrc -a 将应用于管理域。 在这种情况下,要应用于对等域,请将 CT_MANAGEMENT_SCOPE 设置为 2
--f 资源数据输入文件
指定包含资源参数信息的文件名。
-l
列出命令参数和数据类型。 某些资源管理器接受 传递至除去请求的额外参数。 使用该标志列出所有已定义的命令参数和命令参数值的数据类型。
--N { 节点文件 "-"}
指定从文件或标准输入读取节点名。 使用 -N node_file 来指示节点名在文件中。
  • node_file 中的每行包含一个节点名
  • 列 1 中的数字符号 (#) 指示该行是注释
  • 忽略节点名之前的任何空白字符
  • 忽略节点名后的任何字符
使用 -N "-" 从标准输入中读取节点名。

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

--r"resource_handle
指定一个资源句柄。 必须使用以下格式指定资源句柄: "0xnnnn 0xnnnn 0xnnnnnnnnnn 0xnnnnnnnnnn 0xnnnnnnnn 0xnnnnnnnnnn"。 其中 n 是任何有效的十六进制数字。 资源句柄唯一地标识了应该除去的特定资源实例。
--s"selection_string"
指定一个选择字符串。 所有选择字符串必须在双引号或单引号内。 如果选择字符串包含有双引号,可以将整个选择字符串写在单引号内。 例如:
-s 'Name == "testing"'
-s 'Name ?= "test"'

只有持久属性才可在选择字符串中列出。 关于如何指定选择字符串的信息,请参阅 RSCT: Administration Guide

-h
将命令的用法语句写到标准输出。
-T
将命令的跟踪消息写到标准错误。 仅供您的软件服务组织使用。
-V
将命令的详细消息写到标准输出。

参数

资源类
指定资源类名称。 与选择字符串标准匹配的该资源类的资源实例将被除去。

安全性

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

退出状态

0
命令已成功运行。
1
RMC 发生错误。
2
命令行接口 (CLI) 脚本发生错误。
3
在命令行上指定了不正确的标志。
4
在命令行上指定了不正确的参数。
5
发生了一个由于不正确的命令行输入而导致的 RMC 错误。
6
没找到匹配选择字符串的资源。

环境变量

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
指定管理域作用域。

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

实现细节

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

标准输出

当指定 -h 标志时,此命令的用法语句将写入标准输出。

命令的输出和所有详细消息写到标准输出。

标准错误

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

示例

  1. 要从资源类IBM®.Host 中删除名称为c175n05的资源,请输入
    rmrsrc -s 'Name == "c175n05"' IBM.Host 
  2. 要除去与资源句柄 0x4017 0x0001 0x00000000 0x0069684c 0x0d52332b3 0xf3f54b45链接的资源,请输入:
    rmrsrc -r "0x4017 0x0001 0x00000000 0x0069684c 0x0d52332b3 0xf3f54b45"
  3. 要使用 /tmp/common/node_file 文件从 IBM.Foo 中除去集群中某些节点的名为 Test1 的资源:
    # common node file
    #
    node1.ibm.com     main node
    node2.ibm.com     main node
    node4.ibm.com     backup node
    node6.ibm.com     backup node
    #
    请输入:
    rmrsrc -s 'Name == "Test1"' -N /tmp/common/node_file IBM.Foo

位置

/opt/rsct/bin/rmrsrc