제2장 주요 기능

내용 목차

2.1. 시스템 조회/제어
2.2. 환경 파일 설정
2.2.1. 설정 추가
2.2.2. 설정 변경
2.3. 모니터링
2.3.1. Node
2.3.2. HTH Statistics
2.3.3. Thread
2.3.4. Thread Summary
2.3.5. Server
2.3.6. JSV Server
2.3.7. Process
2.3.8. Service
2.3.9. Reverse Proxy Group
2.3.10. Reverse Proxy
2.3.11. Handler (client)
2.3.12. Handler Summary

본 장에서는 WebAdmin의 각 메뉴에 대한 설명과 사용법에 대해서 설명한다.

2.1. 시스템 조회/제어

[시스템 조회/제어] 메뉴에서 관리자가 현재 WebtoB가 사용하고 있는 설정값, 접속된 클라이언트 정보 등을 확인할 수 있다. 설정 확인은 wsadminconfig 명령과 유사하다. 명령어에 대한 자세한 사용법은 WebtoB 관리자 안내서”의 “6.1.1.2. config (cfg)”를 참고한다.

다음은 시스템 구성에서 [Node]를 선택하면 조회되는 화면이다.

[그림 2.1] WebAdmin 시스템 조회 노드 선택

WebAdmin 시스템 조회 노드 선택

메인 영역에 WebtoB 노드의 정보가 출력된다. 노드 이름(Name)을 클릭하면 노드의 자세한 설정 정보가 출력된다. 각 항목에 대한 설명은 WebtoB 관리자 안내서”의 “3.3. NODE 절”을 참고한다.

[그림 2.2] WebAdmin 시스템 조회 노드 정보

WebAdmin 시스템 조회 노드 정보

참고

모든 시스템 개채별 보기에 있는 모든 항목들이 같은 방식으로 동작한다. 개별 설정들은 WebtoB 관리자 안내서”의 “3.3.1. 설정 항목”을 참고한다.

동적 제어 정보

특정 설정들은 동적으로 변경할 수 있다. 동적으로 변경 가능한 설정들은 WebtoB 재기동이 필요없다. 동적 설정 변경은 wsadminset 명령과 동일한 역할을 한다. 명령어에 대한 자세한 사용법은 WebtoB 관리자 안내서”의 “6.1.5.1. set”을 참고한다.

다음은 [동적 제어 정보] 버튼을 클릭하면 조회되는 화면이다. 변경할 항목들에 새로운 값을 입력하고, [확인] 버튼을 클릭하면 설정이 변경된다.

[그림 2.3] WebAdmin 시스템 동적 설정 제어

WebAdmin 시스템 동적 설정 제어

2.2. 환경 파일 설정

[환경 파일 설정] 메뉴에서는 현재 WebtoB 설정 파일에 설정된 정보를 각 절별로 조회하고 추가 및 변경할 수 있다.

다음은 시스템 구성에서 [VHost]를 선택하면 조회되는 화면이다.

[그림 2.4] WebAdmin 환경 파일 설정

WebAdmin 환경 파일 설정

VHost의 이름을 클릭하면 다음과 같이 환경 파일의 VHost 설정 정보가 조회된다. 개별 항목에 대한 자세한 설명은 WebtoB 관리자 안내서”의 “3.4.1. 설정 항목”을 참고한다. 설정 파일에 저장된 모든 절에 대한 설정 정보를 확인할 수 있다.

[그림 2.5] WebAdmin 환경설정 - VHost

WebAdmin 환경설정 - VHost

2.2.1. 설정 추가

