Workstation 시작

소개 › Workstation 관리 › Workstation 시작

Workstation 시작

다음 방법 중 하나를 사용하여 Workstation을 시작합니다.

Windows에서는 다음과 같이 할 수 있습니다.
- Introscope Workstation.exe를 실행합니다.
- "시작", "APM", "Introscope Workstation"을 차례로 클릭합니다.
브라우저에서 다음과 같은 URL을 사용합니다.
```
http://<EM_Host>:8081/workstation
```
- 여기서 EM_Host는 Enterprise Manager의 호스트 이름입니다.
특정 매개 변수를 사용하여 Workstation 시작을 참조하십시오.

참고: Workstation을 처음 시작할 때 workstation.jnlp를 시작할지 또는 파일을 저장할지를 묻는 메시지가 표시됩니다.

workstation.jnlp를 시작하는 것이 좋습니다.
파일을 저장하고 "Do this automatically for files like this from now on"(앞으로 이러한 파일에 대해 자동으로 이 작업 수행) 옵션을 선택하는 것은 권장되지 않습니다. 이 옵션을 사용하면 URL을 통해 Workstation이 올바로 실행되지 않습니다.
명령줄을 사용합니다.
참고: 자세한 내용은 명령줄에서 Workstation 기능 실행을 참조하십시오.

로그인하려면

로그인 대화 상자에서 다음 정보를 입력합니다.
- 호스트 이름 또는 IP 주소
  참고: 클라이언트 컴퓨터와 호스트 컴퓨터에서 동일한 IP 프로토콜을 지원하는 경우에만 호스트 이름 대신 IP 주소를 사용하십시오.
- 포트 번호
- 사용자 이름과 암호
"연결"을 클릭하거나 현재 호스트 및 사용자 정보를 이후 로그인의 기본값으로 설정하려면 "기본값 설정"을 클릭합니다.
콘솔이 열립니다. 인증 프로세스가 실패하면 실패를 알리는 메시지가 나타납니다.

참고: Workstation 사용자 권한을 구성하려면 CA APM 보안 안내서를 참조하십시오.

특정 매개 변수를 사용하여 Workstation 시작

액세스할 Workstation의 뷰를 지정하는 특정 매개 변수를 사용하여 Workstation을 시작할 수 있습니다. 이러한 매개 변수는 다음과 같은 방법으로 사용할 수 있습니다.

명령줄에서 실행된 Java 시작 명령
Java Web Start를 사용하여 Workstation을 시작하는 URL
IntroscopeWorkstation.lax 파일의 인수

참고: 표준 URL 인코딩을 사용하여 에이전트 및 메트릭 이름에서 특수 문자를 이스케이프할 수 있습니다.

예제 1

예를 들어, 명령줄에서 -page 및 -agent 옵션은 다음과 같이 사용합니다.

java -client -Xms64m -Xmx256m -Dsun.java2d.noddraw=true -jar launcher.jar 
-consoleLog -noExit -product com.wily.introscope.workstation.product 
-name "Introscope Workstation" -install ".\\product\\workstation" 
-configuration ".\\product\\workstation\\configuration" -page
investigator -agent "SuperDomain|localhost|WebLogic|WebLogic Agent"

URL에서 이와 동일한 조합은 다음과 같습니다.

http://<localhost>:8081/workstation?page=investigator&agent=SuperDomain|localhost|WebLogic|WebLogic%20Agent

IntroscopeWorkstation.lax 파일에서 lax.command.line.args 지정자를 편집하여 동일한 페이지를 가리키십시오. 문자열의 끝에서 다음과 같이 동일한 페이지와 에이전트 위치를 지정하십시오.

lax.command.line.args=$CMD_LINE_ARGUMENTS$ -consolelog -noExit -product com.wily.introscope.workstation.product -name "Introscope Workstation" -install ".\\product\\workstation" -configuration ".\\product\\workstation\\configuration" -page investigator -agent "SuperDomain|localhost|WebLogic|WebLogic Agent"

이 인수를 추가하면 "시작" 메뉴에서 시작할 때마다 Workstation이 지정된 페이지 및 에이전트 위치에서 열립니다.

각 예제에서 에이전트 이름의 특수 문자를 처리하는 방법을 확인하십시오.

