WebtoB Error Message Reference Manual Copyright 2005 Tmax Soft Co., Ltd. All Rights Reserved.
Copyright Notice Copyright 2005 Tmax Soft Co., Ltd. All Rights Reserved. Tmax Soft Co., Ltd. 대한민국서울시강남구대치동 946-1 글라스타워 18 층우 )135-708 Restricted Rights Legend This software and documents are made available only under the terms of the Tmax Soft License Agreement and may be used or copied only in accordance with the terms of this agreement. No part of this document may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, or optical, without the prior written permission of Tmax Soft Co., Ltd. 이프로그램과문서는 TmaxSoft 라이선스동의하에서만만들거나, 사용되거나, 복사될수있습니다. TmaxSoft Co., Ltd. 의허락없이이문서의일부분이나전체를전자적, 기계적, 광학적, 수작업등어떤방법으로든복사, 재생산, 번역등을할수없습니다. Trademarks Tmax, WebtoB, WebT, and JEUS are registered trademarks of Tmax Soft Co., Ltd. All other product names may be trademarks of the respective companies with which they are associated. Tmax, WebtoB, WebT, JEUS 는 TmaxSoft Co., Ltd. 의등록상표입니다. 기타모든제품들과회사이름은각각해당소유주의상표로서참조용으로만사용됩니다. Document info Document name: WebtoB Error Message Reference Manual Document date: 2005-09-23 Manual release version: 4.1 Software Version: WebtoB 4.1
WebtoB Error Message Reference Manual WebtoB 차례 매뉴얼에대하여... 3 일러두기... 4 제품별기능... 5 1 서문... 7 2 Error Message... 8 2.1 wsadmin... 8 2.2 wsboot... 10 2.3 wscfl... 13 2.4 wsdown... 19 2.5 wsracd... 21 2.6 Errorlog... 22 2.7 Syslog... 26 1 TmaxSoft
WebtoB WebtoB Error Message Reference Manual TmaxSoft 2
WebtoB Error Message Reference Manual WebtoB 매뉴얼에대하여 본매뉴얼은 WebtoB system 을이용하여사이트를운영및개발시에개발자와웹서버관리자들이참고할수있도록실제운영시 WebtoB 내에포함된툴및로그파일에서접할수있는에러를휴형별로원인을파악하고, 그해결방안을제시한다. 본매뉴얼은크게두부분으로구성되어있으며그내용은다음과같다. Chapter 1 본장에서는해당매뉴얼방향및 Http Error Code 참고문서에관해설명한다. Chapter 2 본장에서는 WebtoB Web Server 운영및관리시발생할수있는 Error Message 유형과그대처방법에대해서설명한다. 3 TmaxSoft
WebtoB WebtoB Error Message Reference Manual 일러두기 표기예 내용 텍스트본문, 12 포인트, 바탕체 Times New Roman 텍스트 본문강조 CTRL+C CTRL 과동시에 C 를누름 public class myclass { } Java 코드 <system-config> XML 문서 참조 : / 주의 :` Configuration 메뉴를연다 WEBTOBDIR 참조사항과주의할사항 GUI 의버튼같은컴포넌트 WebtoB 가실제설치된디렉토리 예 )c:\tmaxsoft\webtob4.1 wsboot [ 파라미터 ] 콘솔명령어와문법 옵션파라미터 < xyz > < 와 > 사이의내용이실제값으로변경됨 선택사항. 예 ) A B: A 나 B 중하나 파라미터등이반복되어서나옴?, +, * 보통 XML 문서에각각 없거나, 한번, 한번이상, 없거나, TmaxSoft 4
WebtoB Error Message Reference Manual WebtoB 여러번 을나타낸다.... XML 이나코드등의생략 <<FileName.ext>> 코드의파일명 그림 1. 그림이름이나표이름 제품별기능 제품구분 Base 제공기능 HTML, CGI, PHP, SSI, SSL, WBAPI Standard Base 제공기능, Multi-Node, JSP/Servlet, Load Balancing, Fail-Over 5 TmaxSoft
WebtoB WebtoB Error Message Reference Manual 연락처 Korea Tmax Soft Co., Ltd 18F Glass Tower, 946-1, Daechi-Dong, Kangnam-Gu, Seoul 135-708 South Korea Tel: 82-2-6288-2114 Fax: 82-2-6288-2115 Email: info@tmax.co.kr Web (Korean): http://www.tmax.co.kr USA Tmax Soft, Inc. 560 Sylvan Ave, Englewood Cliffs NJ 07632 USA Tel: 1-201-567-8266 FAX: 1-201-567-7339 Email: info@tmaxsoft.com Web (English): http://www.tmaxsoft.com Japan Tmax Soft Japan Co., Ltd. 6-7 Sanbancho, Chiyoda-ku, Tokyo 102-0075 Japan Tel: 81-3-5210-9270 FAX: 81-3-5210-9277 Email: info@tmaxsoft.co.jp Web (Japanese): http://www.tmaxsoft.co.jp China Beijing Silver Tower, RM 1507, 2# North Rd Dong San Huan, Chaoyang District, Beijing, China, 100027 Tel: 86-10-6410-6148 Fax: 86-10-6410-6144 E-mail : info@tmaxchina.com.cn Web (Chinese): http://www.tmaxchina.com.cn TmaxSoft 6
WebtoB Error Message Reference Manual WebtoB 1 서문 이매뉴얼에는현재 WebtoB 제품에대한에러메시지와그에대한조치사항을기술하고있다. 지금까지지원된초기버전및제품에대한에러메시지를포함하고있으며앞으로도추가메시지가계속포함될것이다. WebtoB 관리자및개발자는시스템오류나사용자오류가발생하였을때우선적으로본매뉴얼을참조하여원인을파악하고조치를할수있을것이다. 조치방법중에 WebtoB 환경설정을변경해야하는부분에대해서는 WebtoB 관리자안내서 를참고하기바란다. Http Error Code 는모든웹서버의공통적인사항이므로본매뉴얼에서언급하지않았으며 Http Error Code 에대해서는 RFC2068 을참고하기바란다. 7 TmaxSoft
WebtoB WebtoB Error Message Reference Manual 2 Error Message WebtoB 를운영하면서자주접할수있는 Error Message 들에대해각툴및 로그파일별로분류하였다. 2.1 wsadmin COM3614: Engine version mismatch (20050721:20050810), Retry wscfl 설명 : wsadmin 과엔진버전이맞지않는다. 조치 : 1) WebtoB 를다시설치하거나 wscfl 실행하여환경파일을재컴파일한다. 2) 환경변수설정과실제 WebtoB 디렉토리가일치하는지확인한다. ADM0031: network connect error for remote admin(nodename (nodename)):(239) Connection refused 설명 : 원격 wsracd 와연결설정중에러가있다. 조치 : 원격 NODE 에서 RACD 가제대로부팅되었는지확인한다. WEBTOB_RAC_PORT 환경변수가 NODE 들간에모순되지않았는지, DOMAIN 절의 RACPORT 필드와맞는지확인한다. ADM0722: remote RAC closed: nodename 설명 : 원격지 wsracd 와통신채널이끊어졌다. 조치 : 네트워크의상태를점검한다. 원격노드에서 wsracd 가정상적으로수행중인지확인한다. Webtob is already running, but you can just only use wsdown 설명 : WebtoB 가이미실행중이므로 wsdown 만사용할수있다. TmaxSoft 8
WebtoB Error Message Reference Manual WebtoB 조치 : $WEBTOBDIR/ path 의스트림파이프가손상되지않았는지확인한다. COM3606: file open error: path/file_name:(2) No such file or directory 설명 : 파일오픈에러가발생했다. 조치 : path/file_name 에해당하는파일의정확한경로와파일이름을확인한다. ADM0022: cannot find host name (host_name) in config 설명 : 환경설정에서 host_name 을찾을수없다. 조치 : host_name 에해당하는설정이환경설정파일의 NODE 절에있는지확인한다. WebtoB is not booted: only boot command is accepted 설명 : WebtoB 부팅중일때에만명령어실행이가능하다.. 조치 : WebtoB 가기동중인지확인한다. 9 TmaxSoft
WebtoB WebtoB Error Message Reference Manual 2.2 wsboot COM3614: Engine version mismatch (20050721:20050810), Retry wscfl 설명 : wsboot 버전이맞지않는다. 조치 : 1) WebtoB 를다시설치하거나 wscfl 실행하여환경파일을재컴파일한다. 2) 환경변수설정과실제 WebtoB 디렉토리가일치하는지확인한다. License file read error 설명 : 라이센스파일읽기에러가났다. 조치 : 라이센스파일을정확한경로 ($(WEBTOBDIR)/license/license.dat) 에설치한다. LIC0203: licensed host(hostname) not found 설명 : 이호스트는유효한라이센스를갖고않고있다. 조치 : 새로운라이센스파일을설치한다. LIC0204: License is expired 설명 : 기간이만료된라이센스이다. 조치 : 새로운라이센스파일을설치한다. BOOT0113: unrecognized option: option 설명 : 유효하지않은옵션플래그 (option ) 이다. 조치 : 정확한매개변수를도움말 (wsboot -h) 에서참조한다. Webtob is already running 설명 : WebtoB 가이미실행중일때 WebtoB 엔진을부팅하려고했다. 조치 : WebtoB 가능하다. 엔진이 down 된상태에서만 wsboot 실행이 TmaxSoft 10
WebtoB Error Message Reference Manual WebtoB Webtob is not booted 설명 : WebtoB 가부트되지않았다. 조치 : 먼저 WebtoB 엔진을부팅한다. BOOT0021: maxproc (max_num) is over for svr (svr_name: svr_name): nodeno = 0, svri = 0, cur = 2, ksvr = 4 BOOT3007 maxsvr (max_num) over for svr (svr_name) 설명 : SERVER 절의 MAX 필드에지정된것보다많은프로세스를실행하려고했다. 조치 : MAX 필드를수정하고 WebtoB 를재부팅한다. BOOT0022: server(svr_name) is not in config 설명 : 환경설정파일에정의하지않은서버명을지정하였다. 조치 : 환경설정파일에지정된서버명을지정하였는지환경파일을확인한다. BOOT0103: length of option arg is too long 설명 : 매개변수가너무길다. 조치 : 매개변수는 256 자를넘을수없다. svr_name0090: svr_name is not set nobody.nobody 설명 : svr_name 실행시권한을 nobody.nobody 못했다. 로설정하지 조치 : 해당서버에서 nobody Group, User 사용이가능하도록설정하고, 실행시 root 권한으로실행해야한다. COM3606: file open error: path/file_name:(2) No such file or directory 설명 : 파일오픈에러가발생했다. 조치 : path/file_name 에해당하는파일의정확한경로와파일이름을확인한다. WSBOOT: SVR(svr_name) is not found 설명 : 서버 (svr_name) 를찾을수가없다.. 11 TmaxSoft
WebtoB WebtoB Error Message Reference Manual 조치 : svr_name 에해당하는파일이있는지확인한다. BOOT0038: exec error: path/file_name:(13) Permission denied 설명 : 실행권한이없다. 조치 : path/file_name 에실행권한이있는지확인한다. BOOT0036: exec error: path/file_name:(11) Resource temporarily unavailable 설명 : 프로세스기동이실패하였다. 조치 : path/file_name 에해당하는파일을기동하는중에시스템에러가발생하였다. wsboot 시 -w 옵션으로기동하거나 WebtoB 가운용되는시스템의매뉴얼을참조하여시스템 ( 또는사용자별 ) 에서최대로실행될수있는프로세스의갯수를늘려준다. TmaxSoft 12
WebtoB Error Message Reference Manual WebtoB 2.3 wscfl CFL0201: line num: continued, but first column started 설명 : 환경설정파일에콤마 (,) 뒤에다음컬럼이시작되지않았다. 조치 : 환경설정파일에부적절한콤마 (,) 가있는지확인한다. License file read error 설명 : 라이센스인증파일을읽는데실패했다. 조치 : 정확한경로에 ($(WEBTOBDIR)/license/license.dat) 라이센스파일을설치한다. LIC0203: licensed host(hostname) not found 설명 : 이호스트는확실한근거가있는라이센스를가지고있지않다. 조치 : 라이센스파일을다시설치한다. LIC0204: License is expired 설명 : 만료된라이센스를가지고있다. 조치 : 라이센스파일을다시설치한다. CFL0219: line num: Name is too big: 1296 > 31 설명 : 이름이너무길다. 조치 : 환경설정파일에지정한이름을 31 자이하로재설정한다. CFL0101: WEBTOBDIR is not set 설명 : 환경변수 (WEBTOBDIR) 가설정되지않았다. 조치 : 환경변수 (WEBTOBDIR) 를설정하여준다. *ksh 의경우 : export WEBTOBDIR = dirname *csh 의경우 : setenv WEBTOBDIR = dirname CFL0116: param parm is mandatory, but missed for section section_name 설명 : section_name 에필수항목인 param 이 환경파일에 설정되지않았다. 13 TmaxSoft
WebtoB WebtoB Error Message Reference Manual 조치 : 환경파일에관련있는항목을입력한다. CFL0003: required section: section_name is not defined 설명 : section_name 절이환경파일에존재하지않는다. 조치 : 환경파일에관련있는항목을입력한다. CFL0036: line num: NODENAME:node1 in SVRGROUP definition not found 설명 : NODE 명 (node1) 이환경파일의 NODE 절에설정되지않았다. 조치 : 환경파일내 NODE 절의 NODE 명을확인한다. CFL0406: no svg (svgname) is defined for cousin (or backup) 설명 : 환경파일내에 COUSIN 또는 BACKUP 항목의값으로설정된서버그룹 (svgname) 이설정되어있지않다. 조치 : 환경파일의 SVRGROUP 항목의그룹명을확인한다. CFL0425: backup is defined for same node in SVRGROUP (svgl) 설명 : 서버그룹 (svg1) 과 BACKUP 이같은 NODE 에위치한다. 조치 : BACKUP 서버그룹은다른 NODE 의서버그룹으로설정되어야한다. 구성파일을수정한다. CFL0069: line num: svg.load is defined without cousin 설명 : 서버의 COUSIN 설정을하지않고 LOAD 설정이되어있다. 조치 : 1) 서버그룹은 BACKUP 과다른서버를위한 COUSIN 양쪽모두에설정될수없다. 구성파일을수정한다. 2) 환경설정파일에 COUSIN 설정을해준다. CFL0001: line num: because of previous error, config_gen cannot proceed 설명 : 이전의에러로인하여이후작업이진행되지않는다. 조치 : 이전의에러메시지를참조한다. CFL0012: line num: param (param) duplicately defined TmaxSoft 14
WebtoB Error Message Reference Manual WebtoB 설명 : parameter 값이 (param) 이중으로정의되어있다. 조치 : 이중으로되어있는것중하나를삭제하거나이전의것과같게한다. CFL0064: no default html server defined in NODE (node_name) 설명 : nodename 에기본 html 서버가정의되지않았다. 조치 : 설정된 node_name 에기본서버설정을한다. CFL0037: line num: SVG_NAME:svg1 in SERVER definition not found 설명 : 환경파일내 SERVER 절에 SVGNAME 으로지정된서버그룹 (svg1) 이 SVRGROUP 항목에없다. 조치 : svg1 이환경파일 SVRGROUP 절에설정되어있는지 확인한다. CFL0623: line = num: no svr is defined for svrtype (type) 설명 : 환경파일내 SERVER 절에 SVGNAME 으로지정된서버그룹의 SVGTYPE 이 type 가아니다. 조치 : SERVER 절에설정된 SVGNAME 의설정과 SVRGROUP 절의 SVRTYPE 을확인한다. CFL0622: line = num: routname must be defined with svrname 설명 : routname 는 svrname 와함께정의해야한다. 조치 : EXT 절의 Routing 설정한곳에 SvrName 설정을확인한다. CFL0042: line num: SVRNAME:svr1 in SERVICE definition not found 설명 : SERVICE 절에 SVRNAME 로지정된 svr1 의설정이 SERVER 항목에없다. 조치 : svr1 이 SERVER 항목에설정되어있는지확인한다. CFL0712: network connect error for remote wscfl(node1(node1)):(num) Connection refused 설명 : remote 에서 wscfl 수행시네트웍연결에러로발생한다. 조치 : 1) remote 서버에 wsracd 가실행중인지확인한다. 15 TmaxSoft
WebtoB WebtoB Error Message Reference Manual 2) remote 서버에실행중인 wsracd 의 Port 가 local 에서설정한환경설정파일에설정한 RacPort 와동일한지확인한다. CFL0063: line num: NODE NAME(node1) is not unique 설명 : NODE 절에정의되는노드네임 (node1) 이유일하지않다. 조치 : node1 이구성파일의다른부분에존재하는지확인한다. CFL0081: line num: svr.maxproc(num1) < svr.minproc(num2) 설명 : 환경파일의 SERVER 절에설정된 maxproc(num1) 이 minproc(num2) 보다작다. 조치 : minproc 값이 maxproc 보다작아야한다는조건을만족하도록값을조정한다. CFL0063: line num: LogDir1 (dir_path) cannot be same as LogDir2 설명 : 환경파일에서설정된 LogDir1 가 LogDir2 와같다. 조치 : LogDir1 와 LogDir2 설정이같지않도록한다. 그들은다른경로를가지고있어야한다. CFL0077: line num: SVRGROUP NAME(svg1) is not unique 설명 : SVRGROUP 절의서버그룹명 (svg1) 이중복되었다. 조치 : 중복을피하기위해환경파일을수정한다. 서버그룹명은환경파일내에서유일해야한다. CFL0082: line num: SVR NAME(svr1) is not unique 설명 : SERVER 절의서버이름 (svr1) 이중복되었다. 조치 : 환경파일의중복을방지하기위하여수정한다. 서버이름은환경파일에서유일한것이어야한다. CFL0085: line num: SERVICE NAME(svc) is not unique 설명 : SERVICE 절에설정된서비스이름 (svc) 이중복되었다. 조치 : 환경파일의중복을방지하기위하여수정한다. 서비스이름은환경파일에서유일한것이어야한다. CFL0077: line num: VHOST NAME(vhost1) is not unique 설명 : VHOST 절에설정된서비스이름 (vhost1) 이중복되었다. TmaxSoft 16
WebtoB Error Message Reference Manual WebtoB 조치 : 환경파일의중복을방지하기위하여수정한다. VHOST 이름은환경파일에서유일한것이어야한다. CFL0061: line num: URI NAME(uri1) is not unique 설명 : URI 절에설정된 URI 이름 (ur1i) 이중복되었다. 조치 : 환경파일의중복을방지하기위하여수정한다. URI 이름은환경파일에서유일한것이어야한다. URI 는 NODE, SVRGROUP, VHOST, SERVER, SERVICE 를제외한나머지모든절이될수있다. CFL0207: line num: type error: expected: type1, input type2 설명 : 타입설정잘못이 line(line_num) 에있다. 조치 : type1 을설정해야할곳에 type2 를설정했으므로, type1 으로수정한다. CFL0307: unknown SERVER parameter: kind = -4, val = val1 설명 : SERVER 절에알수없는파라미터가설정되었다. 조치 : 서버절에설정된항목에타입이맞지않는것이나, 필요없는항목이있는지확인한다. SERVER 은모든절이올수있다. CFL0307: line 12: GROUP error 설명 : GROUP 에러가발생했다. 조치 : NODE 절에 Group 관련설정시해당그룹이름이사용가능한지확인한다. CFL0046: More than one DOMAIN sections are defined 설명 : 하나이상의 DOMAIN 절이정의되어있다. 조치 : 유효하지않은 DOMAIN 하나만정의한다. 절을삭제하여도메인절에 CFL0309: line num: TxLogDir is deprecated 설명 : TxLogDir 항목은더이상지원하지않는옵션이다. 조치 : 4.1 버전부터는지원하지않는옵션이므로관련설정을삭제한다. 17 TmaxSoft
WebtoB WebtoB Error Message Reference Manual COM3606: file open error: path/file_name:(2) No such file or directory 설명 : 파일오픈에러가발생했다. 조치 : path/file_name 에해당하는파일의정확한경로와파일이름을확인한다. TmaxSoft 18
WebtoB Error Message Reference Manual WebtoB 2.4 wsdown DOWN0021: socket connect error for remote down: tmaxh4 4455:(79) Connection refused 설명 : remote 서버다운을위한소켓연결에러가발생했다. 조치 : 멀티노드구성시 remote 연결을위한 wsracd 가실행중인지확인하고, 서버간통신을위한 WEBTOB_RAC_PORT 설정을확인한다. COM3614: Engine version mismatch (20050721:20050810), Retry wscfl 설명 : wsdown 버전이엔진과일치하지않는다. 조치 : 1) WebtoB 를다시설치하거나 wscfl 실행하여환경파일을재컴파일한다. 2) 환경변수설정과실제 WebtoB 디렉토리가일치하는지확인한다. DOWN0110: length of option arg is too long 설명 : 유효하지않은인수를지정하였다. 조치 : 어떠한인수의길이도 256 문자를초과할수없다. COM3606: file open error: path/file_name:(2) No such file or directory 설명 : 파일오픈에러가발생했다. 조치 : path/file_name 에해당하는파일의정확한경로와파일이름을확인한다. BOOT0022: server(svr_name) is not in config 설명 : 환경설정파일에정의하지않은서버명을지정하였다. 19 TmaxSoft
WebtoB WebtoB Error Message Reference Manual 조치 : 환경설정파일에지정된서버명을지정하였는지환경파일을확인한다. DOWN0112: unrecognized option 설명 : 유효하지않은옵션플래그 (option ) 이다. 조치 : 정확한매개변수를도움말 (wsdown -h) 을참조한다. DOWN0003: cannot find node name 설명 : 노드이름을찾을수가없다. 조치 : 인자로넘긴노드이름이실제환경설정파일에존재하는지확인한다. spr_id(spid) is invalid 설명 : 유효하지않은 spid 이다. 조치 : spid 로지정한것이실제로존재하는 spid 인지확인한다. TmaxSoft 20
WebtoB Error Message Reference Manual WebtoB 2.5 wsracd RAC0022: socket listen error, we'll retry after 10 seconds: errno = -2, portno = 3333:(226) Address already in use 설명 : 이미사용중인포트를사용하여에러가발생했으며, 10 초후에다시시도할것이다.. 조치 : 환경설정 NODE 절의 RacPort 를다른포트로변경하고 WEBTOB_RAC_PORT 환경변수도 RacPort 와동일하게변경해준다. RAC0024: socket listen error: errno = -2, portno = 3333:(226) Address already in use 설명 : 이미사용중인포트를사용하려고하여소켓리슨에러가발생하였다. 조치 : 환경설정 NODE 절의 RacPort 를다른포트로변경하고 WEBTOB_RAC_PORT 환경변수도 RacPort 와동일하게변경해준다. COM3606: file open error: path/file_name:(2) No such file or directory 설명 : 파일오픈에러가발생했다. 조치 : path/file_name 에해당하는파일의정확한경로와파일이름을확인한다. 21 TmaxSoft
WebtoB WebtoB Error Message Reference Manual 2.6 Errorlog Errorlog 는 Client 로부터의 HTTP Request 를처리하는도중발생하는 Error 를기록한것이다. WebtoB 관리자및개발자는 Errorlog 를참조하여사용자의오류조치또는잠재된오류를조치할수있다. Errorlog 는 WebtoB 환경설정의 Errorlog 항목에서설정한위치에저장되며기본적으로는 $WEBTOBDIR/log 디렉토리에 error.log_ 날짜 파일로저장된다. Errorlog 의구조는다음과같다. [ 발생시각 ] [ 에러종류 ] [Client 정보 ] 에러메세지 File does not exist: file_path/file_name 설명 : file_path/file_name 에해당하는파일이존재하지않는다. 조치 : 해당 file_path 에 file_name 에해당하는파일이존재하는지확인하여해당파일을작성하거나웹페이지의링크를수정한다. svr (svr_name) is not available 설명 : svr(svr_name) 는사용할수없다. 조치 : 해당 svr(svr_name) 프로세스가기동중인지확인한다. 기동중이지않으면해당서버를기동시켜준다. Access to this node is not allowed 설명 : Virture Host 노드에접근이허락되지않았다. 조치 : Client 에서요청을보낼시의 HostName 및 Port 번호가 WebtoB 환경설정의 VHOST 설정의 HostName 및 Port 과일치하는지확인한다. send to hth error TmaxSoft 22
WebtoB Error Message Reference Manual WebtoB 설명 : server 가 hth 로파일을전송시에러가발생했다. 조치 : Cache 와 HttpOutBufferSize 를과도하게크게잡은경우대용량파일로인해메모리부족현상이일어날수있으므로, Cache 크기와 HttpOutBufferSize 를적당한크기로조정한다. Request URI too large 설명 : HTTP Request URI 길이가한계를초과하였다. 조치 : Request URI 길이가 LimitRequestLine( 기본값 :8190) 를초과하였기때문이다. WebtoB 환경설정에서 LimitRequestLine 값을늘려주거나 Request URI 길이를줄인다. Request content-length of n1 is larger than the configured limit of n2 설명 : Request Body 길이가한계를초과하였다. 조치 : Request Body 길이 (n1) 가설정된 LimitRequestBody(n2) 를초과하였기때문이다. WebtoB 환경설정에서 LimitRequestBody 값을늘려준다. Size of a request header field exceeds server limit. 설명 : Request Header Field 크기가한계를초과하였다. 조치 : Request Header Field 크기가설정된 LimitRequestFieldSize ( 기본값 :8190) 를초과하였기때문이다. WebtoB 환경설정에서 LimitRequestFieldSize 값을늘려주거나 Request Header 의 Field 크기를줄인다. The number of request header fields exceeds this server's limit. 설명 : Request Header 의 Field 갯수가한계를초과하였다. 조치 : Request Header 의 Field 갯수가설정된 LimitRequestFields ( 기본값 :100) 를초과하였기때문이다. WebtoB 환경설정에서 LimitRequestFields 값을늘려준다. File open error: file_path/file_name 설명 : file_path/file_name 을열수없다. 조치 : 해당 file_path/file_name 의존재여부를체크하고 WebtoB 기동유저에서 Access 할수있는지퍼미션을체크한다. 23 TmaxSoft
WebtoB WebtoB Error Message Reference Manual Method Not Allowed (Method 명 ) 설명 : () 안의 Method 요청이거부되었다. 조치 : () 안의 Method 에대해서서비스를수행할수없도록설정되어있기때문이다. WebtoB 환경설정에서 NODE 절의 Method 항목에해당 Method 명을사용할수있도록설정한다. Not allowed options ( 서비스 ) 설명 : () 안의서비스요청이거부되었다. 조치 : () 안의서비스에대해서서비스를수행할수없도록설정되어있기때문이다. WebtoB 환경설정에서 NODE 절의 Options 항목에해당서비스를사용할수있도록설정한다. TIMEOUT is expired while svc is running 설명 : Request 처리중에 TIMEOUT 을초과하였다. 조치 : 사용자가보낸 Request 가 TIMEOUT 이내에완료되지않았기때문이다. WebtoB 환경설정에서 TIMEOUT 값을늘려주거나 Application 의수행속도를튜닝해야한다. max q for svr (svr_name) reached: error sent 설명 : 서버프로세스 (svr_name) 의큐에있는클라이언트의요청이한계를초과했다. 조치 : 사용자 Request 가폭주하여서버프로세스큐의크기를초과하였기때문이다. WebtoB 환경설정에서 SERVER 절의 MaxQCount 값을늘려주거나 Application 의수행속도를튜닝해야한다. uri(/uri_path/) is access-denied 설명 : URI (/uri_path/) 에대해서접근할수없다. 조치 : URI /uri_path/ 에대해서접근할수없도록차단되어있기때문이다. WebtoB 환경설정에서 URI 절과 ACCESS 절의설정을확인한다. dir(/file_path/) is access-denied 설명 : 디렉토리 (/file_path/) 에대해서접근할수없다. TmaxSoft 24
WebtoB Error Message Reference Manual WebtoB 조치 : DIRECTORY(/file_path/) 에대해서접근할수없도록차단되어있기때문이다. WebtoB 환경설정에서 DIRECTORY 절과 ACCESS 절의설정을확인한다. ext(ext_name) is access-denied 설명 : 확장자 (ext_name) 파일에대해서접근할수없다. 조치 : EXT(ext_name) 에대해서접근할수없도록차단되어있기때문이다. WebtoB 환경설정에서 EXT 절과 ACCESS 절의설정을확인한다. Reuqest URI format is wrong 설명 : Request 가잘못되었다. 조치 : 클라이언트에서보낸 Request 의형식이 HTTP 스펙에어긋나기때문이다. HTTP 스펙에맞는 Request 를보내도록해야한다. No response from cgi program 설명 : CGI 프로그램으로부터응답이없다. 조치 : WebtoB 가 CGI 프로그램을실행하였으나그로부터응답이없기때문이다. CGI 프로그램이정상적으로존재하는지확인해야한다. 또는 CGI 프로그램의퍼미션에실행권한이있는지확인한다. svr_q (svr_name) is purged: error sent 설명 : 서버프로세스 (svr_name) 의큐에있는클라이언트의요청이삭제되었다. 조치 : WebtoB 관리자가 wsadmin 에서서버프로세스의큐에적체되어있는요청을삭제한경우이다. svc_q (svc_name) is purged: error sent 설명 : 서비스 (svc_name) 의큐에있는클라이언트의요청이삭제되었다. 조치 : WebtoB 관리자가 wsadmin 에서서비스의큐에적체되어있는요청을삭제한경우이다. 25 TmaxSoft
WebtoB WebtoB Error Message Reference Manual 2.7 Syslog Syslog 는 WebtoB 시스템에문제가발생한경우에원인을분석하기위한용도이며 WebtoB 자체적으로발생한오류내역및시스템레벨에서발생한오류내역을포함하고있다. 따라서이를분석하기위해서는 WebtoB 운영경험및시스템운영경험이풍부해야하며시스템에러메시지에대한지식도필요하다. 시스템에러에의한오류인경우는본매뉴얼외 WebtoB 가운용되는시스템의매뉴얼을참조하거나시스템관리자에게문의한다. Syslog 는 WebtoB 환경설정의 SysLogDir 항목에서설정한위치에저장되며기본적으로는 $WEBTOBDIR/log/syslog 디렉토리에 syslog._ 날짜 파일로저장된다. 또한 Syslog 는장애원인분석에필수적인정보이므로일정기간동안의 log 는서버에남겨둘것을권고한다. Syslog 의구조는다음과같다. 프로세스명.PID. 시간 : 에러코드 : 에러메세지 :( 시스템에러코드 ) 시스템에러메세지 HTH0538: server (svr_name:num) abnormally closed 설명 : 서버가비정상적으로종료되었다.. 조치 : svr_name 에해당하는서버가비정상종료된원인을찾아서제거한다. WBAPI 서버프로세스에서발생한경우는대부분 Application 로직의오류일확률이높으므로 Applicaton 의디버깅이필요하다. HTH0102: malloc error: size = size:(12) Not enough space 설명 : 메모리할당과정에서에러가발생했다. 조치 : 시스템에서사용가능한메모리크기가부족하거나프로세스별로사용가능한메모리크기설정이적은경우이다. 우선시스템의사용가능메모리를확인해야하며충분한경우라면프로세스별사용가능한메모리크기설정을늘려야한다. 만일이와같은조치로해결되지않는다면 WebtoB 환경설정의조절을통해서도해결할수있다. TmaxSoft 26
WebtoB Error Message Reference Manual WebtoB 1) NODE 절의 CacheEntry 항목의값을줄인다. 2) SERVER 절의 HttpOutBufSize 항목의값을줄인다. setsockopt error for TCP_NODELAY:(22) Invalid argument 설명 : 유효하지않은인자로인해소켓할당에러가발생했다. 조치 : 네크워크상의오류를 WebtoB 가대신기록해주는것으로네트워크상태나해당연결이정상적인지확인하고, 네트워크관리자에게문의하여네크워크를점검한다. HTH2417: Write Error:(22) Invalid argument 설명 : 유효하지않은인자로쓰기에러가발생했다. 조치 : HTH 에서 Client 로응답을내려주는과정에서 Client 가 중간에끊어버린경우발생할수있는에러이다. 문제가 지속되는 경우 네트워크 관리자에게 문의하여 네트워크를 점검한다. HTMLS0016: WSM read error:(146) Connection refused HTMLS0011: register to WSM error 설명 : 연결거절에의해 WSM 읽기에러가발생했다. WSM 에등록에러가발생했다. 조치 : 동시에많은수의서버를기동하는경우 wsboot 시 -w 옵션을사용하여각각의서버들을순차적으로부팅시킬수있도록한다. HTH0538: server (svr_name:spr_no) abnormally closed: running svc = svr_name: url = "/uri_name" 설명 : 서버프로세스가비정상종료하였다. 조치 : 서버프로세스 (svr_name) 에서 url (/usr_name) 을처리하던중비정상적으로종료하였다. WBAPI 서버프로세스에서발생한경우는대부분 Application 로직의오류일확률이높으므로 Applicaton 의디버깅이필요하다. WSM0176: SVR (svr_name:spr_no) is restarted the n th time 설명 : 서버프로세스가재시작되었다. 27 TmaxSoft
WebtoB WebtoB Error Message Reference Manual 조치 : 서버프로세스 (svr_name) 가 n 번째로재기동되었다. WBAPI 서버프로세스에서발생한경우는대부분 Application 로직의오류일확률이높으므로 Applicaton 의디버깅이필요하다. WSM0713: log(1) write error:(27) File too large 설명 : log 파일사이즈가한계에도달했다. 조치 : 하나의 log 파일이시스템에서제한된크기에도달했기때문이다. 시스템에서정의된파일사이즈를늘려주거나 log 파일의크기를줄여야한다. ( 만일 accesslog 가하나의파일로저장되는경우이를날짜별로기록하도록 WebtoB 환경설정을변경할수있다.) WSM5516: signal 25 catched: ignored 설명 : 시스템으로부터시그널 25 번이감지되었다. 조치 : 시스템으로부터시그널 25 번이감지되었으나이를 WebtoB 에서무시하였다. WebtoB 에영향을주지않는에러이므로무시해도된다. WSM0116: server abnormaly closed: ADM 설명 : wsadmin 프로세스가비정상종료되었다. 조치 : wsadmin 을강제로종료한경우에출력되는에러이다. WebtoB 에영향을주지않는에러이므로무시해도된다. HTH2601: no slot is available for jsv: name = svr_name 설명 : JEUS 의커넥션을맺기위한공간이부족하다. 조치 : JEUS 로부터 WebtoB 의 JSV 타입의서버프로세스의 MaxProc 를초과하여커넥션을맺으려고한경우이다. WebtoB 환경설정의 JSV 서버프로세스의 MaxProc 갯수를늘려주거나 JEUS 환경설정 (WEBMain.xml) 에서 <webtob-listener> 의 max 갯수를 WebtoB 의 MaxProc 보다작게설정한다. HTH2602: jsv register error: jsvno (ind) error 설명 : JEUS 의커넥션을등록중에에러가발생하였다. 조치 : JEUS 로부터 WebtoB 로커넥션을연결하는과정에서내부프로토콜이맞지않기때문이다. WebtoB 환경설정의 JSV TmaxSoft 28
WebtoB Error Message Reference Manual WebtoB 서버프로세스명과 JEUS 환경설정 (WEBMain.xml) 에서 <webtoblistener> 의 registration-id 이름이일치하는지확인한다. HTH0221: svr_q (svr_name) is purged: count = n 설명 : 서버프로세스 (svr_name) 의큐에있는클라이언트의요청 n 개가삭제되었다. 조치 : WebtoB 관리자가 wsadmin 에서서버프로세스의큐에적체되어있는요청을삭제한경우이다. HTH0222: svc_q (svc_name) is purged: count = n 설명 : 서비스 (svc_name) 의큐에있는클라이언트의요청 n 개가삭제되었다. 조치 : WebtoB 관리자가 wsadmin 에서서비스의큐에적체되어있는요청을삭제한경우이다. 29 TmaxSoft