본 장에서는 JEUS에서 사용하는 관리 툴과 디렉터리 구조와 환경변수에 대해서 설명한다. 그리고 JEUS와 관련 XML 설정 파일의 전반적인 내용에 대해서 소개한다.
다음은 JEUS에 접속해서 사용하는 툴에 대한 설명이다.
[표 2.1] JEUS 관리 툴
| 툴 | 설명 |
|---|---|
| WebAdmin | HTML 기반의 관리 툴로 JEUS의 제어, 모니터링, 관리 등의 기능을 제공한다. 자세한 내용은 "JEUS WebAdmin 안내서"를 참고한다. |
| jeus | JEUS Manager를 실행하는 가장 기본적인 툴이다. 자세한 내용은 “JEUS Reference Book”의 “제3장 jeus”를 참고한다. |
| jeusadmin | 콘솔 툴은 command prompt에서 JEUS를 컨트롤하는 데 사용된다. 자세한 내용은 “JEUS Reference Book”의 “4.2. jeusadmin”을 참고한다. |
참고
위에서 언급한 것 이외에도 EJB와 서블릿 엔진을 위한 툴이 존재한다. 자세한 내용은 해당 안내서를 참고한다.
다음은 JEUS를 설치했을 때의 전체 디렉터리 구조이다.
다음은 디렉터리와 파일의 설명이다.
- JEUS_HOME
-
JEUS의 최상위 디렉터리로 실제 디렉터리 이름과 위치는 설치할 때 결정된다. (예: c:\jeus)
- bin
- config
-
서버 설정이 저장되는 하위 디렉터리를 가지고 있다.
-
<nodename>
이름이 <nodename>인 설정 파일이 위치한다. <nodename>은 JEUS 가 설치된 서버의 이름(일반적으로 hostname)이다. 만약 현재 JEUS가 백업 노드로 작동되도록 설정되었다면 백업하는 노드의 <nodename> 디렉터리가 존재해야 한다.
JEUS Manager의 설정 파일은 JEUSMain.xml이며, 이 디렉터리에 존재한다. <nodename>이 jeus일 때 "c:\jeus\config\jeus”가 된다.
하위 디렉터리 설명 <nodename>_<enginetype>_<enginename> 엔진별로 설정 파일을 가지고 있다.
<enginetype>은 ejb, jms, servlet 셋 중 하나이며, <enginename>은 JEUSMain.xml에서 설정한 이름이다.
“c:\jeus\config\jeus\jeus_servlet_Engine1”일 때 <nodename>은 'jeus', <enginetype>은 'servlet'이며, 사용자가 지정하는 <enginename>은 'Engine1'이 된다.
security 해당 노드에서 사용하는 security configuration이 들어가 있다. 자세한 내용은 "JEUS Security 안내서"를 참조한다.
-
- webserver
-
JEUS가 설치될 때 JEUS 웹 서버가 설치되는 디렉터리이다. 자세한 내용은 "JEUS Web Service 안내서"를 참조한다.
- license
-
JEUS 라이선스 파일을 가지고 있다. 라이선스 파일은 JEUS가 실행되기 위해서 반드시 필요한 파일이다.
- logs
-
시스템 로그가 기록된다.
하위 디렉터리 설명 TM 트랜잭션 매니저의 로그 정보를 기록한다. JeusSystem node, engine container, engine들이 생성하는 로그를 기록한다. - samples
-
JEUS의 예제들이 있다.
- lib
-
JEUS가 기동될 때, 이 디렉터리의 모든 서브 디렉터리를 스캐닝해서 '.jar' 파일이나 '.zip' 파일을 클래스 패스로 추가한다. 서브 디렉터리 스캐닝 순서는 system → application → datasource 순서이다.
하위 디렉터리 설명 application 사용자 애플리케이션에서 사용하는 클래스 파일이 위치한다. 이 디렉터리의 모든 '.zip' 파일이나 '.jar' 파일, 디렉터리 형태의 일반 클래스들은 클래스 패스로 추가된다. 클래스 파일은 '.jar'나 '.zip' 파일보다 먼저 읽힌다. system JEUS가 사용하는 라이브러리가 있는 디렉터리이므로 사용자는 이 디렉터리를 수정해서는 안 된다. '.so'나 '.dll'같은 Native Driver(예를 들면, Connector Resource Adapter에서 필요한 드라이버 등…)는 이 디렉터리에 위치해야 한다. 또 여기에는 JEUS의 클래스인 jeus.jar가 있다. datasource JDBC 드라이버의 '.jar' 파일과 설정 파일이 위치한다. schemas XML 설정 파일을 위한 XML Schema 파일이 위치한다. endorsed Java 런타임이 기본 JDK 클래스들에 우선하여 읽어들일 클래스들이 JAR 파일 형태로 위치한다. shared 애플리케이션 간에 공유되는 라이브러리들이 위치한다. client Standalone과 애플릿 등의 클라이언트가 사용하는 라이브러리가 위치한다. - webhome
-
JavaEE 애플리케이션(웹 애플리케이션, EJB)이 디플로이되는 홈 디렉터리이다.
하위 디렉터리 설명 admin_home WebAdmin에서 사용되는 서블릿/JSP 파일이 있다. app_home 애플리케이션의 기본 경로이다. autodeploy Auto Deploy할 애플리케이션의 기본 경로이다. <node_name>_<container_name> <node_name>_<container_name>에 해당하는 엔진 컨테이너에서 사용되는 애플리케이션이 존재한다. - workspace
-
JEUS가 동작하면서 필요한 작업을 하는 임시 디렉터리로 이 디렉터리를 수정해서는 안 된다.
환경변수는 모두 "JEUS_HOM\bin\jeus.properties"에서 설정되어 있으며, JEUS_HOME\bin 디렉터리의 모든 스크립트에서 사용된다.
다음은 JEUS에서 사용하는 환경변수이다.
[표 2.2] JEUS 환경변수
해당 변수는 필요한 경우 수정해서 사용한다. 단, XML 설정 파일에서는 이들 환경변수를 사용할 수 없다. 모든 환경변수는 설치할 때 기본값으로 정해진다. 대부분의 경우 설정된 값을 그대로 사용하면 된다.
참고
환경변수를 변경하는 방법은 OS에 따라 다르므로, 이에 대해서는 각 OS 안내서를 참고한다.
JEUS는 환경설정을 위해서 각각 고유의 XML 포맷을 사용하며, 직접 수정하거나 툴을 사용해서 수정할 수 있다. 다음은 JEUS의 XML 설정 파일과 내용, 위치를 정리한 내용이다.
-
위치 JEUS_HOME\config\<nodename>\ 목적 JEUS Manager와 노드를 관리하는 기본 설정 파일이다. 참고 안내서 JEUS Server 안내서 -
위치 JEUS_HOME\config\<nodename>\<Servlet Enginedir>\ 설명 서블릿/JSP 엔진 설정 파일이다. 참고 안내서 JEUS Web Container 안내서 -
jeus-web-dd.xml (jeus-web-dd.xsd)
위치 웹 애플리케이션 Archive의 WEB-INF 설명 JEUS 웹 애플리케이션(Servlet app) Deployment Descriptors 파일이다. 참고 안내서 JEUS Web Container 안내서 -
위치 JEUS_HOME\config\<nodename>\<EJB Enginedir>\ 설명 EJB 엔진 설정 파일이다. 참고 안내서 JEUS EJB 안내서 -
jeus-ejb-dd.xml (jeus-ejb-dd.xsd)
위치 EJB 애플리케이션 Archive의 META-INF 설명 JEUS EJB Module Deployment Descriptors 파일이다. 참고 안내서 JEUS EJB 안내서 -
jeus-client-dd.xml (jeus-client-dd.xsd)
위치 클라이언트 애플리케이션 Archive의 WEB-INF 설명 애플리케이션 클라이언트 Deployment Descriptor 파일이다. 참고 안내서 JEUS 애플리케이션 안내서 -
jeus-connector-dd.xml (jeus-connector-dd.xsd)
위치 리소스 어댑터 Archive의 META-INF 설명 리소스 어댑터 Deployment Descriptor 파일이다. 참고 안내서 JEUS JCA 안내서 -
위치 JEUS_HOME\config\<nodename>\<JMS Enginedir>\ 설명 JMS 엔진 설정 파일이다. 참고 안내서 JEUS MQ 안내서 -
policies.xml (policies.xsd)
위치 JEUS_HOME\config\<nodename>\security\<domainname>\ 설명 JEUS Security 정책을 설정한 파일이다. 참고 안내서 JEUS Security 안내서 -
accounts.xml (accounts.xsd)
위치 JEUS_HOME\config\<nodename>\security\<domainname>\ 설명 JEUS 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 Web Service 안내서 -
jeus-webservices-config.xml (jeus-webservices-config.xsd)
위치 Webservice client archive의 META-INF 설명 웹 서비스 클라이언트 Ant Task에서 사용하는 설정 파일이다. 참고 안내서 JEUS Web Service 안내서
참고
1. Java EE의 표준 Descriptor 파일인 “web.xml”이나 “ejb-jar.xml” 파일도 사용된다. 각 파일은 해당 Java EE 스펙을 참조한다.
2. 모든 XML Schema 파일은 JEUS_HOME\lib\schemas\jeus\에 위치한다.