[AIX Solaris HP-UX Linux Windows][z/OS]

Intelligent Management:运行状况策略管理任务

可使用以下管理任务创建、删除和管理运行状况策略。

createHealthPolicy 命令

使用 createHealthPolicy 命令创建新的运行状况策略。
表 1. createHealthPolicy 命令参数
参数 描述
name(必需) 为运行状况策略指定在单元中唯一的名称。
description 指定运行状况策略的描述。
reactionMode 指定对运行状况策略执行操作前是否创建运行时任务,或者指定操作是否为自动。值可以为 SUPERVISEAUTOMATIC
表 2. addCondition 步骤参数
参数 描述
type(必需) 指定条件类型。值可以为 CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME, EXCESSIVE_REQUEST_TIMEOUTSTORM_DRAINGC_PERCENTAGE。每个值都具有必须指定的不同参数。
expression 如果使用的是定制条件,那么指定要计算的子表达式。
params
  • AGE
    • maxAge:指定最大时效。
    • ageUnits:指定 age 参数的单位类型。值可以为 HOURSMINUTES。缺省值为 HOURS
  • WORKLOAD
    • totalRequests:指定重新启动成员前对服务的总请求数。此数目必须大于或等于 1000
  • MEMORY_LEAK
    • level:指定内存泄漏的检测级别。值可以为 FASTNORMALCONSERVATIVE。缺省值为 FAST
  • EXCESSIVE_MEMORY
    • timeOverThreshold:指定超出内存条件的违规时间段。缺省值是 1 MINUTE
    • timeUnits:指定 timeOverThreshold 值的单位。值可以为 MINUTESSECONDS。缺省值为 MINUTES
    • memoryUsed:指定一个百分比,它表示用于 JVM 进程的最大 Java™ 虚拟机 (JVM) 堆大小。此值的范围介于 199
  • EXCESSIVE_RESPONSE_TIME
    • responseTime:指定被视为超出的平均响应时间。当平均值达到此值时,成员将重新启动。
    • responseTimeUnits:指定响应时间的时间单位。值可以为 MINUTES、SECONDSMILLISECONDS
  • EXCESSIVE_REQUEST_TIMEOUT
    • timeoutPercent:指定超时请求百分比的阈值,超过此阈值将导致违反条件。此值的范围介于 199
  • STORM_DRAIN
    • level:指定检测级别。值可以为 NORMALCONSERVATIVENORMAL 不太精确,但可以快速地检测到堵塞条件。CONSERVATIVE 最精确,但是将花费较长时间才能检测到堵塞条件。
  • GC_PERCENTAGE
    • garbageCollectionPercent:在垃圾回收中花费的时间百分比的阈值。此值可以从 199。缺省值为 10
    • samplingPeriod:用于收集垃圾回收数据的采样时间段。在执行纠正行动之前,在采样时间段中在垃圾回收中花费的总时间量必须高于阈值。此值可以从 1 分钟到 24 小时。缺省值为 2 分钟。
    • samplingUnits:指定 samplingPeriod 参数的时间单位。值可以为 MINUTESHOURS。缺省值为 MINUTES
    • 避免故障 避免故障: garbageCollectionPercentsamplingPeriod 参数是必需参数,必须进行指定以执行此命令。gotcha
表 3. addAction 步骤参数.

以表格式使用 addAction 步骤参数。借助表格式,可以在不带参数名的情况下按顺序指定参数。

参数 描述
type(必需) 指定操作类型。值可以为 CUSTOM、HEAPDUMP、THREADDUMP、RESTART_SERVER、SET_MAINT_MODE、MAINT_MODE_BREAKMAINT_MODE_STOP
stepNum(必需) 指定执行操作的顺序。步骤 1 先完成,以此类推。
action 指定定制操作的名称。使用 createHealthAction 命令来创建定制操作。此参数仅对于定制操作为必需。
node 指定要对其执行操作的节点。此参数仅对于定制操作为必需。有效的选项是节点名称或空字符串 ""。

server 指定要对其执行操作的服务器。

此参数仅对于定制操作为必需。有效的选项是服务器名称或以下某个字符串:“病态服务器”或“病态服务器的 Node Agent”。如果使用这两个字符串中的任何一个,那么有效的节点值为空字符串 ""。

表 4. addMember 步骤参数.

以表格式使用 addMember 步骤参数。借助表格式,可以在不带参数名的情况下按顺序指定参数。

参数 描述
type(必需) 指定成员的类型。值可以为 CELL、CLUSTER、DYNAMIC_CLUSTER、SERVERODR
name(必需) 指定成员的名称。
node 指定节点的名称。如果选择了 SERVER 类型,那么节点名是必需的。

