JEUS 환경
본 장에서는 JEUS에서 사용하는 관리 툴과 디렉터리 구조와 환경변수에 대해서 설명한다. 그리고 JEUS와 관련 XML 설정 파일의 전반적인 내용에 대해서 소개한다.
1. 관리 툴
다음은 JEUS에 접속해서 사용하는 툴에 대한 설명이다.
| 툴 | 설명 |
|---|---|
WebAdmin |
JEUS의 제어, 모니터링, 관리 등의 기능을 제공하는 HTML 기반의 관리 툴이다. 자세한 내용은 JEUS WebAdmin 안내서를 참고한다. |
startMasterServer |
JEUS Master Server를 실행하는 가장 기본적인 툴이다. 자세한 내용은 JEUS Reference 안내서를 참고한다. |
startManagedServer |
JEUS Managed Server를 실행하는 가장 기본적인 툴이다. 자세한 내용은 JEUS Reference 안내서를 참고한다. |
jeusadmin |
콘솔 툴은 command prompt에서 JEUS를 관리하는 데 사용된다. 자세한 내용은 JEUS Reference 안내서의 jeusadmin을 참고한다. |
|
위에서 언급한 것 이외에 Master Server와 Managed Server를 다운시키는 명령어가 존재한다. 자세한 내용은 JEUS Reference 안내서를 참고한다. |
2. 디렉터리 구조
다음은 JEUS를 설치했을 때의 전체 디렉터리 구조이다.
{JEUS_HOME}
|-- bin
| |--[01]startMasterServer
| |--[01]startManagedServer
| |--[01]stopServer
| |--[01]jeusadmin
|--derby
|--docs
|--lib
| |--shared
| |--[X]libraries.xml
|--license
|--setup
|--templates
|--samples
|--webserver
|--domains
|--<domain_name>
|--.applications
|--.deploymentplans
|--.libraries
|--bin
|--config
|--lib
| |--application
|--servers
|--<server_name>
|--.workspace
| |--deployed
| |--tmp
| |--web-nio
| |--tmlog
|--bin
|--lib
| |--application
|--logs
|--hostmanager
* Legend
- [01]: binary or executable file
- [X] : XML document
- [J] : JAR file
- [T] : Text file
- [C] : Class file
- [V] : jaba source file
- [DD] : deployment dexcriptor
다음은 디렉터리와 파일의 설명이다.
- {JEUS_HOME}
-
JEUS의 최상위 디렉터리로 실제 디렉터리 이름과 위치는 설치할 때 결정된다.
- bin
-
서버의 시작 및 종료 스크립트인 startMasterServer, startManagedServer, stopServer와 JEUS 콘솔 툴(jeusadmin)과 같은 실행 파일들이 위치한다.
- derby
-
샘플 애플리케이션이나 테스트에서 쉽게 사용할 수 있도록 Apache Derby를 포함시킨다.
- docs
-
JEUS에서 제공하는 API에 대한 Javadoc이 존재한다.
- lib
-
JEUS가 기동하는 데 필요한 라이브러리가 존재한다. shared 디렉터리를 제외한 나머지 디렉터리들은 사용자가 접근할 필요가 없다.
디렉터리 설명 shared
shared 디렉터리에는 애플리케이션에서 사용하는 라이브러리가 존재한다.
shared 디렉터리의 라이브러리를 사용하려면 libraries.xml에 라이브러리의 정보를 추가해야 한다. 그리고 해당 라이브러리를 사용할 애플리케이션의 JEUS Deployment Descriptor(DD)에서 해당 라이브러리에 대한 레퍼런스 정보를 지정해야 한다. shared 라이브러리에 대한 자세한 설명은 JEUS Applications & Deployment 안내서의 공유 라이브러리를 참고한다.
- license
-
JEUS 라이선스 파일이 위치한다. 라이선스 파일은 JEUS가 실행되기 위해서 반드시 필요한 파일이다.
- setup
-
JEUS 설치 후 사용할 수 있도록 환경을 구축하기 위해 필요한 파일들이 위치한다.
- templates
-
각종 설정과 환경 등의 template 파일이 위치한다.
- samples
-
JEUS의 예제 파일들이 위치한다.
- webserver
-
JEUS가 설치될 때 JEUS 웹 서버가 설치되는 디렉터리이다. 자세한 내용은 JEUS Web Engine 안내서를 참조한다.
- domains
-
하위에 도메인별로 DOMAIN_HOME과 JEUS_HOME에서 사용하는 노드 정보가 포함된 nodes.xml이 존재한다.
다음의 디렉터리 및 파일들은 DOMAIN_HOME 아래에 위치한다.
-
.applications
해당 도메인에서 관리하는 애플리케이션 파일이 존재한다.
install-application, uninstall-application 명령어를 통해서만 추가 및 삭제가 가능한다. JEUS가 사용하는 디렉터리로 사용자의 접근을 제한한다. 각 명령어에 대한 설명은 JEUS Reference 안내서의 install-application과 uninstall-application을 참고한다.
-
.deploymentplans
해당 도메인에서 관리하는 Deployment Plan 파일이 존재한다.
install-deployment-plan, uninstall-deployment-plan 명령어를 통해서만 추가 및 삭제가 가능한다. JEUS가 사용하는 디렉터리로 사용자의 접근을 제한한다. 각 명령어에 대한 설명은 JEUS Reference 안내서의 install-deployment-plan과 uninstall-deployment-plan을 참고한다.
-
.libraries
해당 도메인에서 관리하는 라이브러리 파일이 존재한다.
install-application, uninstall-application 명령어를 통해서만 추가 및 삭제가 가능한다. JEUS가 사용하는 디렉터리로 사용자의 접근을 제한한다. 각 명령어에 대한 설명은 JEUS Reference 안내서의 install-application과 uninstall-application을 참고한다.
-
bin
해당 도메인에 속한 Master Server와 Managed Server의 시작 및 종료 스크립트가 위치한다. JEUS_HOME/bin의 startMasterServer, startManagedServer, stopServer와 동일한 기능을 수행하지만 도메인 이름을 설정할 필요가 없다.
-
config
도메인의 설정 파일인 domain.xml이 변경된 경우 이전 이력을 위해 존재하는 백업 파일들이 위치한다. 도메인 설정에 대한 자세한 설명은 JEUS Domain 안내서의 도메인 설정변경을 참고한다.
구분 설명 security
-
SYSTEM_DOMAIN : 도메인 단위로 적용되는 보안 도메인 파일인 accounts.xml, policies.xml이 존재하며, 각 XML 파일은 WebAdmin과 jeusadmin을 통해 동적 설정 변경이 가능하다. 보안 도메인 설정에 대한 자세한 설명은 JEUS Security 안내서의 보안 도메인 설정을 참고한다.
-
security-domains.xml : JEUS의 보안 도메인에 대한 설정을 저장하는 파일이다.
-
security.key : 대칭키 암호화 알고리듬에 대한 Key를 저장하는 파일로 JEUS_HOME/bin/encryption을 수행하면 생성된다. security.key 파일에 대한 자세한 설명은 JEUS Security 안내서의 패스워드 보안 설정을 참고한다.
-
policy : Java permission 설정 파일이다. JEUS의 보안 시스템과는 별도로 Java SE Security Manager에서 사용된다.
servlet
-
web.xml : web.xml을 개별적으로 가지고 있지 않은 경우 웹 엔진이 사용할 웹 모듈의 web.xml이다. 기본값은 빈 XML 파일이다.
-
webcommon.xml : 도메인 내 서버의 웹 엔진의 모든 웹 모듈에 적용되는 공통 설정 파일이다. 설정에 대한 자세한 설명은 JEUS Web Engine 안내서의 디렉터리 구조를 참고한다.
-
-
lib/application
도메인 전체에 적용하고 싶은 애플리케이션 라이브러리를 위치시키는 디렉터리다.
SERVER_HOME에 존재하는 애플리케이션 라이브러리와 충돌이 발생할 경우 SERVER_HOME/lib/application이 우선되고 경고 메시지가 남는다. lib/application 디렉터리에 대한 자세한 설명은 JEUS Applications & Deployment 안내서의 lib/application 디렉터리를 참고한다.
-
servers
이 디렉터리 하위에 SERVER_HOME 디렉터리가 서버 이름으로 생성된다. SERVER_HOME 디렉터리 구조에 대한 자세한 설명은 JEUS Server 안내서의 서버 디렉터리 구조를 참고한다.
디렉터리 설명 .workspace
JEUS가 사용하는 서버별 공간으로 사용자가 변경해서는 안 된다.
bin
서버의 시작/종료 스크립트를 포함하고 있다. JEUS_HOME/bin의 스크립트와 동일한 기능을 수행하지만 도메인 이름과 서버 이름을 설정할 필요가 없다.
-
Master Server일 경우 : startMasterServer/stopServer가 존재한다.
-
Managed Server일 경우 : startManagedServer/stopserver가 존재한다.
lib/application
서버에 적용하고 싶은 애플리케이션 라이브러리가 존재한다. 도메인 범위의 라이브러리(DOMAIN_HOME/lib/application)보다 우선순위가 높다. 라이브러리가 충돌할 경우 이 디렉터리에 존재하는 파일이 적용되며 경고 메시지가 남는다. lib/application에 대한 자세한 설명은 JEUS Applications & Deployment 안내서의 lib/application 디렉터리를 참고한다.
logs
서버의 Launcher 로그, 서버 로그, 엑세스 로그 파일이 남는다. 자세한 내용은 JEUS Server 안내서의 Logging을 참고한다.
-
-
- hostmanager
-
JEUS 설치시 JEUS_HOME/hostmanager 경로에 hostmanager가 설치된다. SUPERFRAME_HOME 환경변수로 hostmanager 디렉터리를 설정할 수 있다. (예: JEUS_HOME/hostmanager) 자세한 내용은 JEUS Host Manager 안내서의 실행 환경을 참고한다.
3. 환경변수
환경변수는 모두 JEUS_HOM\bin\jeus.properties에 설정되어 있으며, JEUS_HOME\bin 디렉터리의 모든 스크립트에서 사용된다.
다음은 JEUS에서 사용하는 환경변수이다.
| 환경변수 | 내용 |
|---|---|
JEUS_HOME |
JEUS가 설치된 홈 디렉터리로 필수 사항이다. (예: JEUS_HOME=/home/jeus/jeus21) |
JAVA_HOME |
JDK의 홈 디렉터리이다. (예: JAVA_HOME=/usr/jdk1.8) |
해당 변수는 필요한 경우 수정해서 사용한다. 단, XML 설정 파일에서는 이들 환경변수를 사용할 수 없다. 모든 환경변수는 설치할 때 기본값으로 설정된다. 대부분의 경우 설정된 값을 그대로 사용하면 된다.
|
환경변수를 변경하는 방법은 OS에 따라 다르므로, 이에 대해서는 각 OS 안내서를 참고한다. |
4. 환경설정 파일
JEUS는 환경설정을 위해서 각각 고유의 XML 포맷을 사용하며, 직접 수정하거나 툴을 사용해서 수정할 수 있다.
다음은 JEUS의 XML 설정 파일과 내용, 위치를 정리한 내용이다.
-
domain.xml (jeus-domain.xsd, ejb-engine.xsd, web-engine.xsd, jms-engine.xsd)
위치
JEUS_HOME/domains/<domain_name>/config/
목적
JEUS Manager와 노드를 관리하는 기본 설정 파일이다.
참고 안내서
-
jeus-web-dd.xml (jeus-web-dd.xsd)
위치
웹 애플리케이션 Archive의 WEB-INF
설명
JEUS 웹 애플리케이션(Servlet app) DD(Deployment Descriptors) 파일이다.
참고 안내서
-
jeus-ejb-dd.xml (jeus-ejb-dd.xsd)
위치
EJB 애플리케이션 Archive의 META-INF
설명
JEUS EJB Module DD(Deployment Descriptors) 파일이다.
참고 안내서
-
jeus-client-dd.xml (jeus-client-dd.xsd)
위치
클라이언트 애플리케이션 Archive의 WEB-INF
설명
애플리케이션 클라이언트 DD(Deployment Descriptors) 파일이다.
참고 안내서
-
jeus-connector-dd.xml (jeus-connector-dd.xsd)
위치
리소스 어댑터 Archive의 META-INF
설명
리소스 어댑터 DD(Deployment Descriptors) 파일이다.
참고 안내서
-
policies.xml (policies.xsd)
위치
JEUS_HOME/domains/<domainname>/config/security
설명
JEUS Security 정책을 설정한 파일이다.
참고 안내서
-
accounts.xml (accounts.xsd)
위치
JEUS_HOME/domains/<domainname>/config/security
설명
JEUS Security 계정을 설정한 파일이다.
참고 안내서
-
jeus-web-dd.xml (jeus-web-dd.xsd), jeus-ejb-dd.xml (jeus-ejb-dd.xsd), jeus-client-dd.xml (jeus-client-dd.xsd)
위치
Webservice client archive의 META-INF
설명
웹 서비스 클라이언트 정보를 설정한 파일이다.
참고 안내서
-
jeus-webservices-config.xml (jeus-webservices-config.xsd)
위치
Webservice client archive의 META-INF
설명
웹 서비스 클라이언트 Ant Task에서 사용하는 설정 파일이다.
참고 안내서
|