다음은 환경 파일을 추가하는 과정에 대한 설명이다.

  1. 시스템 구성에서 환경 파일에 추가할 시스템을 선택한다.

    [그림 2.6] WebAdmin 환경 설정 추가 (1)

    WebAdmin 환경 설정 추가 (1)

  2. 위 화면에서 왼쪽에 [생성] 버튼을 클릭한다.

    [그림 2.7] WebAdmin 환경 설정 추가 (2)

    WebAdmin 환경 설정 추가 (2)

  3. 설정의 각 항목(필드)를 입력한 후 왼쪽 [추가] 버튼을 클릭한다.

    [그림 2.8] WebAdmin 환경 설정 추가 (3)

    WebAdmin 환경 설정 추가 (3)

  4. 설정 추가가 완료되었으면 오른쪽에 [저장] 버튼을 클릭한다.

  5. 저장 후 [컴파일] 버튼을 클릭하면 해당 파일을 적용한다.

2.2.2. 설정 변경

다음은 환경 파일을 수정하는 과정에 대한 설명이다.

  1. 시스템 구성에서 환경 파일에 수정할 시스템을 선택한다. 각 항목을 수정한 후 왼쪽의 [저장] 버튼을 클릭한다.

    [그림 2.9] WebAdmin 환경 설정 변경

    WebAdmin 환경 설정 변경

  2. 변경 및 추가 내용 확인을 위해 오른쪽 [비교보기] 버튼을 클릭하여 아래 그림과 같이 내용을 확인할 수 있다. [원래대로] 버튼을 클릭하면 기존의 설정으로 되돌릴 수 있다.

    [그림 2.10] WebAdmin 환경 설정 변경 - 비교보기

    WebAdmin 환경 설정 변경 - 비교보기

  3. 설정 변경 및 추가가 완료되었으면 오른쪽 [저장] 버튼을 클릭한다.

  4. 저장된 내용은 [컴파일] 버튼을 클릭해서 적용한다.

2.3. 모니터링

[모니터링] 메뉴에서는 현재 WebtoB가 처리한 요청 수, 개별 서버들의 상태 등을 확인할 수 있다. 조회할 내용을 왼쪽의 트리 영역에 모니터링에서 선택한다. 모니터링 결과를 주기적으로 갱신하려면 오른쪽 위에 [모니터링] 버튼을 클릭하여 나타나는 창에 주기를 입력한다.

2.3.1. Node

다음은 모니터링에서 [Node]를 선택하면 조회되는 화면으로 노드에 대한 정보를 조회할 수 있다.

[그림 2.11] WebAdmin 모니터링

WebAdmin 모니터링

화면은 다음의 정보로 구성된다.

항목설명
Shared Memory Segment KeyNODE 절의 SHMKEY 값이다.
Shm Size실제 사용하는 Shared Memory의 크기이다.

2.3.2. HTH Statistics

다음은 모니터링에서 [HTH Statistics]를 선택하면 조회되는 화면으로 wsadminstat -h 명령어와 동일한 정보를 출력한다. 자세한 내용은 WebtoB 관리자 안내서”의 “6.1.2.3. stat (st)”를 참고한다.

[그림 2.12] WebAdmin 모니터링 - HTH Statistics

WebAdmin 모니터링 - HTH Statistics

2.3.3. Thread

다음은 모니터링에서 [Thread]를 선택하면 조회되는 화면으로 wsadminstat -t 명령어와 동일한 정보를 출력한다. 자세한 내용은 WebtoB 관리자 안내서”의 “6.1.2.3. stat (st)”를 참고한다.

[그림 2.13] WebAdmin 모니터링 - Thread

WebAdmin 모니터링 - Thread

항목설명
hthHTH 번호를 나타낸다.
threadid각 스레드의 이름이다.
status

현재 상태를 나타낸다.

  • RDY : 스레드가 새로운 작업을 기다리고 있다.

  • NRDY : 작업을 처리할 수 없다.

  • RUN : 스레드가 작업을 처리하고 있다.

elapsed작업시작 또는 작업완료 후 지나간 시간이다.
atasks전체 작업 수이다.
ptasks현재까지 처리된 작업 수이다.
qtasks아직 처리되지 않고 남아있는(큐잉된) 작업 수이다.

2.3.4. Thread Summary

