chcondition 命令
用途
更改某个已定义条件的任何属性。
语法
要更改某个条件的属性：
chcondition [ -r resource_class ] [ -e "event_expression" ] [ -E "rearm_expression" ] [ -d "event_description" ] [ -D "rearm_description" ] [ -b interval[，max_events] [，retention_period] [，max_totalsize]] [-m l | m | p ] [-n node_name1[,node_name2...]] [ --qnotoggle | --qtoggle ] [-s "selection_string"] [-S c | w | i ] [ -g 0 | 1 | 2 ] [-h] [-TV] 条件[:node_name]
要对条件重命名：
chcondition-c 新条件 [-h][-TV] 条件 [:节点名称］
要锁定某个条件或将某个条件解锁：
chcondition { -L | -U } [-h] [-TV] 条件[:node_name]
描述
chcondition 命令将定义的条件的属性更改为提供的值。 如果使用 -c 标志更改了条件的名称，那么任何条件/响应关联都保持不变。
如果系统软件正确工作需要满足某个特定的条件，那么该条件可能被锁定。 不能修改或除去锁定的条件，直到将它解锁为止。 如果您在 chcondition 命令上指定的条件已锁定，那么不会对其进行修改; 而是会生成错误，通知您该条件已锁定。 要解锁条件，可以使用 -U 标志。 但是，由于条件通常是被锁定的（因为它是系统软件正确工作的基本因素），您应该在解锁它之前进行提醒。 要锁定条件以使其无法修改，请使用 -L 标志。
如果系统上安装了 Cluster Systems Management (CSM)，可以将 CSM 定义的节点组用作节点名值来引用多个节点。 有关使用 CSM 节点组和使用 CSM nodegrp 命令的信息，请参阅 CSM: Administration Guide 和 CSM: Command and Technical Reference 。
标志
- --b interval[,max_events][,retention_period][,max_totalize］
- 更改一个或多个批处理相关的属性。 使用逗号来分隔属性值。 不要在值之间或逗号之间插入任何空格。
interval 指定对所指示时间间隔内的事件一起进行批处理。 批处理会继续执行，直到时间间隔内不再生成事件为止。 使用时间间隔 0 来关闭批处理。
max_events 指定要对事件一起进行批处理，直到生成 max_events 个事件为止。 如果在时间间隔过期之前达到 max_events 个事件，那么时间间隔会重新开始。
retention_period 以小时为单位指定保留期。 会在指定为保留期的时间内保存批处理事件文件。 一旦达到此时间，就会自动删除该文件。
max_totalsize 以兆字节 (MB) 为单位指定批处理事件文件的总大小。 保存批处理的事件文件，直到达到此大小为止。 达到此大小后，会自动删除该文件。
不能指定 max_events、retention_period 和 max_totalsize，除非时间间隔大于 0。 如果 interval 大于 0 且 max_events 等于 0，那么不使用最大事件数。
如果同时指定 retention_period 和 max_totalsize，那么会保存批处理事件文件，直至达到指定的时间或大小为止（以先到为准）。
如果要更改一个、两个或三个属性值，那么必须为您要更改的值前面的任何属性指定一个有效值或一个空字段。 不必为您要更改的值后面的属性指定任何值。 例如，如果您仅需要更改保留期，那么还需要指定 interval 和 max_events 的值。 如果不需要更改属性，那么可以提供空字段。 例如，要将保留期更改为36小时而不更改 interval 和 max_events的值，请输入:chcondition -b ,,36 - --c 新条件
- 为条件指定新名称。 new_condition（用于替换当前名称）是标识该条件的字符串。 如果 new_condition 包含一个或多个空格，必须将其用引号引起来。 名称不能为空、都由空格构成或包含嵌入式双引号。
- --e"事件表达式"
- 指定一个事件表达式，用于确定事件的发生时间。 事件表达式由 resource_class的动态属性 或持久属性 ，数学比较符号 (例如 或 <) 和常量组成。 如果表达式评估为 TRUE，那么生成一个事件。
- --E"rearm_expression"
- 指定一个重整表达式。 当 event_expression 求值为 TRUE 并且生成事件后，重整表达式将确定 event_expression 的监视再次开始的时间。 通常，对于同一事件评估，重整表达式会防止多个事件生成。 重整表达式由 resource_class的动态属性，数学比较符号 (例如>) 和常量组成。
- --d"事件描述"
- 描述事件表达式。
- --D"重新武装说明
- 描述重整表达式。
- --g 0 | 1 | 2
- 指定用来对条件的审计记录进行控制的详细程度级别。 详细程度的级别为：
- 0
- 启用审计记录。 ERRM 会将所有活动写到审计日志。 这是缺省值。
- 1
- 仅启用错误记录。 ERRM 仅将错误写到审计日志。
- 2
- 禁用审计记录。 ERRM 不会将任何记录写到审计日志。
- -L
- 锁定某个条件而使其无法修改或删除。 使用 -L 标志锁定某个条件时，此命令不能执行其他操作。
- -m l │ m │ p
- 指定条件应用的管理作用域。 管理作用域确定如何注册条件和如何评估选择字符串。 作用域可以与当前的配置不同，但是直到选择相应的作用域，才可以启动监视。 有效值为：
- l
- 指定本地作用域。 条件仅应用于本地节点（其中定义了条件的节点）。 在评估选择字符串时，仅使用本地节点。
- -L
- 锁定某个条件而使其无法修改或删除。 当使用 -L 标志锁定条件时，此命令不能执行其他操作。
- m
- 指定管理域作用域。 条件应用于管理域，而定义了条件的节点属于此管理域。 管理域中的所有节点都用在评估选择字符串中。 已定义条件的节点必须是管理服务器，以便使用管理域作用域。
- p
- 指定对等域作用域。 此条件应用于对等域，而定义了条件的节点属于该对等域。 对等域中的所有节点都用在评估选择字符串中。
- --n 节点名称1[，节点名称2......]
- 指定可以监视条件的节点的主机名（或者用逗号分割的多个节点的主机名列表）。 也可以指定节点组名，这被扩展到节点名列表中。
如果要使用 -n 标志，那么必须指定值为 m 或 p 的 -m 标志。 通过这种方式，您可以在指定节点上（而非整个域上）监视条件。
当前配置中的主机名无需联机，但是一旦该条件受监视，如果节点不存在，该条件将出错。 该条件将处于错误状态，直到节点有效为止。
- --qnotoggle
- 指定监视在事件表达式与重整表达式之间不切换，但是始终对事件表达式求值。
- --qtoggle
- 指定监视在事件表达式与重整表达式之间切换。
- --r 资源类别
- 指定了该条件将监视哪个资源类。 lsrsrcdef 命令可用于列出资源类名。
- --s"selection_string"
- 指定应用于所有 resource_class 属性的选择字符串以确定 event_expression 应该监视哪些资源。 缺省值为监视 resource_class 中的所有资源。 用于评估选择字符串的资源由管理作用域 ( -m 标志) 确定。 必须用单引号或双引号将选择字符串括起来。 关于如何指定选择字符串的信息，请参阅 RSCT: Administration Guide。
- -S c │ w │ i
- 指定事件的严重性：
- c
- 严重
- w
- 警告
- i
- 信息性（缺省值）
- -U
- 解锁某个条件而使其可以修改或删除。 如果某个条件被锁定，这通常是因为它是系统软件正确运行的基本因素。 由于此原因，您在解锁它之前应小心谨慎。 当使用 -U 标志解锁条件时，此命令不能执行其他操作。
- -h
- 将命令的用法语句写到标准输出。
- -T
- 将命令的跟踪消息写到标准错误。 仅供您的软件服务组织使用。
- -V
- 将命令的详细消息写到标准输出。
参数
- 条件
- 指定在 node_name 上定义的现有条件名称。
- 节点名
- 指定在其中定义了条件的域中的节点。 如果未指定 node_name，那么使用本地节点。 node_name 是由 CT_MANAGEMENT_SCOPE 环境变量所确定的作用域内的节点。
安全性
chcondition 命令的用户需要对定义了条件的节点上的 IBM.Condition 资源类具有写许可权。 许可权在联系系统的访问控制表 (ACL) 文件中指定。 请参阅 RSCT: Administration Guide 以获取有关 ALC 文件以及如何修改该文件的详细信息。
退出状态
- 0
- 命令成功运行。
- 1
- RMC 发生错误。
- 2
- 命令行界面脚本发生错误。
- 3
- 命令行中输入错误标志。
- 4
- 命令行中输入错误参数。
- 5
- 不正确的命令行输入导致出错。
环境变量
- CT_CONTACT
- 确定与资源监视和控制 (RMC) 守护程序发生会话的系统。 当 CT_CONTACT 设置为主机名或 IP 地址时，该命令会与指定主机上的 RMC 守护程序联系。 如果未设置 CT_CONTACT，那么该命令会与运行它的本地系统的 RMC 守护程序联系。 RMC 守护程序会话的目标和管理作用域确定了处理的资源类或资源。
- CT_IP_AUTHENT
- 如果存在 CT_IP_AUTHENT 环境变量，那么 RMC 守护程序将使用基于 IP 的网络认证，与 CT_CONTACT 环境变量中的 IP 地址所指定系统上的 RMC 守护程序联系。 仅当 CT_CONTACT 设为 IP 地址时，CT_IP_AUTHENT 才有意义；它不依赖于域名系统（DNS）服务。
- CT_MANAGEMENT_SCOPE
- 确定处理事件响应资源管理器（ERRM）的资源时用于与 RMC 守护程序的会话的管理作用域。 管理作用域确定可以处理资源的可能目标节点集。 有效值为：
- 0
- 指定本地作用域。
- 1
- 指定本地作用域。
- 2
- 指定对等域作用域。
- 3
- 指定管理域作用域。
如果此环境变量未设置，那么使用本地作用域。
实现细节
该命令是AIX Reliable Scalable Cluster Technology（RSCT）文件集的一部分。
标准输出
当指定 -h 标志时，此命令的用法语句将写入标准输出。 所有详细消息都写到标准输出。
标准错误
所有跟踪消息都写到标准错误。
示例
- 要将条件名从“FileSystem space used”更改为“Watch FileSystem
space”，运行此命令：
chcondition -c "Watch FileSystem space" "FileSystem space used" - 要为名为“tmp space used”的条件更改重整表达式和重整描述，运行此命令：
chcondition -E "PercentTotUsed < 80" \ -D "Start monitoring tmp again after it is less than 80 percent full" \ "tmp space used" - 要禁用称为“使用的文件系统空间”的条件的审计日志信息的记录，请运行此命令：
chcondition -g 2 "File System space used" - 要将称为“使用的文件系统空间”的条件的批处理事件文件的最大大小更改为 100 MB，请运行此命令：
chcondition -b ,,,100 "File System space used" - 要禁用称为“使用的文件系统空间”的条件的批处理功能，请运行此命令：
如果先前指定了 max_event、retention_period 和 max_totalsize，那么此命令会重置这些值。 当您重新启用批处理功能时，必须指定这些属性的值（如果需要）。chcondition -b 0 "File System space used"
- 要将管理服务器上名为“FileSystem space used”的条件更改为检查大于 95% 的空间使用情况，运行此命令：
chcondition -e "PercentTotUsed > 95" "FileSystem space used" - 要更改 "NodeB上名称为"NodeB FileSystemspace used "的条件，以检查空间使用率是否大于 95%，请运行此命令：
chcondition -e "PercentTotUsed > 95" \ "NodeB FileSystem space used":NodeB
- 要更改 NodeA 上定义的名为 " "FileSystem space used "的条件，以检查空间使用率是否大于 95%，请运行此命令：
chcondition -e "PercentTotUsed > 95" \ "FileSystem space used":NodeA
位置
- /opt/rsct/bin/chcondition