| Sun ONE Web Server 6.1 관리자 설명서 |
부록 A
명령줄 유틸리티이 부록에서는 HttpServerAdmin 명령줄 유틸리티를 이용하는 방법에 대하여 설명합니다.
HttpServerAdmin (가상 서버 관리)HttpServerAdmin은 Server Manager와 Class Manager에 있는 가상 서버 사용자 인터페이스와 동일한 관리 기능을 수행하는 명령줄 유틸리티입니다. 명령줄 인터페이스를 사용하여 가상 서버를 설정하려는 경우에는 HttpServerAdmin을 사용합니다.
HttpServer Admin 명령줄 유틸리티의 위치는 server_root/bin/https/httpadmin/bin 디렉토리입니다.
HttpServerAdmin을 실행하기 전에 환경의 서버 루트 디렉토리에 대하여 IWS_SERVER_HOME 환경 변수를 설정해야 합니다.
예를 들어 UNIX/Linux 시스템의 경우,
setenv IWS_SERVER_HOME /usr/sun/servers
Windows 시스템의 경우,
HttpServerAdmin 구문
HttpServerAdmin 구문은 다음과 같습니다.
HttpServerAdmin command_name command_options -d server_root -sinst http_instance
명령 매개 변수에 대한 온라인 설명을 보려면 다음 명령을 입력합니다.
./HttpServerAdmin -h
command_name 매개 변수에는 네 가지 값을 사용할 수 있습니다.
각 명령줄에는 자체의 명령 옵션 세트가 있습니다. 자세한 내용은 이 장의 뒤에 있는 각 명령에 대한 설명을 참조하십시오.
명령 매개 변수의 값에 상관 없이 Table 에 있는 매개 변수는 모든 HttpServerAdmin 명령 사용에 적용할 수 있습니다.
표 A-1) HttpServerAdmin 매개 변수
매개 변수
값
-d server_root
(필수). 이 매개 변수는 서버 루트에 대한 경로(서버가 설치된 위치)를 지정합니다.
-sinst http_instance
(필수). 이 매개 변수는 HttpServeAdmin이 영향을 미치는 인스턴스를 지정합니다.
control 명령
클래스와 가상 서버를 시작, 정지 및 사용 하지 않도록 설정하려면 control 명령을 사용합니다. 가상 서버를 지정하지 않으면 클래스의 모든 가상 서버를 시작, 정지 또는 사용하지 않도록 설정합니다.
옵션
control 명령과 Table 에 있는 옵션을 사용하여 클래스 및 가상 서버를 제어할 수 있습니다.
구문
HttpServerAdmin control -cl classname, -control_option [-id virtual_server] -d server_root -sinst http_instance
매개 변수
이들 매개 변수를 명령 옵션과 함께 사용하여 가상 서버를 제어합니다.
표 A-3) control 명령 매개 변수
매개 변수
값
-cl classname
가상 서버 클래스를 지정합니다.
-id virtual_server
(선택) 제어하는 가상 서버 ID를 지정합니다.
예
create 명령
가상 서버 클래스, 가상 서버 및 청취 소켓을 만들려면 create 명령을 사용합니다.
옵션
create 명령과 Table 에 있는 옵션을 사용하여 클래스, 청취 소켓, 가상 서버 및 리소스를 만들 수 있습니다.
각 옵션에는 모두 다음에서 설명하는 차제의 매개 변수가 있습니다.
가상 서버 클래스 생성
create 명령의 이 옵션을 사용하여 가상 서버 클래스를 만듭니다.
구문
HttpServerAdmin create -c -cl classname -docroot document_root [-obj obj.conf_file] [-acptlang accept_language] -d server_root -sinst http_instance
매개 변수
Table 에 있는 매개 변수를 create -c 명령 옵션과 함께 사용하여 클래스를 만듭니다.
표 A-5) 가상 서버 클래스 생성 매개 변수
매개 변수
값
-cl classname
만들려는 클래스의 이름을 지정합니다.
-docroot document_root
클래스의 문서 루트. 여기에는 반드시 절대 경로를 사용해야 합니다.
-obj obj.conf_file
(선택) 해당 클래스용 obj.conf 파일. 이 매개 변수를 지정하지 않으면 서버는 obj.conf 파일을 classname.obj.conf롤 만듭니다. 클래스의 obj.conf 파일을 다른 이름으로 만들려면 여기에 해당 이름을 지정합니다.
-acptlang accept_language
(선택) 이 매개 변수를 지정하지 않으면 기본 값으로 acptlang가 사용되지 않습니다.
예
청취 소켓 생성
create 명령에 이 옵션을 사용하여 청취 소켓을 만듭니다.
구문
HttpServerAdmin create -l -ip ip_address -port port_number -sname server_name -id default_virtual_server [-sec security] [-acct number_of_accept_threads] -d server_root -sinst http_instance
매개 변수
Table 에 있는 매개 변수를 create -l 명령 옵션과 함께 사용하여 청취 소켓을 만듭니다.
표 A-6) 청취 소켓 생성 매개 변수
매개 변수
값
-ip ip_address
청취 소켓의 IP 주소.
-port port_number
청취 소켓의 포트 번호.
-sname server_name
청취 소켓에 연결할 서버 이름.
-id default_virtual_server
기본 가상 서버의 ID. 가상 서버를 사용하여 청취 소켓을 만들기 전에 이 가상 서버가 반드시 존재해야 합니다.
-acct number_of_accept_threads
(옵션) 청취 소켓용 승인 스레드의 수.
-sec on
(선택) 지정하는 경우 on을 사용하여 청취 소켓용 보안을 사용 설정합니다. 지정하지 않는 경우 보안을 사용하지 않습니다.
예
HttpServerAdmin create -l -id ls3 -ip 0.0.0.0 -port 1333 -sname austen -defaultvs vs2 -sec on -acct 4 -d /export/carey/server6 -sinst https-austen.com
가상 서버 생성
create 명령의 이 옵션을 사용하여 가상 서버를 만듭니다.
참고로 선택 매개 변수의 일부에 대한 값을 포함하지 않으면 기본 값이 사용됩니다. 해당 기본 값은 서버를 만든 후 언제라도 변경할 수 있습니다.
구문
HttpServerAdmin create -v -id virtual_server -cl classname -urlh urlhosts [-state state][-docroot document_root] [-mime mime_types_file] [-aclid acl_ID] -d server_root -sinst http_instance
매개 변수
Table 에 있는 매개 변수를 create -v 명령 옵션과 함께 사용하여 가상 서버를 만듭니다.
표 A-7) 청취 소켓 생성 매개 변수
매개 변수
값
-id virtual_server
만들려는 가상 서버의 ID.
-cl classname
가상 서버가 속할 클래스.
-urlh URL_hosts
가상 서버의 URL 호스트. 공백으로 구분된 URL 호스트를 하나 여러 개 지정할 수 있습니다.
-state state
(선택) 유효한 값은 on, off 또는 disable입니다.
-docroot document_root
(선택) 가상 서버용 문서 루트를 지정하려는 경우 이 매개 변수를 사용합니다. 반드시 절대 경로 이름을 사용해야 합니다.
-mime mime_types_file
(선택) 가상 서버용 MIME 유형의 이름.
-aclid acl_ID
(선택) server.xml 파일에서 사용하는 ACL 파일 ID <ACLID>.
예
HttpServerAdmin create -v -id vs3 -cl class1 -urlh annh -d /export/sun/server6 -sinst https-sun.com
HttpServerAdmin create -v -id vs4 -cl class1 -urlh annh,annh2 -state off -mime mime.types -d /export/sun/server6 -sinst https-sun.com
JDBC 연결 풀 생성
명령줄 인터페이스를 사용하여 JDBC 연결 풀을 만들려면 create -r 명령을 사용합니다.
구문
HttpServerAdmin -create -r -jdbcconnectionpool -poolname jdbcpoolname -classname classname [-steadypoolsize steadypoolsize] [-maxpoolsize maxpoolsize] [-poolresizequantity poolresizequantity] [-idletimeout idletimeout] [-maxwaittime maxwaittime] [-connectionvalidation true/false] [-connectionvalidationmethod connectionvalidationmethod] [-validationtablename validationtablename] [-failall true/false] [-desc description] [[-property propertyname=value],...]
옵션
create -r 명령 옵션으로 연결 풀을 만드는데 필요한 모든 옵션은 다음 표에서 설명하는 것과 같습니다.
표 A-8) 연결 풀 생성 매개 변수
매개 변수
값
poolname jdbcpoolname
JDBC 연결 풀용 풀 이름.
classname classname
데이터 소스를 구현하는 클래스 이름으로 공급자가 지정합니다.
steadypoolsize steadypoolsize
풀에서 반드시 유지되어야 하는 연결의 최소 수.
maxpoolsize maxpoolsize
풀에서 허용하는 최대 연결 수.
poolresizequantity poolresizequantity
steadpoolsize 값에 가까워지는 경우 풀의 크기가 조정되는 배치 크기.
idletimeout idletimeout
풀에서 연결이 유휴 상태를 유지할 수 있는 최대 시간을 초 단위로 지정합니다.
maxwaittime maxwaittime
호출자에게 연결 제한 시간이 지정될 때까지 대기하는 시간을 지정합니다.
connectionvalidation true/false
연결이 응용 프로그램에 대하여 파싱되기 전에 해당 연결 풀의 유효성을 검사할 것인지 지정합니다.
connectionvalidationmethod connectionvalidationmethod
데이터베이스 연결의 유효성을 검사할 메소드. 유효한 값은 auto-commit, meta-data 및 table입니다.
validationtablename validationtablename
connectionvalidationmethod가 table로 설정된 경우 테이블의 이름.
failall true/false
풀에 있는 모든 연결을 차단한 후 다시 설정하여 단일 연결이 실패했는지 확인하도록 할 것인지 지정합니다.
desc description
풀에 대한 설명
property propertyname=value
표준 및 사유 JDBC 연결 풀 등록 정보를 지정하는 이름-값 쌍.
예
HttpServerAdmin create -r -jdbcconnectionpool -poolname testpool -classname "oracle.jdbc.pool.OracleDataSource" -property "URL=jdbc:oracle:thin:@dbhost:1521:ORCL,user=scott,password=tige r" -d /opt/Sun/S1WS6.1 -sinst testinstance
JDBC 리소스 생성
명령줄 인터페이스를 사용하여 JDBC 리소스를 만들려면 create -r 명령을 사용합니다.
구문
HttpServerAdmin -create -r -jdbc -jndiname jndiname -poolname poolname [-desc description] [-enabled true/false]
옵션
create -r 명령 옵션으로 새 JDBC 리소스를 만드는데 필요한 모든 옵션은 다음 표에서 설명하는 것과 같습니다.
표 A-9) JFBC 리소스 생성 매개 변수
매개 변수
값
jndiname jndiname
리소스의 JNDI 이름.
poolname poolname
JDBC 연결 풀용 풀 이름.
desc description
풀에 대한 설명
enabled true/false
리소스를 사용할 것인지 지정합니다.
JDBC 리소스를 사용하지 않도록 설정하면 어떤 응용 프로그램 구성요소도 이에 연결할 수 없으나, 구성은 서버 인스턴스에 유지됩니다.
예
HttpServerAdmin create -r -jdbc -jndiname "jdbc/testjdbcresource" -poolname testpool -d /opt/Sun/S1WS6.1 -sinst testinstance
사용자 지정 리소스 생성
명령줄 인터페이스를 사용하여 새 사용자 지정 리소스를 만들려면 create -r 명령을 사용합니다.
구문
HttpServerAdmin -create -r -custom -jndiname jndiname -resourcetype resourcetype -factoryclass factoryclassname [-enabled true/false] [-desc description] [[-property propertyname=value],...]
옵션
create -r 명령 옵션으로 새 JDBC 리소스를 만드는데 필요한 모든 옵션은 다음 표에서 설명하는 것과 같습니다.
표 A-10) 사용자 정의 리소스 생성 매개 변수
매개 변수
값
jndiname jndiname
리소스의 JNDI 이름.
resourcetype resourcetype
리소스 유형.
factoryclassname factoryclassname
개체 팩토리의 클래스이름.
enabled true/false
리소스를 사용할 것인지 지정합니다.
desc description
풀에 대한 설명
property propertyname=value
사용자 정의 리소스의 등록 정보를 지정하는 이름-값 쌍.
예
HttpServerAdmin create -r -custom -jndiname "testcustomresource" -resourcetype "java.lang.String" -factoryclass "com.mycom.test.StringFactory" -d /opt/Sun/S1WS6.1 -sinst testinstance
외부 JNDI 리소스 생성
명령줄 인터페이스를 사용하여 외부 JNDI 리소스를 만들려면 create -r 명령을 사용합니다.
구문
HttpServerAdmin -create -r -external -jndiname jndiname -jndilookupname jndilookupname -restype restype -factoryclass factoryclass [-enabled true/false] [-desc description] [[-property propertyname=value],...]
옵션
create -r 명령 옵션으로 새 외부 JNDI 리소스를 만드는데 필요한 모든 옵션은 다음 표에서 설명하는 것과 같습니다.
표 A-11) 외부 JNDI 리소스 생성 매개 변수
매개 변수
값
jndiname jndiname
리소스의 JNDI 이름.
jndilookupname jndilookupname
리소스용 JNDI 조회 이름.
restype restype
리소스 유형.
factoryclass factoryclass
개체 팩토리의 클래스이름.
enabled true/false
리소스를 사용할 것인지 지정합니다.
desc description
풀에 대한 설명
property propertyname=value
사용자 정의 리소스의 등록 정보를 지정하는 이름-값 쌍.
예
HttpServerAdmin create -r -external -jndiname "testexternalresource" -jndilookupname "rmiconverter" -restype "samples.rmi.simple.ejb.ConverterHome" -factoryclass "com.sun.jndi.cosnaming.CNCtxFactory" -property "java.naming.provider.url=iiop://localhost:3700" -d /opt/Sun/S1WS6.1 -sinst testinstance
전자우편 리소스 생성
명령줄 인터페이스를 사용하여 새 전자우편 리소스를 만들려면 create -r 명령을 사용합니다.
구문
HttpServerAdmin -create -r -mail -jndiname jndiname -host host -user user -from from [-storeprotocol storeprotocol] [-storeprotocolclass storeprotocolclass] [-transportprotocol transportprotocol] [-transportprotocolclass transportprotocolclass] [-enabled true/false] [-desc description] [[-property propertyname=value]...]
옵션
create -r 명령 옵션으로 새 전자우편 리소스를 만드는데 필요한 모든 옵션은 다음 표에서 설명하는 것과 같습니다.
표 A-12) 전자우편 리소스 생성 매개 변수
매개 변수
값
jndiname jndiname
리소스의 JNDI 이름.
host host
전자우편 서버 호스트 이름.
user user
전자우편 서버 사용자 이름.
from from
전자 우편 서버가 메시지 송신자를 표시할 때 사용하는 전자우편 주소.
storeprotocol storeprotocol
저장 프로토콜 서비스를 지정하며, 이 서비스는 전자 우편에 연결하고, 메시지를 검색하며 메시지를 폴더에 저장합니다. 값의 예는 imap 및 pop3입니다.
storeprotocolclass storeprotocolclass
저장소용 서비스 제공업체 구현 클래스를 지정합니다.
이 클래스의 위치:
transportprotocol transportprotocol
메시지를 전송하는 전송 프로토콜 서비스를 지정합니다.
transportprotocolclass transportprotocolclass
전송용 서비스 제공업체 구현 클래스를 지정합니다.
이 클래스의 위치:
enabled true/false
리소스가 런타임에 사용될 것인지 결정합니다. 적절한 값은 on, off, yes, no, 1, 0, true, false입니다.
desc description
리소스에 대한 설명.
property propertyname=value
사용자 정의 리소스의 등록 정보를 지정하는 이름-값 쌍.
예
HttpServerAdmin create -r -mail -jndiname "localmail" -host localhost -user mailid -from mailid@mailhost -d /opt/Sun/S1WS6.1 -sinst testinstance
delete 명령
가상 서버 클래스, 가상 서버 및 청취 소켓을 삭제하려면 delete 명령을 사용합니다.
옵션
Table 에 있는 옵션을 delete 명령과 함께 사용하여 클래스를 삭제합니다.
표 A-13) delete 명령 옵션
옵션
값
-c
지정된 가상 서버 클래스를 삭제합니다.
-l
지정된 청취 소켓 ID를 삭제합니다.
-v
지정된 가상 서버를 삭제합니다.
-r
지정된 리소스를 삭제합니다.
클래스 삭제
delete 명령의 이 옵션을 사용하여 가상 서버 클래스를 삭제합니다.
구문
HttpServerAdmin delete -c -cl classname -d server_root -sinst http_instance
매개 변수
Table 에 있는 매개 변수를 delete 명령과 함께 사용하여 클래스를 삭제합니다.
예
청취 소켓 삭제
delete 명령에 이 옵션을 사용하여 청취 소켓을 삭제합니다.
구문
HttpServerAdmin delete -l -id listen_socket -d server_root -sinst http_instance
매개 변수
Table 에 있는 매개 변수를 delete 명령과 함께 사용하여 클래스를 삭제합니다.
예
가상 서버 삭제
delete 명령의 이 옵션을 사용하여 가상 서버를 삭제합니다.
구문
HttpServerAdmin delete -v -id virtual_server -cl classname -d server_root -sinst http_instance
매개 변수
Table 에 있는 매개 변수를 delete 명령과 함께 사용하여 가상 서버를 삭제합니다.
예
JDBC 연결 풀 삭제
delete 명령에 이 옵션을 사용하여 연결 풀을 삭제합니다.
구문
HttpServerAdmin delete -r jdbcconnectionpoolname
매개 변수
Table 에 있는 매개 변수를 delete 명령과 함께 사용하여 연결 풀을 삭제합니다.
예
JNDI 자원 삭제
delete 명령에 이 옵션을 사용하여 JNDI 리소스를 삭제합니다.
구문
HttpServerAdmin delete -r jndiname
매개 변수
Table 에 있는 매개 변수를 delete 명령과 함께 사용하여 JNDI 리소스를 삭제합니다.
예
list 명령
가상 서버 클래스, 가상 서버, 청취 소켓 및 리소스의 목록을 표시하려면 list 명령을 사용합니다.
구문
HttpServerAdmin list -command_option -d server_root -sinst http_instance
옵션
표 A-19) list 명령 옵션
옵션
값
-c
모든 가상 서버 클래스 목록을 표시합니다.
-l
모든 청취 소켓 목록을 표시합니다.
-v
모든 가상 서버 목록을 표시합니다.
-r
지정된 리소스의 목록을 표시합니다.
예
HttpServerAdmin list -c -d /export/sun/server6 -sinst https-sun.com
HttpServerAdmin list -l -d /export/sun/server6 -sinst https-sun.com
명령 창에 나타나는 정보의 목록을 표시합니다.