다음은 모니터링에서 [Thread Summary]를 선택하면 조회되는 화면으로 wsadminstat -T 명령어와 동일한 정보를 출력한다. 자세한 내용은 WebtoB 관리자 안내서”의 “6.1.2.3. stat (st)”를 참고한다.

[그림 2.14] WebAdmin 모니터링 - Thread Summary

WebAdmin 모니터링 - Thread Summary

항목설명
hthHTH 번호를 나타낸다.
threadtype각 스레드의 타입이다.
status

현재 상태를 나타낸다.

  • RDY : 스레드가 새로운 작업을 기다리고 있다.

  • NRDY : 작업을 처리할 수 없다.

threadsthreadtype에 해당하는 스레드 수이다.
atasks전체 작업 수이다.
ptasks현재까지 처리된 작업 수이다.
qtasks아직 처리되지 않고 남아있는(큐잉된) 작업 수이다.

2.3.5. Server

다음은 모니터링에서 [Server]를 선택하면 조회되는 화면이다. 항목 값들은 wsadminsvrinfo 명령어와 동일하다. 자세한 내용은 WebtoB 관리자 안내서”의 “6.1.2.2. svrinfo (si)”를 참고한다.

[그림 2.15] WebAdmin 모니터링 - Server

WebAdmin 모니터링 - Server

항목설명
hthHTH 번호를 나타낸다.
svrname환경설정의 서버 이름이다.
svri내부적으로 관리되는 서버별 인덱스 번호이다.
status

서버 내부의 클라이언트 상태이다.

  • RDY : 서버가 요청을 처리할 수 있다. WebtoB와 연결된 서버 프로세스들이 존재한다.

  • NRDY : 요청을 처리할 수 없다. WebtoB와 연결된 서버 프로세스가 없다.

  • BLK : 서버가 관리자 명령에 따라 suspend된 상태이다. 서버는 요청을 처리할 수 없다.

reqs해당 서버에 보내진 요청 수이다.
count요청처리 수이다.
cqcnt현재 큐에서 대기 중인 요청 수이다.
aqcnt현재까지 큐에 대기했던 요청 수(cqcnt의 cumulative 값이다)이다.
qpcnt큐에 대기 중이던 요청이 timeout 또는 qp 명령 등으로 인해 큐에서 제거된 요청 수이다.
emcnt큐에 대기 중인 요청 수가 MaxQCount를 넘어간 횟수이다.
rscnt해당 서버의 비정상 종료로 인한 restart 횟수이다.
rbcnt해당 서버의 rbs 명령을 통한 reboot 횟수이다.

2.3.6. JSV Server

다음은 모니터링에서 [JSV Server]를 선택하면 조회되는 화면으로 wsadminstat -j 명령어와 동일한 정보를 출력한다. 자세한 내용은 WebtoB 관리자 안내서”의 “6.1.2.3. stat (st)”를 참고한다.

[그림 2.16] WebAdmin 모니터링 - JSV Server

WebAdmin 모니터링 - JSV Server

항목설명
hthHTH 번호를 나타낸다.
svrname환경설정의 서버 이름이다.
jengineno연결된 JEUS의 지정된 엔진 번호이다.
consJEUS와 연결된 커넥션 수이다.
reqs해당 서버에 보내진 요청 수이다.
count요청 처리 수이다.
avg평균 처리 시간이다.
jengineidWebtoB와 연결된 JEUS Servlet 엔진 이름이다.

2.3.7. Process

다음은 모니터링에서 [Process]를 선택하면 조회되는 화면으로 wsadminstat -p 명령어와 동일한 정보를 출력한다. 자세한 내용은 WebtoB 관리자 안내서”의 “6.1.2.3. stat (st)”를 참고한다.

[그림 2.17] WebAdmin 모니터링 - Process

WebAdmin 모니터링 - Process

