내용 목차
본 장에서는 Windows에서 JEUS를 설치하고 제거하는 과정에 대해서 설명한다.
Windows 환경에서 JEUS 설치는 GUI 설치 툴을 통하여 이루어진다. Windows에서 JEUS 설치는 다음의 과정으로 진행된다.
JDK 5 설치
GUI 모드에서 JEUS 설치(파일 복사)
설치 확인
기동 확인
환경변수 설정과 검증
선택적으로 JEUS의 Windows 서비스 등록과 해제
JEUS 제거도 GUI를 통해 이루어진다.
내장 WebtoB의 Windows 플랫폼의 컴파일 환경이 VC90으로 변경되었다. 이에 따라서 JEUS 6 Fix#7이전의 버전에서 JEUS 6 Fix#8이후의 버전으로 Upgrade 하거나 JEUS 6 Fix#8 이후의 버전을 새로 설치할 때에 내장 WebtoB의 정상적인 동작을 위해서는 “C 런타임 및 표준 C++ 라이브러리(msvcm90.dll, msvcp90.dll, msvcr90.dll)"가 필요하게 되었다.
다음의 사이트를 통해 Microsoft Visual C++ 2008 Redistributable Package 파일을 다운로드 받을 수 있다.
Microsoft Visual C++ 2008 Redistributable Package (x86)
http://www.microsoft.com/downloads/ko-kr/details.aspx?FamilyID=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF
Microsoft Visual C++ 2008 Redistributable Package (x64)
내장 WebtoB를 사용하지 않거나 Microsoft.NET Framework 3.5 SP1이 설치되어 있으면 Redistributable Package를 설치하지 않아도 된다.
본 절은 설치 툴을 사용하여 Microsoft Windows 환경(Windows 2000/2003/XP,Vista)에서 JEUS를 설치하는 방법을 설명한다.
UNIX 콘솔 모드 환경과는 달리, Windows 환경에서 JEUS 설치할 때 커맨드 라인 툴은 제공하지 않는다.
JDK 5 설치한 후 Windows에 JEUS를 설치하려면 다음과 같은 단계로 진행한다.
JEUS 설치 프로그램인 jeus60-win.exe가 있는 위치로 이동한다. jeus60-win.exe 파일을 더블 클릭해서 실행한다.
설치 툴의 초기화면이 나타난다. 진행이 100%가 될 때까지 기다린다.
설치 소개 화면에서 소개 내용을 읽고 [Next] 버튼을 클릭한다. 설치를 종료하려면 [Cancel] 버튼을 클릭한다.
JEUS 라이선스 준수 화면이 나타난다. 라이선스 준수 내용을 읽고 “I accept the terms of …”를 선택한 후 [Next] 버튼을 클릭한다.
설치 디렉터리 선택 화면이 나타난다. JEUS 바이너리와 기타 다른 파일들은 설정한 경로의 디렉터리의 하위에 설치된다.
[Choose…]를 클릭하면 다른 설치 폴더를 선택할 수 있고 [Restore Default Folder]를 클릭하면 초기 기본 폴더로 복귀한다. 가능하면 기본 폴더를 그대로 사용하길 권장한다. (예: “C:\TmaxSoft\JEUS6.0”)
설치할 디렉터리를 선택하고 [Next] 버튼을 클릭한다.
Install Set 선택 화면의 설치 옵션에서 Full Install, Typical, Advanced Mode 중 하나를 선택하고 [Next]을 클릭한다(기본 Full Install 권장).
다음은 설치 옵션에 대한 설명이다.
구분 | 설명 |
---|---|
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 전체 경로를 입력한다. (예: “C:\java\1.5.0.7")
설치 프로그램은 설치된 JDK 경로를 제안하지만 경우에 따라 변경할 수 있다. [Choose…]를 클릭하면 다른 설치 폴더를 선택할 수 있고 [Restore Default Folder]를 클릭하면 초기 기본 폴더로 복귀한다.
JEUS 설치 후에 Java 2 JDK를 설치하려면 JDK 설치 경로를 포함하는 JAVA_HOME 환경변수를 수동으로 설정해야 한다. 그러므로 JDK를 설치 후 JEUS 설치를 권장한다.
예를 들면 Windows 명령 프롬프트에 “set JAVA_HOME=C:\java\1.5.0.7” 명령을 실행하여 설정한다.
Windows NT 서비스 등록 선택 팝업 화면이 나타난다. 서비스 등록은 Windows용 설치 파일에만 나타난다.
패스워드 입력 화면이 나타난다. 화면에서 JEUS 관리자의 패스워드를 입력한다. 패스워드는 “administrator” 관리자 계정으로 할당된다.
지금 단계까지 설정한 설치 정보를 확인한 후 [Install] 버튼을 클릭하여 설치를 시작한다.
화면에 Progress bar를 통해 설치가 진행되는 상황을 확인할 수 있다.
설치 종료를 확인한다.
JEUS를 설치한 후 사용에 필요한 환경변수를 설정해야 한다. 환경변수를 설정하고 JEUS를 기동해서 설치가 정상적으로 이루어졌는지 확인한다. 환경변수를 설정하기 전에 JEUS가 설치된 경로에 디텍터리 구조를 확인한다.
다음은 JEUS를 설치했을 때의 전체 디렉터리 구조이다.
다음은 디렉터리와 파일의 설명이다.
JEUS의 최상위 디렉터리로 실제 디렉터리 이름과 위치는 설치할 때 결정된다. (예: c:\jeus)
서버 설정이 저장되는 하위 디렉터리를 가지고 있다.
<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 안내서"를 참조한다. |
JEUS가 설치될 때 JEUS 웹 서버가 설치되는 디렉터리이다. 자세한 내용은 "JEUS Web Service 안내서"를 참조한다.
JEUS 라이선스 파일을 가지고 있다. 라이선스 파일은 JEUS가 실행되기 위해서 반드시 필요한 파일이다.
시스템 로그가 기록된다.
하위 디렉터리 | 설명 |
---|---|
TM | 트랜잭션 매니저의 로그 정보를 기록한다. |
JeusSystem | node, engine container, engine들이 생성하는 로그를 기록한다. |
JEUS의 예제들이 있다.
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과 애플릿 등의 클라이언트가 사용하는 라이브러리가 위치한다. |
JavaEE 애플리케이션(웹 애플리케이션, EJB)이 디플로이되는 홈 디렉터리이다.
하위 디렉터리 | 설명 |
---|---|
admin_home | WebAdmin에서 사용되는 서블릿/JSP 파일이 있다. |
app_home | 애플리케이션의 기본 경로이다. |
autodeploy | Auto Deploy할 애플리케이션의 기본 경로이다. |
<node_name>_<container_name> | <node_name>_<container_name>에 해당하는 엔진 컨테이너에서 사용되는 애플리케이션이 존재한다. |
JEUS가 동작하면서 필요한 작업을 하는 임시 디렉터리로 이 디렉터리를 수정해서는 안 된다.
JEUS를 사용하기 위해서는 환경변수가 필요하다. 설치과정에서 일부 환경변수를 설정하지만 경우에 따라서는 수정해서 사용한다.
환경변수 PATH는 Windows 명령 프롬프트에 “set” 명령을 사용함으로써 정확하게 설정되었는지 확인할 수 있다. 또한, [시작] > [설정] > [제어판] > [시스템] > [고급] > [환경변수]에서 확인 가능하다. (Windows 2000/Windows XP/Windows 2003/Windows Vista 경우)
나머지 환경변수는 %JEUS_HOME%\bin\jeus.properties.cmd 파일에 설정된다.
다음은 주요 환경변수에 대한 설명이다.
[표 6.1] JEUS 설치 - 환경변수 설정
환경변수 | 설명 |
---|---|
PATH | 시스템 경로를 설정한다. 다음을 포함하고 있어야 한다. C:\TmaxSoft\JEUS6.0\bin C:\TmaxSoft\JEUS6.0\webserver\bin C:\TmaxSoft\JEUS6.0\lib\system |
JEUS_HOME | JEUS 설치 디렉터리를 설정한다. (예: C:\TmaxSoft\JEUS6.0) |
JEUS_BASEPORT | JEUS가 사용할 네트워크 포트 가운데 가장 기본이 되는 포트를 설정한다. (기본값 : 9736) |
DEPLOY_HOME | 디플로이가 자동으로 수행되는 디렉터리를 설정한다. (예: C:\TmaxSoft\JEUS6.0\webhome\autodeploy) |
JEUS_LIBPATH | JEUS 라이브러리 파일 경로를 설정한다. (예: C:\TmaxSoft\JEUS6.0\lib\system) |
VM_TYPE | Java HotSpot JVM 사용 유무를 설정한다. hotspot or old로 설정이 가능하며 hotspot으로 설정하면 -server 옵션으로 동작하고 old로 설정하면 vm 옵션이 들어가지 않는다. vm option이 동작하지 않는 장비는 old로 설정해야 한다. |
USERNAME | Administrator 계정의 ID를 설정한다. 매니저와 컨테이너를 한 번에 부트하는 "One Step 부트"의 경우에 설정된다. |
PASSWORD | Administrator 패스워드를 설정한다. 매니저와 컨테이너를 한 번에 부트하는 "One Step 부트"의 경우에 설정된다. |
JAVA_HOME | Java 2 설치 디렉터리 경로를 설정한다. (예: C:\java\1.5.0.7) |
JAVA_ARGS | JDK 파라미터를 설정한다. |
JAVA_VENDOR | JDK 벤더를 설정한다. (예: Sun or IBM or HP) |
SESSION_MEM | JEUS 세션 서버를 위한 JDK 표준 메모리 인자를 설정한다. |
SESSION_VERSION | JEUS 세션 서버를 위한 네트워크 프로토콜을 설정한다. (예: Socket or RMI) |
JEUS 설치가 정상적으로 완료되는지 확인하기 위하여 다음 단계를 진행하여 JEUS를 기동한다.
명령 프롬프트를 실행하고 jeus를 입력하거나 [시작] > [프로그램] > [TmaxSoft] > [JEUS] > [jeus 스크립트]를 실행한다.
다음 메시지가 명령 프롬프트 창에 나타난다.
C:\Documents and Settings\Administrator>jeus ************************************************************** - JEUS Home : C:\TmaxSoft\JEUS6.0 - JEUS Base Port : 9736 - Added Java Option : - Java Vendor : Sun ************************************************************** "C:\java\1.5.0.7\bin\java" -server -Xmx512m -Xbootclasspath/p:"C:\TmaxSoft\JEUS6 .0\lib\system\extension.jar";"C:\TmaxSoft\JEUS6.0\lib\system\classloader.jar" -c lasspath "C:\TmaxSoft\JEUS6.0\lib\system\bootstrap.jar" -Djava.endorsed.dirs="C: \TmaxSoft\JEUS6.0\lib\endorsed" -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rm i.dgc.server.gcInterval=3600000 -Djeus.jvm.version=hotspot -Djeus.home="C:\TmaxS oft\JEUS6.0" -Djava.naming.factory.initial=jeus.jndi.JNSContextFactory -Djava.na ming.factory.url.pkgs=jeus.jndi.jns.url -Djava.library.path="C:\TmaxSoft\JEUS6.0 \lib\system" -Djeus.baseport=9736 -Djava.util.logging.config.file="C:\TmaxSoft\J EUS6.0\bin\logging.properties" -Djeus.properties.replicate=jeus,java.util.loggin g,sun.rmi.dgc -Djeus.tool.webadmin.locale.language=ko -Djava.net.preferIPv4Stack =true -Djeus.management.simple.log=true jeus.server.JeusBootstrapper [2007.05.19 13:33:39][1][] [client-10] initialize virtual DNS table, enable : tr ue, table : {shimbh:9736=johan} [2007.05.19 13:33:40][0][b037] [johan-10] [MGR-0411] virtual host name of this m anager : johan [Network Configuration] default local hostname : null, default local ip : null, local inetaddress : shimbh/192.168.1.210, local host address : 192.168.1.210, full host name : shimbh, local hostname : shimbh [RMI Configuration] Default RMI export port for this container : 9743 [SystemProperty] The system property is set but has no corresponding jeus proper ty, maybe typographical error : jeus.management.simple.log [2007.05.19 13:33:48][2][b037] [johan-10] jeus.server.useListenPortPerContainer= true [2007.05.19 13:33:48][2][b037] [johan-10] The id of this container johan_contain er1 is 63 [2007.05.19 13:33:48][2][b037] [johan-10] The base port of this container johan_ container1 is 10381 [2007.05.19 13:33:48][3][b037] [johan-10] [MGR-0239] JEUSMain.xml is loaded [2007.05.19 13:33:50:390] webt.properties file is not found [2007.05.19 13:33:57][0][b037] [johan-10] [MGR-0241] JeusServer is Ready
출력 메시지에 "JeusServer is Ready"는 JEUS가 대기 상태에 있는 것을 나타낸다.
1. “Invalid License” 메시지가 출력되면 라이선스가 잘못된 것이다. TmaxSoft로부터 라이선스를 취득하여 %JEUS_HOME%\license 디렉터리에 복사한다.
2. 모든 설치 과정과 필요한 환경변수들이 제대로 설정되어 있는지 확인한다. 특히, “C:\TmaxSoft\JEUS6.0\bin” 디렉터리가 시스템 경로(jeus.cmd 스크립트 가 실행)에 포함 유무를 확인한다.
다른 터미널 창에 다음 명령어를 입력한다.
jeusadmin <hostname>
다음은 hostname이 'johan'인 경우에 대한 예이다.
C:\TmaxSoft\JEUS6.0\bin>jeusadmin johan Login name>administrator Password> JEUS 6.0 Jeus Manager Controller johan>
JEUS 관리자의 사용자명과 패스워드를 입력한다. 일반적으로 관리자의 계정은 administrator이고 패스워드는 JEUS를 설치할 때 입력한 값이다.
잠시 후 프롬프트가 다시 뜨면 JEUS가 제대로 기동되었고, 다시 명령어를 받을 수 있는 상태가 되었다는 것을 나타낸다.
웹 브라우저를 열어서 주소 창에 다음의 주소를 입력한다.
http://localhost:9744/webadmin
만약 위 예제의 JEUSMain.xml에서 WebAdmin을 사용할 수 있게 해놓았다면, WebAdmin이라는 웹 기반의 관리 툴이 접속된다.
JEUS 관리자의 계정과 패스워드를 입력하고 [Login] 버튼을 클릭한다. 일반적으로 관리자의 계정은 "administrator"이고 패스워드는 JEUS를 설치할 때 입력한 값이다.
WebAdmin을 통해서 JEUS를 관리할 수 있다.
JEUS 서비스나 엔진을 중지하려면 JEUS 노드 트리에서 노드명을 선택(johan)한 후 웹 페이지 메인 뷰의 [제어] 탭을 선택한다. 그리고 JEUS 매니저-제어 화면에서 [다운] 탭을 선택한다.
다운가능한 노드를 체크한 후 [확인] 버튼을 클릭하여 다운 작업을 진행한다.
종료 가능한 노드가 [종료] 탭에 나타난다. 종료할 노드를 선택한 후 [확인] 버튼을 클릭하여 종료 작업을 완료한다.
다음 명령어를 입력해서 jeusadmin을 종료한다.
exit
JEUS는 Windows 운영체제에서 서비스로 동작할 수 있도록 설계되었다. 이 기능을 사용하려면 JEUS 폴더에 있는 서비스를 실행한다. 다음은 Windows NT 서비스로 동작하도록 JEUS를 등록, 제거하는 과정에 대한 설명이다.
다음은 Windows 서비스를 등록하는 과정에 대한 설명이다.
svcinstall.exe가 위치한 %JEUS_HOME% 아래 bin 디렉터리로 이동한다.
(기본: C:\TmaxSoft\JEUS6.0\bin)
svcinstall.exe를 실행해서 JEUS를 Windows에 서비스로 등록한다.
%JEUS_HOME%\bin 아래 jeus.ini 파일은 JEUS를 Windows NT 서비스로 실행할 때 사용되는 설정 파일이다. 뿐만 아니라 jeus.ini 파일명은 서비스명으로 등록된다(jeus라는 이름으로 등록). 이 파일에는 JEUS_HOME, JEUS_BASEPORT, JAVA_HOME 등의 설정 정보가 저장된다.
JEUS를 시작할 때 Hotspot JVM을 사용하는 경우
jeus.cmd 스크립트에 -hotspot 옵션을 넣는다.
svcinstall.exe <jeus.ini> <id> <password> -hotspot
JEUS가 시작할 때 Hotspot JVM을 사용하지 않는 경우
JEUS를 실행할 때 -hotspot 옵션을 넣지 않는다.
svcinstall.exe <jeus.ini> <id> <password>
다음은 svcinstall 명령어 사용에 대한 예이다.
C:\TmaxSoft\JEUS6.0\bin>svcinstall jeus.ini administrator 1111111 -hotspot JEUS Windows service installer Ver. 3.1.1 Copyright (c) 2006, TmaxSoft Co., Ltd. JEUS Service[jeusservice-jeus] installed
초기에 ID와 패스워드는 “administrator”와 “password”이다.
서비스 등록에 대해서는 다음과 같이 2가지 방법으로 확인이 가능하다.
GUI 모드에서 등록 확인
Windows에서 [시작] > [설정] > [제어판] > [관리 도구] > [서비스]를 클릭하면 서비스 화면에서 JEUS 서비스가 존재하는지 확인할 수 있다.
서비스명(서비스 등록 시 사용한 파일명)을 더블 클릭하면 [시작], [중지], [일시 중지], [계속] 버튼이 나타난다. [시작] 버튼을 클릭하면 서비스가 시작된다. 이것은 설치 파일에 등록된 엔진과 기타 컴포넌트가 로딩된다는 것을 나타낸다. [중지] 버튼을 클릭하면 서비스가 중단된다.
명령 프롬프트에서 등록 확인
서비스를 확인하려면 명령 프롬프트에서 다음과 같이 입력한다.
svcremove -list
다음은 서비스를 확인하는 예제이다.
C:\TmaxSoft\JEUS6.0\bin>svcremove -list JEUS Windows service remover Ver. 3.1.1 Copyright (c) 2006, TmaxSoft Co., Ltd. ** JEUS Services ** ---------------------------- - jeus Total count: 1
결과 메시지에서 Windows 서비스가 총 1개 등록되어 있음을 확인할 수 있다.
서비스를 중지하려면 Windows에서 [시작] >[ 설정] > [제어판] > [관리 도구] > [서비스]를 선택하고 [중지] 버튼을 클릭하여 서비스를 중단한다.
서비스를 영구히 제거하려면 %JEUS_HOME%\bin 디렉터리의 svcremove.exe를 실행한다. 인자로 서비스명을 사용한다.
C:\TmaxSoft\JEUS6.0\bin> svcremove.exe jeus>
JEUS Windows service remover Ver. 3.0
Copyright (c) 2006, TmaxSoft Co., Ltd.
Removing windows service 'jeus'...
Successfully done.
다음은 JEUS를 제거하는 과정이다.
jeus 스크립트와 WebAdmin 등의 모든 JEUS 프로그램들을 종료한다.
JEUS 홈 디렉터리의 UninstallerData\JEUS6.0 디렉터리에서 Uninstall.exe를 실행하거나(예: “C:\TmaxSoft\JEUS6.0\UninstallerData\JEUS6.0”), [시작] > [프로그램] > [TmaxSoft] > [JEUS6.0] > [Uninstall]을 클릭한다.
다음과 같이 설치 제거 초기 화면이 나타난다.
제거 화면의 메시지를 읽고 JEUS 제거 준비가 되었다면 [Uninstall] 버튼을 클릭한다. JEUS를 제거하지 않고 프로그램을 종료하려면 [Cancel] 버튼을 클릭한다.
제거 프로그램으로 제거하여도 JEUS 설치 후에 생성된 파일들은 제거되지 않는다. 이 파일들은 수동으로 제거해야 한다.
Windows NT서비스가 존재한다면 수동으로 제거를 하고, 다시 제거 과정을 수행한다.
Uninstall JEUS 화면에서 JEUS 제거의 진행표시를 볼 수 있다.
설치 제거 완료 화면이 나타날 때까지 기다린다.
JEUS 설치 후에 생성된 파일들은 Uninstaller로 제거되지 않기 때문에 삭제할 수 없는 파일의 목록은 다음과 같이 출력된다. 이 파일들은 그대로 두거나, 수작업으로 삭제한다.
[Done] 버튼을 클릭하여 JEUS Uninstaller를 종료한다.
제거된 사항의 적용을 위하여 컴퓨터를 재기동하거나 또는 로그오프 후 다시 로그인한다.
정상적으로 제거되었는지 다음 방법으로 확인한다.
파일과 디렉터리
%JEUS_HOME% 디렉터리의(기본: C:\TmaxSoft\JEUS6.0) 모든 하위 파일과 하위 폴더가 제거되었는지 확인한다.
Shortcuts
설치하는 동안에 생성된 ‘바로가기’ (프로그램 메뉴의 항목과 같은)가 제거되었는지 확인한다.
환경변수
다음 환경변수들이 제거되었는지를 확인하고, 만약 필요하다면 [시작] > [설정] > [제어판] > [시스템] > [고급] > [환경변수]에서 수동으로 제거한다(Windows 2000/ Windows 2003/ Windows XP/ Windows Vista).
Windows 명령 프롬프트에 set 명령으로 변수들을 확인할 수 있다. 만약 JEUS 제거 후에 컴퓨터를 재부팅했다면 갱신되어 있어야 한다.
PATH
시스템 PATH에서 JEUS 경로는 사라진다(예: “C:\TmaxSoft\JEUS6.0”).