3.3. 웹 컨텍스트 Deploy
3.3.1. jeus-web-dd.xml 설정
WebAdmin을사용하여오류가발생한경우의 Stacktrack 첨부여부를설정하는방법은다음과같다.
1. WebAdmin 왼쪽 메뉴에서 [Servers]를 선택하면 서버 목록 조회 화면으로 이동한다. 서버 목록에서 실 행할 서버를 선택하면 서버 설정화면으로 이동한다. 설정화면에서 [Engine] > [Web Engine] > [Basic]
메뉴를 선택한다. ([그림 1.7] 참고)
2.설정 및 설정 변경을 위해 화면 왼쪽의 [LOCK & EDIT] 버튼을 클릭해서 설정 변경 모드로 전환한다.
3. Web Engine 화면에서 'Attach Stacktrace on Error' 항목을 Boolean 값으로 설정하고 [확인] 버튼을 클릭한다. 기본값은 false이고, 항목을 체크하면 기본 오류 페이지 관련 설정인 'Default Error Page' 항 목이 설정되지 않은 경우에 웹 엔진의 기본 오류 페이지에 첨부되어 사용자에게 전달된다.
기본 오류 페이지 관련 설정에 대한 자세한 내용은 “1.6.3. 기본 오류 페이지 설정”을 참고한다.
[그림 1.12] 오류 발생시 Stack Trace 첨부 - 설정
4.설정을 완료한 뒤 설정 내용의 반영을 위해 [Activate Changes] 버튼을 클릭한다. ([그림 1.5] 참고) 5.설정 내용이 반영되면 다음과 같이 화면에 반영 결과가 나타난다. 'Attach Stacktrace on Error'는 동
적 설정 항목이 아니므로 반영 결과에 표시된 것처럼 서버를 재시작해야 설정 내용이 반영된다.
웹 엔진은 엔진 내의 모든 컨텍스트에 의해 사용될 수 있는 3가지 인코딩 설정을 가지고 있다.
● Request Url Encoding
HTTP 요청 URL을 위한 인코딩이다.
Request Url Encoding은 웹 브라우저로부터 받은 HTTP 요청의 Request Line에 적용된다. Request Url Encoding이 설정되지 않은 경우에는 Request Encoding이 적용된다. 일반적으로 Request Url Encoding 을 지정해야 하는 경우는 HTTP Request Line의 인코딩이 HTTP 바디와 다른 특별한 경우이다.
– Request Url Encoding은 다음의 우선순위에 따라 적용된다.
1. domain.xml에 정의된 "forced" 인코딩
2. HTTP 헤더의 "Accept-Language" 필드값에 해당하는 인코딩 3. domain.xml에 정의된 "default" 인코딩
4.위의 어떤 것도 적용되지 않으면 기본적으로 "ISO-8859-1"로 설정
기본적으로 우선순위에 따라 적용되지만, 사용자가 Request 객체에 setCharacterEncoding()으로 설 정한 경우에는 query string 및 쿠키에 대해서는 사용자가 설정한 인코딩이 최우선적으로 적용된다.
따라서 관리자는 domain.xml에 "default"와 "forced" 요청 인코딩을 정의할 수 있다. "default"와 "forced"를 동시에 설정하는 것은 의미가 없으므로 둘 중 하나만 설정한다.
● Request Encoding
HTTP Request Header의 query string, 쿠키 및 postdata에 사용되는 인코딩이다.
이 인코딩은 jeus-web-dd.xml에서도 설정이 가능하며, jeus-web-dd.xml의 설정이 우선적으로 적용된다.
– Request Encoding은 다음의 우선순위에 따라 적용된다.
1.애플리케이션(Servlet/JSP)에서의 설정(request.setCharacterEncoding()으로 설정한 인코딩) 2. domain.xml에 정의된 "forced" 인코딩
3. HTTP 요청의 Content-Type의 charset에 의한 인코딩 4. HTTP 헤더의 "Accept-Language" 필드값에 해당하는 인코딩 5. domain.xml에 정의된 "default" 인코딩
6.위의 어떤 것도 적용되지 않으면 기본적으로 "ISO-8859-1"로 설정
기본적으로 우선순위에 따라 적용되지만, jeus-web-dd.xml에 설정한 경우에는 jeus-web-dd.xml의 설 정이 우선적으로 적용된다.
– HTTP Request Line의 query string은 다음과 같은 우선순위로 인코딩이 적용된다.
1. request.setCharacterEncoding()으로 지정한 인코딩
2. Request Url Encoding : 애플리케이션에서 설정되지 않은 경우 3. Request Encoding : Request Url Encoding이 설정되지 않은 경우
● Response Encoding
웹 컨테이너로부터 받은 전체 응답 HTTP 메시지에 적용되는 인코딩이다.
Response Encoding은 PrintWriter.println()을 Byte 배열로 변환할 때 HTTP 헤더의 "Content-Type:text/html;charset=XXX" 부분의 "XXX" 값을 설정하고 웹 컨테이너의 응답에 어떤 인코딩을 사용 할지 결정한다. 이 인코딩 역시 jeus-web-dd.xml에서도 설정이 가능하다.
– Response Encoding은 다음의 우선순위 목록에 따라 적용된다.
1. domain.xml에 정의된 "forced" 인코딩
2.서블릿에서의 설정(Servlet에서는 response.setContentType ("text/html;charset=XXX"), JSP에서 는 <%@ page contentType="text/html;charset=XXX"%>로 프로그래머가 설정한 XXX 값의 인코 딩)
3. domain.xml에 정의된 "default" 인코딩
4.위의 어떤 것도 적용되지 않으면 기본적으로 "ISO-8859-1"로 설정된다.
기본적으로 우선순위에 따라 적용되지만 jeus-web-dd.xml에 설정한 경우에는 jeus-web-dd.xml의 설 정이 우선적으로 적용된다. 관리자는 domain.xml에 "default"와 "forced" Response Encoding을 정의 할 수 있다.
WebAdmin 사용
WebAdmin을 사용하여 인코딩을 설정하는 방법은 다음과 같다.
1. WebAdmin 왼쪽 메뉴에서 [Servers]를 선택하면 서버 목록 조회 화면으로 이동한다. 서버 목록에서 실 행할 서버를 선택하면 서버 설정화면으로 이동한다. 설정화면에서 [Engine] > [Web Engine] > [Basic]
메뉴를 선택한다. ([그림 1.7] 참고)
2.설정 및 설정 변경을 위해 화면 왼쪽의 [LOCK & EDIT] 버튼을 클릭해서 설정 변경 모드로 전환한다.
3.고급 선택사항의 Encoding 영역에서 'Request Url Encoding', 'Request Encoding', 'Response En coding' 항목을 설정하고 [확인] 버튼을 클릭한다.
'Request Url Encoding'을 제외하고 jeus-web-dd.xml에서도 설정이 가능하다.
[그림 1.14] 웹 엔진 인코딩 - 설정
각 항목별로 'Default' / 'Forced' 중 하나를 선택하여 활성화한 후 설정할 인코딩명을 입력한다.
설명 설정값
어떤 인코딩도 없을 경우에 기본값으로 사용한다.
Default
해당 인코딩을 모든 경우에 항상 강제적으로 사용한다.
Forced
4.설정을 완료한 뒤 설정 내용의 반영을 위해 [Activate Changes] 버튼을 클릭한다. ([그림 1.5] 참고) 5.설정 내용이 반영되면 다음과 같이 화면에 반영 결과가 나타난다. 'Attach Stacktrace on Error'는 동
적 설정 항목이 아니므로 반영 결과에 표시된 것처럼 서버를 재시작해야 설정 내용이 반영된다.
[그림 1.15] 웹 엔진 인코딩 - 설정 적용 결과
참고
JEUS 6까지는 위의 <default>와 <forced>를 동시에 설정하는 것이 가능했다. 그러나 두 값이 모두 설정되면 <forced>가 적용될 것이므로 동시에 설정되는 것은 의미가 없기 때문에 JEUS 7에서는 이 부분을 서로 배타적으로 설정하도록 변경했다.
1.6.7. 응답 헤더 설정
사용자 임의의 HTTP Response Header를 이름과 값의 짝으로 정의할 수 있다.
WebAdmin을 사용하여 응답에 기본적으로 포함될 사용자 정의 헤더를 설정하는 방법은 다음과 같다.
1. WebAdmin 왼쪽 메뉴에서 [Servers]를 선택하면 서버 목록 조회 화면으로 이동한다. 서버 목록에서 실 행할 서버를 선택하면 서버 설정화면으로 이동한다. 설정화면에서 [Engine] > [Web Engine] > [Basic]
메뉴를 선택한다. ([그림 1.7] 참고)
2.설정 및 설정 변경을 위해 화면 왼쪽의 [LOCK & EDIT] 버튼을 클릭해서 설정 변경 모드로 전환한다.
3.고급 선택사항의 Response Header 영역의 항목을 설정하고 [확인] 버튼을 클릭한다.
다음은 응답에 2개의 사용자 정의 헤더를 설정한 예제이다. 1개 이상의 응답 헤더를 설정할 경우에는 각 헤더들의 헤더명과 헤더값을 등호(=)로 연결하고, 라인별로 구분한다.
[그림 1.16] 웹 엔진 응답 헤더 - 설정
설정 항목에 대한 설명은 다음과 같다.
설명 항목
HTTP 응답 메시지에 포함하기 위한 커스텀 필드를 정의한다.
Custom Header
4.설정을 완료한 뒤 설정 내용의 반영을 위해 [Activate Changes] 버튼을 클릭한다. ([그림 1.5] 참고)
5.설정 내용이 반영되면 다음과 같이 화면에 반영 결과가 나타난다. 'Custom Header'는 동적 설정 항목 이 아니므로 반영 결과에 표시된 것처럼 서버를 재시작해야 설정 내용이 반영된다.
[그림 1.17] 웹 엔진 응답 헤더 - 설정 적용
1.6.8. 쿠키 정책 설정
HTTP Request Header의 쿠키를 읽거나 애플리케이션이 생성한 새로운 쿠키를 HTTP 응답으로 보낼 때 적용하는 정책을 설정할 수 있다. 쿠키 정책 설정은 웹 엔진에 대하여 WebAdmin을 통하여 설정할 수 있 고, 또한 각 애플리케이션별로 jeus-web-dd.xml 에서 설정 가능하다.
WebAdmin을 사용하여 쿠키 정책을 설정하는 방법은 다음과 같다.
1. WebAdmin 왼쪽 메뉴에서 [Servers]를 선택하면 서버 목록 조회 화면으로 이동한다. 서버 목록에서 실 행할 서버를 선택하면 서버 설정화면으로 이동한다. 설정화면에서 [Engine] > [Web Engine] > [Basic]
메뉴를 선택한다. ([그림 1.7] 참고)
2.설정 및 설정 변경을 위해 화면 왼쪽의 [LOCK & EDIT] 버튼을 클릭해서 설정 변경 모드로 전환한다.
3.고급 선택사항의 Cookie Policy 영역의 항목을 설정하고 [확인] 버튼을 클릭한다.
다음은 쿠키 정책으로 UTF-8 인코딩을 사용하여 쿠키 인코딩 수행을 설정한 예제이다.
[그림 1.18] 웹 엔진 쿠키 정책 - 설정
설명 항목
URL Encoding Rule의 적용 여부를 설정한다.
Apply Url Encoding Rule
URL Encoding Rule을 적용할 때 사용하는 Charset Encoding이다. 설정하지 않을 경우 Request Encoding의 값을 따른다.
Charset Encoding
4.설정을 완료한 뒤 설정 내용의 반영을 위해 [Activate Changes] 버튼을 클릭한다. ([그림 1.5] 참고) 5.설정 내용이 반영되면 다음과 같이 화면에 반영 결과가 나타난다. 쿠키 정책은 동적 설정 항목이 아니
므로 반영 결과에 표시된 것처럼 서버를 재시작해야 설정 내용이 반영된다.
[그림 1.19] 웹 엔진 쿠키 정책 - 설정 적용 결과
1.6.9. 세션 설정
웹 엔진의 세션 관리를 위한 세션 객체의 공유 여부, 세션 쿠키 설정, 타임아웃 등 웹 엔진의 세션과 관련 된 모든 사항을 설정한다.
세션 설정은 다음과 같이 구분된다.
● 웹 엔진 레벨 : WebAdmin을 사용해서 세션을 설정한다. 세션 설정에 대한 자세한 내용은 “JEUS 세션 관리 안내서”의 “1.6.1. 세션 설정”을 참고한다.
● 컨텍스트 레벨 : jeus-web-dd.xml의 <jeus-web-dd> 하위에 설정한다.
웹 엔진 레벨에서 세션이 설정되어 있다면, 컨텍스트 레벨에서 세션을 설정하지 않아도 공통적으로 웹 엔 진의 세션 설정이 적용된다.
웹 엔진 레벨, 컨텍스트 레벨의 설정이 중복되었을 경우 하위 레벨의 세부적인 설정에 가장 높은 우선순위 를 부여한다. 즉, 모두 설정이 되어있다면 컨텍스트 레벨 > 웹 엔진 레벨 순으로 설정값이 적용된다.
만약 하위 레벨에서 특정 설정을 하지 않았다면 상위 레벨의 설정값을 적용하고 모든 레벨에서 설정하지 않은 값은 엔진 내부적인 기본값으로 동작한다.
참고
클러스터링된 환경에서의 세션 관련 사항에 대한 자세한 내용은 “JEUS 세션 관리 안내서”의 “제1 장 세션 트래킹(Session Tracking)”을 참고한다.
본 절에서는 각 로그들의 설정 방법에 대해 설명한다.
● 서버 로그 설정
● 액세스 로그 기본 설정
● 가상 호스트별 액세스 로그 설정
● 액세스 로그의 포맷 설정
● 액세스 로그의 필터 설정
● 유저 로그 설정
서버 로그 설정
서버 로그 설정에 대한 자세한 내용은 “JEUS Server 안내서”의 “제8장 Logging”을 참고한다.
액세스 로그 기본 설정
웹 엔진 액세스 로그는 WebAdmin을 통해 설정한다. 특별히 설정하지 않아도 기본적으로 액세스 로그를 파일로 남기도록 설정되어 있다.
참고
JEUS v6.0 Fix #8부터는 액세스 로그도 기본적으로 로그 로테이션을 적용한다.
로그 로테이션이란 JEUS에서 제공하는 기능으로 JEUS가 시작될 때 또는 JEUS 운영 중에 설정한 시간이 되거나 파일 사이즈를 넘으면 자동으로 이전에 Logging하던 파일의 이름은 바꾸고 새로 출력 할 로그들은 원래의 로그 파일에 계속 Logging할 수 있는 기능이다.
WebAdmin을 사용한 액세스 로그 기본 설정 방법은 다음과 같다.
1. WebAdmin 왼쪽 메뉴에서 [Servers]를 선택하면 서버 목록 조회 화면으로 이동한다. 서버 목록에서 실 행할 서버를 선택하면 서버 설정화면으로 이동한다. 설정화면에서 [Engine] > [Web Engine] > [Access Log]메뉴를 선택한다.