사용 가능한 MBean 속성을 설정하여
IBM® Rational® ClearQuest® Web 서버를 사용자 정의할 수 있습니다.
주의: 쓰기를 의미하는 [W] 표기법으로 수정 가능으로 문서화되거나
IBM 지원 센터에서 수정하도록 지시하지 않는 한
MBean 속성을 수정하지 마십시오. 읽기 전용[R] 또는 문서화되지 않은
MBean 속성을 수정하면 시스템 성능에 영향을 미칠 수 있습니다.
속성은 속성이 있는 MBean별로 분류됩니다. 읽기를 의미하는 [R]로 표시되는 대로 모든 매개변수를 검색할 수 있습니다. 수정 가능한
매개변수는 쓰기를 의미하는 [W]로 표시됩니다. IBM WebSphere® Application Server wsadmin
명령행 유틸리티를 사용하여 Jacl 명령으로 속성에
액세스할 수 있습니다. teamAdminUtils.jacl 파일은
Jacl 명령, 구문, 기능의 예제를 제공합니다. 또한
사이트 구성 대화 상자를 사용하여
일부 ClearQuest Web 서버 MBean 속성을 수정할 수 있습니다.
ClearQuest Web 서버가 실행 중인 경우에만 수정 가능한 MBean 매개변수에 대한
변경사항을 작성할 수 있습니다. 변경사항은 서버 프로세스를 다시 시작하지 않고도
즉시 적용됩니다. 백엔드 개방형 네트워크 컴퓨팅 원격 프로시저 호출(ONC RPC)
서버 프로세스의 시작을 관리하는
MBean 속성에 작성된 변경사항은 이미 시작된 백엔드 ONC RPC 프로세스에
영향을 미치지 않습니다. 새 백엔드 ONC RPC 서버 프로세스만
새 설정을 사용합니다.
ClearQuest Web 서버가 시작되면
두 개의 MBean이 작성됩니다. TeamServerMBean(ClearQuest Web 서버
구성 속성 보유) 및 CqServerFactoryMBean(ClearQuest
관리 연결 팩토리 속성 보유)
ClearQuest 관리 연결 팩토리는
하나 이상의 다중 스레드 ClearQuest ONC RPC 백엔드 서버 프로세스를
시작하기 위한 ClearQuest Web 서버
컴포넌트입니다. 각 ClearQuest RPC
프로세스는 다중 스레드이므로 여러 다른 신임 정보의 요청을
처리할 수 있습니다. ClearQuest 관리 연결 팩토리는
각 ClearQuest RPC 프로세스에서
자동으로 라이프사이클 관리를 수행합니다.
ClearQuest Web 서버는
다음 MBean을 포함합니다.
- TeamServerMBean
TeamServerMBean은
전체 ClearQuest Web 서버 동작과 관련된 속성을
보유합니다. ClearQuest 서버 팩토리가 작동하는 방법을
제어하는 데 적용되는 속성은 CqServerFactoryMBean 서버 팩토리에 저장됩니다.
- cqFulltextSearchCacheSize[R,W] - 단일 전체 텍스트 검색에 대해
ClearQuest 코어에 저장된
레코드 히트 수. 이 값은
ClearQuest 코어에서 가정한 기본 동작을 대체하는 데 사용됩니다.
이 속성의 기본값은 0이며 이는 이 값이 설정되지 않았으며
ClearQuest 코어의 기본 설정을 대체하는 데 사용해서는 안됨을 ClearQuest Web 서버에
나타냅니다. 양의 값은 ClearQuest 코어의 기본 설정을 대체합니다.
- cqFulltextSearchPageSize[R,W] - 단일
전체 텍스트 검색에 대한 ClearQuest 코어에서
전체 텍스트 검색 결과 페이지의 레코드 히트 수. 이 값은
ClearQuest 코어에서 가정한 기본 동작을 대체하는 데 사용됩니다.
이 속성의 기본값은 0이며 이는 이 값이 설정되지 않았으며
ClearQuest 코어의 기본 설정을 대체하는 데 사용해서는 안됨을 ClearQuest Web 서버에
나타냅니다. 양의 값은 ClearQuest 코어의 기본 설정을 대체합니다.
- cqFulltextSearchRecordHitLimit[R,W] - 단일 전체
텍스트 검색에 대해 하나의 웹 서비스 호출에 리턴된
최대 레코드 히트 수이며 애플리케이션 서버에 캐시될 수 있는
히트 수이기도 합니다. 기본값은 100입니다.
- cqLoginSessionTimeout[R,W] - 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 서버는
해당 간격 동안 트래픽이 전송되지 않은 경우 지정된 간격으로
클라이언트와 백엔드 서버 컴포넌트 간에 킵얼라이브(keep alive) 메시지를
발행합니다. 이는
장기 실행 중인 ClearQuest 조회가
기본 소켓을 제거하는 인프라 없이 완료할 수 있도록 디자인됩니다.
이 값은 소켓 제한시간 값보다 최소한 10초 미만이어야 합니다. 기본값은 300초(5분)입니다.
- largeReadSocketTimeoutMultiplier[R,W] - 장기 실행 중인 조작에 대해
중간 계층과 백엔드 서버 컴포넌트 사이의 소켓에서 읽기 제한시간 값에 적용되는
배수입니다. 기본값 4는 읽기 소켓 제한시간 값이 백엔드 서버 팩토리 기본 읽기
소켓 제한시간 값의 4배임을 나타냅니다. 이 배수는 특정 조작에만 적용됩니다.
IBM 지원 센터의 지시가 없으면
값을 변경하지 마십시오.
- maxCqSessionsPerUser[R,W] - 단일 세션에서 각 사용자에 대해 작성될 ClearQuest 세션의 최대 수입니다. 기본값은 2이고, 최소값은 1입니다.
- maxProcureServerAttempts[R,W] - 관리 연결 풀로
예외를 리턴하기 전에 백엔드 ONC RPC 서버를 확보할 수 있는
최대 시도 수. 기본값은 6이며 2 이상이어야 합니다.
- mediumReadSocketTimeoutMultiplier[R,W] - 장기 실행 중인 조작에 대해
중간 계층과 백엔드 서버 컴포넌트 사이의 소켓에서 읽기 제한시간 값에 적용되는
배수입니다. 기본값 2는 읽기 소켓 제한시간 값이 백엔드 서버 팩토리 기본 읽기
소켓 제한시간 값의 2배임을 나타냅니다. 이 배수는 특정 조작에만 적용됩니다. 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] - 서버가 시작된 이후로 작성된 총 oncrpc 호출 수.
- totalWebServiceCallCount[R] - 서버가 시작된
이후로 작성된 총 웹 서비스 호출 수.
- versionNumber[R] - ClearQuest Web
서버 제품 버전 번호(문자열 값으로 표시되고
마침표로 구분됨). 예: 7.1.0.1.
- CqServerFactoryMBean
이 MBean은
ClearQuest 관리 연결 팩토리와 관련된
구성 속성을 보유합니다. ClearQuest 관리 연결 팩토리가
ClearQuest 코어와 통신하는
ClearQuest ONC RPC 백엔드 프로세스를 시작하고 관리합니다.
이 MBean의 속성은 TeamServerMBean의 일부 ClearQuest 특정 속성처럼
ClearQuest 일반 동작에 영향을 미치지 않습니다. 대신
이 MBean의 속성이 팩토리의 동작 및
실행되는 ClearQuest ONC
RPC 백엔드 프로세스의 관리를 제어합니다. 이 MBean의
변경사항은 새로 실행된 백엔드 프로세스에 대해
즉시 적용되고(기존 백엔드 프로세스에는 영향을 주지 않음)
서버 프로세스를 다시 시작할 필요는 없습니다.
- activeHttpSessionThreshold[R,W] - 초과하는 경우
이 관리 연결 팩토리에 의해 다른 백엔드 ClearQuest ONC RPC 서버가
시작되도록 할 수 있는 활성 백엔드 ClearQuest ONC RPC 서버의
활성 HTTP 세션 수. 기본값은 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입니다.
- recycleServerHttpSessionLimit[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] - UNIX 시스템 및 Linux에만 해당.
차트 및 보고서 요청을 처리하도록 지정된
Windows ClearQuest Web 서버의 호스트 이름. 기본값은 ""(빈 문자열/설정 안함)입니다.
- remoteChartReportServerPort[R,W] - UNIX 시스템 및 Linux에만 해당.
차트 및 보고서 요청을 처리하도록 지정된 Windows ClearQuest Web 서버의
포트 번호. 기본값은 0입니다.
- serverWorkerThreadCount[R,W] - 백엔드
ClearQuest ONC RPC 서버가
수신 요청을 처리하는 데 사용할 스레드 수. 기본값은 30입니다.
- OncrpcServerMBean:
ClearQuest
관리 연결 팩토리가 시작하는 각 ONC RPC 백엔드 프로세스에 대해
CqOncrpcServerMBean 인스턴스가 작성됩니다.
각 MBean은 기본 OncrpcServerMBean에 정의된 값을
포함합니다(기본 OncrpcServerMBean은 인스턴스화되지 않음). 각 서버
프로세스 MBean은 MBean이 표시하는 프로세스가
ClearQuest Web 서버 시스템에서 실행 중인 동안에만
존재합니다. 프로세스가 종료되면 프로세스를 표시하는 MBean도
종료됩니다. 다음은 모든 서버 프로세스
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 ClearCase®).
- CqOncrpcServerMBean
ClearQuest
관리 연결 팩토리가 시작하는 각 ClearQuest ONC RPC
백엔드 프로세스에 대해 CqOncrpcServerMBean MBean 인스턴스가
작성됩니다. 이 인스턴스는 이 인스턴스가 표시하는
ClearQuest ONC RPC 백엔드 프로세스가 ClearQuest Web
서버 시스템에서 실행 중인 동안에만 존재합니다. 프로세스가 종료되는 즉시 프로세스를 표시하는 MBean 또한 종료됩니다.
CqOncrpcServerMBean은
OncrpcServerMBean의 확장입니다. 각 CqOncrpcServerMBean은
OncrpcServerMBean이 정의한 모든 값 및
다음 추가 값을 포함합니다.
- activeHttpSessions[R] - 백엔드
ClearQuest ONC RPC 서버가 처리 중인
현재 활성 HTTP 세션 수.
- activeStatefulHttpSessions[R] - 백엔드
ClearQuest ONC RPC 서버가 처리 중인
현재 stateful HTTP 세션 수.
- recycleReasonCode[R] - 백엔드
ClearQuest ONC RPC 서버가 재순환되는 이유를 표시하는 이유 코드(정수로 표시).
- 1=RECYCLE_TIME_LIMIT_EXCEEDED
- 2=ONCRPC_CALL_LIMIT_EXCEEDED
- 3=SESSION_LIMIT_EXCEEDED
- recycleServerHttpSessionLimit[R,W] - 백엔드
ClearQuest ONC RPC 서버가 재순환되기 전에 처리할
최대 세션 수. 기본값은 처음에는 CqServerFactoryMBean의 recycleServerHttpSessionLimit 속성 값을 사용하여 설정됩니다.
실행 중인 ClearQuest ONC RPC 백엔드 서버에서만 설정할 수 있습니다. 모든
ONC RPC 백엔드 서버 프로세스는 일시적임을 참고하십시오. 값을 변경하도록
시도하는 중에 ClearQuest 관리 연결 팩토리가
서버를 종료하는 경우 실행 중인 ClearQuest ONC
RPC 서버에서의 값 설정이 실패할 수 있습니다.
- totalHttpSessions[R] - 백엔드
ClearQuest ONC RPC 서버가 처리한
총 HTTP 세션 수.
- workerThreadCount[R] - 백엔드
ClearQuest ONC RPC 서버가 요청을 처리하기 위해 사용 중인 스레드 수.