refsensor 命令

在线编辑

用途

刷新定义给资源监视和控制 (RMC) 子系统的传感器或微传感器。

语法

要刷新传感器，请输入：

refsensor [–a | –n host1[,host2...] | –N { node_file | "–" }] [–h ] [ –v | –V ] sensor_name

要刷新微传感器，请输入：

refsensor –m [–a | –n host1[,host2...] | –N { node_file | "–" }] [–h ] [ –v | –V ] sensor_name

描述

refsensor 命令刷新对 RMC 子系统定义的传感器或微传感器资源。 Sensors 和 microsensors 是其属性可以受到监视的 RMC 资源。必须监视传感器和微传感器， refsensor 才能成功运行。

可以通过以下两种方式之一使用 refsensor 来刷新传感器: 运行为传感器资源定义的传感器命令，或者指定特定传感器属性的值。可以使用 refsensor 来刷新微传感器，以查询微传感器的装入模块的值。使用 -m 标志来刷新微传感器。

当 refsensor 命令运行时，它不会影响为运行传感器命令或查询微传感器装入模块而定义 (使用 mksensor) 的时间间隔 (如果有)。即，如果每 60 秒更新一次受监视传感器或微传感器，那么运行 refsensor 不会导致时间间隔计时器重置为 60 秒。

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

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

要使 refsensor 更新特定传感器属性，请指定一个或多个 attr=value 参数。将仅更新指定的属性。不更新其他传感器属性。可指定为参数的传感器属性为：

Float32: 此传感器资源的类型 float32 属性
Float64: 此传感器资源的类型 float64 属性
Int32: 此传感器资源的类型 int32 属性
Int64: 此传感器资源的类型 int64 属性
Quantum: 此传感器资源的类型 quantum 属性
String: 此传感器资源的类型 string 属性
Uint32: 此传感器资源的类型 uint32 属性
Uint64: 此传感器资源的类型 uint64 属性

例如，要更新名为 Sensor1的传感器的 Int32 和 Float32 传感器属性，请输入:

refsensor Sensor1 Int32=45 Float32=7.8

微传感器属性无法单独更新。

标志

–a

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

–m

指定要刷新的资源是一个微传感器资源。

-n host1[，host2...]

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

-N { node_file | "-" }

指定从文件或标准输入读取节点名。

使用 -N node_file 来指示节点名在文件中。

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

在管理域或对等域中使用 -N "–" 从标准输入读取节点名。

–h

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

–v | –V

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

参数

传感器名称: 指定要刷新的传感器的名称。
属性 =值: 指定刷新哪些传感器属性和这些属性将设置为的值。

安全性

要使用此命令刷新传感器，您需要 IBM.Sensor 资源类的写许可权。

要使用此命令刷新微传感器，您需要 IBM.MicroSensor 资源类的写许可权。

许可权在联系系统的访问控制表 (ACL) 文件中指定。请参阅 RSCT: Administration Guide 以获取有关 ALC 文件以及如何修改该文件的详细信息。

退出状态

0: 命令已成功运行。
1: 输入了不正确的标志和参数的组合。
4: 传感器不受监视，因此不能刷新。
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® 和 rsct.core-3.1.0.0-0.platform.rpm package for Linux®， Solaris 和 Windows 的 rsct.core 文件集的一部分，其中 platform 是 i386， ppc， ppc64， s390或 x86_64。

示例

要刷新名为 Sensor1 的传感器以使其定义的传感器命令运行，请输入:
```
refsensor Sensor1
```
要刷新名为 Sensor1 的传感器，以便将 Int32 设置为 50，将 Float32 设置为 123.45，并将 String 设置为 "test input"，请输入:
```
refsensor Sensor1 Int32=50 Float32=123.45 String="test input"
```
要在 /u/joe/common_nodes 文件中列出的节点上刷新名为 Sensor1 的传感器，以便运行 Sensor1定义的传感器命令，请输入:
```
refsensor -N /u/joe/common_nodes Sensor1
```
其中 /u/joe/common_nodes 包含:
```
# common node file
#
node1.myhost.com    main node
node2.myhost.com    backup node
```
要刷新名为 IBM.Sensor1 的微传感器，以便使用定义的微传感器装入模块来查询属性值，请输入:
```
refsensor -m IBM.Sensor1
```

位置

/opt/rsct/bin/refsensor