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

지능형 관리: 성능 상태 정책 관리 태스크

다음 관리 태스크를 사용하여 성능 상태 정책을 작성, 삭제 및 관리할 수 있습니다.

createHealthPolicy 명령

createHealthPolicy 명령은 새 성능 상태 정책을 작성합니다.
표 1. createHealthPolicy 명령 인수
인수 설명
name(필수) 셀에서 고유한 성능 상태 정책의 이름을 지정합니다.
description 성능 상태 정책에 대한 설명을 지정합니다.
reactionMode 성능 상태 정책에 대해 조치를 취하기 전 런타임 태스크가 작성된 경우 또는 조치가 자동인 경우를 지정합니다. 값은 SUPERVISE 또는 AUTOMATIC이 될 수 있습니다.
표 2. addCondition 단계 인수
인수 설명
type(필수) 조건 유형을 지정합니다. 값은 CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME, EXCESSIVE_REQUEST_TIMEOUT, STORM_DRAIN 또는 GC_PERCENTAGE가 될 수 있습니다. 각 값에는 반드시 지정해야 하는 다른 매개변수가 있습니다.
expression 사용자 정의 조건을 사용 중인 경우, 평가할 하위 표현식을 지정하십시오.
params
  • AGE
    • maxAge: 최대 연령을 지정합니다.
    • ageUnits: age 매개변수의 단위 유형을 지정합니다. 값은 HOURS 또는 MINUTES가 될 수 있습니다. 기본값은 HOURS입니다.
  • WORKLOAD
    • totalRequests: 멤버를 다시 시작하기 전에 서비스에 대한 전체 요청을 지정합니다. 수는 1000 이상이어야 합니다.
  • MEMORY_LEAK
    • level: 메모리 누수의 발견 레벨을 지정합니다. 값은 FAST, NORMAL, 또는 CONSERVATIVE가 될 수 있습니다. 기본값은 FAST입니다.
  • EXCESSIVE_MEMORY
    • timeOverThreshold: 과도한 메모리 상태의 위반 기간을 지정합니다.기본값은 1 MINUTE입니다.
    • timeUnits: timeOverThreshold 값의 단위를 지정합니다. 값은 MINUTES 또는 SECONDS가 될 수 있습니다. 기본값은 MINUTES입니다.
    • memoryUsed: JVM 프로세스에 사용할 최대 JVM(Java™ Virtual Machine) 힙 크기를 나타내는 백분율을 지정합니다. 값 범위는 1 - 99입니다.
  • EXCESSIVE_RESPONSE_TIME
    • responseTime: 과도한 것으로 간주되는 평균 응답 시간을 지정합니다. 평균이 이 값에 도달하면 멤버는 다시 시작합니다.
    • responseTimeUnits: 응답 시간의 시간 단위를 지정합니다. 값은 MINUTES, SECONDS, 또는 MILLISECONDS가 될 수 있습니다.
  • EXCESSIVE_REQUEST_TIMEOUT
    • timeoutPercent: 조건 분기를 발생시키는 제한시간 초과 요청 백분율의 임계값을 지정합니다. 이 값의 범위는 1 - 99입니다.
  • STORM_DRAIN
    • level: 검출 레벨을 지정합니다. 값은 NORMAL 또는 CONSERVATIVE가 될 수 있습니다. NORMAL은 정확도가 떨어지지만 빗물 배수관(storm drain) 조건을 신속하게 발견할 수 있습니다. CONSERVATIVE는 가장 정확하지만, 빗물 배수관(storm drain) 조건을 탐지하는 데 오랜 시간이 소요됩니다.
  • GC_PERCENTAGE
    • garbageCollectionPercent: 가비지 콜렉션에 소비된 시간의 백분율 임계값. 이 값은 199 이내입니다. 기본값은 10입니다.
    • samplingPeriod: 가비지 콜렉션 데이터를 수집하기 위한 샘플링 기간. 샘플링 기간 동안 가비지 콜렉션에 사용한 총 시간은 수정 조치 이전 임계값보다 높아야 합니다. 이 값은 1분에서부터 24시간 이내입니다. 기본값은 2분입니다.
    • samplingUnits:samplingPeriod 매개변수를 위한 시간 단위를 지정합니다. 값은 MINUTES 또는 HOURS가 될 수 있습니다. 기본값은 MINUTES입니다.
    • 문제점 방지 문제점 방지: garbageCollectionPercentsamplingPeriod 매개변수는 필수이므로 명령을 실행하려면 지정해야 합니다. gotcha
표 3. addAction 단계 인수.

테이블 형식에서 addAction 단계 인수를 사용하십시오. 테이블 형식을 사용하면 매개변수 이름을 사용하지 않고도 순서 대로 매개변수를 지정할 수 있습니다.

