chsensor 命令

用途

更改资源监视和控制（RMC）传感器的属性。

语法

chsensor [-m[-i 秒] [ -a | -n host1 [ , host2 , ...] | -N { node_file | "-"}] [-h] [ -v | -V ] sensor_name attr1=value1 [attr2=value2 ...]

描述

chsensor 命令更改资源监视和控制 (RMC) 传感器的属性。 使用 sensor_name 参数可指定您将更改哪个传感器。

chsensor 命令可在任何节点上运行。 如果您希望 chsensor 在域中的所有节点上运行，请使用 -a 标志。 如果您希望 chsensor 在域中的部分节点上运行，请使用 -n 标志。 可以使用 -N node_file 标志来指示节点名在文件中，而不是使用 -n 标志指定多个节点名。 使用 -N "–" 从标准输入读取节点名。

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

标志

-a

更改域中所有节点上匹配指定名称的传感器。 CT_MANAGEMENT_SCOPE 环境变量确定集群作用域。 如果未设置 CT_MANAGEMENT_SCOPE，首先选择管理域作用域（如果有），然后选择对等域作用域（如果有），再选择本地作用域，直到作用域对该命令有效为止。 该命令对找到的第一个有效域运行一次。 例如，如果管理域和对等域都存在，那么未设置 CT_MANAGEMENT_SCOPE 的 chsensor -a 将在管理域中运行。 在这种情况下，要在对等域中运行，请将 CT_MANAGEMENT_SCOPE 设置为 2。

--i 秒

指定运行 sensor 命令来更新传感器属性的值的时间间隔。 seconds 是整数值，必须大于或等于 10。 仅当传感器资源受监视时才在指定的时间间隔运行该 sensor 命令。 如果时间间隔设置为 0，那么传感器命令将不会自动运行。 使用 refsensor 命令与时间间隔更新无关。

-m

指定要更改的资源是微传感器资源。

--n host1[,host2...]

指定应该在其上更改传感器的节点。 缺省情况下，在本地节点上更改传感器。 此标志只适用于管理域或对等域。

--N {node_file|"-"}

指定文件或标准输入，它们用于列示必须在其上除去传感器的节点。 此标志仅在 Cluster Systems Management (CSM) 或对等域集群中适用。

-h

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

-v │ -V

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

参数

传感器名称

指定要更改的传感器名称。

属性 1=值 1 [属性 2=值 2 ...]

指定一个或多个传感器或微传感器属性及其新值。

可以更改这些传感器属性的值：

姓名

指定传感器的新名称。 如果新名称是包含空格或特殊字符的字符串，那么必须将其用引号引起来。

ControlFlags

指定该传感器是否需要特殊的处理。 可以指定这些值的任意组合：

0

表示无需特殊处理。 这是缺省情况。

该传感器以为 sensor_name 定义的时间间隔运行。 sensor 命令不在监视开始时或运行 lssensor 命令时运行。 传感器命令是传感器资源管理器运行的一个命令或脚本，用以设置和更新传感器的属性值。

1

指定 sensor 命令在监视开始时运行。 该 sensor 命令还以为 sensor_name 定义的时间间隔运行。 该 sensor 命令不在 lssensor 命令运行时运行。

指定不建议此值，除非您希望迅速运行 sensor 命令。 如果传感器命令不马上运行，那么可能会阻塞对传感器资源管理器发出的其他请求。 不会处理这些请求，直到 sensor 命令结束运行。

2

指示 SavedData 字段中的命令输出不会永久保存到 SavedData 持久资源属性。 如果未指定此值，那么只要命令的标准输出包含以下行，传感器资源管理器就会更新注册表的资源表中的数据: SavedData="any-string"。

3

指示值 1 和 2 的组合

4

指示监视停止后传感器资源管理器会运行该命令。

5

指示值 1 和 4的组合。

6

指示值 2 和 4的组合。

7

指示值 1， 2和 4的组合。

8

指示监视停止后传感器资源管理器会重置该动态属性值。

UserName

指定使用其特权运行命令的用户的名称。 应已在系统上定义此用户。

描述

提供对传感器及其监视的对象的描述。

ErrorExitValue

指定会将哪些退出值解释为错误，如下所示：

0

没有任何退出值被解释为错误。

1

0 以外的退出值将解释为错误。

2

0 的退出值解释为错误。

如果退出值指示此属性指定的错误，那么不会更新任何动态属性值 ( ExitValue除外)。

您可以更改这些微传感器属性的值：

姓名

指定微传感器的新名称。 如果新名称是包含空格或特殊字符的字符串，那么必须将其用引号引起来。

描述

提供对微传感器及其监视对象的描述。

安全性

用户需要 IBM.Sensor 资源类的写许可权才能运行 chsensor。 许可权在联系系统的访问控制表 (ACL) 文件中指定。 请参阅 RSCT: Administration Guide 以获取有关 ALC 文件以及如何修改该文件的详细信息。

退出状态

0

命令已成功运行。

1

输入了不正确的标志和参数的组合。

6

未找到传感器资源。

n

基于 RMC 子系统可能返回的其他错误。

环境变量

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）文件集的一部分。

示例

位置

/opt/rsct/bin/chsensor