06 webtob error message reference 41 - tmaxsoft · 2019. 4. 9. · webtob webtob error message...

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

TmaxSoft 1

차 례

매뉴얼에 대하여 ............................................................................... 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

WebtoB WebtoB Error Message Reference Manual

TmaxSoft 2


TmaxSoft 3

매뉴얼에 대하여

본 매뉴얼은 WebtoB system 을 이용하여 사이트를 운영 및 개발시에 개발자와 웹 서버 관리자들이 참고 할수 있도록 실제 운영시 WebtoB 내에 포함된 툴 및 로그 파일에서 접할 수 있는 에러를 휴형별로 원인을 파악하고, 그 해결 방안을 제시한다.

본 매뉴얼은 크게 두 부분으로 구성되어 있으며 그 내용은 다음과 같다.

Chapter 1

본 장에서는 해당 매뉴얼 방향 및 Http Error Code 참고 문서에 관해 설명한다.

Chapter 2

본 장에서는 WebtoB Web Server 운영 및 관리시 발생할 수 있는 Error Message 유형과 그 대처 방법에 대해서 설명한다.


TmaxSoft 4

일러두기

표기 예 내용

텍스트 본문, 12 포인트, 바탕체 Times New Roman

텍스트 본문 강조

CTRL+C CTRL 과 동시에 C 를 누름

public class myClass { } Java 코드

<system-config> XML 문서

참조: / 주의:` 참조 사항과 주의할 사항

Configuration 메뉴를 연다 GUI 의 버튼 같은 컴포넌트

WEBTOBDIR WebtoB 가 실제 설치된 디렉토리

예)c:\TmaxSoft\WebtoB4.1

wsboot 콘솔 명령어와 문법

[ 파라미터 ] 옵션 파라미터

< xyz > ‘<’와 ‘>’ 사이의 내용이 실제

값으로 변경됨

| 선택 사항. 예) A|B: A 나 B 중

하나

… 파라미터 등이 반복되어서 나옴

?, +, * 보통 XML 문서에 각각 “없거나, 한 번”, “한 번 이상”, “없거나,


TmaxSoft 5

여러 번”을 나타낸다.

. . . XML 이나 코드 등의 생략

<<FileName.ext>> 코드의 파일명

그림 1. 그림 이름이나 표 이름

제품별 기능

제품 구분 제공 기능

Base HTML, CGI, PHP, SSI, SSL, WBAPI

Standard Base 제공기능, Multi-Node, JSP/Servlet ,

Load Balancing, Fail-Over


TmaxSoft 6

연락처

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: [email protected] 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: [email protected] 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: [email protected] 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 : [email protected] Web (Chinese): http://www.tmaxchina.com.cn


TmaxSoft 7

1 서 문

이 매뉴얼에는 현재 WebtoB 제품에 대한 에러 메시지와 그에 대한 조치사항을 기술하고 있다. 지금까지 지원된 초기 버전 및 제품에 대한 에러 메시지를 포함하고 있으며 앞으로도 추가 메시지가 계속 포함될 것이다.

WebtoB 관리자 및 개발자는 시스템오류나 사용자오류가 발생하였을때 우선적으로 본 매뉴얼을 참조하여 원인을 파악하고 조치를 할 수 있을 것이다.

조치 방법중에 WebtoB 환경설정을 변경해야 하는 부분에 대해서는 “WebtoB 관리자 안내서”를 참고하기 바란다.

Http Error Code 는 모든 웹서버의 공통적인 사항이므로 본 매뉴얼에서 언급하지 않았으며 Http Error Code 에 대해서는 RFC2068 을 참고하기 바란다.


TmaxSoft 8

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 9

조치 : $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 가 기동중인지 확인한다.


TmaxSoft 10

2.2 wsboot


wscfl

설명 : wsboot 버전이 맞지 않는다.


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 11

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 권한으로 실행해야 한다.


directory



WSBOOT: SVR(svr_name) is not found

설명 : 서버(svr_name)를 찾을 수가 없다..


TmaxSoft 12

조치 : 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 13

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 이 환경파일에 설정되지 않았다.


TmaxSoft 14

조치 : 환경파일에 관련 있는 항목을 입력한다.

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 15

설명 : 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 가 실행중인지 확인한다.


TmaxSoft 16

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 17

조치 : 환경파일의 중복을 방지하기 위하여 수정한다. 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 버전부터는 지원하지 않는 옵션이므로 관련설정을 삭제한다.


TmaxSoft 18


directory




TmaxSoft 19

2.4 wsdown

DOWN0021: socket connect error for remote down: tmaxh4 4455:(79)

Connection refused

설명 : remote 서버 다운을 위한 소켓 연결 에러가 발생했다.

조치 : 멀티노드 구성시 remote 연결을 위한 wsracd 가 실행중인지 확인하고, 서버간 통신을 위한 WEBTOB_RAC_PORT 설정을 확인한다.


wscfl

설명 : wsdown 버전이 엔진과 일치하지 않는다.


DOWN0110: length of option arg is too long

설명 : 유효하지 않은 인수를 지정하였다.

조치 : 어떠한 인수의 길이도 256 문자를 초과할 수 없다.


directory



BOOT0022: server(svr_name) is not in config

설명 : 환경설정 파일에 정의하지 않은 서버명을 지정하였다.


TmaxSoft 20

조치 : 환경설정 파일에 지정된 서버명을 지정하였는지 환경파일을 확인한다.

DOWN0112: unrecognized option

설명 : 유효하지 않은 옵션 플래그(option )이다.

조치 : 정확한 매개변수를 도움말(wsdown -h)을 참조한다.

DOWN0003: cannot find node name

설명 : 노드 이름을 찾을 수가 없다.

조치 : 인자로 넘긴 노드이름이 실제 환경설정 파일에 존재하는지 확인한다.

spr_id(spid) is invalid

설명 : 유효하지 않은 spid 이다.

조치 : spid 로 지정한 것이 실제로 존재하는 spid 인지 확인한다.


TmaxSoft 21

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 와 동일하게 변경해 준다.


directory




TmaxSoft 22

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 23

설명 : 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 할 수 있는지 퍼미션을 체크한다.


TmaxSoft 24

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 25

조치 : 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 에서 서비스의 큐에 적체되어 있는 요청을 삭제한 경우이다.


TmaxSoft 26

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 27

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

설명 : 서버프로세스가 재시작 되었다.


TmaxSoft 28

조치 : 서버프로세스(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 29

서버프로세스명과 JEUS 환경설정(WEBMain.xml)에서 <webtob-listener> 의 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 에서 서비스의 큐에 적체되어 있는 요청을 삭제한 경우이다.

06 webtob error message reference 41 - tmaxsoft · 2019. 4. 9. · webtob webtob error message...

Documents