APM 명령줄 Workstation
Introscope CLW(명령줄 Workstation)를 사용하여 Introscope Workstation 기능 중 일부를 실행할 수 있습니다. CLW는 Introscope 운영 작업을 자동화하거나 예약할 때 유용합니다. 예를 들어 Workstation 인터페이스 대신 CLW를 사용하여 보다 빠르게 여러 관리 모듈에서 여러 알림이 사용되지 않도록 설정하는 등의 반복 작업을 수행할 수 있습니다. 마찬가지로 CLW는 자동으로 수행하거나 주기적으로 수행해야 하는 작업을 예약하는 경우에도 유용합니다.
apmdevops104kr
Introscope CLW(명령줄 Workstation)를 사용하여 Introscope Workstation 기능 중 일부를 실행할 수 있습니다. CLW는 Introscope 운영 작업을 자동화하거나 예약할 때 유용합니다. 예를 들어 Workstation 인터페이스 대신 CLW를 사용하여 보다 빠르게 여러 관리 모듈에서 여러 알림이 사용되지 않도록 설정하는 등의 반복 작업을 수행할 수 있습니다. 마찬가지로 CLW는 자동으로 수행하거나 주기적으로 수행해야 하는 작업을 예약하는 경우에도 유용합니다.
CLW 명령으로 수행할 수 있는 작업은 다음과 같습니다.
- 관리 모듈 및 요소 관리- 관리 모듈 및 요소에 대해 나열, 복사, 이름 바꾸기, 삭제, 활성 여부 확인, 현재 상태 변경 등의 작업을 수행할 수 있습니다.CLW의 복사 및 이름 바꾸기 명령을 사용하여 기존 관리 모듈과 요소를 기반으로 관리 모듈과 요소를 만들 수는 있지만 CLW를 사용하여 관리 모듈과 요소를 처음부터 새로 만들거나 세부 정보를 변경할 수는 없습니다.
- 에이전트 제어- 에이전트 보고를 원격으로 시작, 중지 및 다시 시작하고 구성 파일을 원격 에이전트에 복사할 수 있습니다.
- 트랜잭션 추적 세션 시작- 알림 조건의 결과로 트랜잭션 추적 세션을 자동으로 시작하는 스크립트를 작성할 수 있습니다.
- Enterprise Manager 종료- Enterprise Manager를 예약 방식으로 종료하는 스크립트를 작성할 수 있습니다. 예를 들어 Workstation 사용이 곤란할 수 있는 경우 업무 외 시간 동안 Enterprise Manager를 중지해야 할 수 있습니다.
- CLW가 종료되는 경우- 오류가 발생하지 않으면 CLW가 0 값으로 종료됩니다. 다음 중 하나가 발생하면 음수 상태 코드로 종료됩니다.
- Enterprise Manager 인증 실패
- 드롭된 네트워크 연결이나 잘못된 호스트 이름과 같은 Enterprise Manager와의 연결 문제
- 잘못된 WS와 Enterprise Manager가 있는 경우
CLW를 사용하려면 JVM 1.7 이상이 필요합니다. CLW 명령을 스크립트 또는 배치 파일에 포함하거나 명령줄에서 입력할 수 있습니다. CLW .jar 파일은 <
EM 홈
>/lib 디렉터리에 설치됩니다. 해당 디렉터리에서 CLW 명령을 실행하거나 디렉터리의 경로를 명령에 포함하십시오.CLW 대화형 모드 사용
기본 모드에서 대화형 모드로 변경할 수 있습니다. CLW용 스크립트를 작성하려는 경우에는 문제가 발생하므로 대화형 모드를 사용할 수 없습니다.
다음 단계를 따르십시오.
- <EM 홈>/lib 디렉터리에서 CLW 명령을 실행하거나 디렉터리의 경로를 명령에 포함합니다.
- 다음 예와 같이 -i 플래그를 사용합니다.java-Xmx128M<EM_logon> <TT_properties>-jar CLWorkstation.jar>usage |-i |<command>
대화형 모드는 명령줄 인수를 읽고 명령을 실행한 다음 종료합니다. 그러나 -DHost=처럼 JVM 옵션 이외에 전달된 명령줄 인수가 없는 경우에는 하나의 표준 입력 줄을 읽고 실행한 다음, 파일 끝에 도달하거나 사용자가 시스템을 종료할 때까지 계속해서 동일한 동작을 수행합니다. 전달된 인수도 없고 제공된 입력도 없는 경우에는 오류가 출력되면서 시스템이 종료됩니다. # 기호로 시작하는 줄은 모두 무시됩니다.
CLW 구문
CLW 명령에는 Introscope 배포 환경에 포함된 에이전트, 관리 모듈 및 그 밖의 명명된 항목을 지정하는 인수를 사용할 수 있습니다. CLW는 대/소문자를 구분하므로 Introscope 개체의 이름을 지정된 대로 정확히 입력해야 합니다. 예를 들어 에이전트 이름이
WebLogic1
인 경우 weblogic1
을 참조하는 CLW 명령은 해당 에이전트에 대해 실행되지 않습니다. CLW 명령 출력은 명령 창에 반환됩니다. 필요한 경우 파일을 명령 출력 대상으로 지정할 수 있습니다. 공백을 포함하는 CLW 명령 인수를 제공하는 경우에는 인수를 따옴표(")로 묶고 백슬래시를 각 따옴표 앞에 넣어서 셸이 따옴표를 해석하지 않도록 하십시오. 예:\"2005/01/01 12:20:37\"
CLW 명령 구문은 다음과 같습니다.
java-Xmx128M <EM_logon>-jar CLWorkstation.jar <command>
다음은 각 요소에 대한 설명입니다.
- -Xmx128M - Java 힙 크기를 설정하며, 이 요소를 설정하지 않을 때 발생할 수 있는 java.lang.OutOfMemoryError 오류를 방지합니다.
- <EM_logon>- Enterprise Manager 로그온 정보입니다.-Duser=<user name> - Dpassword=<password> - Dhost=<Enterprise Manager host / ip address> - Dport=<Enterprise Manager port number>
- <command>- CLW 명령 참조에 설명된 명령 중 하나입니다.
예:
java-Xmx128M -Duser=jdoe -Dpassword=mypassword -Dhost=jdoeDT -Dport=5001 -jar CLWorkstation.jar <command>
Enterprise Manager에 액세스하기 위한 기본 로그온 값은 다음과 같이 로그온 정보를 제공하지 않고 CLW를 호출하는 경우에 사용됩니다.
java-Xmx128M -jar CLWorkstation.jar <command>
명령줄에 입력하거나 스크립트에 포함하는 모든 CLW 명령은 다음과 같이 CLW 호출로 시작해야 합니다.
java-Xmx128M -jar CLWorkstation.jar
참고:
java.lang.OutOfMemoryError를 방지하려면 Java 힙 크기를 설정하십시오.CLW 및 정규식
CLW 명령을 사용하여 에이전트, 관리 모듈, 대시보드, 작업, 알림 등의 Introscope 환경 요소를 조작할 수 있습니다. 대상 유형에 따라 복사, 나열, 이름 바꾸기, 활성화, 비활성화 등의 작업을 수행할 수 있습니다.
정규식 구문은 사용 중인 운영 체제와 명령 셸에 따라 다르고 표현식을 명령줄에서 입력하는지 아니면 스크립트에 포함하는지 여부에 따라서도 다른 경우가 있습니다. 샘플 명령은 Windows 환경용으로 작성되었으며, 배치 파일에서 정규식을 사용하는 데 필요한 구문을 반영합니다.
정확한 텍스트 문자열이나 Perl 정규식을 사용하여 CLW 명령의 대상을 지정합니다. 예를 들어 이 CLW 명령은 Enterprise Manager에 연결된 에이전트를 모두 나열합니다.
list agents matching (.*)
참고:
Linux OS의 경우 작은따옴표를 사용하십시오. 예:
'(.*)'이 명령은 이름에
weblogic
이라는 문자열이 포함된 에이전트만 나열합니다.list agents matching .*weblogic.*
명령줄 Workstation 로그 구성
CLW(명령줄 Workstation) 명령을 Enterprise Manager 콘솔과 <
EM_Home
>/logs 디렉터리에 있는 IntroscopeEnterpriseManager.log 파일에 기록하도록 CA APM을 구성할 수 있습니다.다음 단계를 따르십시오.
- <EM_Home>\config 디렉터리에 있는 IntroscopeEnterpriseManager.properties 파일을 엽니다.
- IntroscopeEnterpriseManager.properties 파일에 다음 속성을 구성하여 로그 파일 및 Enterprise Manager 콘솔에 CLW 명령 로깅이 사용되도록 설정합니다.
- log4j.additivity.Manager.CLW를 true로 설정합니다.참고:이 속성의 기본값은 false입니다.
- log4j.logger.Manager.CLW를 DEBUG로 설정합니다.이 속성의 기본값은 INFO입니다.