항목설명
hthHTH 번호를 나타낸다.
svrname환경설정 SERVER 절의 서버 이름이다.
svgnameSVRGROUP 절의 서버 그룹 이름이다.
sprnoWebtoB 내부에서 할당한 번호이다.
pid프로세스 ID이다(JSV 서버경우 각 커넥션별 worker thread가 보내준 ID).
status

현재 상태를 나타낸다.

  • RDY : 프로세스가 새로운 요청을 기다리고 있다.

  • NRDY : 요청을 처리할 수 없다. WebtoB와 연결된 서버 프로세스가 없다.

  • RUN : 프로세스가 요청을 처리하고 있다.

  • BRUN : 프로세스가 요청에 대한 응답을 전송하는 중이다. 하지만 Flow Control로 인해 잠시 대기 중인 상태이다.

reqs해당 프로세스로 보내진 요청 수이다.
count해당 프로세스가 처리한 요청 수이다.
avg평균 처리시간 (초)이다.
rt현재 처리 중인 요청이 사용한 시간이다.
clid해당 프로세스가 처리 중인 클라이언트 ID이다.
svc요청이 속하는 EXT나 URI 절의 서비스 이름이다.
vJEUS 연결인 경우 WJP(WebtoB-JEUS Protocol) 버전 정보를 표시한다. 내부 서버 프로세스인 경우 0으로 표시한다.
contime해당 프로세스가 HTH에 연결을 맺은 후 지난 시간(HTH에 접속된 시간)이다.

2.3.8. Service

다음은 모니터링에서 [Service]를 선택하면 조회되는 화면으로 wsadminstat -s 명령어와 동일한 정보를 출력한다. 자세한 내용은 WebtoB 관리자 안내서”의 “6.1.2.3. stat (st)”를 참고한다.

[그림 2.18] WebAdmin 모니터링 - Service

WebAdmin 모니터링 - Service

항목설명
hthHTH 번호를 나타낸다.
svrname환경설정 SERVER 절의 서버 이름이다.
countWebtoB가 처리한 요청 중 해당 서비스에 속하는 요청 수이다.
avg해당 서버가 처리한 요청 수이다.
cqcnt현재 queue에 쌓인 수이다.
aqcnt누적 queue 건수이다.
qavg요청이 queue에 있던 평균 시간을 나타낸다.
status

현재 상태를 나타낸다.

  • RDY : 해당 서비스가 요청을 처리할 수 있는 상태이다.

  • NRDY : 요청을 처리할 수 없다.

  • BLK : 관리자 명령에 따라 suspend된 상태이다. 요청을 처리할 수 없다.

2.3.9. Reverse Proxy Group

다음은 모니터링에서 [Reverse Proxy Group]를 선택하면 조회되는 화면으로 wsadminstat -rpg 명령어와 동일한 정보를 출력한다. 자세한 내용은 WebtoB 관리자 안내서”의 “6.1.2.3. stat (st)”를 참고한다.

[그림 2.19] WebAdmin 모니터링 - Reverse Proxy Group

WebAdmin 모니터링 - Reverse Proxy Group

항목설명
hthHTH 번호를 나타낸다.
rpgiReverse Proxy Group 번호를 나타낸다.
rpgname설정의 Reverse Proxy Group 이름을 나타낸다.
rproxyname설정의 Reverse Proxy 이름을 나타낸다.
count요청 처리 수이다.
qcntReverse Proxy Group 단위의 큐잉된 요청 수(위와 같은 경우 rproxy1, rproxy2의 qcnt는 동일)이다.
avg평균 처리시간(초)이다.
consWAS와 연결된 커넥션 수이다.
remoteaddress클라이언트 IP:PORT이다.

2.3.10. Reverse Proxy

다음은 모니터링에서 [Reverse Proxy]를 선택하면 조회되는 화면으로 wsadminstat -rp 명령어와 동일한 정보를 출력한다. 자세한 내용은 WebtoB 관리자 안내서”의 “6.1.2.3. stat (st)”를 참고한다.