인수 설명
type(필수) 조치 유형을 지정합니다. 값은 CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK 또는 MAINT_MODE_STOP가 될 수 있습니다.
stepNum(필수) 조치를 수행하는 순서를 지정합니다. 단계 1이 먼저 완료되는 방식으로 진행됩니다.
action 사용자 정의 조치의 이름을 지정합니다. 사용자 정의 조치를 작성하려면 createHealthAction 명령을 사용하십시오. 이 매개변수는 사용자 정의 조치에서만 필요합니다.
node 조치를 취할 노드를 지정합니다. 이 매개변수는 사용자 정의 조치에서만 필요합니다. 유효 옵션은 노드 이름 또는 빈 문자열 ""입니다.

서버 조치를 취할 서버를 지정합니다.

이 매개변수는 사용자 정의 조치에만 필요합니다. 유효 옵션은 서버 이름 또는 다음 문자열 중 하나입니다: "상태가 나쁜 서버" 또는 "상태가 나쁜 서버의 노드 에이전트". 이러한 문자열 중 하나가 사용되는 경우, 유효한 노드값은 빈 문자열 ""입니다.

표 4. addMember 단계 인수.

테이블 형식에서 addMember 단계 인수를 사용하십시오. 테이블 형식을 사용하면 매개변수 이름을 사용하지 않고도 순서 대로 매개변수를 지정할 수 있습니다.

인수 설명
type(필수) 멤버 유형을 지정합니다. 값은 CELL, CLUSTER, DYNAMIC_CLUSTER, SERVER, 또는 ODR이 될 수 있습니다.
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 성능 상태 정책에 대해 조치를 취하기 전 런타임 태스크가 작성된 경우 또는 조치가 자동인 경우를 지정합니다. 값은 SUPERVISE 또는 AUTOMATIC이 될 수 있습니다.
표 6. modifyCondition 단계 인수
인수 설명
type 조건 유형을 지정합니다. 값은 CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME, EXCESSIVE_REQUEST_TIMEOUT, STORM_DRAIN 또는 GC_PERCENTAGE가 될 수 있습니다. 각 값에는 반드시 지정해야 하는 다른 매개변수가 있습니다.
expression 사용자 정의 조건을 사용 중인 경우, 평가할 하위 표현식을 지정하십시오.
params
  • AGE
    • maxAge: 최대 연령을 지정합니다.
    • ageUnits: age 매개변수의 단위 유형을 지정합니다. 값은 HOURS 또는 MINUTES가 될 수 있습니다. 기본값은 HOURS입니다.
  • WORKLOAD
    • totalRequests: 멤버를 다시 시작하기 전에 서비스에 대한 전체 요청을 지정합니다. 수는 1000 이상이어야 합니다.
  • MEMORY_LEAK
    • level: 메모리 누수의 발견 레벨을 지정합니다. 값은 FAST, NORMAL, 또는 CONSERVATIVE가 될 수 있습니다. 기본값은 FAST입니다.
  • EXCESSIVE_MEMORY
    • timeOverThreshold: 과도한 메모리 상태의 위반 기간을 지정합니다.기본값은 1 MINUTE입니다.
    • timeUnits: timeOverThreshold 값의 단위를 지정합니다. 값은 MINUTES 또는 SECONDS가 될 수 있습니다. 기본값은 MINUTES입니다.
    • memoryUsed: JVM 프로세스에 사용할 최대 JVM(Java Virtual Machine) 힙 크기를 나타내는 백분율을 지정합니다. 값 범위는 1 - 99입니다.
  • EXCESSIVE_RESPONSE_TIME
    • responseTime: 과도한 것으로 간주되는 평균 응답 시간을 지정합니다. 평균이 이 값에 도달하면 멤버는 다시 시작합니다.
    • responseTimeUnits: 응답 시간의 시간 단위를 지정합니다. 값은 MINUTES, SECONDS, 또는 MILLISECONDS가 될 수 있습니다.
  • EXCESSIVE_REQUEST_TIMEOUT
    • timeoutPercent: 조건 분기를 발생시키는 제한시간 초과 요청 백분율의 임계값을 지정합니다. 이 값의 범위는 1 - 99입니다.
  • STORM_DRAIN
    • level: 검출 레벨을 지정합니다. 값은 NORMAL 또는 CONSERVATIVE가 될 수 있습니다. NORMAL은 정확도가 떨어지지만 빗물 배수관(storm drain) 조건을 신속하게 발견할 수 있습니다. CONSERVATIVE는 가장 정확하지만, 빗물 배수관(storm drain) 조건을 탐지하는 데 오랜 시간이 소요됩니다.
  • GC_PERCENTAGE
    • garbageCollectionPercent: 가비지 콜렉션에 소비된 시간의 백분율 임계값. 이 값은 199 이내입니다. 기본값은 10입니다.
    • samplingPeriod: 가비지 콜렉션 데이터를 수집하기 위한 샘플링 기간. 샘플링 기간 동안 가비지 콜렉션에 사용한 총 시간은 수정 조치 이전 임계값보다 높아야 합니다. 이 값은 1분에서부터 24시간 이내입니다. 기본값은 2분입니다.
    • samplingUnits:samplingPeriod 매개변수를 위한 시간 단위를 지정합니다. 값은 MINUTES 또는 HOURS가 될 수 있습니다. 기본값은 MINUTES입니다.
    • 문제점 방지 문제점 방지: garbageCollectionPercentsamplingPeriod 매개변수는 필수이므로 명령을 실행하려면 지정해야 합니다. gotcha
