미들웨어(제우스 웹투비)

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

재노 2022. 3. 26. 23:24

※ 웹투비(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.환경설정

 

초기 설정 파일

*DOMAIN
webtob1

*NODE
server-hostname
        WEBTOBDIR="/home/webtob", 
        SHMKEY = 54000,
        DOCROOT="/home/webtob/docs",
        PORT = "8080", 
        NODENAME = "$(NODENAME)",
        LOGGING = "log1",
        ERRORLOG = "log2",
        SYSLOG = "log3",
        JSVPORT = 9900,
        HTH = 1

*SVRGROUP
htmlg       SVRTYPE = HTML
cgig        SVRTYPE = CGI
ssig        SVRTYPE = SSI
jsvg        SVRTYPE = JSV

*SERVER
html        SVGNAME = htmlg, MinProc = 1, MaxProc = 2, ASQCount = 5
cgi         SVGNAME = cgig, MinProc = 1, MaxProc = 2, ASQCount = 5
ssi         SVGNAME = ssig, MinProc = 1, MaxProc = 2, ASQCount = 5
default     SVGNAME = jsvg, MinProc = 5, MaxProc = 5, ASQCount = 5

*URI
uri1        Uri = "/cgi-bin/", Svrtype = CGI
uri2        Uri = "/examples/", Svrtype = JSV

*ALIAS
alias1      URI = "/cgi-bin/", RealPath = "/home/webtob/cgi-bin/"

*LOGGING
log1        FORMAT = "DEFAULT", FileName = "/home/webtob/log/access_%Y%%M%%D%.log", Option = "sync"
log2        FORMAT = "ERROR", FileName = "/home/webtob/log/error_%Y%%M%%D%.log", Option = "sync"
log3        FORMAT = "SYSLOG", FileName = "/home/webtob/log/system_%Y%%M%%D%.log", Option = "sync"

*EXT
htm         MimeType = "text/html", SvrType = HTML
jsp         MimeType = "application/jsp", SvrType = JSV

 

예제 설정 파일

*DOMAIN
webtob1

*NODE
test-node
        WEBTOBDIR="/home/webtob", 
        SHMKEY = 54000,
        DOCROOT="/home/webtob/docs",
        PORT = "8080", 
        NODENAME = "$(NODENAME)",
        LOGGING = "log1",
        ERRORLOG = "log2",
        SYSLOG = "log3",
        ERRORDOCUMENT = "403,404,500,503",
        ServiceOrder = "ext,uri",
        JSVPORT = 9900,
        HTH = 3

*VHOST
web     DOCROOT ="/home/web",
        HOSTNAME = "www.test.co.kr",
        HostAlias = "224.36.94.196",
        PORT = "443",
        ServiceOrder = "ext,uri",
        ERRORDOCUMENT = "403,404,500,503",
        SSLFLAG = Y,
        SSLNAME = ssl,
        LOGGING = "web_successlog",
        ERRORLOG = "web_errorlog"

app     DOCROOT ="/home/app",
        HOSTNAME = "www.test.co.kr",
        HostAlias = "224.36.94.196",
        PORT = "543",
        ServiceOrder = "ext,uri",
        ERRORDOCUMENT = "403,404,500,503",
        SSLFLAG = Y,
        SSLNAME = ssl2,
        LOGGING = "app_successlog",
        ERRORLOG = "app_errorlog"

*SSL
ssl     CertificateFile = "/home/webtob/ssl/newreq.pem",
        CertificateKeyFile = "/home/webtob/ssl/newreq.pem",
        CACertificateFile = "/home/webtob/ssl/name-Chain.crt",
        CACertificatePath = "/home/webtob/ssl",

ssl2    CertificateKeyFile = "/home/webtob/ssl/sslcert.co.kr.key.pem",
        CertificateFile = "/home/webtob/ssl/sslcert.co.kr.crt.pem",
        CertificateChainFile = "/home/webtob/ssl/chain-bundle.pem”,
        CACertificateFile = "/home/webtob/ssl/Root.crt.pem”,
        Protocols = "-SSLv2, -SSLv3, -TLSv1, -TLSv1.1, TLSv1.2"

*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

*URI
uri2        Uri = "/app_prod", Svrtype = JSV, SVRNAME = "app1"
uri3        Uri = "/app_test", Svrtype = JSV, SVRNAME = "app2"
uri1        Uri = "/", Svrtype = JSV, SVRNAME = "web"

*ALIAS
#alias1      URI = "/cgi-bin/", RealPath = "/home/webtob/cgi-bin/"

*LOGGING
log1        FORMAT = "DEFAULT", FileName = "/home/webtob/log/access_%Y%%M%%D%.log", Option = "sync"
log2        FORMAT = "ERROR", FileName = "/home/webtob/log/error_%Y%%M%%D%.log", Option = "sync"
log3        FORMAT = "SYSLOG", FileName = "/home/webtob/log/system_%Y%%M%%D%.log", Option = "sync"

web_successlog   FORMAT = "SYSLOG", FileName = "/home/webtob/log/web/system_%Y%%M%%D%.log", Option = "sync"
web_errorlog     FORMAT = "ERROR", FileName = "/home/webtob/log/web/error_%Y%%M%%D%.log", Option = "sync"

app_successlog   FORMAT = "SYSLOG", FileName = "/home/webtob/log/app/system_%Y%%M%%D%.log", Option = "sync"
app_errorlog     FORMAT = "ERROR", FileName = "/home/webtob/log/app/error_%Y%%M%%D%.log", Option = "sync"

*EXT
htm         MimeType = "text/html", SvrType = HTML
jsp         MimeType = "application/jsp", SvrType = JSV

 

  • 자주 사용하는 절에 대한 설명
*DOMAIN : 웹투비 도메인 이름 설정(외부 솔루션에서 webtob1_container 처럼 보인다.)

*HEADERS : 클라이언트 요청에 HTTP Header를 추가하여 응답한다.

*NODE : 웹투비 노드 환경 설정(웹투비 전체적으로 적용)

*VHOST : VHOST별로 NODE절에 정의한 설정을 재정의할 수 있다(동일한 항목에 대해 VHOST의 우선순위가 높다)

*SVRGROUP : SERVER 절의 프로세스들을 그룹으로 관리하고 싶다

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

*URI : 고객이 입력한 URI를 특정 서비스에서 처리하도록 정의

*ALIAS : 고객이 입력한 URI를 서버의 실제 디렉터리에 매핑하도록 정의

*LOGGING : 웹투비 로그 파일 생성 및 기록(서비스별 분리 가능)

*EXT : 클라이언트가 요청한 확장자가 EXT 절에 있으면, 특정 서비스에서 처리하도록 한다

*SSL : HTTPS 통신시 설정

*ERRORDOCUMENT : 사용자가 정의한 에러 페이지 출력

 

각 절에서 다루는 내용 및 설정은 다음 글에서 알아보겠다.

 

2022/05/01 : 각 절에서 자주 사용하는 설정 사항 정리 완료, 추후 부분적으로 수정 가능

 

 

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

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

woshcareer.tistory.com

 

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

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

woshcareer.tistory.com

 

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

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

woshcareer.tistory.com

 

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

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

woshcareer.tistory.com

 

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

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

woshcareer.tistory.com

 

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

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

woshcareer.tistory.com

 

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

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

woshcareer.tistory.com

 

웹투비(webtob) http.m 설정(LOGGING, LOGLEVEL절)

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

woshcareer.tistory.com

 

웹투비(webtob) http.m 설정(HTH_THREAD, ALIAS, ERRORDOCUMENT, EXT 절)

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

woshcareer.tistory.com

 

참고자료

[워니의 일상블로그 - 웹투비 http.m 설정방법]

https://m.blog.naver.com/won2gonzo/221245947327

[지승준님 - http.m 웹투비 설정하기]

https://dlevelb.tistory.com/620

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

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

[한국전자인증 - 웹투비 SSL인증서 설치 메뉴얼]

https://cert.crosscert.com/webtob-ssl-%EC%84%A4%EC%B9%98/

[SecureSign - 웹투비 SSL 인증서 적용 가이드]

https://www.sslcert.co.kr/guides/TmaxSoft-WebtoB-SSL-Certificate-Install