[그림 2.20] WebAdmin 모니터링 - Reverse Proxy

WebAdmin 모니터링 - Reverse Proxy

항목설명
hthHTH 번호를 나타낸다.
rproxyname설정의 Reverse Proxy 이름을 나타낸다.
rpgname설정의 Reverse Proxy Group 이름을 나타낸다.
status

해당 커넥션의 상태 정보이다.

  • RDY : 클라이언트로부터 Reverse Proxy 요청을 받을 수 있는 상태이다.

  • NRDY : 클라이언트로부터 Reverse Proxy 요청을 받을 수 없는 상태이다.

  • RUN : 클라이언트의 Reverse Proxy 요청을 처리 중이다.

  • QED : 클라이언트로부터 요청을 받고 처리해야 하는 서버는 확인되었지만 해당 서버가 모두 요청을 처리 중인 상태여서 큐에 잠시 대기 중인 상태이다.

count요청 처리 수이다.
idleidle 시간(초)이다.
spri커넥션에 대한 내부 관리 인덱스이다.
clid요청 처리 중인 클라이언트 인덱스이다.
sslWAS와의 SSL 사용 여부이다.
websocket커넥션이 웹 소켓으로 사용되고 있는지 여부이다.

2.3.11. Handler (client)

다음은 모니터링에서 [Handler(client)]를 선택하면 조회되는 화면으로 WebtoB 핸들러(HTH) 프로세스에 연결된 클라이언트들의 정보가 출력된다.

wsadmincliinfo 명령어와 동일한 기능이다. 자세한 내용은 WebtoB 관리자 안내서”의 “6.1.2.1. cliinfo (ci)”를 참고한다.

[그림 2.21] WebAdmin 모니터링 - Handler(client)

WebAdmin 모니터링 - Handler(client)

항목설명
hthHTH 번호를 나타낸다.
status

서버 내부의 클라이언트 상태이다.

  • RDY : 클라이언트로부터 요청을 받는 중이다.

  • RUN : 클라이언트의 요청이 서버에서 처리 중이다.

  • QED : 클라이언트로부터 요청을 받고 처리해야 하는 서버는 확인되었지만 해당 서버가 모두 요청을 처리 중인 상태여서 서버 내 큐에 잠시 대기 중인 상태이다.

count클라이언트가 현재까지 보낸 요청 수이다.
idle요청/응답 데이터 전송없이 소요된 시간(idle time, 초)이다.
localaddress연결된 WebtoB 서버 주소이다.
remoteaddress연결된 클라이언트 주소이다.
spri요청을 처리하고 있는 서버 프로세스이다(-1은 프로세스가 할당되지 않았다는 것을 의미한다).
user요청에 포함된 사용자 이름을 표시한다.
ssl해당 클라이언트가 SSL로 연결되어 있는지 여부이다.

2.3.12. Handler Summary

다음은 모니터링에서 [Handler Summary]를 선택하면 조회되는 화면으로 각 상태에 속한 클라이언트 수로 wsadmincliinfo -S 명령어와 동일한 통계값을 출력한다. 자세한 내용은 WebtoB 관리자 안내서”의 “6.1.2.1. cliinfo (ci)”를 참고한다.

[그림 2.22] WebAdmin 모니터링 - Handler Summary

WebAdmin 모니터링 - Handler Summary

항목설명
hthHTH 번호를 나타낸다(total의 경우 총합을 나타낸다).
rdy클라이언트로부터 받고 있는 요청의 수이다.
qed클라이언트로부터 요청을 받고 처리해야 하는 서버는 확인되었지만 해당 서버가 모두 요청을 처리 중인 상태여서 서버 내 큐에 잠시 대기 중인 요청의 수이다.
run서버에서 처리 중인 클라이언트의 요청 수이다.
etcReady, Run, Queued 상태를 제외한 나머지 상태인 클라이언트 요청 수이다.
total클라이언트로부터 받고 있거나 받은 요청의 총합이다.