이 예제에서는 이름에 공백이 있으므로 전체 에이전트 이름을 따옴표로 묶었습니다.
URL 예제에서는 공백 문자가 %20으로 렌더링됩니다.

예제 2

에이전트 이름이 “MyAgent%1”인 경우 URL에 다음 문자열을 사용하십시오.

MyAgent%251

여기서 %25는 리터럴 % 문자에 대한 URL 인코딩입니다.

예제 3

에이전트 이름이 “WhatIsThisAgent??”인 경우 URL에 다음 문자열을 사용하십시오.

WhatIsThisAgent%3F%3F

%3F는 리터럴 ?에 대한 문자 URL 인코딩입니다.

다음 표는 다른 매개 변수를 설명합니다.

Options	설명
-loginimmediate	로그인 화면을 표시하지 않고 지정된 호스트 이름 및 포트 번호 또는 기본값을 사용하여 Workstation에 곧바로 로그인합니다.
-loginhost <hostname>	로그인 호스트 이름을 지정합니다. 지정하지 않은 경우 기본값은 localhost입니다.
-loginport <portnumber>	로그인 포트 번호를 지정합니다. 지정하지 않은 경우 기본값은 5001입니다.
-loginresponse <values>	사용자 이름 및 암호에 대한 인증 값을 쉼표로 구분하여 지정합니다.
-page	시작할 Workstation 화면의 이름입니다. Workstation 명령줄 인터페이스에 대한 모든 요청에 이 매개 변수를 포함해야 합니다. 지원되는 값: investigator historicalquery console
-agent	Investigator 창에 표시할 정규화된 에이전트 이름입니다. page 매개 변수가 investigator인 경우 필수입니다. 에이전트 이름의 특수 문자를 렌더링하려면 URL 인코딩을 사용하십시오.
-metric	지정된 에이전트에 대해 Investigator 창에 표시할 메트릭 경로입니다. 이 매개 변수를 사용하는 경우 에이전트를 지정해야 합니다. 메트릭 이름에 특수 문자를 렌더링하려면 URL 인코딩을 사용하십시오.
-start	page 매개 변수 값에 따라 Investigator 창의 기록 시간 범위에 대한 시작 시간(표준 Java 형식인 밀리초)이거나 "Transaction Tracer Historical Query"(트랜잭션 추적 프로그램 기록 쿼리)에 대한 시작 시간입니다. 참고: page 매개 변수가 historicalquery인 경우 start/end 또는 guid 매개 변수는 필수입니다.
-end	page 매개 변수 값에 따라 Investigator 창의 기록 시간 범위에 대한 종료 시간(표준 Java 형식인 밀리초)이거나 "Transaction Tracer Historical Query"(트랜잭션 추적 프로그램 기록 쿼리)에 대한 종료 시간입니다. page 매개 변수가 historicalquery인 경우 start/end 또는 guid 매개 변수는 필수입니다. 다음 예제에서는 Java 타임스탬프 값을 사용합니다. 인터넷에서 사용 가능한 변환기를 비롯해 널리 사용되는 변환기를 사용하여 달력 날짜를 Java 타임스탬프 값으로 변환할 수 있습니다. http://<localhost>:8081/workstation?page=historicalquery&start=1135686483474&end=1136686483474
-guid	"Transaction Tracer Historical Query"(트랜잭션 추적 프로그램 기록 쿼리) 창에 표시할 트랜잭션의 고유 식별자입니다. page 매개 변수가 historicalquery인 경우 start/end 또는 guid 매개 변수는 필수입니다. 예: http://<localhost>:8081/workstation?page=historicalquery&guid=aRx345
-agentSpecifier	데이터를 필터링하여 지정하는 에이전트의 데이터로 대시보드 표시를 제한합니다. page 매개 변수가 console인 경우에만 사용할 수 있습니다. AgentSpecifier 매개 변수의 인수에는 Enterprise Manager 호스트 이름을 포함하는 에이전트 이름이 포함되어야 합니다. 에이전트 이름의 요소를 구분하는 \| 기호와 같은 특수 문자는 백슬래시로 이스케이프해야 합니다. 에이전트 이름의 공백은 %20 문자열로 대체하십시오. 이 예제에서는 대시보드에 WebLogic 에이전트의 데이터만 표시됩니다. http://<localhost>:8081/workstation?page=console&agentSpecifier=machine1\\|WebLogic\\|WebLogic%20Agent&metric=GC%20Heap:Bytes%20In%20Use
-dashboardName	표시할 대시보드를 지정합니다. page 매개 변수가 console인 경우에만 사용할 수 있습니다. 대시보드 이름의 공백은 %20 문자열로 대체하십시오. 이 예제의 URL은 "GC Memory In Use"(사용 중인 GC 메모리)라는 대시보드로 이동됩니다. http://<localhost>:8081/workstation?page=console&dashboardName=GC%20Memory%20In%20Use&metric=GC%20Heap:Bytes%20In%20Use

