wsadmin 도구를 사용할 때 ClearQuest Web 서버가 실행 중이어야 합니다.
MBean 속성은 속성이 저장되어 있는 해당 Mbean별로 분류됩니다. 읽기를 의미하는 [R]로 표기되는 모든 매개변수를 검색할 수 있습니다. 수정 가능한 매개변수는 쓰기를 의미하는 [W]로 표시됩니다. IBM WebSphere® Application Server wsadmin 도구를 사용하여 Jacl(Java Application Control Language) 명령으로 속성에 액세스할 수 있습니다. teamAdminUtils.jacl 파일은 Jacl 명령, 구문, 기능의 예제를 제공합니다. 또한 사이트 구성 창을 사용하여 일부 ClearQuest Web 서버 MBean 속성을 수정할 수 있습니다.
ClearQuest Web 서버가 실행하고 있는 동안에만 수정 가능한 MBean 매개변수를 변경할 수 있습니다. 변경사항은 서버 프로세스를 다시 시작할 필요가 없이 즉시 적용됩니다. 백엔드 개방형 네트워크 컴퓨팅 원격 프로시저 호출(ONC RPC) 서버 프로세스의 시작을 관리하는 MBean 속성에 작성된 변경사항은 실행 중인 백엔드 ONC RPC 프로세스에 영향을 주지 않습니다. 새 백엔드 ONC RPC 서버 프로세스만 새 설정을 사용합니다.
ClearQuest Web 서버가 시작되면 두 개의 MBean(ClearQuest Web 서버 구성 속성을 보유하는 TeamServerMBean 및 ClearQuest 관리 연결 팩토리 속성을 보유하는 CqServerFactoryMBean)이 작성됩니다.
ClearQuest 관리 연결 팩토리는 하나 이상의 다중 스레드 ClearQuest ONC RPC 백엔드 서버 프로세스를 시작할 책임이 있는 ClearQuest Web 서버 컴포넌트입니다. 각 ClearQuest RPC 프로세스는 다중 스레드이므로 여러 다른 신임 정보의 요청을 처리할 수 있습니다. ClearQuest 관리 연결 팩토리는 각 ClearQuest RPC 프로세스에서 자동으로 라이프사이클 관리를 수행합니다.
MBean 속성 | 액세스 제어 | 설명 |
---|---|---|
attachmentTempLocation | [R,W] | 첨부 파일을 저장할 디렉토리를 지정합니다. 기본적으로 첨부 파일은 WAS 프로파일 디렉토리 구조 내의 깊은 위치에 저장됩니다. 하지만 Windows에서는 경로 이름의 길이가 약 250바이트로 제한됩니다. 첨부 파일의 파일 이름이 약 150바이트를 초과하는 경우 기본 저장 위치에서는 첨부 파일의 전체 경로 이름이 250바이트를 초과하게 되므로 ClearQuest에서 첨부 파일을 저장하는 데 실패할 수 있습니다. |
cqFulltextSearchCacheSize | [R,W] | 단일 전체 텍스트 검색에 대해 ClearQuest 코어에 저장된 레코드 히트 수. 기본값은 0(설정되지 않음)입니다. 양수 값이 ClearQuest 코어의 기본 설정을 대체합니다. |
cqFulltextSearchRecordHitLimit | [R,W] | 하나의 전체 텍스트 검색 웹 서비스 호출에서 리턴된 최대 레코드 히트 수. 이 숫자는 또한 애플리케이션 서버에 캐시될 수 있는 히트 수를 나타냅니다. 기본값은 100입니다. |
cqLoginSessionTimeout | [R,W] | 제한시간이 초과되기 전에 Rational ClearQuest 로그인 세션이 지속되는 시간(초)입니다. 기본값은 1800초(30분)입니다. 각 ClearQuest 세션이 데이터베이스 연결을 사용하므로 이 값을 너무 높게 설정하면 필요한 시간보다 더 오랫동안 자원을 이용할 수 있습니다. 기본값을 변경하지 마십시오. |
cqLoginSessionWaitTimeout | [R,W] | Rational ClearQuest 로그인 세션을 획득하기 위해 스레드가 대기할 수 있는 시간(초)입니다. 기본값은 300초입니다. |
cqServerFactory | [R] | ClearQuest J2C 연결 팩토리 MBean의 오브젝트 이름입니다. |
cqUserDBListSecureAccess | [R,W] | 사용자가 올바르지 않은 신임 정보를 사용하여 ClearQuest Web에 로그인하려고 시도할 때 사용자가 데이터베이스 목록을 볼 수 있는지 여부를 표시합니다. 기본값은 FALSE이며 이는 사용자가 올바르지 않은 신임 정보를 사용하여 로그온하려는 경우 데이터베이스 목록을 볼 수 있음을 표시합니다. 값을 TRUE로 설정하면 사용자 인증이 사용되므로 권한이 없는 사용자는 데이터베이스 목록을 보지 못하게 됩니다. |
ejbBufferLimit | [R,W] | EJB 호출에 의해 리턴되는 최대 오브젝트 수입니다. 기본값은 100입니다. |
keepAliveInterval | [R,W] | 이 값이 0초보다 크면 ClearQuest Web 서버는 지정된 간격으로 클라이언트와 백엔드 서버 컴포넌트 사이에서 활성 유지 메시지를 발행합니다. 이 속성은 장기 실행 중인 ClearQuest 조회가 기본 소켓을 제거하지 않고 완료할 수 있도록 디자인되었습니다. 이 값은 소켓 제한시간 값보다 최소한 10초 미만이어야 합니다. 기본값은 300초(5분)입니다. |
largeReadSocketTimeoutMultiplier | [R,W] | 장기 실행 중인 조작에 대해 중간 티어와 백엔드 서버 컴포넌트 사이의 소켓에서 read-timeout 값에 적용되는 승수입니다. 기본값인 4는 read-socket-timeout 값이 backend-server-factory default-read-socket-timeout 값의 네 배임을 나타냅니다. 이 승수는 특정 조작에만 적용됩니다. IBM 지원 센터의 지시가 없으면 이 값을 변경하지 마십시오. |
maxCqSessionsPerUser | [R,W] | 단일 세션에서 각 사용자에 대해 작성되는 최대 ClearQuest 세션 수입니다. 기본값은 2이고, 최소값은 1입니다. |
maxProcureServerAttempts | [R,W] | 관리 연결 풀로 예외를 리턴하기 전에 백엔드 ONC RPC 서버를 확보할 수 있는 최대 시도 수입니다. 기본값은 6이며, 값이 2 이상이어야 합니다. |
mediumReadSocketTimeoutMultiplier | [R,W] | 특정한 장기 실행 조작에 대해 중간 티어와 백엔드 서버 컴포넌트 사이의 소켓에서 read-timeout 값에 적용되는 승수입니다. 기본값인 2는 read-socket-timeout 값이 backend-server-factory default-read-socket-timeout 값의 두 배임을 나타냅니다. 이 승수는 특정 조작에만 적용됩니다. IBM 지원 센터의 지시가 없으면 값을 변경하지 마십시오. |
numberOfActiveSessions | [R] | 서버가 처리 중인 활성 세션 수. |
numberOfHttpSessionsCreated | [R] | 이 서버가 처리하는 세션 수. |
oncrpcBufferLimit | [R,W] | 단일 ONC RPC 호출로 리턴되는 최대 오브젝트 수입니다. 기본값은 100입니다. |
oncrpcInterruptLimit | [R,W] | 사용자 요청에 대해 리턴되는 최대 오브젝트 수입니다. 기본값은 1000입니다. |
oncrpcServers | [R] | 실행 중인 ONC RPC 서버 MBean에 대한 오브젝트 이름. |
procureServerInterval | [R,W] | 요청 스레드가 관리 연결 풀에 예외를 리턴하기 전에 서버를 확보하기 위해 대기할 수 있는 시간(초)입니다. 기본값은 60초입니다. |
sessionObjectDefaultTimeout | [R,W] | 오브젝트가 세션에 남아 있는 기본 시간(초)입니다. 기본값은 1800초(30분)입니다. 이 값은 0 이상이어야 합니다. |
sessionQueryObjectTimeout | [R,W] | 새로 작성되거나 수정된 조회가 전달되지 않은 경우 ClearQuest 로그인 세션이 제한시간 초과되기 전에 지속되는 시간입니다. 이 값은 cqLoginSessionTimeout 값보다 작을 수 없습니다. 기본값은 1800초(30분)입니다. 이 값은 sessionObjectDefaultTimeout에서 정의된 값을 대체합니다. |
sessionRecordObjectTimeout | [R,W] | 새로 작성되거나 수정된 레코드가 전달되지 않은 경우 ClearQuest 로그인 세션이 제한시간 초과되기 전에 지속되는 시간입니다. 이 값은 cqLoginSessionTimeout 값보다 작을 수 없습니다. 기본값은 10,800초(3시간)입니다. 이 값은 sessionObjectDefaultTimeout에서 정의된 값을 대체합니다. |
sessionReaperThreadDelay | [R,W] | 세션 Reaper 스레드의 시간 지연(초)입니다. 기본값은 900초(15분)입니다. 값의 범위는 300 - 1800초입니다. 가상 메모리 수요가 많은 경우 이 값을 줄이고자 할 수 있습니다. 너무 많은 CPU가 사용되는 경우 이 값을 늘리고자 할 수도 있습니다. |
totalNumberOfOncrpcServers | [R] | 모든 Rational ClearQuest 연결 팩토리 인스턴스에서 실행 중인 백엔드 RPC 서버 수. |
totalOncrpcCallCount | [R] | 서버가 시작된 이후로 작성된 ONC RPC 호출 수. |
totalWebServiceCallCount | [R] | 서버가 시작된 이후로 작성된 웹 서비스 호출 수. |
versionNumber | [R] | ClearQuest Web 서버 제품 버전 번호(문자열 값으로 표시되고 점 구분 기호로 구분됨). 예를 들어, 7.1.2.1입니다. |
MBean 속성 | 액세스 제어 | 설명 |
---|---|---|
activeHttpSessionThreshold | [R,W] | 활성 백엔드 ClearQuest ONC RPC 서버의 활성 HTTP 세션 수입니다. 이 수를 초과하면 해당 관리 연결 팩토리가 다른 백엔드 ClearQuest ONC RPC 서버를 시작하게 할 수 있습니다. 기본값은 30입니다. |
cqrpcAbandonedProcessCleanupEnabled | [R,W] | ClearQuest Web 서버가 사용되지 않는 ClearQuest RPC 프로세스를 종료하는 정리 프로시저를 시작할지 여부를 표시합니다. 기본값은 TRUE입니다. |
cqrpcAbandonedProcessCleanupInterval | [R,W] | ClearQuest Web 서버가 사용되지 않는 ClearQuest RPC 프로세스를 종료하기 위해 정리 프로시저를 시작하는 데 사용하는 정기적 간격(분)입니다. 기본값은 30분입니다. 이 값은 0 이상이어야 합니다. 간격은 가장 가까운 2의 제곱으로 작동합니다. 값 0은 간격이 2로 설정됨을 표시합니다. |
maximumActiveServers | [R,W] | 이 관리 연결 팩토리에서 허용되는 최대 활성 백엔드 ClearQuest ONC RPC 서버 수입니다. 기본값은 10입니다. |
recycleServerHttpSessionLimi | [R,W] | 백엔드 ClearQuest ONC RPC 서버가 관리 연결 팩토리에 의해 재순환되기 전에 처리하는 HTTP 세션 수입니다. 기본값은 200입니다. 0 값은 이 한계가 선택되지 않음을 표시합니다. |
recycleServerLifetimeLimit | [R,W] | 백엔드 ClearQuest ONC RPC 서버가 관리 연결 팩토리에 의해 재순환되기 전에 실행할 수 있는 최대 수명 시간(초)입니다. 기본값은 86,400초(24시간)입니다. 0 값은 이 한계가 선택되지 않음을 표시합니다. |
recycleServerOncrpcCallLimit | [R,W] | 백엔드 ClearQuest ONC RPC 서버가 관리 연결 팩토리에 의해 재순환되기 전에 처리하는 최대 ONC RPC 요청 수입니다. 기본값은 100,000입니다. 0 값은 이 한계가 선택되지 않음을 표시합니다. |
recyclingPeriod | [R,W] | 재순환 백엔드 ClearQuest ONC RPC 서버가 관리 연결 팩토리에 의해 종료되기 전에 세션 작업을 완료하도록 할당된 시간(초)입니다. 재순환 ClearQuest ONC RPC 백엔드 서버의 상태는 2(중지 중)입니다. 기본값은 1800초(30분)입니다. 이 값은 0보다 커야 합니다. |
remoteChartReportServerHostName | [R,W] | ![]() ![]() |
remoteChartReportServerPort | [R,W] | ![]() ![]() |
serverWorkerThreadCount | [R,W] | 백엔드 ClearQuest ONC RPC 서버가 수신 요청을 처리하는 데 사용하는 스레드 수입니다. 기본값은 30입니다. |
MBean 속성 | 액세스 제어 | 설명 |
---|---|---|
hostname | [R] | 백엔드 ONC RPC 서버가 실행 중인 호스트의 이름. |
oncrpcCalls | [R] | 백엔드 ONC RPC 서버가 처리하는 총 ONC RPC 호출 수. |
port | [R] | 백엔드 ONC RPC 서버가 청취 중인 정수 포트 번호. |
serverId | [R] | 백엔드 ONC RPC 서버의 고유 ID. |
serverStartTime | [R] | 백엔드 ONC RPC 서버가 시작된 때를 표시하는 시간소인입니다. 이 값은 1970년 1월 1일 00:00:00 GMT 이후의 밀리초 수입니다. |
serverState | [R] | 백엔드 ONC RPC 서버의 현재 상태이며 정수(0=중지됨, 1=실행 중, 2=중지 중, 3=데드 상태)로 표시됩니다. |
serverStoppingTime | [R] | 백엔드 ONC RPC 서버가 중지 중(2) 상태로 들어간 때를 표시하는 시간소인입니다. 이 값은 1970년 1월 1일 00:00:00 GMT 이후의 밀리초 수입니다. |
serverStopTime | [R] | 백엔드 ONC RPC 서버가 중지됨(0) 또는 데드(3) 상태로 들어간 때를 표시하는 시간소인입니다. 이 값은 1970년 1월 1일 00:00:00 GMT 이후의 밀리초 수입니다. |
serverType | [R] | 백엔드 ONC RPC 서버의 유형: Rational ClearQuest. |
CqOncrpcServerMBean 프로세스는 OncrpcServerMBean 프로세스의 확장입니다. 각 CqOncrpcServerMBean 프로세스는 OncrpcServerMBean 프로세스에서 정의된 모든 값과 표 4에 설명된 속성을 포함하고 있습니다.
MBean 속성 | 액세스 제어 | 설명 |
---|---|---|
activeHttpSessions | [R] | 백엔드 ClearQuest ONC RPC 서버가 처리 중인 활성 HTTP 세션 수. |
activeStatefulHttpSessions | [R] | 백엔드 ClearQuest ONC RPC 서버가 처리 중인 stateful HTTP 세션 수. |
recycleReasonCode | [R] | 백엔드 ClearQuest ONC RPC 서버가 재순환되고 있는 이유를 표시하는
이유 코드입니다. 이 속성은 정수값입니다.
|
recycleServerHttpSessionLimit | [R,W] | 백엔드 ClearQuest ONC RPC 서버가 재순환되기 전에 처리할 수 있는 최대 세션 수입니다. 기본값은 CqServerFactoryMBean의 recycleServerHttpSessionLimit 속성 값을 사용하여 설정됩니다. 이 값은 실행 중인 ClearQuest ONC RPC 백엔드 서버에서만 설정될 수 있습니다. 모든 ONC RPC 백엔드 서버 프로세스는 일시적입니다. 실행 중인 ClearQuest ONC RPC 서버에서 이 값을 설정하는 경우 ClearQuest 관리 연결 팩토리가 서버를 종료하면 값을 설정하는 데 실패할 수 있습니다. |
totalHttpSessions | [R] | 백엔드 ClearQuest ONC RPC 서버가 지원하는 HTTP 세션 수. |
workerThreadCount | [R] | 백엔드 ClearQuest ONC RPC 서버가 요청을 처리하는 데 사용하는 스레드 수. |
wsadmin 도구를 사용하여 MBean 속성 검색 및 설정
이 예제는 wsadmin 도구를 시작하고 사용하기 위한 Jacl 기반 명령을 보여줍니다.
// 이 절에서는 wsadmin 도구를 시작하고 사용하기 위한 샘플 명령을 제공합니다.
// 이 예제에서 운영 체제 명령 프롬프트는
// 해시 문자, "#" 및 wsadmin 명령 프롬프트는 "wsadmin>"으로 표기됩니다.
//
// 여러 가지 편의 메소드와 함수를 제공하는 ClearQuest Web 서버 wsadmin 도구 스크립트가
// 있습니다. 기본적으로 이 스크립트는 다음 디렉토리에
// 있습니다.
// Windows의 경우:
// "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
// UNIX 시스템 및 Linux의 경우:
// "/opt/rational/common/CM/scripts"(UNIX 시스템 및 Linux)
//
// 명령 프롬프트를 열고 기본 디렉토리를
// ClearQuest Web 서버 wsadmin 도구 스크립트의 위치로 설정하십시오. 예를 들어, 다음과 같습니다.
//
// Windows의 경우:
# cd "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
//
// UNIX 시스템 및 Linux의 경우:
# cd /opt/rational/common/CM/scripts
//
// 원하는 쉘에 적합한 구문을 사용하여 WAS_BIN 환경 변수를
// wsadmin 도구의 위치로 설정하십시오. 예를 들어, 다음과 같습니다.
//
// Windows의 경우:
# set WAS_BIN="C:\Program Files\IBM\RationalSDLC\common\eWAS\bin"
// UNIX 시스템 및 Linux의 경우:
# WAS_BIN=/opt/rational/common/eWAS/bin
// ClearQuest Web 서버 프로파일 이름을 지정하여 wsadmin 도구를 시작하십시오.
// 기본 ClearQuest Web 서버 프로파일 이름은 'cmprofile'입니다. 예를 들어, 다음과 같습니다.
//
// Windows의 경우:
# %WAS_BIN%\wsadmin -profileName cmprofile
// UNIX 시스템 및 Linux의 경우:
# $WAS_BIN/wsadmin.sh -profileName cmprofile
// 다음 wsadmin 명령은 ClearQuest Web 서버 wsadmin 편의 함수를 로드합니다.
wsadmin> source teamAdminUtils.jacl
// 다음 명령은 몇 가지 유용한 ClearQuest Web 서버 명령을 표시하는 방법의 예제입니다.
// getTeamServer 함수는 최상위 레벨 TeamServerMBean에 포인터를 지정하는 데 유용하며,
// 각각의 TeamServerMBean 속성을 가져오고 설정하는 데 도움이 됩니다.
//
wsadmin> info proc *Team*
startTeamEAR stopTeamEAR getTeamServer
// 다음 명령은 MBean 값을 빠르고 쉽게 보는 데 사용할 수 있는 'dump' 명령을
// 표시합니다.
wsadmin> info proc dump*
dumpAllServers dumpAll dumpTeamServer dumpCcServers dumpCqServerFactory
dumpCcServerFactory dumpCqServers
// 다음 명령은 편의 명령 'getTeamServer'을 사용하여 변수
// 't'를 설정합니다. 이 변수는 TeamServerMBean 속성에 액세스하는 데 사용할 수 있습니다.
wsadmin> set t [getTeamServer]
// 변수 't'를 사용하여 TeamServerMBean 속성 값을 검색합니다.
wsadmin> $AdminControl getAttributes $t
{cqServerFactory WebSphere:cell=testhost2Node01Cell,version=6.1.0.0,spec=1.0,name=CqServerFactoryMBeanId,
mbeanIdentifier=CqServerFactoryMBeanId,type=stp.management.CqServerFactoryMBean,node=testhost2Node01,
process=server1}
{oncrpcBufferLimit 100}
{cqLoginSessionWaitTimeout 300}
{oncrpcInterruptLimit 1000}
{sessionReaperThreadDelay 900}
{sessionQueryObjectTimeout 1800}
{oncrpcServers {
{cqLoginSessionTimeout 1800}
{cqFulltextSearchRecordHitLimit 100}
{ejbBufferLimit 100}
{sessionRecordObjectTimeout 10800}
{cqFulltextSearchPageSize 25}
{numberOfActiveSessions 0}
{sessionObjectDefaultTimeout 1800}
{maxProcureServerAttempts 6}
{cqFulltextSearchCacheSize 1000}
{maxCqSessionsPerUser 2}
{totalNumberOfOncrpcServers 0}
{numberOfHttpSessionsCreated 0}
{procureServerInterval 60}
// 모든 TeamServerMBean 속성을 보다 편리하게 검색할 수 있는 방법은 다음과 같습니다.
wsadmin> dumpTeamServer
TeamServerMBean Attributes:
====================
{cqServerFactory WebSphere:cell=testhost2Node01Cell,version=6.1.0.0,spec=1.0,name=CqServerFactoryMBeanId,
mbeanIdentifier=CqServerFactoryMBeanId,type=stp.management.CqServerFactoryMBean,node=testhost2Node01,
process=server1}
// 기타 'get' 편의 명령에는 getCqServerFactory, getTeamServer
// 및 getOncrpcServers가 포함됩니다.
// 다음 명령은 CqServerFactoryMBean에 액세스하기 위한 변수 'cq'를 설정합니다.
// 이전 명령에서 정의된 변수 't'는 TeamServerMBean의 cqServerFactory 속성 값에 대한
// 포인터를 얻는 데 사용되는 점을 참고하십시오.
// 그런 다음, 변수 'cq'는 CqServerFactoryMBean의 속성에 액세스하는 데 사용할 수 있습니다.
wsadmin> set cq [$AdminControl getAttribute $t cqServerFactory]
// 변수 'cq'를 보다 편리하게 설정할 수 있는 방법은 다음과 같습니다.
wsadmin>set cq [getCqServerFactory]
// 다음 명령은 이전에 정의된 'cq' 변수를 사용하여 CqServerFactoryMBean 속성 값을
// 검색합니다.
wsadmin> $AdminControl getAttributes $cq
. . .
// 다음 명령은 ONCRPC 서버 MBeans 목록에 액세스하는 데 사용하는 변수 'os'를 설정합니다.
// 이는 각각 특정 ONCRPC 백엔드 서버를 나타냅니다.
// 이 명령은 이 세션 앞부분에 제공된 teamAdminUtils.jacl 스크립트에
// 정의되어 있는 편리한 메소드 중 하나를 사용합니다.
wsadmin> set os [$AdminControl invoke $t getOncrpcServers]
. . .
// 실행 중인 oncrpc 백엔드 서버의 목록이 표시됩니다. 첫 번째
// oncrpc 서버는 색인 0(영), 두 번째는 색인 1 등에 있습니다.
// 다음 명령은 위 명령의 결과 중 첫 번째 oncrpc 서버 MBean에 액세스할 수 있는
// 변수 'o'를 설정합니다. 이 레벨의 MBean 속성
// 액세스(즉, 특정 oncrpc 서버 MBeans)는 백엔드 oncrpc 서버 프로세스가 일시적이라
// 액세스하기 전에 없어질 수 있으므로 주의해야 합니다.
wsadmin> set o [getOnc 0] // '0'은 위 명령의 결과로 표시된 첫 번째 백엔드 서버의
// 색인 번호입니다.
// 다음 명령은 변수 'o'로 정의된 CQ oncrpc 서버의 MBean 속성 값을
// 검색합니다.
wsadmin> $AdminControl getAttributes $o
{workerThreadCount 16}
{serverState 1}
{activeStatefulHttpSessions 0}
{port 3431}
{oncrpcCalls 7}
{recycleServerHttpSessionLimit 500}
{serverId {ClearQuest - 0
{serverType ClearQuest}
{hostname testhost2}
{activeHttpSessions 0}
{totalHttpSessions 1}
// 다음 명령은 변수 'o'를 통해 이미 정의된 CQ oncrpc 서버의
// recycleServerHttpSessionLimit 속성을 설정하고 가져옵니다.
wsadmin> $AdminControl setAttribute $o recycleServerHttpSessionLimit 501
wsadmin> $AdminControl getAttribute $o recycleServerHttpSessionLimit 501
// 나머지 명령은 기타 oncrpc 서버 MBean 액세스 및 해당 결과물을 표시합니다.
// ONCRPC 서버 목록은 일시적이므로 dump 명령(예:
// dumpCqServers 또는 dumpAllServers)을 사용하는 것이 훨씬 더 편리합니다.
wsadmin> listOnc
"WebSphere:cell=testhost2Node02Cell,version=6.1.0.0,spec=1.0,
name=ClearQuest - 11,mbeanIdentifier=ClearQuest - 11,
type=stp.management.CqOncrpcServerMBean,node=testhost2Node02,
process=server1"
// 다음은 편의 dump 명령을 사용하는 경우의 예제입니다.
wsadmin> dumpAllServers
ONCRPC Server: ClearQuest - 0
============
{workerThreadCount 10}
{serverState 1}
{activeStatefulHttpSessions 0}
{port 3693}
{oncrpcCalls 1}
{recycleServerHttpSessionLimit 500}
{serverStartTime 1215633895763}
{serverId {ClearQuest - 0
{recycleReasonCode 0}
{serverType ClearQuest}
{hostname testhost2}
{activeHttpSessions 0}
{totalHttpSessions 0}
wsadmin> dumpCqServers
CQRPC Server: ClearQuest - 0
===========
{workerThreadCount 10}
{serverState 1}
{activeStatefulHttpSessions 0}
{port 3693}
{oncrpcCalls 1}
{recycleServerHttpSessionLimit 500}
{serverStartTime 1215633895763}
{serverId {ClearQuest - 0
{recycleReasonCode 0}
{serverType ClearQuest}
{hostname duke2}
{activeHttpSessions 0}
{totalHttpSessions 0}
wsadmin> dumpCqServerFactory
CqServerFactoryMBean Attributes:
==========================
{serverWorkerThreadCount 10}
{recycleServerLifetimeLimit 14400}
{recyclingPeriod 3600}
{recycleServerOncrpcCallLimit 500000}
{recycleServerHttpSessionLimit 500}
{maximumActiveServers 4}
{activeHttpSessionThreshold 40}
wsadmin> dumpAll
// 이 명령의 결과물은 현재 실행 중인 모든 백엔드 ONCRPC 서버 프로세스를 비롯한
// 모든 MBean 속성 값의 dump입니다.
wsadmin 도구를 사용하여 MBean 속성 가져오기 및 내보내기
wsadmin 도구에서 ClearQuest Web 서버 가져오기 및 내보내기 편의 명령을 사용하여 각각 MBean 속성을 가져오고 내보냅니다. 이 명령을 사용하여 MBean 속성 값을 검색하고 업데이트할 수 있으며 특정 구성을 쉽게 캡처할 수 있습니다. ClearQuest Web 서버가 제대로 기능하지 않는 경우 이전에 캡처한 사용 가능한 구성을 실시간으로 가져올 수 있습니다.
문서 편집기를 사용하여 특성 파일을 편집한 후 이들 파일을 실시간으로 가져오고 내보낼 수 있습니다. 특성 파일에서 가져올 필요가 없는 항목을 주석 처리할 수 있습니다. MBean 이름 및 속성 이름에 대해 이름 지정 규칙을 따르십시오. importFile 명령을 사용할 때 문자열 값을 지우려면 가져오는 특성 파일에서 값을 공백으로 남겨 두거나 ""를 지정하십시오. 숫자 값을 공백으로 두지 마십시오.
// 이 wsadmin 명령은 importFile 및 exportToFile 명령을 포함한
// 모든 편의 명령 및 메소드를 로드합니다. 이들 명령을 사용하여
// MBean 속성 값을 검색하고 업데이트할 수 있으며 특정 구성을 쉽게
// 캡처할 수 있습니다. ClearQuest Web 서버(이전 릴리스에서 CM Server로
// 참조됨)가 제대로 기능하지 않는 경우 이전에 캡처한 구성을 실시간으로
// 가져올 수 있습니다.
//
wsadmin> source teamAdminUtils.jacl
// TeamServerMBean 및 CqServerFactoryMBean MBean의 스냅샷을
// 캡처하려면 exportToFile 명령을 사용하십시오. 파일을 저장할
// 전체 경로 이름을 지정하십시오. 문서 편집기를 사용하여
// 작성된 특성 파일을 편집하고 importFile 명령을 사용하여 파일을
// 가져올 수 있습니다.
// 중요: 이러한 명령의 경로 이름에는 슬래시를 사용해야 합니다.
wsadmin> exportToFile C:/temp/CmServer.properties
File "C:/temp/CmServer.properties" does not exist, proceeding with export...
Retrieving MBeans...
Exporting TeamServerMBean.sessionReaperThreadDelay...
Exporting TeamServerMBean.cqLoginSessionTimeout...
Exporting TeamServerMBean.cqLoginSessionWaitTimeout...
Exporting TeamServerMBean.sessionObjectDefaultTimeout...
Exporting TeamServerMBean.sessionQueryObjectTimeout...
Exporting TeamServerMBean.sessionRecordObjectTimeout...
Exporting TeamServerMBean.oncrpcBufferLimit...
Exporting TeamServerMBean.oncrpcInterruptLimit...
Exporting TeamServerMBean.ejbBufferLimit...
Exporting TeamServerMBean.cqFulltextSearchPageSize...
Exporting TeamServerMBean.cqFulltextSearchCacheSize...
Exporting TeamServerMBean.cqFulltextSearchRecordHitLimit...
Exporting TeamServerMBean.procureServerInterval...
Exporting TeamServerMBean.maxProcureServerAttempts...
Exporting TeamServerMBean.maxCqSessionsPerUser...
Exporting CqServerFactoryMBean.serverWorkerThreadCount...
Exporting CqServerFactoryMBean.activeHttpSessionThreshold...
Exporting CqServerFactoryMBean.maximumActiveServers...
Exporting CqServerFactoryMBean.recycleServerHttpSessionLimit...
Exporting CqServerFactoryMBean.recycleServerLifetimeLimit...
Exporting CqServerFactoryMBean.recycleServerOncrpcCallLimit...
Exporting CqServerFactoryMBean.recyclingPeriod...
wsadmin> importFile C:/temp/CmServer.properties
File "C:/temp/CmServer.properties" found, proceeding with import...
Importing value '900' into property sessionReaperThreadDelay in MBean TeamServerMBean
Old value=900
New value=900
Importing value '1803' into property cqLoginSessionTimeout in MBean TeamServerMBean
Old value=1803
New value=1803
Importing value '300' into property cqLoginSessionWaitTimeout in MBean TeamServerMBean
Old value=300
New value=300
Importing value '1800' into property sessionObjectDefaultTimeout in MBean TeamServerMBean
Old value=1800
New value=1800
. . .
// 이미 존재하는 파일을 내보내는 경우에는 명령에 지정한 파일 이름에
// 시간소인이 추가됩니다.
wsadmin> exportToFile C:/temp/CmServer.properties
File "C:/temp/CmServer.properties" already exists; appending date to file name.
exportFilePath is now: C:/temp/CmServer.properties_2008-07-09_16-27-11
Retrieving MBeans...
Exporting TeamServerMBean.sessionReaperThreadDelay...
// 다음은 내보낸 파일의 예제입니다.
C:\> type c:\temp\CmServer.properties
# ClearQuest Web 서버 MBean 속성 내보내기(작성 날짜: 2008-07-09_16-22-29)
#
#
# TeamServerMBean writable attributes
#
TeamServerMBean.sessionReaperThreadDelay=900
TeamServerMBean.cqLoginSessionTimeout=1803
TeamServerMBean.cqLoginSessionWaitTimeout=300
TeamServerMBean.sessionObjectDefaultTimeout=1800
TeamServerMBean.sessionQueryObjectTimeout=1803
TeamServerMBean.sessionRecordObjectTimeout=10800
TeamServerMBean.oncrpcBufferLimit=100
TeamServerMBean.oncrpcInterruptLimit=1000
TeamServerMBean.ejbBufferLimit=100
TeamServerMBean.cqFulltextSearchPageSize=25
TeamServerMBean.cqFulltextSearchCacheSize=1000
TeamServerMBean.cqFulltextSearchRecordHitLimit=100
TeamServerMBean.procureServerInterval=60
TeamServerMBean.maxProcureServerAttempts=6
TeamServerMBean.maxCqSessionsPerUser=2
#
# CqServerFactoryMBean writable attributes
#
CqServerFactoryMBean.serverWorkerThreadCount=10
CqServerFactoryMBean.activeHttpSessionThreshold=40
CqServerFactoryMBean.maximumActiveServers=4
CqServerFactoryMBean.recycleServerHttpSessionLimit=500
CqServerFactoryMBean.recycleServerLifetimeLimit=14400
CqServerFactoryMBean.recycleServerOncrpcCallLimit=500000
CqServerFactoryMBean.recyclingPeriod=3600