표 7. removeAction 단계 인수
인수 설명
name 제거할 성능 상태 조치의 이름을 지정합니다. name 매개변수는 사용자 정의 조치에만 사용됩니다.
type(필수) 조치 유형을 지정합니다. 값은 CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK 또는 MAINT_MODE_STOP가 될 수 있습니다.
표 8. addAction 단계 인수
인수 설명
type(필수) 조치 유형을 지정합니다. 값은 CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK 또는 MAINT_MODE_STOP가 될 수 있습니다.
action 성능 상태 조치의 이름을 지정합니다. 사용자 정의 조치를 작성하려면 createHealthAction 명령을 사용하십시오. 이 매개변수는 사용자 정의 조치에서만 필요합니다.
node 조치를 취할 노드를 지정합니다. 이 매개변수는 사용자 정의 조치에서만 필요합니다. 유효 옵션은 노드 이름 또는 빈 문자열 ""입니다.
서버 조치를 취할 서버를 지정합니다.

이 매개변수는 사용자 정의 조치에만 필요합니다. 유효 옵션은 서버 이름 또는 다음 문자열 중 하나입니다: "상태가 나쁜 서버" 또는 "상태가 나쁜 서버의 노드 에이전트". 이러한 문자열 중 하나가 사용되는 경우, 유효한 노드값은 빈 문자열 ""입니다.

stepNum(필수) 조치를 수행하는 순서를 지정합니다. 단계 1이 먼저 완료되는 방식으로 진행됩니다.
표 9. orderAction 단계 인수
인수 설명
이름 성능 상태 조치의 이름을 지정합니다. name 매개변수는 사용자 정의 조치에만 사용됩니다.
type 조치 유형을 지정합니다. 값은 CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK 또는 MAINT_MODE_STOP가 될 수 있습니다.
stepNum(필수) 조치를 수행하는 순서를 지정합니다. 단계 1이 먼저 완료되는 방식으로 진행됩니다.
표 10. addMember 단계 인수
인수 설명
type(필수) 멤버 유형을 지정합니다. 값은 CELL, CLUSTER, DYNAMIC_CLUSTER, SERVER, 또는 ODR이 될 수 있습니다.
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을 지정하십시오. 유효한 운영 체제 이름에는 windows, unix 또는 zos가 포함됩니다.
workingDir 명령이 호출되는 파일 시스템에서의 위치를 지정합니다. 이 인수는 비Java 단계 인수를 지정하는 경우 필요합니다.
usernameVar 사용자 이름을 위한 변수를 지정합니다.
userNameVal 사용자 이름 변수의 값을 지정합니다.
passwordVar 비밀번호 변수를 지정합니다.
passwordVal 비밀번호 변수 값을 지정합니다.
표 14. Java 단계 인수
인수 설명
javaDir Java 실행 파일의 위치를 지정합니다. 예: ${JAVA_HOME}. 변수 또는 경로를 지정할 수 있습니다.
executableTargetType Java 실행 파일에 대해 사용 중인 파일 유형을 지정합니다. 값은 EXECUTABLE_JAR 또는 JAVA_CLASS가 될 수 있습니다.
executable 실행 파일 경로를 지정합니다.이 인수는 Java 단계 인수를 지정하는 경우 필요합니다.
exectuableArgs 실행 파일로 전달할 인수의 문자열 배열을 지정합니다.
osNames 쉼표로 구분되는 운영 체제 목록을 지정합니다. 각 운영 체제에 대해 조치를 적용하려면 null을 지정하십시오. 유효한 운영 체제 이름에는 windows, unix 또는 zos가 포함됩니다.
pidVarName Java 프로세스 ID 변수 이름을 지정합니다.
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_JAR 또는 JAVA_CLASS가 될 수 있습니다.
executable 실행 파일 경로를 지정합니다.
executableArgs 실행 파일로 전달할 인수의 문자열 배열을 지정합니다.
pidVarName Java 프로세스 ID 변수 이름을 지정합니다.
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