내용 목차
본 장에서는 UNIX에서 JEUS를 설치하고 제거하는 과정에 대해서 설명한다.
UNIX 환경에서 JEUS 설치는 GUI 모드나 콘솔 모드를 선택이 가능하다.
JEUS 설치는 다음의 과정으로 진행된다.
-
JDK 5 설치
-
JEUS 설치(파일 복사)
-
설치 확인
-
기동 확인
-
환경변수 설정과 검증
-
JEUS 제거도 GUI 모드나 콘솔 모드를 통해 JEUS 제거가 가능하다.
본 절에서는 GUI 모드와 콘솔 모드에서 설치하는 과정에 대해서 설명한다.
UNIX 환경에서 GUI 모드에서 JEUS 설치하는 과정에 대해서 설명한다. GUI 설치가 가능하지 않다면 “5.2.2. 콘솔 모드에서 설치”를 참고한다.
LINUX, Solaris, HP, AIX에서의 JEUS 설치 과정은 동일하며, 설치할 때 화면 구성은 Windows 설치할 때와 유사하다. 그러나 UNIX에서 GUI 설치 툴을 이용하기 위해서는 Java 기반의 GUI 환경을 지원하는 콘솔 또는 터미널이 설치되어 있어야 한다.
GUI 모드에서 JEUS 설치 과정은 다음과 같다.
-
CD를 CD-ROM 장치에 넣고 마운트(mount)한다.
-
명령 라인에서 다음을 입력한 후에 <ENTER> 키를 누른다.
jeus60-unix-generic.bin –i GUI
만약 다른 위치에서 실행한다면 jeus60-unix-generic.bin 파일 실행이 가능하도록 확인하고 콘솔 프롬프트를 실행한 후 다음을 실행한다.
chmod u+x jeus60-unix-generic.bin
-
JEUS 설치 툴의 초기 화면이 나타난다. 진행 상태가 100%가 될 때까지 기다린다.
-
다음과 같은 소개 화면이 표시된다.
JEUS 소개 내용을 읽고 [Next] 버튼을 클릭한다. 설치를 종료 하려면 [Cancel] 버튼을 클릭한다.
-
라이선스 준수 화면에서 라이선스 준수 내용을 읽고 “I accept the terms of …”를 선택한 후 [Next] 버튼을 클릭한다.
-
플랫폼 목록에서 설치 할 플랫폼을 선택한다.
-
설치 디렉터리 선택 화면이 나타난다. JEUS 바이너리와 기타 다른 파일들은 설정한 경로의 디렉터리의 하위에 설치된다.
[Choose…]를 클릭하면 다른 설치 폴더를 선택할 수 있고 [Restore Default Folder]를 클릭하면 초기 기본 폴더로 복귀한다. 가능하면 기본 폴더를 그대로 사용하길 권장한다(예: “/home/jeus”). 설치할 디렉터리를 선택하고 [Next] 버튼을 클릭한다.
-
Install Set 선택 화면의 설치 옵션에서 Full Install, Typical, Advanced Mode 중 하나를 선택한다.
다음은 설치 옵션에 대한 설명이다.
구분 설명 Full Install JEUS 예제인 Samples와 JEUS 관련 문서 파일이 포함된 JEUS Full 버전을 설치한다. Typical JEUS 예제인 Samples가 제외된 JEUS 관련 문서 파일과 JEUS Core 파일을 설치한다. Advanced Mode Manual Configuration Option에는 관리자가 Auto Deploy 경로와 JEUS_BASEPORT를 직접 지정할 수 있다. -
JDK 설치 디렉터리 선택 화면에 초기에 설치된 Java 2 JDK 전체 경로를 설정한다. (예: “/usr/jdk1.5”).
설치 프로그램은 설치된 JDK 경로를 제안하지만 경우에 따라 변경할 수 있다. [Choose…]를 클릭하면 다른 설치 폴더를 선택할 수 있고 [Restore Default Folder]를 클릭하면 초기 기본 폴더로 복귀한다.
참고
JEUS 설치 후에 Java 2 JDK를 설치하려면 JDK 설치 경로를 포함하는 JAVA_HOME 환경변수를 수정해야 한다. 그러므로 JDK를 설치 후 JEUS 설치를 권장한다.
-
패스워드 입력 화면이 나타난다. 화면에서 JEUS 관리자의 패스워드를 입력한다. 패스워드는 “administrator” 관리자 계정으로 할당된다.
-
지금 단계까지 설정한 설치 정보를 확인한 후 [Install] 버튼을 클릭해서 설치를 시작한다.
-
화면에 Progress bar를 통해 설치가 진행되는 상황을 확인할 수 있다.
-
설치 종료를 확인한다.
본 절에서는 콘솔 모드(명령 라인) UNIX/LINUX 환경에서 JEUS를 설치하는 방법에 대해서 설명한다. 콘솔 모드에서 설치를 하기 위해서 Console Installer를 실행해야 한다.
참고
Console Installer는 설치 과정에서 값을 입력 받을 때 기본값을 제시한다. 셸은 이전 단계로 돌아가는 것이 기본적으로 불가능하므로 설치가 완료된 후에 값을 변경하면 된다. 하지만 어느 단계까지는 <back>을 입력하거나 <ENTER> 키를 눌러 이전 단계로 이동이 가능하다
다음의 하위 절은 텍스트 기반 셸을 실행하는 과정에 대한 설명이다.
-
JEUS 설치 CD를 넣고 마운트(mount)한다. CD의 jeus60-unix-generic.bin 파일이 있는 곳으로 이동한다.
-
다른 곳에 있는 설치 Console Installer가 실행이 가능하도록 하려면 jeus60-unix-generic.bin 파일의 실행 권한을 부여한다.
chmod u+x jeus60-unix-generic.bin -
콘솔에서 jeus60-unix-generic.bin을 실행한다(./jeus60-unix-generic.bin 입력 후 <ENTER> 키를 누른다).
[jeususer@matrix jeus]$ ./jeus60-unix-generic.bin Preparing to install... Extracting the JRE from the installer archive... Unpacking the JRE... Extracting the installation resources from the installer archive... Configuring the installer for this system's environment... Launching installer... Preparing CONSOLE Mode Installation... -
JEUS 라이선스 준수 화면이 나타난다.
=========================================================== License Agreement ----------------- Installation and use of JEUS6 requires acceptance of the following License Agreement: TmaxSoft Co., Ltd. (hereafter, TmaxSoft) End-User License Agreement Jeus This is a legal agreement between you (either an individual or an company) and T max Soft, Incorporated. By opening the sealed software package and/or by using the software, you agree to be bound by the terms of this agreement. TmaxSoft License 1. Grant of License: This TmaxSoft License Agreement ("License") permits you to use one copy of the TmaxSoft product Jeus, on any single computer, provided the software is in use on only one computer at any one time. If this package is a license pack, you may make and use additional copies of the software up to th e number of licensed copies authorized. If you have multiple licenses for the s oftware, then at any time you may have as many copies of the software in use as you have licenses. The software is "in use" on a computer when it is loaded into the temporary me mory (i.e., RAM) or installed into the permanent memory (e.g., hard disk, CD-ROM , or other storage devices) of that computer, except that a copy installed on a network server for the sole purpose of distribution to other computers is not " in use". If the anticipated number of users of the software will exceed the num ber of applicable licenses, then you must have a reasonable mechanism or process in place to ensure that the number of persons using the -
JEUS 라이선스 준수에 대한 다음 정보를 보기 위하여 <ENTER> 키를 누른다.
PRESS <ENTER> TO CONTINUE: software concurrently does not exceed the number of licenses. 2. Copyright: The software (including any images, "applets," photographs, anim ations, video, audio, music and text incorporated into the software) is owned by TmaxSoft or its suppliers and international treaty provisions. Therefore, you must treat the software like any other copyrighted materials (e.g ., a book or musical recording) except that you may either (a) make one copy of the software solely for backup or archival purposes, or (b) transfer the softwar e to a single hard disk provided you keep the original solely for backup or arch ival purposes. You may not copy the printed materials accompanying the software , nor print copies of any user documentation provided in "online" or electronic form. 3. Other restrictions: This license is your proof of license to exercise the ri ghts granted herein and must be retained by you. You may not rent, lease, or tra nsfer your rights under this license on a permanent basis provided you transfer this license, the software, and all accompanying printed materials, retain no co pies, and the recipient agrees to the terms of this license. You ay not reverse engine, decompile, or disassemble the software, except to the extent that the fo regoing restriction is expressly prohibited by applicable law.
-
라이선스 동의 여부를 답한다.
동의하면 ‘y’를 입력 후 <ENTER> 키를 누르고, 아니면 ‘n’을 입력 후 <ENTER> 키를 누른다.
PRESS <ENTER> TO CONTINUE: DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N):
y -
플랫폼 목록에서 설치할 플랫폼을 선택하고 해당 번호를 입력한다.
================================================================= Choose Platform --------------- Choose current system ( platform-architecture ) 1)HP-UX PA-RISC 2)HP-UX ITANIUM 3)Solaris Ultra-Sparc 4)Solaris x86 5)AIX 5.x, 6.x PowerPC 6)Linux i386 7)Linux ITANIUM 8)Linux x86_64 Quit) Quit Installer Choose Current System (DEFAULT: 8):
-
설치 디렉터리를 선택한다.
기본적으로 제공되는 값을 사용하려면 <ENTER> 키를 누르고, 디렉터리 변경을 원하면 설치 경로를 입력한다.
=========================================================== Choose Install Folder --------------------- Where would you like to install? Default Install Folder: /home/jeus ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT :
-
Full Install, Typical 설치 중 하나를 선택한다.
Choose Install Set ------------------ Please choose the Install Set to be installed by this installer. ->1- Full Install 2- Typical ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT : 1다음은 각 설치 옵션에 대한 설명이다.
구분 설명 Full Install JEUS 예제인 Samples와 JEUS 관련 문서 파일이 포함된 JEUS Full 버전을 설치한다. Typical Samples을 제외한 JEUS 관련 문서 파일과 JEUS Core 파일을 적용하여 JEUS 필수 파일들을 설치한다. 참고
콘솔 모드는 Advanced Mode를 지원하지 않는다. Advanced Mode를 선택하기 위해서는 GUI 모드를 이용한다.
-
JDK의 위치를 입력한다. <ENTER> 키를 누르면 자동으로 인식한 JDK의 위치를 사용한다. 디렉터리 변경을 원하면 설치 경로를 입력한다.
========================================================== Choose JDK Folder ----------------- Please Choose a Folder: Input User JDK Folder (DEFAULT: /usr/jdk1.5):
-
JEUS 관리자의 패스워드를 입력한다. 이 패스워드는 “administrator” ID로 할당된다.
================================================================= Password Input -------------- Enter the Password for the administrator account. This password will be registered in JEUS as the first user. Input Password:: Corfirm Password::
참고
패스워드는 JEUS를 기동하는 필수적인 요소이다. 입력한 패스워드는 기억장치에 기록되며, 주의 깊게 입력해야 한다.
-
다음 화면은 설치에 관련한 요약정보를 보여준다. <ENTER> 키를 누르면 설치가 진행된다.
Pre-Installation Summary ------------------------ Please Review the Following Before Continuing: Product Name: JEUS6 Install Folder: /home/jeus Install Set Full Install Disk Space Information (for Installation Target): Required: 130,312,561 bytes Available: 1,612,476,416 bytes PRESS <ENTER> TO CONTINUE: -
진행 바와 함께 설치가 진행된다.
=========================================================== Installing... ------------- [===============|===============|===============|===============] [---------------|---------------|---------------|---------------]
-
설치가 완료된다.
=========================================================== Installation Complete --------------------- Congratulations! JEUS6 has been successfully installed to: /home/jeus Press Done to quit the installer. PRESS <ENTER> TO EXIT THE INSTALLER:
GUI 모드나 콘솔 모드를 사용해서 JEUS를 설치한 후 사용에 필요한 환경변수를 설정해야 한다. 환경변수를 설정하고 JEUS를 기동해서 설치가 정상적으로 이루어졌는지 확인한다. 환경변수를 설정하기 전에 JEUS가 설치된 경로에 디텍터리 구조를 확인한다.
다음은 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를 사용하기 위해서는 환경변수가 필요하다. 설치과정에서 일부 환경변수를 설정하지만 경우에 따라서는 수정해서 사용한다. 해당 변수들은 설치할 때 환경변수 PATH는 '.profile/.cshrc'에 적용되고, 그 외 환경변수는 '$JEUS_HOME/bin/jeus.properties' 파일에 설정된다.
다음은 주요 환경변수에 대한 설명이다.
[표 5.1] 환경변수 설정
| 환경변수 | 의미 |
|---|---|
| PATH | 시스템 경로를 설정한다. 다음을 포함하고 있어야 한다. /home/jeus/bin /home/jeus/webserver/bin /home/jeus/lib/system |
| JEUS_HOME | JEUS 설치 디렉터리를 설정한다. (예: /home/jeus) |
| JEUS_BASEPORT | JEUS가 사용할 네트워크 포트 가운데 가장 기본이 되는 포트를 설정한다. (기본값 : 9736) |
| JEUS_LIBPATH | JEUS 라이브러리 파일 경로를 설정한다. (예: /home/jeus/lib/system) |
| VM_TYPE | Java HotSpot JVM 사용 유무를 설정한다. (예: hotspot or old) |
| USERNAME | Administrator 계정의 ID를 설정한다. 매니저와 컨테이너를 한 번에 부트하는 "One Step 부트"의 경우에 설정된다. |
| PASSWORD | Administrator 패스워드를 설정한다. 매니저와 컨테이너를 한 번에 부트하는 "One Step 부트"의 경우에 설정된다. |
| JAVA_HOME | Java 2 설치 디렉터리 경로를 설정한다. (예: /usr/jdk1.5v) |
| JAVA_ARGS | JDK 파라미터를 설정한다. |
| JAVA_VENDOR | JDK 벤더를 설정한다. (예: Sun or IBM or HP) |
| SESSION_MEM | JEUS 세션 서버를 위한 JDK 표준 메모리 인자를 설정한다. |
| SESSION_VERSION | JEUS 세션 서버를 위한 네트워크 프로토콜을 설정한다. (예: Socket or RMI) |
환경변수를 설정할 때 C 셸이라면 JEUS_HOME 변수를 설정하기 위해서는 ‘setenv’을 사용한다.
setenv JEUS_HOME “/home/jeus”
다음은 시스템 PATH를 설정하는 예이다.
setenv PATH “${PATH}:/home/jeus/bin:
/home/jeus/lib/system:/home/jeus/webserver/bin”
참고
Java의 실행 디렉터리(/usr/jdk1.5/bin)는 JEUS에서 사용하게 되므로 환경변수에 추가할 때는 앞쪽에 추가한다.
위의 사항을 검증한 후에 로그오프하고 그 다음에 환경을 적용하기 위하여 다시 로그인한다.
JEUS 설치가 정상적으로 완료되는지 확인하기 위하여 다음 단계를 진행해서 JEUS를 기동한다.
-
콘솔 프롬프트에 jeus를 입력하면 다음 메시지를 출력한다.
다음 예제는 Base Port가 9736로 설정되어 있다.
*********************************************************** - JEUS Home : /home/jeus - JEUS Base Port : 9736 - Java Vendor : Sun - Added Java Option : *********************************************************** /usr/jdk1.5/bin/java -server - Xbootclasspath/p:/home/jeus/lib/system/extension.jar:/home/jeus/jeus/lib/system /classloader.jar -classpath /home/jeus/lib/system/bootstrap.jar -Djeus.jvm.vers ion=hotspot -Djeus.home=/home/jeus -Djava.naming.factory.initial=jeus.jndi.JNSC ontextFactory -Djava.naming.factory.url.pkgs=jeus.jndi.jns.url -Djeus.session.v ersion=socket -Djeus.baseport=9736 -Djeus.tm.checkReg=true -Djava.util.logging. config.file=/home/jeus/bin/logging.properties jeus.server.JeusBootstrapper [2005.02.02 17:11:34][0] [tmax-10] [MGR-0411] virtual host name of this manager : tmax [2005.02.02 17:11:38][1] [tmax-10] [EJB-6452] class ftp is exported [2005.02.02 17:11:42][0] [tmax-10] [MGR-0241] JeusServer is Ready
위 출력은 JEUS Manager가 정상적인 로딩과 JEUS가 대기 상태임을 나타낸다.
참고
1. “Invalid License” 메시지가 나타나면 라이선스가 잘못된 것이다. TmaxSoft로부터 라이선스를 취득하여 $JEUS_HOME/license 디렉터리에 복사한다.
2. 모든 단계들의 진행과 환경변수가 정확히 설정되어 있는지 확인한다. 특히, /jeus/bin 디렉터리가 시스템 경로(‘jeus’ 스크립트가 실행될 수 있도록)에 있는 것을 확인한다.
-
다른 콘솔 창에서 다음의 명령어를 실행한다. <node name>은 호스트 머신 이름이다.
jeusadmin <node name> -
jeusadmin 툴에 로그인을 한 후에, boot와 down 명령으로 JEUS 서버를 제어할 수 있다.
JEUS 서버를 다운시키려면 down을 입력한 후<ENTER> 키를 누르고, 다음 행에서 jeusexit를 입력한 후 <ENTER> 키를 누른다.
down jeusexit
-
jeusadmin을 종료하기 위해서 exit 명령어를 사용한다.
exit
본 절에서는 GUI 모드와 콘솔 모드에서 제거하는 과정에 대해서 설명한다.
다음은 GUI 모드에서 JEUS를 삭제하는 과정에 대한 설명이다. GUI 모드로 삭제가 가능하지 않다면 “5.4.2. 콘솔 모드에서 제거”를 참고한다. UNIX에서 GUI 설치 툴을 이용하기 위해서는 Java 기반의 GUI 환경을 지원하는 콘솔 또는 터미널이 설치되어 있어야 한다.
-
‘jeus’ 스크립트와 WebAdmin 등의 모든 JEUS 프로그램을 종료한다.
-
JEUS가 설치된 경로에서 '$JEUS_HOME/UninstallerData/Uninstall -i GUI'를 실행한다.
[jeususer@matrix UninstallerData]$./Uninstall -i GUI -
다음과 같은 설치 제거 초기 화면이 나타난다.
-
제거 화면의 메시지를 읽고 JEUS 제거 준비가 되었다면 [Uninstall] 버튼을 클릭한다. JEUS를 제거하지 않고 프로그램을 종료하려면 [Cancel] 버튼을 클릭한다.
참고
제거 프로그램으로 제거하여도 JEUS 설치 후에 생성된 파일들은 제거되지 않는다. 이 파일들은 수동으로 제거해야 한다.
-
JEUS 제거가 진행되는 것을 확인한다.
-
JEUS 제거 종료를 확인하고 [Done] 버튼을 클릭하여 JEUS 제거를 완료한다.
다음은 콘솔 모드에서 JEUS를 삭제하는 과정에 대한 설명이다.
-
JEUS가 설치된 경로에서 $JEUS_HOME/UninstallerData/Uninstall을 실행하여 JEUS Core와 JEUS 설치 디렉터리를 삭제한다.
[jeususer@matrix UninstallerData]$./Uninstall -
삭제 과정이 진행된다. 제거가 완료되면 제거가 완료되었다는 메시지가 표시된다.
Preparing CONSOLE Mode Installation... =========================================================== (created with InstallAnywhere by Zero G) ----------------------------------------------------------- =========================================================== Uninstall JEUS6 ------------------ About to uninstall... JEUS6 This will remove features installed by InstallAnywhere. It will not remove files and folders created after the installation. PRESS <ENTER> TO CONTINUE: =========================================================== Uninstalling... --------------- ...* * ************************************************** ************************************************* ...* * ************************************************** ************************************************* ...* * ************************************************** ************************************************* =========================================================== Uninstall Complete ------------------ All items were successfully uninstalled.