이 URL 중 하나를 실행하거나 이와 동등한 Java 명령줄로 Workstation을 시작하면 Workstation 인스턴스가 시작되고 적절한 창이 열립니다. 이후 URL 요청을 하면 기존 Workstation 인스턴스에서 새 창이 열립니다.

추가 예제

다음은 Java Web Start를 사용하여 Workstation을 실행하기 위해 URL을 사용하는 예제입니다.

WebStart를 콘솔 뷰의 특정 대시보드에서 실행하십시오. 콘솔 뷰에서 대시보드 이름은 "An Intro to Introscope"입니다.

http://localhost:8081/workstation?host=localhost&port=5001&username=<User_ID>&password=<Your_Pwd>&page=console&dashboardName=An%20Intro%20to%20Introscope

Investigator의 특정 에이전트(<Agent_Name>)에서 WebStart를 실행합니다.

http://localhost:8081/workstation?host=localhost&port=5001&username=<User_ID>&password=<Your_Pwd>&page=investigator&agent=SuperDomain|<Host_Name>|AppServers|<Agent_Name>

Investigator의 특정 에이전트 및 메트릭에서 WebStart를 실행합니다.

http://localhost:8081/workstation?host=localhost&port=5001&username=<User_ID>&password=<Your_Pwd>&page=investigator&agent=SuperDomain|<Host_Name>|AppServers|<Agent_Name>&metric=GC%20Heap:Bytes%20In%20Use

기록 쿼리 뷰어의 특정 트랜잭션 추적 GUID(<GUID_Number>)에서 WebStart를 실행합니다.

http://localhost:8081/workstation?host=localhost&port=5001&username=<User_ID>&password=<Your_Pwd>&page=historicalquery&guid=<GUID_Number>

Java Web Start에 대한 JVM 요구 사항

Java Web Start를 사용하여 Workstation을 실행하려는 서버는 지원되는 JVM 버전이 로컬에 설치되어 있어야 합니다.

Java Web Start는 Workstation 클라이언트의 임시 사본을 설치합니다. 잘못된 JVM 버전을 사용하는 경우 프록시 인증을 사용하여 Enterprise Manager에 연결하는 컴퓨터에서 문제가 발생할 수 있습니다.

클라이언트 시스템에서 Java Web Start는 다음 파일을 통해 Workstation(Java 버전 사용)을 실행합니다.

<EM_Home>\product\enterprisemanager\plugins\com.wily.introscope.workstation.webstart_9.5\WebContent\jnlp\workstation.jsp
<EM_Home>\product\enterprisemanager\plugins\com.wily.introscope.workstation.webstart_9.5\WebContent\jnlp\com.wily.introscope.workstation.feature.jsp

이 두 파일은 Workstation을 실행하는 Java 버전을 결정하는 버전 특성이 있는 j2se 노드를 수록하고 있습니다. Java Web Start가 현재 JVM을 찾고 이에 대응하는 방법에 대한 자세한 설명은 파일의 주석을 보십시오.

참고: JVM 요구 사항에 대한 자세한 내용은 호환성 안내서를 참조하십시오.

대체 Enterprise Manager에 연결

단일 브라우저에서 특정 매개 변수를 사용하여 Workstation 시작에 명시된 매개 변수를 사용하여 다른 Enterprise Manager 호스트에서 여러 Workstation 응용 프로그램 인스턴스를 시작할 수 있습니다. 대체 또는 다른 Enterprise Manager에 연결하려면 loginHost 매개 변수를 적절히 변경하십시오.