createHealthPolicy 命令示例

交互方式示例用法:

  • 使用 Jacl:
    $AdminTask createHealthPolicy {-interactive}
  • 使用 Jython:
    AdminTask.createHealthPolicy ('[-interactive]')

批处理方式示例用法:

以下命令使用其中一个预定义的运行状况条件来创建运行状况策略:

$AdminTask createHealthPolicy { -name myHealthPolicy -description "My Health Policy" -reactionMode SUPERVISE 
-addCondition { -type AGE -params {{maxAge 12} {ageUnits HOURS}} } -addAction {{HEAPDUMP 1}{CUSTOM 2 myAction 
myNode myServer} } -addMember {{SERVER myServer1 myNode1}{SERVER myServer2 mynode2}}

以下命令使用定制条件来创建运行状况策略:

$AdminTask createHealthPolicy { -name myHealthPolicy -description "My Health Policy" -reactionMode SUPERVISE 
-addCondition { -type CUSTOM -expression "ODRServerMetric_FromServerStart$errors  > 100L"  } 
-addAction {{HEAPDUMP 1}{CUSTOM 2 myAction myNode myServer} } -addMember {{SERVER myServer1 myNode1}{SERVER myServer2 mynode2}} 
使用引号将定制条件的表达式括起来。

modifyHealthPolicy 命令

使用 modifyHealthPolicy 命令可更改现有运行状况策略。
表 5. 初始参数
参数 描述
name(必需) 指定要更改的运行状况策略的名称。
reactionMode 指定对运行状况策略执行操作前是否创建运行时任务,或者指定操作是否为自动。值可以为 SUPERVISEAUTOMATIC
表 6. modifyCondition 步骤参数
参数 描述
type 指定条件类型。值可以为 CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME, EXCESSIVE_REQUEST_TIMEOUTSTORM_DRAINGC_PERCENTAGE。每个值都具有必须指定的不同参数。
expression 如果使用的是定制条件,那么指定要计算的子表达式。
params
  • AGE
    • maxAge:指定最大时效。
    • ageUnits:指定 age 参数的单位类型。值可以为 HOURSMINUTES。缺省值为 HOURS
  • WORKLOAD
    • totalRequests:指定重新启动成员前对服务的总请求数。此数目必须大于或等于 1000
  • MEMORY_LEAK
    • level:指定内存泄漏的检测级别。值可以为 FASTNORMALCONSERVATIVE。缺省值为 FAST
  • EXCESSIVE_MEMORY
    • timeOverThreshold:指定超出内存条件的违规时间段。缺省值是 1 MINUTE
    • timeUnits:指定 timeOverThreshold 值的单位。值可以为 MINUTESSECONDS。缺省值为 MINUTES
    • memoryUsed:指定一个百分比,它表示用于 JVM 进程的最大 Java 虚拟机 (JVM) 堆大小。此值的范围介于 199
  • EXCESSIVE_RESPONSE_TIME
    • responseTime:指定被视为超出的平均响应时间。当平均值达到此值时,成员将重新启动。
    • responseTimeUnits:指定响应时间的时间单位。值可以为 MINUTES、SECONDSMILLISECONDS
  • EXCESSIVE_REQUEST_TIMEOUT
    • timeoutPercent:指定超时请求百分比的阈值,超过此阈值将导致违反条件。此值的范围介于 199
  • STORM_DRAIN
    • level:指定检测级别。值可以为 NORMALCONSERVATIVENORMAL 不太精确,但可以快速地检测到堵塞条件。CONSERVATIVE 最精确,但是将花费较长时间才能检测到堵塞条件。
  • GC_PERCENTAGE
    • garbageCollectionPercent:在垃圾回收中花费的时间百分比的阈值。此值可以从 199。缺省值为 10
    • samplingPeriod:用于收集垃圾回收数据的采样时间段。在执行纠正行动之前,在采样时间段中在垃圾回收中花费的总时间量必须高于阈值。此值可以从 1 分钟到 24 小时。缺省值为 2 分钟。
    • samplingUnits:指定 samplingPeriod 参数的时间单位。值可以为 MINUTESHOURS。缺省值为 MINUTES
    • 避免故障 避免故障: garbageCollectionPercentsamplingPeriod 参数是必需参数,必须进行指定以执行此命令。gotcha
表 7. removeAction 步骤参数
参数 描述
名称 指定要移除的运行状况操作的名称。此 name 参数仅用于定制操作。
type(必需) 指定操作类型。值可以为 CUSTOM、HEAPDUMP、THREADDUMP、RESTART_SERVER、SET_MAINT_MODE、MAINT_MODE_BREAKMAINT_MODE_STOP
表 8. addAction 步骤参数
参数 描述
type(必需) 指定操作类型。值可以为 CUSTOM、HEAPDUMP、THREADDUMP、RESTART_SERVER、SET_MAINT_MODE、MAINT_MODE_BREAKMAINT_MODE_STOP
action 指定运行状况操作的名称。使用 createHealthAction 命令来创建定制操作。此参数仅对于定制操作为必需。
node 指定要对其执行操作的节点。此参数仅对于定制操作为必需。有效的选项是节点名称或空字符串 ""。
server 指定要对其执行操作的服务器。

此参数仅对于定制操作为必需。有效的选项是服务器名称或以下某个字符串:“病态服务器”或“病态服务器的 Node Agent”。如果使用这两个字符串中的任何一个,那么有效的节点值为空字符串 ""。

stepNum(必需) 指定执行操作的顺序。步骤 1 先完成,以此类推。
表 9. orderAction 步骤参数
参数 描述
name 指定运行状况操作的名称。此 name 参数仅用于定制操作。
type 指定操作类型。值可以为 CUSTOM、HEAPDUMP、THREADDUMP、RESTART_SERVER、SET_MAINT_MODE、MAINT_MODE_BREAKMAINT_MODE_STOP
stepNum(必需) 指定执行操作的顺序。步骤 1 先完成,以此类推。
表 10. addMember 步骤参数
参数 描述
type(必需) 指定成员的类型。值可以为 CELL、CLUSTER、DYNAMIC_CLUSTER、SERVERODR
name(必需) 指定成员的名称。
node 指定节点的名称。如果选择了 SERVER 类型,那么节点名是必需的。

modifyHealthPolicy 命令示例

交互方式示例用法:

  • 使用 Jacl:
    $AdminTask modifyHealthPolicy {-interactive}
  • 使用 Jython:
    AdminTask.modifyHealthPolicy ('[-interactive]')

批处理方式示例用法:

$AdminTask modifyHealthPolicy { -name myHealthPolicy -removeAction { -type HEAPDUMP } }

deleteHealthPolicy 命令

使用 deleteHealthPolicy 命令可移除指定的运行状况策略。
表 11. deleteHealthPolicy 命令参数
参数 描述
name(必需) 指定要删除的运行状况策略的名称。

deleteHealthPolicy 命令示例

批处理方式示例用法:

  • 使用 Jacl:
    $AdminTask deleteHealthPolicy {-name MyHealthPolicy}
  • 使用 Jython:
    AdminTask.deleteHealthPolicy('MyHealthPolicy')

交互方式示例用法:

  • 使用 Jacl:
    $AdminTask deleteHealthPolicy {-interactive}
  • 使用 Jython:
    AdminTask.deleteHealthPolicy ('[-interactive]')

listHealthPolicies 命令

使用 listHealthPolicies 命令可列示单元中的每个已配置运行状况策略。

listHealthPolicies 命令示例

  • 使用 Jacl:
    $AdminTask listHealthPolicies
  • 使用 Jython:
    AdminTask.listHealthPolicies

createHealthAction 命令

使用 createHealthAction 命令可创建一个您在定义运行状况策略时可以使用的新运行状况操作。
表 12. createHealthAction 命令参数
参数 描述
name(必需) 指定运行状况操作的名称。
可以创建 Java 操作或任何其他可执行文件类型的操作。
表 13. 非 Java 步骤参数
参数 描述
executable 指定可执行文件的路径。如果指定了非 Java 步骤参数,那么此参数是必需的。
executableArgs 指定参数的字符串数组以传递至可执行文件。
osNames 指定以逗号分隔的操作系统名称列表。指定 null 以便将该操作应用于每个操作系统。有效的操作系统名称包括:windowsunixzos
workingDir 指定文件系统中调用命令的位置。如果指定了非 Java 步骤参数,那么此参数是必需的。
usernameVar 指定用户名的变量。
userNameVal 指定用户名变量的值。
passwordVar 指定密码的变量。
passwordVal 指定密码变量的值。
表 14. Java 步骤参数
参数 描述
javaDir 指定 Java 可执行文件的位置,例如,${JAVA_HOME}。可以指定变量或路径。
executableTargetType 指定用于 Java 可执行文件的文件类型。值可以为 EXECUTABLE_JARJAVA_CLASS
executable 指定可执行文件的路径。如果指定了 Java 步骤参数,那么此参数是必需的。
exectuableArgs 指定参数的字符串数组以传递至可执行文件。
osNames 指定以逗号分隔的操作系统名称列表。指定 null 以便将该操作应用于每个操作系统。有效的操作系统名称包括:windowsunixzos
pidVarName 指定 Java 进程标识变量名称。
workingDir 指定文件系统中调用命令的位置。如果指定了 Java 步骤参数,那么此参数是必需的。
usernameVar 指定用户名的变量。
usernameVal 指定用户名变量的值。
passwordVar 指定密码的变量。
passwordVal 指定密码变量的值。

createHealthAction 命令示例

批处理方式示例用法:

  • 使用 Jacl:
    $AdminTask createHealthAction { -name myAction -java { -javaDir c:\java\bin -executableTargetType EXECUTABLE_JAR
     -executable test.jar -executableArgs "{arg1}{arg2a arg2b}" -osNames "windows, unix" -pidVarName pvn 
    -workingDir c:\workingDir } }

交互方式示例用法:

  • 使用 Jacl:
    $AdminTask createHealthAction {-interactive}
  • 使用 Jython:
    AdminTask.createHealthAction('[-interactive]')

modifyHealthAction 命令

使用 modifyHealthAction 命令可修改现有运行状况操作。
表 15. modifyHealthAction 命令参数
参数 描述
name(必需) 指定要修改的运行状况操作的名称。
表 16. 非 Java 步骤参数
参数 描述
executable 指定可执行文件的路径。
executableArgs 指定参数的字符串数组以传递至可执行文件。
workingDir 指定文件系统中调用命令的位置。
usernameVar 指定用户名的变量。
usernameVal 指定用户名变量的值。
passwordVar 指定密码的变量。
passwordVal 指定密码变量的值。
表 17. Java 步骤参数
参数 描述
javaDir 指定 Java 可执行文件的位置,例如,${JAVA_HOME}。可以指定变量或路径。
executableTargetType 指定用于 Java 可执行文件的文件类型。值可以为 EXECUTABLE_JARJAVA_CLASS
executable 指定可执行文件的路径。
executableArgs 指定参数的字符串数组以传递至可执行文件。
pidVarName 指定 Java 进程标识变量名称。
usernameVar 指定用户名的变量。
usernameVal 指定用户名变量的值。
passwordVar 指定密码的变量。
passwordVal 指定密码变量的值。
workingDir 指定文件系统中调用命令的位置。

modifyHealthAction 命令示例

批处理方式示例用法:

$AdminTask modifyHealthAction { -name myAction -java { -javaDir c:\java\bin -executableTargetType EXECUTABLE_JAR
 -executable test.jar -executableArgs "{arg1}{arg2a arg2b}" -pidVarName pvn -workingDir c:\workingDir } }

交互方式示例用法:

  • 使用 Jacl:
    $AdminTask modifyHealthAction {-interactive}
  • 使用 Jython:
    AdminTask.modifyHealthAction('[-interactive]')

deleteHealthAction 命令

使用 deleteHealthAction 命令可移除运行状况操作。
表 18. deleteHealthAction 命令参数
参数 描述
name(必需) 指定运行状况操作的名称。

deleteHealthAction 命令示例

批处理方式示例用法:

  • 使用 Jacl:
    $Admintask deleteHealthAction {-name myHealthAction}
  • 使用 Jython:
    AdminTask.deleteHealthAction('-name myHealthAction')

listHealthActions 命令

使用 listHealthActions 命令可列示单元中每个已定义的运行状况操作。

listHealthActions 命令示例

批处理方式示例用法:

  • 使用 Jacl:
    $Admintask listHealthActions
  • 使用 Jython:
    AdminTask.listHealthActions

executeHealthAction 命令

使用 executeHealthAction 命令可运行指定的运行状况操作。
表 19. executeHealthAction 命令参数
参数 描述
name(必需) 指定要运行的运行状况操作的名称。
node(必需) 指定要对其执行操作的节点。此参数仅对于定制操作为必需。有效的选项是节点名称或空字符串 ""。
server(必需) 指定要对其执行操作的服务器。
cell 指定要对其执行运行状况操作的单元。
timeout 指定执行运行状况操作的超时值。
变量 指定变量的 java.util.Properties 值。

executeHealthAction 命令示例

批处理方式示例用法:

  • 使用 Jacl:
    $AdminTask executeHealthAction {-name myHealthAction -node myNode -server myServer}
  • 使用 Jython:
    AdminTask.executeHealthAction ('[-name myHealthAction -node myNode -server myServer]')

交互方式示例用法:

  • 使用 Jacl:
    $AdminTask executeHealthAction {-interactive}
  • 使用 Jython:
    AdminTask.executeHealthAction ('[-interactive]')

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwve_adtaskhealth
文件名:rwve_adtaskhealth.html