웹투비(webtob) http.m 설정(SERVER 절)

※ 웹투비(webtob) 설정 변경시 반드시 티맥스에 문의하시기 바랍니다. 아래 글은 온라인 매뉴얼을 바탕으로 작성했습니다.

 

공식 매뉴얼

[웹투비 5.0 온라인 매뉴얼 - 티맥스 공식]

https://technet.tmaxsoft.com/upload/download/online/webtob/pver-20160331-000002/index.html  
참고 : 위 매뉴얼은 2016년 웹투비 5.0이 처음 출시되었을 때 발행되었습니다. 안내 : 좌상단 WebtoB 관리자 안내서 > 3.환경설정

 

[웹투비 4.1 온라인 매뉴얼 - 티맥스 공식]
https://technet.tmaxsoft.com/upload/download/online/webtob/pver-20150203-000001/index.html  
참고 : 위 매뉴얼은 2015년에 발행되었습니다. 안내 : 좌상단 WebtoB 관리자 안내서 > 3.환경설정

 

웹투비(webtob) http.m 설정 개요

 

예제 설정 파일

 

*VHOST
web     HOSTNAME = "www.test.co.kr",
        HostAlias = "224.36.94.196",
        PORT = "443",

app     HOSTNAME = "www.test.co.kr",
        HostAlias = "224.36.94.196",
        PORT = "543",

*SVRGROUP
htmlg       SVRTYPE = HTML
jsvg        SVRTYPE = JSV
jsvg_web    SVRTYPE = JSV, VHOSTNAME = "web"
jsvg_app    SVRTYPE = JSV, VHOSTNAME = "app"

*SERVER
html        SVGNAME = htmlg, MinProc = 100, MaxProc = 100, ASQCount = 1
web         SVGNAME = jsvg_web, MinProc = 100, MaxProc = 100
app1        SVGNAME = jsvg_app, MinProc = 100, MaxProc = 100
app2        SVGNAME = jsvg_app, MinProc = 100, MaxProc = 100

 

• 자주 사용하는 절에 대한 설명

*SERVER : 제우스 컨테이너별로 추가한다(제우스와 웹투비가 이곳에 정의한 이름으로 통신한다)

 

SERVER 절에서 자주 사용하는 설정

 

server 이름 : 하나의 서버가 사용하는 이름으로 중복되지 않아야 한다

→ JSV 타입의 SVRGROUP에 포함되면 server 이름을 최대 15자까지만 입력할 수 있다

 

SVGNAME : 서버가 속한 서버 그룹을 정의한다(SVRGROUP 절에서 정의되어야 함)

 

MinProc : 서버별 최소 프로세스 개수(웹투비 기동 시 생성되는 서버 프로세스 개수)

 

MaxProc : 서버별 최대 프로세스 개수(트래픽이 많아지는 경우 MaxProc까지 자동으로 증가함)
→ 일반적으로 MinProc과 MaxProc을 같게 설정하여 서버 프로세스(스레드풀) 개수 변동이 일어나지 않도록 함

 

• 성능 최적화

 

※ 큐(Queue) : 스레드풀 개수 이상으로 트래픽이 들어오는 경우, 큐에 트래픽을 쌓아 대기시킨다.

 

MaxQCount : 기본값(없음) - 큐에 제한 없이 트래픽 쌓기 가능(클라이언트가 무한정 대기)
MaxQCount 값 설정 - 설정한 값만큼 큐에 대기 가능(그 이상은 큐에 누적되지 못하고 에러로 응답)

 

MaxQUrl : MaxQCount를 설정한 큐에 트래픽이 모두 찬 경우, 대신 서비스할 페이지를 설정한다.

MaxQUrlRedirectStatus : MaxQCount를 설정한 큐에 트래픽이 모두 찬 경우, 클라이언트에 보내줄 Redirect Status Code를 설정한다.

설정값	별칭	설명
301	permanent	"301 Moved Permanently"로 응답한다.
302	found	"302 Found"로 응답한다.
303	seeother	"303 See Other"로 응답한다.
305	useproxy	"305 Use Proxy"로 응답한다.
307	temp	"307 Temporary Redirect"로 응답한다.
410	gone	"410 Gone"로 응답한다.

 

ASQCount : 큐에 ASQConut 값 이상이 쌓이면 MinProc에서 MaxProc 만큼 차례로 프로세스가 증가한다.(기본값은 0이며, ASQCount가 0이면 MinProc에 설정된 값만큼 서버 프로세스를 유지한다)

 

FlowControl : 서버 프로세스가 응답을 만들어 HTH에 전달할 때 버퍼의 크기

httpOutBufSize : HTH가 사용자에게 응답을 보낼 때 사용하는 버퍼의 크기

request : 클라이언트 → WEB 서버 → HTH(스레드풀) → WAS 서버(컨테이너)
response : WAS 서버(컨테이너) → HTH(스레드풀) → WEB 서버 → 클라이언트

 

MaxRequests : SERVER 절에 정의된 각 서버가 MaxRequests 값만큼 사용자 Request 처리 후 자동으로 재기동한다.

 

SvrChkTime : 제우스 컨테이너와 웹투비 연결이 정상인지 SvrChkTime 만큼 주기적으로 확인한다.

 

SessionIdCookieKey
매뉴얼 : 서버 타입이 JSV인 경우 Session routing용으로 사용되는 HTTP Cookie의 Key 이름 설정
번역 : JSV 타입의 서버에만 적용되며, 해당 서비스에서 생성되는 세션 쿠키의 Key를 지정한다.
(기본값 : JSESSIONID = random 값 → 예시 : JSESSIONID_app = random 값)

 

VhostName : 특정한 Virtual Host를 통과한 요청만 처리하고 싶은 경우 설정(VHOST절과 SVRGROUP절에 정의되어야 사용 가능)

 

Headers : 서버별로 적용할 Headers 설정(VHOST - SVRGROUP - SERVER 가 1:1:1 구조면 VHOST에만 Headers를 설정하면 된다.)

 

LBFactor : SVRGROUP 절에서 LBServers로 지정한 서버들에게 어떤 비율로 요청을 분산할지 입력한다.(WEB 서버 앞에 L4를 둔 경우, 해당 설정은 필요 없다)

*SVRGROUP
jsvg    SvrType = JSV, LBServers = "jsv1, jsv2, jsv3", LBType = Static, LBBackup = "jsv4"

*SERVER
jsv1    SvgName = jsvg, MinProc = 1, MAXProc = 10, LBFactor = 10
jsv2    SvgName = jsvg, MinProc = 1, MAXProc = 10, LBFactor = 5
jsv3    SvgName = jsvg, MinProc = 1, MAXProc = 10, LBFactor = 1
jsv4    SvgName = jsvg, MinProc = 1, MAXProc = 10

※ 참고
SvgName이 jsvg이고 *SVRGROUP 절에 LBServers로 설정된 jsv1, jsv2, jsv3가 로드 밸런싱 서버로 동작하고 각각 10, 5, 1의 비율로 요청을 분산한다(LBFactor는 LBType이 Static인 경우에만 의미가 있음). LBBackup인 jsv4는 jsv1, jsv2, jsv3가 모두 사용할 수 없으면 요청을 처리한다.

 

참고자료

[웹투비 5.0 온라인 매뉴얼 - 공식]

https://technet.tmaxsoft.com/upload/download/online/webtob/pver-20160331-000002/index.html

 

[웹투비 5.0 Fix#2 매뉴얼 - WebtoB 튜닝]

https://technet.tmaxsoft.com/upload/download/online/webtob/pver-20180725-000001/administrator-guide/ch07.html