1. 웹 엔진 관련 명령어
웹 엔진 관련 명령어는 크게 다음과 같이 2가지로 구분할 수 있다.
-
모니터링 및 제어
deploy되어 있는 웹 컨텍스트의 상태를 확인하거나 제어하기 위한 명령어, 웹 엔진의 상태를 확인하거나 제어하기 위한 명령어들이다.
명령어 설명 일시 중지된 웹 컴포넌트(서블릿)를 재시작한다.
웹 컴포넌트(서블릿)를 일시중지한다.
특정 컨텍스트를 동적으로 reload한다.
웹 엔진 관련 설정 정보를 조회한다.
웹 엔진 관련 각종 통계 자료를 조회한다.
web-connection thread pool에 저장된 thread local 정보의 삭제 여부를 설정한다.
컨텍스트, 서블릿 등의 요청 통계 자료를 초기화한다.
URL 패턴이나 특정 호스트명으로 들어온 요청의 처리 흐름을 조회한다.
deploy된 웹 컨텍스트의 JSP 파일들을 요청처리 전에 미리 컴파일한다.
Web Server나 Jeus Managed Server의 추가/삭제를 알려준다.
-
설정 변경 관련 명령어
웹 엔진에 속한 설정을 추가, 삭제, 수정할 수 있는 명령어들이다. 명령에 따라 동적으로 반영되지 않는 설정이 있다. 이러한 명령의 설정 변경 사항들은 XML에는 적용하지만 실제 운영 중인 서비스(메모리 영역)에 적용하지 않는다. 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
명령어 설명 Cookie Policy 설정을 추가한다.
Cookie Policy 설정을 변경한다.
Cookie Policy 설정을 삭제한다.
Character Set Encoding 설정을 추가한다.
Character Set Encoding 설정을 변경한다.공통
Character Set Encoding 설정을 삭제한다.
웹 엔진의 프로퍼티 설정을 추가한다.
웹 엔진의 프로퍼티 설정을 변경한다.
웹 엔진의 프로퍼티 설정을 삭제한다.
HTTP Response Custom Header 설정을 추가한다.
HTTP Response Custom Header 설정을 변경한다.
HTTP Response Custom Header 설정을 삭제한다.
JSP 엔진 설정을 변경한다.
가상 호스트를 추가한다.
가상 호스트의 일부 설정을 변경한다.
가상 호스트를 삭제한다.
Valve를 추가한다.
Valve를 삭제한다.
Valve의 프로퍼티 설정을 추가한다.
Valve의 프로퍼티 설정을 삭제한다.
WebtoB 커넥터를 추가한다.
WebtoB 커넥터의 일부 설정을 변경한다.
WebtoB 커넥터를 삭제한다.
WebtoB 커넥터 정보를 조회한다.
Backup WebtoB를 추가한다.
Backup WebtoB를 삭제한다.
Tmax 커넥터를 추가한다.
Tmax 커넥터의 일부 설정을 변경한다.
Tmax 커넥터를 삭제한다.
AJP 리스너를 추가한다.
HTTP 리스너를 추가한다.
TCP 리스너를 추가한다.
HTTP, TCP, AJP 리스너의 일부 설정을 변경한다.
HTTP, TCP, AJP 리스너를 삭제한다.
웹 엔진의 일부 설정을 동적으로 변경한다.
1.1. 공통적용 사항
다음은 웹 엔진 관련 명령어에서 공통적으로 적용되는 옵션에 대한 설명이다. 아래 옵션 중 하나만 설정될 수 있다.
-
[-cluster <cluster-name>] 옵션
-
각 명령어가 적용될 클러스터를 지정할 때 사용하는 옵션이다. 옵션을 설정하지 않으면 현재 접속된 서버의 웹 엔진으로 적용된다.
-
각 명령어의 옵션 설명에서 이 옵션에 대한 설명은 생략한다. 단, precompile-jsp는 이 옵션을 제공하지 않는다.
-
-
[-server <server-name>] 옵션
-
각 명령어가 적용될 서버를 지정할 때 사용하는 옵션이다. 옵션을 설정하지 않으면 현재 접속된 서버의 웹 엔진으로 적용된다.
-
각 명령어의 옵션 설명에서 이 옵션에 대한 설명은 생략한다.
-
|
1.2. add-ajp-listener
AJP 리스너를 추가한다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/ajp13-listener
-
alias
addajpl
-
사용법
add-ajp-listener [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -name <web-connection-name> -slref <server-listener-ref-name> -tmin <minimum-thread-num> [-tmax <maximum-thread-num>] [-tidle <max-idle-time>] [-qs <max_queue>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-name <web-connection-name>
리스너의 이름이다.
-slref <server-listener-ref-name>
서버에 등록된 서비스 리스너의 이름이다.
-tmin <minimum-thread-num>
Thread Pool의 최소 Thread 수이다.
[-tmax <maximum-thread-num>]
Thread Pool의 최대 Thread 수이다. 설정하지 않으면 tmin와 같은 값을 갖는다.
[-tidle <max-idle-time>]
Thread Pool에서 제거되기 전에 Idle 상태로 머물러 있는 Worker Thread의 최대 시간이다.
[-qs <max_queue>]
Thread Pool에서 처리할 작업들을 저장할 Queue의 Size이다.
-
예제
add-ajp-listener -name ajp1 -server server1 -slref ajp-server -tmin 10
1.3. add-backup-webtob
Backup WebtoB을 추가한다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/webtob-connector/webtob-backup
-
alias
addbackupwebtob
-
사용법
add-backup-webtob -cluster <cluster-name> | -server <server-name> [-f, --forceLock] -name <web-connection-name> [-addr <server-address>] -port <server-port> | -dsocket [-wbhome <webtob-home>] [-ipcport <ipc-base-port>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-name <web-connection-name>
Backup WebtoB를 추가할 WebtoB 커넥터의 이름이다.
-addr <server-address>
Backup WebtoB의 서버 주소이다. -port 사용할 때 필수 옵션이다.
-port <server-port>
Backup WebtoB의 서버 포트 번호이다.
-dsocket
Unix 도메인 소켓(Pipe)을 이용하여 JEUS와 WebtoB 사이에 통신을 한다.
-wbhome <webtob-home>
JEUS와 WebtoB가 같은 장비 안에 설치되어 있을 경우 Backup WebtoB가 설치된 절대 경로이다.
-ipcport <ipc-base-port>
Windows 환경에서 WebtoB의 내부 프로세스간 통신을 할 때 사용하는 기본 포트 번호이다.
-
예제
add-backup-webtob -server server1 -name webtob1 -port 9999 -addr localhost
1.4. add-http-listener
HTTP 리스너를 추가한다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/http-listener
-
alias
addhttpl
-
사용법
add-http-listener [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -name <web-connection-name> -slref <server-listener-ref-name> -tmin <minimum-thread-num> [-tmax <maximum-thread-num>] [-tidle <max-idle-time>] [-qs <max_queue>] [-http2] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-name <web-connection-name>
리스너의 이름이다.
-slref <server-listener-ref-name>
서버에 등록된 서비스 리스너의 이름이다.
-tmin <minimum-thread-num>
Thread Pool의 최소 Thread 수이다.
[-tmax <maximum-thread-num>]
Thread Pool의 최대 Thread 수이다. 설정하지 않으면 tmin와 같은 값을 갖는다.
[-tidle <max-idle-time>]
Thread Pool에서 제거되기 전에 Idle 상태로 머물러 있는 Worker Thread의 최대 시간이다.
[-qs <max_queue>]
Thread Pool에서 처리할 작업들을 저장할 Queue의 Size이다.
[-http2]
HTTP/2를 사용한다.
-
예제
add-http-listener -name http1 -server server1 -slref http-server -tmin 5 -tmax 10 -http2
1.5. add-response-header
웹 엔진의 Response Header 설정을 추가한다. 추가되는 Response Header는 대소문자를 구별하지 않는다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/response-header
-
alias
addwebrh
-
사용법
add-response-header [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] [-n,--name <header-name>] [-v,--value <header-value>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
[-n,--name <header-name>]
추가할 HTTP Response Header의 이름을 설정한다. 입력값은 대소문자를 구별하지 않는다. 같은 이름의 Header는 1개만 허용된다.
[-v,--value <header-value>]
추가할 HTTP Response Header의 값을 설정한다. 입력값은 대소문자를 구별하지 않는다.
-
예제
add-response-header -server server1 -n testHeader -v testValue
1.6. add-tcp-listener
TCP 리스너를 추가한다. 단, TCP 리스너는 XML에만 반영하며 TCP 리스너를 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/tcp-listener
-
alias
addtcpl
-
사용법
add-tcp-listener [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -name <web-connection-name> -slref <server-listener-ref-name> -dcc <dispatcher-config-class> -tmin <minimum-thread-num> [-tmax <maximum-thread-num>] [-tidle <max-idle-time>] [-qs <max_queue>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-name <web-connection-name>
리스너의 이름이다.
-slref <server-listener-ref-name>
서버에 등록된 서비스 리스너의 이름이다.
-dcc <dispatcher-config-class>
jeus.servlet.tcp.TCPDispatcherConfig 인터페이스를 구현한 클래스 이름이다.
-tmin <minimum-thread-num>
Thread Pool의 최소 Thread 수이다.
[-tmax <maximum-thread-num>]
Thread Pool의 최대 Thread 수이다. 설정하지 않으면 tmin와 같은 값을 갖는다.
[-tidle <max-idle-time>]
Thread Pool에서 제거되기 전에 Idle 상태로 머물러 있는 Worker Thread의 최대 시간이다.
[-qs <max_queue>]
Thread Pool에서 처리할 작업들을 저장할 Queue의 Size이다.
-
예제
add-tcp-listener -name tcp1 -slref tcp -server server1 -dcc tcp.DispatcherConfigImpl -tmin 5 -tmax 10
1.7. add-tmax-connector
Tmax 커넥터를 추가한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/tmax-connector
-
alias
addtmaxcon
-
사용법
add-tmax-connector [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -name <web-connection-name> -addr <server-address> -port <server-port> -svrg <server-group-name> -svr <server-name> -dcc <dispatcher-config-class> -tmin <minimum-thread-num> [-tmax <maximum-thread-num>] [-tidle <max-idle-time>] [-qs <max_queue>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-name <web-connection-name>
Tmax 커넥터의 이름이다.
-addr <server-address>
Tmax 서버 주소이다.
-port <server-port>
Tmax 서버 포트 번호이다.
-svrg <server-group-name>
Tmax가 속한 서버 그룹 이름이다.
-svr <server-name>
Tmax의 서버 이름이다.
-dcc <dispatcher-config-class>
jeus.servlet.tcp.TCPDispatcherConfig 인터페이스를 구현한 클래스 이름이다.
-tmin <minimum-thread-num>
Thread Pool의 최소 Thread 수이다.
[-tmax <maximum-thread-num>]
Thread Pool의 최대 Thread 수이다. 설정하지 않으면 tmin와 같은 값을 갖는다.
[-tidle <max-idle-time>]
Thread Pool에서 제거되기 전에 Idle 상태로 머물러 있는 Worker Thread의 최대 시간이다.
[-qs <max_queue>]
Thread Pool에서 처리할 작업들을 저장할 Queue의 Size이다.
-
예제
add-tmax-connector -name tmax1 -addr 5.0.1.2 -port 1024 -svrg group1 -svr server1 -server server1 -dcc serice.DispatcherConfig
1.8. add-virtual-host
가상 호스트를 추가한다.
-
관련 스키마
web-engine.xsd - web-engine/virtual-host
-
alias
addvh
-
사용법
add-virtual-host [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] <virtual-host-name> -list <host-name-list> [-tmin <minimum-thread-num>] [-tmax <maximum-thread-num>] [-tidle <max-idle-time>] [-qs <max-queue>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
<virtual-host-name>
가상 호스트의 이름이다.
-list <host-name-list>
가상 호스트에 등록할 도메인 이름 또는 IP 주소이다.
[-tmin <minimum-thread-num>]
Thread Pool의 최소 Thread 수이다.
[-tmax <maximum-thread-num>]
Thread Pool의 최대 Thread 수이다.
[-tidle <max-idle-time>]
Thread Pool에서 제거되기 전에 Idle 상태로 머물러 있는 Worker Thread의 최대 시간이다.
[-qs <max-queue>]
Thread Pool에서 Queue에 대기할 수 있는 최대 요청값이다.
-
예제
add-virtual-host -server server1 host2 -list www.foo.com,192.168.1.2 -tmin 1 -tmax 10 -tidle 20000
1.9. add-valve
Valve를 추가한다.
-
관련 스키마
web-engine.xsd - pipeline/valve
-
alias
addvlv
-
사용법
add-valve [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -cn, --classname <class-name> -p, --properties <property> [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-cn, --classname <class-name>
서버, 가상호스트에 적용할 valve class를 지정한다. 제우스의 ValveBase를 상속받은 클래스로 지정해야 한다.
[-p,--properties <properties>]
valve의 프로퍼티를 설정한다.
-
한 개의 프로퍼티는 "key=value" 형태로 "="를 이용하여 설정한다.
-
한 개 이상의 프로퍼티를 수정할 경우에는 각 프로퍼티를 콤마(,)로 구분하여 설정한다.
[-vh <virtual-host-name>]
valve를 추가할 가상 호스트의 이름이다. 가상 호스트 이름을 설정 안하면 서버 단에서 valve가 추가된다.
-
-
예제
add-valve -server server1 -cn UserValveBase -p jeus.servlet.jsp.compile-java-source-concurrently=false,userProperty=myValue
1.10. add-web-cookie-policy
웹 엔진의 HTTP Cookie Policy 설정을 추가한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/cookie-policy
-
alias
addcookie
-
사용법
add-web-cookie-policy [-cluster <cluster-name> | -server <server-name>] [-f, -forceLock] [-auer,--apply-url-encoding-rule <apply-url-encoding-rule>] [-enc,--charset-encoding <charset-encoding>] [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
[-auer,--apply-url-encoding-rule <apply-url-encoding-rule>]
URL Encoding Rule 적용 여부를 설정한다.
[-enc,--charset-encoding <charset-encoding>]
URL Encoding Rule을 적용할 때 사용하는 Charset Encoding이다. 설정하지 않을 경우 Request Encoding 값을 따른다.
[-vh <virtual-host-name>]
가상 호스트를 지정한다.
-
예제
add-web-cookie-policy -server server1 -auer true add-web-cookie-policy -server server1 -enc EUC-KR
1.11. add-web-encoding
웹 엔진의 Encoding을 추가한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다(이미 설정되어 있던 Encoding을 삭제하고 추가하며, Encoding이 변한 경우 restart되어야 서버에 적용이 된다).
-
관련 스키마
web-engine.xsd - web-engine/encoding
-
alias
addenc
-
사용법
add-web-encoding [-cluster <cluster-name> | -server <server-name>] [-f, -forceLock] <charset-encoding> [-co | -default | -forced] [-url] [-req] [-res] [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
<charset-encoding>
설정할 Character Set Encoding 이름이다. 잘못된 값이 입력되면 오류가 출력되고 명령이 실패한다.
-co | -default | -forced
입력된 Encoding을 default로 설정할지 forced로 설정할지 결정한다. request encoding인 경우 두 설정 외에 client-override를 설정할 수 있다.
[-url]
Request Url의 Character Set Encoding을 설정한다.
[-req]
Request의 Character Set Encoding을 설정한다.
[-res]
Response의 Character Set Encoding을 설정한다.
[-vh <virtual-host-name>]
가상 호스트를 지정한다.
-
예제
add-web-encoding -server server1 -default -url UTF-8 addenc -server server1 UTF-8 -forced -req -res
1.12. add-web-properties
웹 엔진의 프로퍼티 설정을 추가한다. 추가되는 프로퍼티는 대소문자를 구별한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/properties
-
alias
addwebpr
-
사용법
add-web-properties [-cluster <cluster-name> | -server <server-name>] [-f, -forceLock] -p,--properties <properties> [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-p,--properties <properties>
추가할 웹 엔진의 프로퍼티를 설정한다.
-
한 개의 프로퍼티는 "key=value" 형태로 "="를 이용하여 설정한다.
-
한 개 이상의 프로퍼티를 추가할 경우에는 각 프로퍼티를 콤마(,)로 구분하여 설정한다.
[-vh <virtual-host-name>]
가상 호스트를 지정한다.
-
-
예제
add-web-properties -server server1 -p jeus.servlet.jsp.modern=false add-web-properties -server server1 -p jeus.servlet.jsp.compile-java-source-concurrently1=false,jeus.servlet.jsp.assure-utf8-file-encoding-detection=true
1.13. add-webtob-connector
WebtoB 커넥터를 추가한다. 추가한 WebtoB 커넥터는 실제 서비스에 사용 가능하다. 단, 추가 후에는 WebtoB 연결 주소, 포트 등을 변경할 수 없으므로 주의깊게 추가하기 바란다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/webtob-connector
-
alias
addwebtobcon
-
사용법
add-webtob-connector [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -name <web-connection-name> -conn <connection-count> -regid <registration-id> -tmin <minimum-thread-num> [-tmax <maximum-thread-num>] [-tidle <max-idle-time>] [-qs <max_queue>] [-hth <hth-count>] [-useNio <use-nio>] [-ver <wjp-version>>] [-addr <server-address>] -port <server-port> | -dsocket [-wbhome <webtob-home>] [-ipcport <ipc-base-port>] [-sndbuf <send-buffer-size>] [-rcvbuf <receive-buffer-size>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-name <web-connection-name>
WebtoB 커넥터의 이름이다.
-conn <connection-count>
WebtoB와 연결할 Connection 갯수이다.
-tmin <minimum-thread-num>
Thread Pool의 최소 Thread 수이다.
[-tmax <maximum-thread-num>]
Thread Pool의 최대 Thread 수이다. 설정하지 않으면 tmin와 같은 값을 갖는다.
[-tidle <max-idle-time>]
Thread Pool에서 제거되기 전에 Idle 상태로 머물러 있는 Worker Thread의 최대 시간이다.
[-qs <max_queue>]
Thread Pool에서 처리할 작업들을 저장할 Queue의 Size이다.
[-hth <hth-count>]
hth process의 갯수이다.
-ver <wjp-version>
WebtoB와 통신할 때 사용하는 프로토콜 버전을 나타낸다. 1 또는 2를 입력한다.
-addr <server-address>
WebtoB 서버 주소이다. -port 사용할 때 필수 옵션이다.
-port <server-port>
WebtoB 서버 포트 번호이다.
-regid <registration-id>
WebtoB와의 등록 ID이다.
-dsocket
Unix 도메인 소켓(Pipe)을 이용하여 JEUS와 WebtoB 사이에 통신을 한다.
-wbhome <webtob-home>
JEUS와 WebtoB가 같은 장비 안에 설치되어 있을 경우 WebtoB가 설치된 절대 경로이다.
-ipcport <ipc-base-port>
Windows 환경에서 WebtoB의 내부 프로세스간 통신을 할 때 사용하는 기본 포트 번호이다.
-sndbuf <send-buffer-size>
TCP 소켓이나 Unix 도메인 소켓의 SO_SNDBUF를 설정한다.
0이면 OS의 기본값을 사용한다.
-rcvbuf <receive-buffer-size>
TCP 소켓이나 Unix 도메인 소켓의 SO_RCVBUF를 설정한다.
0이면 OS의 기본값을 사용한다.
-
예제
add-webtob-connector -server server1 -name webtob1 -conn 10 -tmin 10 -hth 2 -regid MyGroup -port 9999 -addr localhost
1.14. clear-thread-local
모든 web-connection thread pool에 저장된 thread local 정보의 삭제 여부를 설정한다. 기본적으로는 삭제하지 않으며, 삭제할 경우 각 thread가 task를 실행하기 전에 매번 체크하고 삭제한다. 해당 기능은 on/off로 조정할 수 있다.
-
관련 스키마
web-engine.xsd
-
alias
clrtl, cltl
-
사용법
clear-thread-local [-cluster <cluster-name> | -server <server-name>] [-f,--forceLock] -wc <web-connection-name> -off | -on -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-wc <web-connection-name>]
web-connection의 이름이다.
-off | -on
-
-off : thread local을 지우지 않는다.
-
-on : thread local을 지운다.
-
-
예제
clear-thread-local -server server1 -wc http-listener -on
1.15. clear-web-statistics
지정한 Entity(컨텍스트, 서블릿)에 대하여 요청 통계 자료를 초기화하여 카운터 기록을 재설정한다.
-
관련 스키마
web-engine.xsd
-
alias
clrstat, clst, clrwebstat
-
사용법
clear-web-statistics [-server <server-name>] [-ctx,--context <context-name>] [-servlet <servlet-name>] -
파라미터
파라미터 설명 [-ctx <context-name>]
요청 횟수 및 처리 시간 기록, 작업 스레드에 대한 정보들을 삭제할 컨텍스트이다.
[-servlet <servlet-name>]
요청 횟수 및 처리 시간 기록을 삭제할 서블릿이다.
-
예제
clear-web-statistic -server server1 -ctx ctx1
1.16. modify-jsp-engine
웹 엔진의 JSP 엔진 설정을 수정한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/jsp-engine
-
alias
modjsp
-
사용법
modify-jsp-engine [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] [-rjwd,--remove-jsp-work-dir | -jwd,--jsp-work-dir <jsp-work-dir>] [-javac,--java-compiler <java-compiler>] [-cod,--compile-output-dir <compile-output-dir> | -rcod,--remove-compile-output-dir] [-rcopt,--remove-compile-option | -copt,--compile-option <compile-option>] [-cij,--check-included-jspfile <check-included-jspfile>] [-kg,--keep-generated <keep-generated>] [-gjr,--graceful-jsp-reloading <graceful-jsp-reloading>] [-gjrp,--graceful-jsp-reloading-period <graceful-jsp-reloading-period>] [-umc,--use-in-memory-compilation <use-in-memory-compilation>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
[-rjwd,--remove-jsp-work-dir | -jwd,--jsp-work-dir <jsp-work-dir>]
-jwd,--jsp-work-dir <jsp-work-dir>을 이용하여 JSP를 Java로 생성한 파일과 그 소스 파일을 컴파일한 클래스 파일들이 저장되는 위치를 설정한다. 이때 설정값은 절대 경로로 입력해야 한다.
-rjwd,--remove-jsp-work-dir을 이용하여 설정을 삭제할 수 있다. 삭제할 경우 엔진의 내부 기본값이 사용된다.
[-javac,--java-compiler <java-compiler>]
JSP의 Java 소스를 서블릿 클래스 파일로 컴파일하기 위한 Java 컴파일러를 지정한다.
다음 중에 하나를 설정한다.
-
java6 (기본값)
-
sun.tools.javac
-
javac
-
com.sun.tools.javac
-
eclipse
각 값들에 대한 설명은 스키마를 참고한다. 기본값으로 설정하는 것이 가장 효율적이기 때문에 별도의 설정을 하지 않는 것을 권장한다.
[-cod,--compile-output-dir <compile-output-dir> | -rcod,--remove-compile-output-dir]
-cod,--compile-output-dir <compile-output-dir>를 이용하여 JSP 파일에 의해 생성된 클래스 파일들을 JSP Work Dir 디렉터리가 아닌 다른 디렉터리에 저장할 수 있는 설정할 수 있다. 설정하지 않으면 클래스 파일들은 JSP Work Dir 디렉터리에 위치한다.
-rcod,--remove-compile-output-dir을 이용하여 설정을 삭제할 수 있다. 삭제할 경우 엔진의 내부 기본값이 사용된다.
[-rcopt,--remove-compile-option | -copt,--compile-option <compile-option>]
-copt,--compile-option <compile-encoding>을 이용하여 서블릿 컴파일러로 사용되는 옵션을 설정한다.
-rcopt,--remove-compile-option을 이용하여 설정한 값을 삭제할 수 있다.
[-cij,--check-included-jspfile <check-included-jspfile>]
JSP 파일의 변경 여부를 확인할 때 include된 JSP 파일들, Tag 파일들의 변경 여부를 확인해서 변경된 경우 해당 JSP 파일을 재컴파일하는 기능의 사용 여부를 설정한다.
[-kg,--keep-generated <keep-generated>]
JSP 페이지로부터 생성된 Java 소스 파일을 컴파일하여 서블릿 클래스 파일을 생성한 이후에 Java 소스 파일의 저장 여부를 결정한다.
[-gjr,--graceful-jsp-reloading <graceful-jsp-reloading>]
JSP 소스와 컴파일된 클래스 파일이 공유되고 있고, 하나의 JVM에서 exclusive하고 JSP 파일을 배치 형태의 Java 파일로 변환하여 컴파일할 것을 설정한다.
JSP Work Dir 설정에 의해 공유되는 폴더가 지정되어 있는 경우에 한해서 동작한다.
[-gjrp,--graceful-jsp-reloading-period <graceful-jsp-reloading-period>]
Graceful JSP reloading이 동작되는 주기를 설정한다.
[-umc,--use-in-memory-compilation <use-in-memory-compilation>]
서비스 중인 JSP 파일을 새로 컴파일해야 할 때 .java 및 .class 파일을 메모리 상에 생성해서 컴파일하는 기능을 설정한다. 단, .class 파일의 경우에는 추후 리부팅할 때에 재컴파일하는 일이 없도록 Background thread를 통해서 파일 시스템에 쓴다.
또한 <keep-generated>>가 true인 경우에는 .java 파일을 Background thread를 통해서 파일 시스템에 쓴다.
-
-
예제
modify-jsp-engine -server server1 -jwd /home/jeus/jsp
1.17. modify-response-header
웹 엔진의 Response Header 설정을 수정한다. 수정되는 Response Header는 대소문자를 구별하지 않는다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/response-header
-
alias
modwebrh
-
사용법
modify-response-header [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] [-n,--name <header-name>] [-v,--value <header-value>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
[-n,--name <header-name>]
수정할 HTTP Response Header의 이름을 설정한다. 입력값은 대소문자를 구별하지 않는다. 같은 이름의 Header는 1개만 허용된다.
[-v,--value <header-value>]
수정할 HTTP Response Header의 값을 설정한다. 입력값은 대소문자를 구별하지 않는다.
-
예제
modify-response-header -server server1 -n testheader -v testvalue3
1.18. modify-tmax-connector
Tmax 커넥터의 설정 등을 변경한다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/tmax-connector
-
alias
modtmaxcon
-
사용법
modify-tmax-connector [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -name <web-connection-name> [-tmin <minimum-thread-num>] [-tmax <maximum-thread-num>] [-tidle <max-idle-time>] [-obuf <output-buffer-size>] [-addr <server-address>] [-port <server-port>] [-svrg <server-group-name>] [-svr <server-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-name <web-connection-name>
Tmax 커넥터의 이름이다.
[-tmin <minimum-thread-num>]
[동적 변경] Thread Pool의 최소 Thread 수이다.
[-tmax <maximum-thread-num>]
[동적 변경] Thread Pool의 최대 Thread 수이다.
[-tidle <max-idle-time>]
Thread Pool의 Thread별 유후 대기 시간이다.
[-obuf <output-buffer-size>]
서블릿 응답 버퍼 크기다.
[-addr <server-address>]
Tmax 서버 주소이다.
[-port <server-port>]
Tmax 서버 포트 번호이다.
[-svrg <server-group-name>]
Tmax 서버의 서버 그룹 이름이다.
[-svr <server-name>]
Tmax 서버의 이름이다.
-
예제
modify-tmax-connector -name tmax1 -tmin 30 -server server1 -obuf 20000
1.19. modify-virtual-host
가상 호스트의 액세스 로그 포맷 설정을 변경한다. 만약 가상 호스트의 액세스 로그가 enable 상태가 아닐 경우 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/virtual-host
-
alias
modvh
-
사용법
modify-virtual-host [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] <virtual-host-name> [-tmin <minimum-thread-num>] [-tmax <maximum-thread-num>] [-tidle <max-idle-time>] [-aluph <true | false>| -alf <access-log-format> | -aluse <true | false> | -alhnl <true | false> | -alext <access-log-excluded-extensions>] [-hnrm <host-name> | -hnadd <host-name>] [-ast <attach-stacktrace-on-error>] [-fhn <access-log-handler-file-handler-name>] [-fhp <access-log-handler-file-handler-permission>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
<virtual-host-name>
가상 호스트의 이름이다.
[-tmin <minimum-thread-num>]
[동적 변경] Thread Pool의 최소 Thread 수이다.
[-tmax <maximum-thread-num>]
[동적 변경] Thread Pool의 최대 Thread 수이다.
[-tidle <max-idle-time>]
Thread Pool의 Thread별 유후 대기 시간이다.
[-aluph <true | false>]
[동적 변경] 웹 엔진 액세스 로그에 남길지 여부를 지정한다.
(true | false 또는 t | f)
[-alf <access-log-format>]
[동적 변경] 액세스 로그 포맷이다. 중간에 스페이스 문자가 있는 경우 큰따옴표(" ")로 감싸야 한다. 포맷에 관한 자세한 사항은 JEUS Web Engine 안내서의 액세스 로그 포맷 설정을 참고한다.
[-aluse <true | false>]
[동적 변경] 액세스 로그 사용 여부를 지정한다.
(true | false 또는 t | f)
[-alhnl <true | false>]
[동적 변경] %h 포맷에 대해 로깅할 때 IP 주소에 대한 DNS Resolution 여부를 지정한다. (true | false 또는 t | f)
[-alext <access-log-excluded-extentions>]
[동적 변경] 액세스 로그에 남기지 않을 확장자를 설정한다. '.gif', '.jpg’와 같이 여러 개를 설정하는 경우 콤마(,)를 사용한다. 설정하지 않는 경우 콤마만 입력한다.
[-hnrm <host-name>]
가상 호스트에 등록된 호스트 이름을 제거한다.
[-hnadd <host-name>]
가상 호스트에 새로운 호스트 이름을 등록한다.
[-ast <attach-stacktrace-on-error>]
JEUS에서 보내주는 에러 페이지에 Stack Trace를 첨부할지 여부를 설정한다.
[-fhn <access-log-handler-file-handler-name>]
Permission을 수정할 file-handler의 이름이다. -fhp를 사용할 때 필수 옵션이다.
[-fhp <access-log-handler-file-handler-permission>]
Log 파일의 접근 권한 설정인 Permission을 수정한다. -fhn을 사용할 때 필수 옵션이다.
-
예제
modify-virtual-host -server server1 vhost1 -tmin 1 -tmax 20 -alf "common %I"
1.20. modify-web-cookie-policy
웹 엔진의 HTTP Cookie Policy 설정을 수정한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/cookie-policy
-
alias
modcookie
-
사용법
modify-web-cookie-policy [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] [-auer,--apply-url-encoding-rule <apply-url-encoding-rule>] [-enc,--charset-encoding <charset-encoding>] [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
[-auer,--apply-url-encoding-rule <apply-url-encoding-rule>]
URL Encoding Rule 적용 여부를 수정한다.
[-enc,--charset-encoding <charset-encoding>]
URL Encoding Rule을 적용할 때 사용하는 Charset Encoding을 수정한다.
[-vh <virtual-host-name>]
가상 호스트를 지정한다.
-
예제
modify-web-cookie-policy -server server1 -auer false modify-web-cookie-policy -server server1 -enc UTF-8
1.21. modify-web-encoding
웹 엔진의 Encoding을 수정한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/encoding
-
alias
modenc
-
사용법
modify-web-encoding [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] <charset-encoding> -co | -default | -forced [-url] [-req] [-res] [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
<charset-encoding>
수정할 Character Set Encoding 이름이다. 잘못된 값이 입력되면 오류가 출력되고 명령이 실패한다.
-co | -default | -forced
입력된 Encoding을 default로 설정할지 forced로 설정할지 결정한다. request encoding인 경우 두 설정 외에 client-override를 설정할 수 있다.
[-url]
Request Url의 Character Set Encoding을 수정한다.
[-req]
Request의 Character Set Encoding을 수정한다.
[-res]
Response의 Character Set Encoding을 수정한다.
[-vh <virtual-host-name>]
가상 호스트를 지정한다.
-
예제
modify-web-encoding -server server1 EUC-KR -forced -url modify-web-encoding -server server1 ISO-8859-1 -default -url -res -req
1.22. modify-web-properties
웹 엔진의 프로퍼티 설정을 수정한다. 수정되는 프로퍼티는 대소문자를 구별한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/properties
-
alias
modwebpr
-
사용법
modify-web-properties [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -p,--properties <properties> [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-p,--properties <properties>
수정할 웹 엔진의 프로퍼티를 설정한다.
-
한 개의 프로퍼티는 "key=value" 형태로 "="를 이용하여 설정한다.
-
한 개 이상의 프로퍼티를 수정할 경우에는 각 프로퍼티를 콤마(,)로 구분하여 설정한다.
[-vh <virtual-host-name>]
가상 호스트를 지정한다.
-
-
예제
modify-web-properties -server server1 -p jeus.servlet.jsp.compile-java-source-concurrently=false
1.23. modify-web-engine-configuration
웹 엔진 설정을 동적으로 변경한다. 이 명령어는 실제로 서비스 운영 중에도 반영되는 설정만 변경을 제공한다. 변경 가능한 정보는 모니터링 주기, 액세스 로그 포맷이다.
-
관련 스키마
web-engine.xsd - web-engine
-
alias
setwebcfg, setwebconf, set-web-engine-configuration, modwebcfg, modwebconf
-
사용법
modify-web-engine-configuration [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] [-tpp <monitoring/check-thread-pool>] [-crp <monitoring/check-class-reload>] [-sp <monitoring/check-session>] [-alf <access-log-format>] [-aluse <true | false>] [-alhnl <true | false>] [-alext <access-log-excluded-extensions>] [-ast <attach-stacktrace-on-error>] [-att <async-timeout-min-threads>] [-rerp | -erp <default-error-page>] [-fhn <access-log-handler-file-handler-name>] [-fhp <access-log-handler-file-handler-permission>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
[-tpp <monitoring/check-thread-pool>]
Thread Pool 체크 주기이다.
[-crp <monitoring/check-class-reload>]
웹 컨텍스트 리로드 체크 주기이다.
[-sp <monitoring/check-session>]
세션 체크 주기이다.
[-alf <access-log-format>]
[동적 변경] 액세스 로그 포맷이다. 중간에 스페이스 문자가 있는 경우 큰따옴표(" ")로 감싸야 한다. 포맷에 관한 자세한 사항은 JEUS Web Engine 안내서의 액세스 로그 포맷 설정을 참고한다.
[-aluse <true | false>]
[동적 변경] 액세스 로그 사용 여부를 지정한다.
(true | false 또는 t | f)
[-alhnl <true | false>]
[동적 변경] %h 포맷에 대해 로깅할 때 IP 주소에 대한 DNS Resolution 여부를 결정한다. (true | false 또는 t | f)
[-alext <access-log-excluded-extentions>]
[동적 변경] 액세스 로그에 남기지 않을 확장자를 설정한다. '.gif', '.jpg’와 같이 여러 개를 설정하는 경우 콤마(,)를 사용한다. 설정하지 않는 경우 콤마만 입력한다.
[-ast <attach-stacktrace-on-error>]
JEUS에서 보내주는 에러 페이지에 Stack Trace를 첨부할지 여부를 설정한다.
[-att <async-timeout-min-threads>]
Servlet 3.0의 Asynchronous Servlet를 사용할 경우 타임아웃 처리를 하기 위한 Thread Pool의 최소 개수를 설정한다.
0이면 타임아웃이 제대로 동작하지 않을 수 있으므로 항상 1 이상으로 설정해야 한다.
[-rerp | -erp <default-error-page>]
-erp <default-error-page>을 이용하여 웹 애플리케이션에 별도의 에러 페이지를 설정하지 않은 경우에 사용하는 에러 페이지를 설정한다. 정적인 페이지(HTML, HTM)만 설정할 수 있으며, 절대 경로여야 한다. -rerp를 이용하여 설정을 삭제할 수 있다.
[-fhn <access-log-handler-file-handler-name>]
Permission을 수정할 file-handler의 이름이다. -fhp를 사용할 때 필수 옵션이다.
[-fhp <access-log-handler-file-handler-permission>]
Log 파일의 접근 권한 설정인 Permission을 수정한다. -fhn을 사용할 때 필수 옵션이다.
-
예제
-
[-alf <access-log-format>] 옵션을 사용한 예
modify-web-engine-configuration -server server1 -alf "common %I" modify-web-engine-configuration -server server1 -alf "%h %l %u %t \"%r\" %>s %b"
-
[-aluse <use-access-log >] 옵션을 사용한 예
modify-web-engine-configuration -server server1 -aluse false
-
[-alext <access-log-excluded-extentions>] 옵션을 사용한 예
modify-web-engine-configuration -server server1 -alext .gif modify-web-engine-configuration -server server1 -alext .gif,.jpg
-
[-alext <access-log-excluded-extentions>] 옵션을 사용해서 기존의 extension 정보를 없애는 예
modify-web-engine-configuration -server server1 -alext
-
[-tpp <monitoring/check-thread-pool>], [-crp <monitoring/check-class-reload>], [-sp <monitoring/check-session>] 옵션을 사용한 예
modify-web-engine-configuration -tpp 10000 -crp 20000 -server server1 -sp 25000
-
[-ast <attach-stacktrace-on-error>] 옵션을 사용한 예
modify-web-engine-configuration -server server1 -ast true
-
[-att <async-timeout-min-threads>] 옵션을 사용한 예
modify-web-engine-configuration -server server1 -att 10
-
[-rerp | -erp <default-error-page>] 옵션을 사용한 예
modify-web-engine-configuration -server server1 -erp /home/jeus/error/error.html
-
1.24. modify-web-listener
HTTP, TCP, AJP 리스너의 설정 등을 변경한다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/http-listener, ajp13-listener, tcp-listener
-
alias
modwebl
-
사용법
modify-web-listener [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -name <web-connection-name> [-tmin <minimum-thread-num>] [-tmax <maximum-thread-num>] [-tidle <max-idle-time>] [-obuf <output-buffer-size>] [-http2 <enable-http2>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-name <web-connection-name>
리스너의 이름이다.
[-tmin <minimum-thread-num>]
[동적 변경] Thread Pool의 최소 Thread 수이다.
[-tmax <maximum-thread-num>]
[동적 변경] Thread Pool의 최대 Thread 수이다.
[-tidle <max-idle-time>]
Thread Pool의 Thread별 유후 대기 시간이다.
[-obuf <output-buffer-size>]
서블릿이 사용하는 응답 버퍼 크기다.
[-http2 <enable-http2>]
리스너가 http2를 사용/미사용할지 결정한다. HTTP 리스너에만 해당된다.
-
예제
modify-web-listener -name http1 -server server1 -obuf 200000 -http2
1.25. modify-webtob-connector
WebtoB 커넥터의 Thread Pool 설정 등을 변경한다. 단, 운영 중인 Thread Pool의 Thread 수가 바로 변하는 것은 아니고 Thread Pool 체크 주기에 의해서 변한다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/webtob-connector
-
alias
modwebtobcon
-
사용법
modify-webtob-connector [-cluster <cluster-name> | -server <server-name>] [-f,--forceLock] -name <web-connection-name> [-conn <connection-count>] [-hth <hth-count>] [-tmin <minimum-thread-num>] [-tmax <maximum-thread-num>] [-tidle <max-idle-time>] [-obuf <output-buffer-size>] [-ver <wjp-version>] [-addr <server-address>] [-port <server-port> | -dsocket] [-wbhome <webtob-home>] [-cloud <cloud-mode>] [-ipcport <ipc-base-port>] [-regid <registration-id>] [-sndbuf <send-buffer-size>] [-rcvbuf <receive-buffer-size>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-name <web-connection-name>
WebtoB 커넥터의 이름이다.
[-conn <connection-count>]
[동적 변경]WebtoB와 연결할 Connection 갯수이다.
[-hth <hth-count>]
hth process의 갯수이다.
[-tmin <minimum-thread-num>]
[동적 변경] Thread Pool의 최소 Thread 수이다.
[-tmax <maximum-thread-num>]
[동적 변경] Thread Pool의 최대 Thread 수이다.
[-tidle <max-idle-time>]
Thread Pool의 Thread별 유후 대기 시간이다.
[-obuf <output-buffer-size>]
서블릿 응답 버퍼 크기다.
[-ver <wjp-version>]
WebtoB와 통신할 때 사용하는 프로토콜 버전을 나타낸다. 1 또는 2를 입력한다.
[-addr <server-address>]
WebtoB 서버 주소이다. -port 사용할 때 필수 옵션이다.
[-port <server-port>]
WebtoB 서버 포트 번호이다.
[-regid <registration-id>]
WebtoB와의 등록 ID 이다.
[-dsocket]
Unix 도메인 소켓(Pipe)을 이용하여 JEUS와 WebtoB 사이에 통신을 한다.
[-wbhome <webtob-home>]
JEUS와 WebtoB가 같은 장비 안에 설치되어 있을 경우 WebtoB가 설치된 절대 경로이다. -dsocket을 사용할 때 설정할 수 있다.
[-cloud <cloud-mode>]
cloud mode를 사용할 것인지에 대한 여부를 나타낸다.
[-ipcport <ipc-base-port>]
Windows 환경에서 WebtoB의 내부 프로세스간 통신을 할 때 사용하는 기본 포트 번호이다. -dsocket을 사용할 때 설정할 수 있다.
[-sndbuf <send-buffer-size>]
TCP 소켓이나 Unix 도메인 소켓의 SO_SNDBUF를 설정한다.
0이면 OS의 기본값을 사용한다.
[-rcvbuf <receive-buffer-size>]
TCP 소켓이나 Unix 도메인 소켓의 SO_RCVBUF를 설정한다.
0이면 OS의 기본값을 사용한다.
-
예제
modify-webtob-connector -name webtob1 -conn 30 -tmin 30 -sndbuf 1200 -rcvbuf 2400 -server server1
1.26. notify-auto-scale
웹 서버나 JEUS MS(Managed Server)의 추가/삭제를 알려준다.
-
관련 스키마
web-engine.xsd
-
alias
nas
-
사용법
notify-auto-scale -wscaleout | -wscalein | -wunlink | -jscaleout | -jscalein -address <ip-address> -port <server-port> [-group <group-id>] -
파라미터
파라미터 설명 -wscaleout
웹 서버가 추가되었음을 알려준다.
-wscalein
웹 서버가 삭제되었음을 알려준다.
-wunlink
웹 서버가 종료되었음을 알려준다.
-jscaleout
JEUS MS(Managed Server)가 추가되었음을 알려준다.
-jscalein
JEUS MS(Managed Server)가 삭제되었음을 알려준다.
-address <ip-address>
추가/삭제된 서버의 ip-address를 지정한다.
[-port <server-port>]
추가/삭제된 서버의 port를 지정한다.
WebtoB를 사용할 경우 WebtoB에 설정된 JSVPORT를 넣어준다. 그 외의 경우에는 사용되지 않는다.
[-group <group-id>]
CWDP 동작을 수행할 그룹의 ID를 지정한다.
-
예제
notify-auto-scale -wscaleout -address 192.168.0.2 -port 9900 notify-auto-scale -wscalein -address 192.168.0.2 -port 9900
1.27. precompile-jsp
deploy된 웹 컨텍스트의 JSP 파일들을 미리 컴파일한다.
JSP 파일은 보통 웹 브라우저로부터 JSP 파일에 대한 요청이 웹 엔진에 올 때 컴파일된다. 그리하여 JSP 파일에 대한 초기 요청은 많은 파싱과 컴파일 작업을 통해 많은 리소스를 소모하여 응답시간이 길어진다.
개발된 JSP 파일이 많고, 사용자 요구가 빈번한 웹사이트이면 "초기 요청 수행"에 소요되는 시간이나 리소스가 서비스에 크게 영향을 미칠 수 있다. 이런 경우에는 개발된 JSP 소스 파일들을 웹 엔진이 시작해서 서비스가 시작되기 전에 precompile-jsp 명령어로 컴파일을 수행하면 문제를 해결할 수 있다.
precompile-jsp는 JEUS가 부팅된 상태에서 deploy된 모듈에 한해 컴파일을 수행한다. JEUS가 부팅되지 않은 상태에서 사전 컴파일을 수행하기 위해서는 appcompiler를 사용해야 한다.
|
-
관련 스키마
web-engine.xsd
-
alias
jspc
-
사용법
precompile-jsp [-server <server-name>] [-ctx <context-name> | -id <application-id>] [-e <excluded-jsp-list-file> | -l <included-jsp-list-file>] -
파라미터
파라미터 설명 [-ctx <context-name>]
웹 컨텍스트 이름을 설정한다. EAR 안에 있는 경우 ear-name#context-name으로 입력한다.
[-id <application-id>]
웹 컨텍스트가 포함된 애플리케이션의 ID를 설정한다. EAR 안에 있는 경우엔 설정할 수 없으며, -ctx 옵션을 사용해야한다.
[-e <excluded-jsp-list-file>]
웹 컨텍스트를 기준으로 컴파일하지 않을 path들을 기술한 텍스트 파일을 지정한다. JSP path들은 Context Root에 대한 상대 경로를 가져야 하며 반드시 슬래시( / )로 시작해야 한다.
jsp-list-file의 위치는 시스템 절대 경로로 지정한다.
[-l <included-jsp-list-file>]
웹 컨텍스트를 기준으로 컴파일할 path들을 기술한 텍스트 파일을 지정한다. JSP path들은 Context Root에 대한 상대 경로를 가져야 하며 반드시 슬래시( / )로 시작해야 한다.
jsp-list-file의 위치는 시스템 절대 경로로 지정한다.
-
예제
precompile-jsp -server server1 -ctx myctx
-
참고
본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.
1.28. reload-web-context
디스크로부터 지정한 Entity(웹 컨텍스트)를 reload한다. 이미 로드된 서블릿(JSP)들과 클래스들을 Reload한다. 이 명령어는 서블릿이나 클래스의 reload 기능이 비활성화되어 있을 경우 유용하게 사용할 수 있다(enable-reload, check-class-reload).
-
관련 스키마
jeus-web-dd.xsd
-
alias
webreload, reloadctx
-
사용법
reload-web-context [-cluster <cluster-name> | -server <server-name>] -ctx <context-name> -
파라미터
파라미터 설명 -ctx <context-name>
reload하려는 컨텍스트이다. 값이 반드시 설정되어야 한다.
-
예제
reload-web-context -server server1 -ctx servlets-examples
1.29. remove-backup-webtob
Backup WebtoB를 삭제한다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/webtob-connector/webtob-backup
-
alias
rmbackupwebtob
-
사용법
remove-backup-webtob [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -name <web-connection-name> -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-name <web-connection-name>
삭제할 backup을 가지고 있는 WebtoB 커넥터의 이름이다.
-
예제
remove-backup-webtob -server server1 -name webtob1
1.30. remove-response-header
웹 엔진의 Response Header 설정을 삭제한다. 삭제되는 Response Header는 대소문자를 구별하지 않는다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/response-header
-
alias
rmwebrh
-
사용법
remove-response-header [-cluster <cluster-name> | -server <server-name>] [-f,--forceLock] [-a,--all | -n,--name <header-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
[-a,--all | -n,--name <header-name>]
-
-n, --name <header-name>를 이용하여 특정 HTTP Response Header를 삭제한다. 입력값은 대소문자를 구별하지 않는다. 한 개 이상의 Header를 동시에 삭제할 경우 콤마(,)로 구분하여 삭제할 Header의 이름을 설정한다.
-
-a, --all를 이용하면 현재 설정되어있는 HTTP Response Header를 모두 삭제할 수 있다.
-
-
예제
remove-response-header -server server1 -n testheader remove-response-header -server server1 -n testheader2,testheader4 remove-response-header -server server1 -a
1.31. remove-tmax-connector
Tmax 커넥터를 삭제한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/tmax-connector
-
alias
rmtmaxcon
-
사용법
remove-tmax-connector [-cluster <cluster-name> | -server <server-name>] [-f,--forceLock] <web-connection-name> -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
<web-connection-name>
Tmax 커넥터의 이름이다.
-
예제
remove-tmax-connector -server server1 tmax1
1.32. remove-virtual-host
가상 호스트를 삭제한다.
-
관련 스키마
web-engine.xsd - web-engine/virtual-host
-
alias
rmvh
-
사용법
remove-virtual-host [-cluster <cluster-name> | -server <server-name>] [-f,--forceLock] <virtual-host-name> -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
<virtual-host-name>
가상 호스트의 이름이다.
-
예제
remove-virtual-host -server server1 host2
1.33. remove-valve
Valve를 삭제한다.
-
관련 스키마
web-engine.xsd - pipeline/valve
-
alias
rmvlv
-
사용법
remove-valve [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -cn, --classname <class-name> [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-cn, --classname <class-name>
서버, 가상호스트에서 삭제할 valve class를 지정한다.
[-vh <virtual-host-name>]
valve를 삭제할 가상 호스트의 이름이다. 가상 호스트 이름을 설정 안하면 서버 단의 valve가 삭제된다.
-
예제
remove-valve -server server1 -cn UserValveBase -vh host1
1.34. remove-valve-property
Valve의 프로퍼티 설정을 삭제한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - pipeline/valve/property
-
alias
rmvlvprop
-
사용법
remove-valve-property [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -cn, --classname <class-name> -k, --key <key> [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-cn, --classname <class-name>
삭제할 property를 가지고 있는 valve class를 지정한다. 제우스의 ValveBase를 상속받은 클래스로 지정해야 한다.
-k, --key <key>
삭제할 property의 key를 지정한다.
[-vh <virtual-host-name>]
삭제할 property의 valve를 가지고 있는 가상 호스트의 이름이다. 가상 호스트 이름을 설정 안하면 서버 단에 있는 valve의 property가 삭제된다.
-
예제
remove-valve-property -server server1 -cn UserValveBase -k userProperty -vh host1
1.35. remove-web-cookie-policy
웹 엔진의 HTTP Cookie Policy 설정을 삭제한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/cookie-policy
-
alias
rmcp, rmcookie
-
사용법
remove-web-cookie-policy [-cluster <cluster-name> | -server <server-name>] [-f,--forceLock] [-auer,--apply-url-encoding-rule] [-enc,--charset-encoding] [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
[-auer,--apply-url-encoding-rule]
URL Encoding Rule 적용 여부를 삭제한다.
[-enc,--charset-encoding]
URL Encoding Rule을 적용할 때 사용하는 Charset Encoding을 삭제한다.
[-vh <virtual-host-name>]
가상 호스트를 지정한다.
-
예제
remove-web-cookie-policy -server server1 -auer
1.36. resume-web-component
일시 중지된 웹 컴포넌트(서블릿)를 재시작한다.
|
JEUS 6에서는 명령어 webresume과 webtob -r 명령어로 분리되어있던 것을 JEUS 7부터 통합하였다. 또한 JEUS 7부터 웹 컨텍스트에 대한 시작 명령어는 별도로 제공되지 않는다. JEUS Master Server의 start-application를 사용해서 제어해야 한다. |
-
관련 스키마
web-engine.xsd - web-engine/web-connections
-
alias
webresume
-
사용법
resume-web-component [-cluster <cluster-name> | -server <server-name>] -ctx,--context <context> -svl,--servlet <servlet> -
파라미터
파라미터 설명 -ctx, --context <context>
시작할 서블릿이 포함된 웹 컨텍스트를 설정해야 한다.
반드시 -svl 옵션과 함께 설정해야 한다.
application-information -type 옵션을 사용한 명령어를 사용한 조회 결과 중 Module Name에 해당하는 값을 <context>에 설정한다.
-svl,--servlet <servlet>
중지된 서블릿 중에서 다시 시작할 서블릿이다. 컨텍스트 옵션이 설정되어 있어야 한다.
-
예제
-
-svl,--servlet <servlet> 옵션을 사용한 예
resume-web-component -server server1 -ctx servlets -svl CookieExample
-
1.37. remove-web-encoding
웹 엔진의 Encoding을 삭제한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/encoding
-
alias
rmenc
-
사용법
remove-web-encoding [-cluster <cluster-name> | -server <server-name>] [-f,--forceLock] [-url] [-req] [-res] [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
[-url]
Request URL의 Character Set Encoding을 삭제한다.
[-req]
Request의 Character Set Encoding을 삭제한다.
[-res]
Response의 Character Set Encoding을 삭제한다.
[-vh <virtual-host-name>]
가상 호스트를 지정한다.
-
예제
remove-web-encoding -server server1 -url remove-web-encoding -server server1 -req -res
1.38. remove-web-listener
HTTP, TCP, AJP 리스너를 삭제한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다. ADMIN-HTTP 리스너는 삭제되지 않는다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/http-listener, ajp13-listener, tcp-listener
-
alias
rmwebl
-
사용법
remove-web-listener [-cluster <cluster-name> | -server <server-name>] [-f,--forceLock] <web-connection-name> -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
<web-connection-name>
리스너의 이름이다.
-
예제
remove-web-listener -server server1 http1
1.39. remove-web-properties
웹 엔진의 프로퍼티 설정을 삭제한다. 삭제되는 프로퍼티는 대소문자를 구별한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/properties
-
alias
rmwebpr
-
사용법
remove-web-properties [-cluster <cluster-name> | -server <server-name>] [-f,--forceLock] -a,--all | -k,--keys <keys> [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-a,--all | -k,--keys <keys>
-
-k, --keys <keys>를 이용하여 웹 엔진의 특정 프로퍼티를 삭제한다. 입력값은 대소문자를 구별한다. 한 개 이상의 프로퍼티를 동시에 삭제하고자할 경우 콤마(,)로 구분하여 삭제할 프로퍼티의 key를 설정한다.
-
-a, --all를 이용하면 현재 설정되어있는 프로퍼티를 모두 삭제할 수 있다.
[-vh <virtual-host-name>]
가상 호스트를 지정한다.
-
-
예제
remove-web-properties -server server1 -k jeus.servlet.jsp.compile-java-source-concurrently1 remove-web-properties -server server1 -a
1.40. remove-webtob-connector
WebtoB 커넥터를 삭제한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/webtob-connector
-
alias
rmwebtobcon
-
사용법
remove-webtob-connector [-cluster <cluster-name> | -server <server-name>] [-f,--forceLock] <web-connection-name> -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
<web-connection-name>
WebtoB 커넥터의 이름이다.
-
예제
remove-webtob-connector -server server1 webtob1
1.41. set-valve-property
Valve의 프로퍼티 설정을 추가한다. 추가되는 프로퍼티는 대소문자를 구별한다. 단, XML에만 반영하며 실제로 서비스에 적용하려면 서버를 재시작해야 한다.
-
관련 스키마
web-engine.xsd - pipeline/valve/property
-
alias
addvlvprop
-
사용법
set-valve-property [-cluster <cluster-name> | -server <server-name>] [-f, --forceLock] -cn, --classname <class-name> -k, --key <key> -v, --value <value> [-vh <virtual-host-name>] -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-cn, --classname <class-name>
property를 추가할 valve class를 지정한다. 제우스의 ValveBase를 상속받은 클래스로 지정해야 한다.
-k, --key <key>
valve에 추가할 key를 지정한다.
-v, --value <value>
valve에 추가할 value를 지정한다.
[-vh <virtual-host-name>]
property를 추가할 가상 호스트의 이름이다. 가상 호스트 이름을 설정 안하면 서버 단에 있는 valve에 추가된다.
-
예제
set-valve-property -server server1 -cn UserValveBase -k userProperty -v true -vh host1
1.42. show-request-processing-flow
URL 패턴이나 특정 호스트 이름으로 들어온 요청의 처리 흐름을 조회한다.
-
관련 스키마
web-app_4_0.xsd
-
alias
reqflow
-
사용법
show-request-processing-flow [-cluster <cluster-name> | -server <server-name>] -path <url-pattern> [-hostname <host-name>] -
파라미터
파라미터 설명 -path <url-pattern>
슬래시( / )로 시작하는 URL 패턴이다.
[-hostname <host-name>]
HTTP Host Header에 명시된 호스트 이름이다.
-
예제
show-request-processing-flow -server server1 -path /test/index.jsp show-request-processing-flow -server server1 -path /test -hostname examples.com
1.43. show-web-engine-configuration
웹 엔진에 대한 설정 정보를 조회한다. 이 명령어를 실행하여 조회되는 구성 항목과 필드들에 대한 정보는 XML의 웹 엔진 구성 레퍼런스를 참고한다.
출력 항목 중 빈 칸으로 표시되는 항목은 XML에 실제 설정이 되어 있지 않음을 의미한다. 즉, 값이 표시되어 있는 경우가 실제 설정되어 있거나, 기본값이 있는 설정이다.
-
관련 스키마
web-engine.xsd - web-gine
-
alias
webcfg, webconf, showwebcfg, showwebconf
-
사용법
show-web-engine-configuration [-cluster <cluster-name> | -server <server-name>] [-vh,--virtual host] [-cn,--web-connections <connection-type>] [-al,--access-log] [-sc,--session-config] [-rh,--response-header] [-mo,--monitoring] [-enc,--encoding] [-cp,--cookie-policy] [-jsp,--jsp-engine] [-pr,--properties] [-erp,--error-page] [-att,--async-timeout_thread] [-ast,--attach-stacktrace] -
파라미터
파라미터 설명 [-vh,--virtual host]
가상 호스트의 설정 정보를 출력한다.
[-cn,--web-connections <connection-type>]
모든 웹 커넥션의 설정 정보를 출력한다. 인자를 줄 경우 해당 타입의 커넥션 설정 정보만 출력한다.
[-al,--access-log]
액세스 로그의 설정 정보를 출력한다.
[-sc,--session-config]
웹 엔진의 세션 설정 정보를 출력한다.
[-rh,--response-header]
응답 헤더의 설정 정보를 출력한다.
[-mo,--monitoring]
웹 엔진 모니터링의 설정 정보를 출력한다.
[-enc,--encoding]
웹 엔진의 인코딩 설정 정보를 출력한다.
[-cp,--cookie-policy]
쿠키의 정책 설정 정보를 출력한다.
[-jsp,--jsp-engine]
JSP 엔진의 설정 정보를 출력한다.
[-pr,--properties]
웹 엔진 프로퍼티의 설정 정보를 출력한다.
[-erp,--error-page]
웹 엔진의 기본 오류 페이지 설정 정보를 출력한다.
[-att,--async-timeout_thread]
비동기 서블릿의 타임아웃을 처리하는 Thread 설정 정보를 출력한다.
[-ast,--attach-stacktrace]
오류가 발생할 때 Stack Trace의 추가 여부 설정 정보를 출력한다.
-
예제
-
웹 엔진 설정 모두 조회
show-web-engine-configuration -server server1
-
옵션별 웹 엔진 설정 조회
show-web-engine-configuration -erp -att -server server1 show-web-engine-configuration -server server1 -sc
-
1.44. show-web-statistics
구동 중인 웹 엔진의 JVM에서 사용하는 메모리 정보, 웹 엔진에 속해 있는 각 리스너/커넥터에 대한 Thread Pool의 상태, 컨텍스트에 대한 요청 횟수 및 처리시간 등의 정보를 파라미터 설정에 따라 조회한다.
-
관련 스키마
web-engine.xsd
-
alias
webstats, stat, st
-
사용법
show-web-statistics [-server <server-name>] [-ctx,--context <context-name>] [-t,--thread | -s,--session | -r,--request |-m,--memory] -
파라미터
파라미터 설명 [-t,--thread]
웹 엔진에 속해 있는 각각의 WebContainer와 Context 레벨의 Thread Pool의 상태를 조회한다. 조회되는 정보는 현재 할당된 Worker Thread의 수와 Wait-Queue에 적체된 클라이언트의 수 그리고 Thread Pool을 유지하는 최대 Thread의 개수를 포함한다.
[-s,--session]
웹 엔진에 구성된 세션 서버의 커넥션에 대한 정보를 출력한다.
정보는 현재 연결되어 있는 세션 서버의 이름, 전체 세션의 수, Pool에서 사용된 세션 서버와 커넥션의 수를 포함한다.
[-r,--request]
각 컨텍스트에 대해 처리된 요청의 누적 수치와 평균 처리시간을 출력한다.
[-m,--memory]
구동 중인 웹 엔진에서 현재 JVM에서 사용하고 있는 메모리의 상태를 조회한다.
-
예제
-
스레드 풀 정보 조회
show-web-statistics -server server1 -ctx test -t
-
세션 서버 정보 확인
show-web-statistics -server server1 -s
-
1.45. show-webtob-connector
WebtoB Connection 정보를 출력한다. 현재 Connection의 상태를 알 수 있다.
-
관련 스키마
web-engine.xsd - web-engine/web-connections/webtob-connector
-
alias
webtobcon
-
사용법
show-webtob-connector [-cluster <cluster-name> | -server <server-name>] [-f,--forceLock] -name <web-connection-name> -
파라미터
파라미터 설명 [-f, --forceLock]
설정 변경을 강제로 진행하여 반영한다.
-name <web-connection-name>
WebtoB 커넥터의 이름이다.
-
예제
show-webtob-connector -server server1 -name webtob1
1.46. suspend-web-component
지정한 서블릿을 중지하여 클라이언트로 에러 페이지를 보여주도록 한다.
|
JEUS 6에서는 websuspend과 webtob -s 명령어로 분리되어있던 것을 JEUS 7부터 통합하였다. 또한 JEUS 7부터 웹 컨텍스트에 대한 중지 명령어는 별도로 제공되지 않는다. JEUS Master Server의 stop-application을 사용해서 제어해야 한다. |
-
관련 스키마
web-engine.xsd - web-engine/web-connections
-
alias
websuspend
-
사용법
suspend-web-component [-cluster <cluster-name> | -server <server-name>] -ctx,--context <context> -svl,--servlet <servlet> -
파라미터
파라미터 설명 -ctx, --context <context>
중지할 서블릿이 포함된 웹 컨텍스트를 설정해야한다. 반드시 -svl 옵션과 함께 설정해야 한다.
application-information -type 옵션을 이용한 명령어를 사용한 조회 결과 중 Unique Module Name에 해당하는 값을 <context>에 설정한다.
-svl,--servlet <servlet>
시작된 서블릿 중에서 중지할 서블릿이다. 컨텍스트 옵션이 설정되어 있어야 한다.
-
예제
-
-svl,--servlet <servlet> 옵션을 사용한 예
suspend-web-component -svl CookieExample -server server1 -ctx servlets
-