본 절에서는 JEUS를 실행하는 jeus 명령어에 대해 설명한다.
jeus 실행 명령은 JEUS Manager를 기동할 때 사용한다. JEUS Manager는 JEUS에서 가장 중요한 컴포넌트이다. 따라서 JEUS를 실행하기 전에 이 명령을 가장 먼저 실행해야 한다. JEUS Manager는 실제로 JEUS를 실행하고, 관리자의 명령을 서버로 전달하는 Agent 역할을 한다.
실행 명령어는 다음의 디렉터리에 위치한다.
JEUS_HOME\bin\
jeusadmin이나 WebAdmin과 같은 관리 툴을 사용하기 위해서는 JEUS Manager를 기동해야 한다.
JEUS Manager는 하나의 JEUS 노드와 통신하고 하나의 JEUS Manager는 각 HOST 머신에서 동작한다. JEUS Manager는 클러스터링을 형성한 다른 JEUS Manager와 연결된다.
JEUS Manager는 JEUS_HOME\config\<nodename>\ 디렉터리의 JEUSMain.xml 파일을 읽어 들인다. <nodename>은 JEUS Manager가 관리하는 노드의 이름으로 머신의 이름이거나, vhost.properties에서 정의한 가상 노드의 이름이다.
다음은 JEUS Manager를 기동하기 위해 jeus 명령을 실행하는 과정이다.
JEUS Manager를 실행하려면 UNIX나 LINUX에서 'jeus'를 실행한다(Windows에서는 'jeus.cmd'를 실행한다).
간단하게는 명령 프롬프트에 jeus라고 입력한다.
jeus 스크립트를 수정하면 JEUS Manager를 디버그 모드로 운영할 수 있다. 이 설정방법은 “3.3. 디버그 모드에서 JEUS Manager 실행”을 참고한다.
jeus [-h] [-protectkey] [-d] [-xml] [–U<username> -P<password>] [-f<filename>] [-D<property=value>] [-properties=<filename>]
다음은 명령어 옵션에 대한 설명이다.
| 옵션 | 설명 |
|---|---|
| [-h] | JEUS 명령의 도움말을 출력한다. |
| [-protectkey] | 암호화된 secret.key 파일의 사용 여부를 결정한다. |
| [-d] | 클러스터링에 Dynamic하게 추가되는 Dynamic boot를 할 때 사용한다. |
| [-xml] | deprecated 옵션으로 이전 버전의 JEUS와 호환을 위해 제공한다. |
[-U<username> ] [-P<password>] | JEUS Manager를 제어할 관리자의 이름과 패스워드를 입력하여, JEUS Manager를 실행하고 기동하여 바로 서비스를 할 수 있게 한다. [–U] 및 [–P]는 관리자 ID와 패스워드를 의미하며, JEUS를 One Step Boot할 때 사용한다. |
| [-f<filename>] | 관리자의 이름과 패스워드가 암호화된 로그인 정보를 가진 파일명을 지정하여, 위의 옵션과 같이 one-step booting을 시도한다. |
| [-D<property=value>] | 시스템 프로퍼티를 지정한다. 이 옵션은 1번이상 이용할 수 있다. |
| [-properties=<filename>] | 파일로부터 시스템 프로퍼티를 설정한다. |
[-protectkey] 옵션을 사용했을 경우 master password를 입력한다.
[-protectkey] 옵션은 JEUS v6.0 Fix#3부터 추가되었으며, security.key 파일을 보호하는 옵션을 사용할 경우 콘솔로 master password를 입력받는 옵션이다. 이 옵션은 반드시 JEUS를 포그라운드 프로세스로 띄울 때만 사용해야 한다.
JEUS가 기동할 때 옵션을 지정하면 다음과 같은 콘솔 입력 화면이 나타나면서 master password의 입력을 기다린다.
secret key file is encrypted. Enter the master password. password>
security.key 파일을 보호하는 방법은 암호화 툴을 사용한다. 이에 관한 자세한 사항은 “4.6. encryption”을 참조한다.
디버그 모드로 JEUS Manager를 실행할 경우 JPDA 지원 디버거를 사용하여 서블릿과 EJB 애플리케이션을 디버그할 수 있다. JEUS를 디버그 모드로 시작하기 위해서는 다음의 2가지를 설정해야 한다.
엔진 컨테이너의 이름 설정
JEUS Manager와 같은 JVM에서 동작하기 위해서 엔진 컨테이너의 이름은 'default'로 설정해야 한다.
엔진 컨테이너에 대한 정보는 “JEUS Server 안내서”의 “2.3. 엔진 컨테이너 설정”을 참조한다.
'jeus' 스크립트 파일 수정
스크립트의 “java” 명령 바로 뒤에 다음과 같이 추가한다(한 줄에 쓰여져야 한다).
-classic -Xdebug –Xnoagent -Xrunjdwp:transport=dt_socket,adderss=8888, suspend=n,server=y
“8888”의 디버그 Port(디버그 Port는 JPDA 디버거가 JVM에 접근할 때 사용된다)를 사용하여 JEUS Manager를 디버그 모드에서 동작하도록 한다.
수정된 스크립트로 JEUS Manager를 기동한다. 그런 다음 JPDA를 지원하는 IDE(Integrated Development Environment)를 사용하여 EJB와 서블릿 애플리케이션을 디버그한다.
'jeus' 스크립트 파일은 “jeus_debug”와 같이 복사본을 수정해서 사용하고 원본은 수정하지 않도록 한다.
JEUS에서 사용하는 시스템 환경변수에 대해서는 “Part I, 시스템 프로퍼티”를 참조한다. “1.1. 개요”에서는 JVM에서 사용하는 “-D” 옵션에 대하여 설명하고 있다.
이 옵션 중 중요한 옵션은 jeus.properties(또는 jeus.properties.cmd) 파일에서 환경변수 설정으로 사용할 수 있지만, JEUS 튜닝을 하거나 JEUSMain.xml에는 없는 기능을 설정하기 위해 'jeus' 스크립트에 적용할 수 있다.
환경변수는 엔진 컨테이너를 실행하는 개별 JVM에 추가된다. 이러한 JVM 파라미터들은 JEUSMain.xml 파일의 엔진 컨테이너 환경에 설정되어야 한다.