설치 및 제거
본 장은 OpenFrame Manager의 설치와 제거 과정에 대해서 설명한다.
1. 설치
본 절은 콘솔 모드 UNIX/Linux 환경에서 OpenFrame Manager를 설치하는 방법을 설명한다.
|
다음은 텍스트 기반 셸을 실행해서 제품을 설치하는 과정에 대한 설명이다. 설치 과정은 시스템에 구별없이 동일하며, 설치 진행 중 이전 단계로 이동하려면 'back'을 입력하고, 설치를 중단하려면 'quit'을 입력하고 <Enter> 키를 누른다.
-
OpenFrame Manager 설치를 위해서는 해당 시스템에 맞는 인스톨러의 바이너리 파일이 필요하다. OpenFrame Manager 설치 인스톨러 바이너리 파일(OpenFrame_Manager7_1_1_Generic.bin)을 시스템의 원하는 위치에 복사한다.
-
설치 바이너리 파일에 실행 권한이 없는 경우 콘솔에서 "chmod a+x " 명령을 사용하여 실행 권한을 부여한다.
다음은 chmod a+x 명령을 사용하여 설치 인스톨러 바이너리 파일에 실행 권한을 부여하는 예제이다.
[oframejeus1@ofLinux64 ~]$ chmod a+x OpenFrame_Manager7_1_1_Generic.bin
-
설치 인스톨러 바이너리 파일 실행하는 방법은 다음 2가지 방법 중 하나를 선택하여 실행할 수 있다. 둘 중 하나의 방법을 선택하고 <Enter> 키를 누른다.
-
방법 1
./OpenFrame_Manager7_1_1_Generic.bin
-
방법 2
-
sh OpenFrame_Manager7_1_1_Generic.bin
-
설치 소개 화면이 나타나면 내용을 확인하고 <Enter> 키를 눌러 설치를 진행한다.
[oframejeus1@ofLinux64 ~]$ sh OpenFrame_Manager7_1_1_Generic.bin Preparing to install... Extracting the installation resources from the installer archive... Configuring the installer for this system's environment... Launching installer... Preparing CONSOLE Mode Installation... =============================================================================== OpenFrame Manager 7.1 Fix1_using_jeus8_5 (created with InstallAnywhere) ------------------------------------------------------------------------------- =============================================================================== Introduction ------------ InstallAnywhere will guide you through the installation of OpenFrame Manager 7.1 Fix1 It is strongly recommended that you quit all programs before continuing with this installation. Respond to each prompt to proceed to the next step in the installation. If you want to change something on a previous step, type 'back'. You may cancel this installation at any time by typing 'quit'. PRESS <ENTER> TO CONTINUE:
-
OpenFrame Manager 라이선스 준수 화면이 나타난다.
라이선스를 확인한 후 동의하면 'Y', 동의하지 않는 경우에는 'N'을 입력한 후 <Enter> 키를 누른다. 라이선스에 동의하지 않은 경우 OpenFrame Manager 설치는 중지된다.
=============================================================================== License Agreement ----------------- Installation and Use of OpenFrame Manager 7.1 Fix1 Requires Acceptance of the Following License Agreement: TmaxSoft Release TmaxSoft Co., Ltd. (hereafter, TmaxSoft) End-User License Agreement Product : OpenFrame Manager 7.1 Fix1 This is a legal agreement between you (either an individual or an company) and TmaxSoft, 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 OpenFrame Manager, 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 the number of licensed copies authorized. If you have multiple licenses for the software, 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 memory (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 number of applicable licenses, then you must have a reasonable PRESS <ENTER> TO CONTINUE: mechanism or process in place to ensure that the number of persons using the software concurrently does not exceed the number of licenses. 2. Copyright: The software (including any images, "applets," photographs, animations, 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 software to a single hard disk provided you keep the original solely for backup or archival 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 rights granted herein and must be retained by you. You may not rent, lease, or transfer your rights under this license on a permanent basis provided you transfer this license, the software, and all accompanying printed materials, retain no copies, and the recipient agrees to the terms of this license. You may not reverse engine, decompile, or disassemble the software, except to the extent that the foregoing restriction is expressly prohibited by applicable law. PRESS <ENTER> TO CONTINUE: DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N):
-
JEUS_HOME 디렉터리를 지정한다.
JEUS의 루트 디렉터리를 절대 경로로 입력한 후 <Enter> 키를 누른다. (기본값: $HOME/jeus8_5)
=============================================================================== Choose JEUS Folder ------------------ Note 1. This OpenFrame Manager7.1 Fix1 is available in the JEUS 8.5 environment. 2. In order to install OpenFrame Manager7.1 Fix1 successfully, Jeus's domainServer and DataBase must be running. 3. The tablespace to be used by the OpenFrameManager must be created before install. Please Enter JEUS HOME Default Install Folder: /home/oframe10/jeus8_5 ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT :
만약, 사용자가 지정한 JEUS_HOME 디렉터리를 찾을 수 없거나 JEUS 8.5 이하 버전을 선택하면 JEUS_HOME 디렉터리를 새로 지정하거나 설치를 중단할 것인지를 확인한다.
JEUS_HOME 디렉터리를 변경하는 경우 '1', 설치를 종료하는 경우 '2'를 선택하고 <Enter> 키를 누른다.
=============================================================================== JEUS Application Server Folder Not Found ---------------------------------------- Installer couldn’t find JEUS Application Server folder Chosen folder is not a JEUS_HOME. To choose a different folder, click 'Change'. To cancel the installation, click 'Quit'. ->1- Change 2- Quit ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
-
OpenFrame Manager를 설치할 JEUS의 도메인과 서버 정보들을 입력한다.
=============================================================================== Get Jeus Information -------------------- Plase Enter the DomainAdminServer Name and the ManagedServer name (Installation Server Folder) JEUS DomainAdminServer Name (DEFAULT: jeus_domain): JEUS ManagedServer Name (DEFAULT: server1): JEUS DomainAdminServer Password (DEFAULT: ): 1111111 JEUS DomainAdminServer IP (DEFAULT: 192.168.105.207): JEUS DomainAdminServer Base Port (DEFAULT: 9736):
다음은 설정 항목에 대한 설명이다.
항목 설명 JEUS DomainAdminServer Name
JEUS의 도메인 이름을 입력한다.
$JEUS_HOME/domains/ 하위의 <domain_name>을 지정한다.
(기본값: JEUS를 설치할 때 지정한 도메인명)
JEUS ManagedServer Name
OpenFrame Manager를 설치할 JEUS의 서버 이름을 입력한다.
$JEUS_HOME/domains/<domain_name>/servers/ 하위의 <server_name>을 지정한다. (기본값: server1)
JEUS DomainAdminServer Password
JEUS의 관리자(Administrator)의 패스워드를 입력한다. 기본값이 없으므로 반드시 입력해야 한다.
JEUS DomainAdminServer IP
JEUS의 DAS가 설치된 IP를 입력한다. (기본값: Local IP)
JEUS DomainAdminServer Base Port
JEUS의 DAS의 Base Port를 입력한다.
$JEUS_HOME/domains/<domain_name>/config/domain.xml에서 확인 가능하다. (기본값: 9736)
-
OpenFrame Manager에서 사용할 데이터베이스의 JDBC 드라이버의 벤더를 선택한다. (기본값: 1)
만약 '4- others'를 선택한 경우 데이터베이스 관련 정보가 모두 빈 값으로 설정되며, 설치 후 사용자가 수동으로 JEUS의 도메인 설정 및 OpenFrame Manager에서 필요한 SQL 문을 수행시켜야 한다.
=============================================================================== Get DataBase Information ------------------------ Choose vendor Name of JDBC driver ->1- Tibero 2- Oracle 3- MS-SQL 4- others ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: :
OpenFrame Manager는 기본적으로 Tibero 6 JDBC 드라이버를 기본으로 제공한다. 설치하는 환경에 따라 벤더의 JDBC 드라이버를 사용하는 데이터베이스 버전에 맞추어서 반드시 해당 위치에 넣어주어야 한다. (위치: $JEUS_HOME/lib/datasource)
-
OpenFrame Manager에서 운영할 데이터베이스 정보를 입력한다.
=============================================================================== Get DataBase Information ------------------------ Please Enter Database Information DataBase Server Name (DEFAULT: 192.168.105.207): DataBase Port (DEFAULT: ): 8444 DataBase Name (DEFAULT: ): oframe4 DataBase User ID (DEFAULT: ): tibero DataBase User PW (DEFAULT: ): tmax
다음은 설정 항목에 대한 설명이다.
항목 설명 DataBase Server Name
사용할 데이터베이스의 서버 이름을 입력한다. (기본값: Local IP)
DataBase Port
사용할 데이터베이스의 포트 번호를 입력한다. 기본값이 없으므로 반드시 입력해야 한다.
DataBase Name
사용할 데이터베이스의 이름를 입력한다. Oracle인 경우에만 SID 값을 입력한다. (기본값: $TB_SID)
DataBase User ID
사용할 데이터베이스의 User ID를 입력한다. 기본값이 없으므로 반드시 입력해야 한다.
DataBase User PW
사용할 데이터베이스의 User 패스워드를 입력한다. 기본값이 없으므로 반드시 입력해야 한다.
-
OpenFrame Manager 정보를 입력한다.
=============================================================================== Get OpenFrame Manager Information ------------------------- Enter requested information Datasource ID (DEFAULT: ds_ofm1): Application Name (DEFAULT: ofmanager): TABLESPACE Name (DEFAULT: OFMGR01):
다음은 설정 항목에 대한 설명이다.
항목 설명 Datasource ID
JEUS 설정 파일에 지정할 데이터소스 이름을 입력한다.
JEUS 설정 파일 $JEUS_HOME/domains/<domain_name>/config/domain.xml의 <data-source>에 추가되고, OpenFrame Manager 설정 파일 ofmanager.properties의 'ofmanager.datasource' 항목에 해당 값이 설정된다. 설정 파일에 대한 자세한 내용은 환경설정 및 TACF 리소스를 참고한다. (기본값: ds_ofm1)
Application Name
OpenFrame Manager의 애플리케이션 이름을 정의한다.
애플리케이션을 디플로이하는 경우 설정한 이름으로 사용된다.
JEUS 설정 파일 domain.xml의 <deployed-application>에 추가되고, 해당 애플리케이션 이름으로 디렉터리 이름이 생성된다.
(기본값: ofmanager)
TABLESPACE Name
OpenFrame Manager에서 사용할 테이블 영역 이름을 입력한다.
제품 설치 전 테이블 영역은 미리 생성되어 있어야 한다. 설치과정에서 관련 테이블들을 생성하는 스크립트에 해당 테이블 영역 이름이 삽입되어 설치가 진행된다. (기본값: DEFVOL)
-
OpenFrame Manager에서 사용할 메뉴들을 선택한다.
[Base] 메뉴는 기본으로 설치가 되므로 선택 항목에 존재하지 않는다. 콤마(,)를 사용해서 여러 개 메뉴 입력이 가능하다. 설치 후 ofmanager.properties 설정 파일의 'ofmanager.module' 항목에 설정된다. 설정된 메뉴는 변경이 가능하다. 설정 파일에 대한 자세한 내용은 환경설정 및 TACF 리소스를 참고한다.
=============================================================================== Check the menu to use. ------------------------ Check all the menus you want to use in the OpenFrame Manager. (Base menus are set by default.) ->1- Batch Manager (BM) ->2- TACF Manager (TM) 3- Online Manager (OSC) ->4- Online Manager (AIM) ENTER A COMMA-SEPARATED LIST OF NUMBERS REPRESENTING THE DESIRED CHOICES, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
현재 AIM 모듈의 경우 설치 후 ofmanager.properties 설정 파일의 'ofmanager.module' 항목을 변경해 사용해야 한다.
-
설치될 OpenFrame의 OS를 선택한다. (기본값: 1)
설치 후 ofmanager.properties 설정 파일의 'openframe.os' 항목에 설정된다. 설정된 값은 변경이 가능하다. 설정 파일에 대한 자세한 내용은 환경설정 및 TACF 리소스를 참고한다.
=============================================================================== Get OpenFrame OS Information. ----------------------------- Please Enter OpenFrame OS Information. (MVS is set by default.) ->1- MVS 2- MSP 3- XSP ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: :
-
설치될 OpenFrame 환경의 NODE 정보를 입력한다.
=============================================================================== Get Node Information -------------------- Please Enter node Information Node names must be separated by semicolons. NodeList (DEFAULT: NODE1;NODE2): NODE1;NODE2 DefaultNode (DEFAULT: NODE1): NODE1
다음은 설정 항목에 대한 설명이다. ofmanager.properties 설정 파일에 대한 자세한 내용은 환경설정 및 TACF 리소스를 참고한다.
항목 설명 NodeList
OpenFrame 환경의 노드명을 모두 입력한다.
노드가 여러 개일 경우 각 노드는 세미콜론(;)으로 구분되어야 한다.
(기본값: NODE1;NODE2)
DefaultNode
OpenFrame Manager에서 기본으로 사용할 노드를 입력한다.
(기본값: NODE1)
-
OpenFrame Manager에서 [OSC] 또는 [AIM] 메뉴를 사용하는 경우 연동할 OpenFrame GW 정보를 입력해야 한다. 이 단계는 이전 단계에서 '3- Online Manager (OSC)' 또는 4- Online Manager (AIM)을 포함하여 선택한 경우에만 수행한다.
=============================================================================== Get Online Information ----------------------------- Enter requested information Webterminal IP (DEFAULT: 192.168.105.207): 192.168.105.191 Webtermianl Application Name (DEFAULT: webterminal): webterminal7 OpenFrame GW LU PORT (DEFAULT: 5556): 5699 OpenFrame GW Name (DEFAULT: ofgw): ofgw7
다음은 설정 항목에 대한 설명이다. 설정한 값들은 OpenFrame Manager를 설치한 후 ofmanager.properties 설정 파일에 반영된다. 설정 파일에 대한 자세한 내용은 환경설정 및 TACF 리소스를 참고한다.
항목 설명 Webterminal IP
웹 터미널(Webterminal)이 설치되어 있는 IP를 입력한다.
OpenFrame Manager를 설치한 후 ofmanager.properties 설정 파일의 'openframe.webterminal.url' 항목에 해당 값이 설정된다.
(기본값: Local IP)
Webtermianl Application Name
웹 터미널의 애플리케이션 이름을 입력한다.
웹 터미널이 디플로이되어 있는 JEUS 설정 파일(domain.xml)에서 확인 가능하다. OpenFrame Manager를 설치한 후 ofmanager.properties 설정 파일의 'openframe.webterminal.url' 항목에 해당 값이 설정된다.
(기본값: webterminal)
OpenFrame GW LU PORT
OpenFrame GW에서 사용하는 LU port를 입력한다.
OpenFrame GW의 설정 파일($OFGW_HOME/ofgwconf/ofgw.properties)의 'lu.port' 항목에서 확인 가능하다. OpenFrame Manager를 설치한 후 ofmanager.properties 설정 파일의 'openframe.webterminal.url' 항목에 해당 값이 설정된다. (기본값: 5556)
OpenFrame GW Name
OpenFrame GW의 이름을 입력한다.
OpenFrame GW의 설정 파일(ofgw.properties)의 'gw.name' 항목에서 확인 가능하다. OpenFrame Manager를 설치한 후 ofmanager.properties 설정 파일의 'openframe.webterminal.name' 항목에 해당 값이 설정된다. (기본값: ofgw)
-
OpenFrame Manager가 접속할 Tmax 서버의 접속 정보를 입력한다.
=============================================================================== Get Tmax Information -------------------- Enter requested information ($OPENFRAME_HOME/core/config/oframe.m) Tmax NODE IP (DEFAULT: 192.168.105.207): Tmax NODE PORT (DEFAULT: ): 4394
다음은 설정 항목에 대한 설명이다. ofmanager.properties 설정 파일에 대한 환경설정 및 TACF 리소스를 참고한다.
항목 설명 Tmax NODE IP
설치된 Tmax IP를 입력한다.
OpenFrame Manager를 설치한 후 ofmanager.properties 설정 파일의 'openframe.tmax.ip' 항목에 해당 값이 설정된다. (기본값: Local IP)
Tmax NODE PORT
Tmax 포트 번호를 입력한다.
OpenFrame Manager를 설치한 후 ofmanager.properties 설정 파일의 'openframe.tmax.port' 항목에 해당 값이 설정된다.
(기본값: $TMAX_HOST_PORT)
-
발급받은 OpenFrame Manager 라이선스 위치를 절대 경로와 라이선스 파일명까지 입력한다. 설치 후 제품 내부적으로 지정된 디렉터리로 OpenFrame Manager 라이선스가 복사된다.
=============================================================================== Get OpenFrame Manager license Path -------------------------- Enter requested information ex) /home/user/license/OFManagerLicense OpenFrame Manager License Path (DEFAULT: ): /home/oframejeus1/License/OFManagerLicense
-
OpenFrame Manager를 설치할 때 설정 사항을 반영하기 위해서 OpenFrame Manager가 설치되는 JEUS 서버 재기동 여부를 선택한다.
=============================================================================== Restart ManagedServer --------------------- Do you want to restart the server(server1)? (To apply the changes, restart the server.) ->1- Yes 2- No ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
다음은 설정 항목에 대한 설명이다.
항목 설명 1- Yes
OpenFrame Manager가 설치되는 JEUS의 해당 서버에 애플리케이션 디플로이와 설정 사항이 반영되도록 서버를 재기동한다. (기본값)
2- No
설치 이후 사용자가 스크립트를 실행 및 수동으로 재기동해야 설정 사항이 반영된다. 자세한 내용은 수동 환경설정을 참고한다.
-
설치에 관련된 요약정보를 조회한다.
설정된 내용은 확인하고 <ENTER> 키를 누르면 설치가 진행된다. 설정된 내용을 수정하려면 'quit'를 입력해서 설치를 중단하고 새로 설치하거나 'back'을 입력해서 수정할 단계로 이동한다.
=============================================================================== Pre-Installation Summary ------------------------ Please Review the Following Before Continuing: Product Name: OpenFrame Manager 7.1 Fix1_using_jeus8_5 JEUS_HOME /home/oframejeus1/jeus8_5 Jeus DomainAdminServer Name jeus_domain Jeus DomainAdminServer PORT 9736 Jeus ManagerServer Name server1 Data Source ID ds_ofm1 Application Name ofmanager Manager TableSpace Name DEFVOL OpenFrame OS mvs OpenFrame Node List NODE1;NODE2 OpenFrame Default Node NODE1 Tmax NODE IP 192.168.105.207 Tmax NODE PORT 4394 OpenFrame Manager License PATH /home/oframejeus1/License/OFManagerLicense OpenFrame Manager Menus BM;TM;OSC; Disk Space Information (for Installation Target): Required: 71,953,592 bytes Available: 851,980,222,464 bytes PRESS <ENTER> TO CONTINUE:
-
설치가 진행되는 동안 진행 과정을 확인할 수 있다.
=============================================================================== Installing... ------------- [==================|==================|==================|==================] [------------
-
설치가 완료되면 아래와 같은 설치 완료 메시지가 출력된다.
=============================================================================== Installation Complete --------------------- Congratulations! OpenFrame Manager 7.1 Fix1 has been successfully installed to: /home/oframejeus1/jeus8_5/domains/jeus_domain/servers/server1/lib/application/ofmanager Press Done to quit the installer. PRESS <ENTER> TO EXIT THE INSTALLER:
2. 수동 환경설정
설치 중 Restart ManagedServer 과정(위 설치 단계의 15번)에서 OpenFrame Manager 설치할 대상 서버 재기동 여부를 'No'로 선택한 경우에는 스크립트 수행에 오류가 발생할 수 있고, JEUS 서버나 DB 서버의 비정상적인 기동 상태, 설치 과정에서 잘못된 입력값 등의 문제가 발생 할 수 있다. 이때 OpenFrame Manager 관련한 JEUS의 설정을 수동으로 재설정하거나 스크립트를 직접 수행해야 한다.
서버 재기동 여부를 'Yes'를 선택한 경우나 정상 설치 후 기동이 완료된 경우에는 본 절에 설명한 과정을 생략한다. |
2.1. 스크립트 파일
수동 환경설정에 필요한 스크립트는 다음의 위치에 저장되어 있다.
$JEUS_HOME/domains/<domain_name>/servers/<server_name>/lib/application/ <application_name>/scripts/
위 경로에 있는 있는 파일을 jeusadmin 툴을 이용하여 실행하면 OpenFrame Manager에 필요한 환경을 수동으로 설정할 수 있다.
다음은 수동으로 실행되어야 하는 스크립트에 대한 설명이다.
파일명 | 설명 |
---|---|
datasource.sh |
OpenFrame Manager에서 사용하는 <data-source>를 추가하고 서버에 적용한다. |
deploy.sh |
OpenFrame Manager에서 제공하는 ofmanager 애플리케이션을 디플로이한다. 디플로이를 위하여 서버를 재기동하고, 재기동 이후 애플리케이션 정보를 확인한다. |
undeploy.sh |
OpenFrame Manager에서 제공하는 ofmanager 애플리케이션을 undeploy한다. 삭제 과정에서 수행되는 스크립트이다. |
만약 OpenFrame Manager 사용에 문제가 있는 경우 해당 설치 과정을 재실행하거나 JEUS 도메인 설정에서 OpenFrame Manager 설정을 다시 확인한다. |
수동으로 DB 테이블 작업을 위한 스크립트는 다음 위치에 저장되어 있다.
$JEUS_HOME/domains/<domain_name>/servers/<server_name>/lib/application/<application_name>/scripts/sql
다음은 스크립트에 대한 설명이다.
파일명 | 설명 |
---|---|
create_tables.sql |
OpenFrame Manager에서 필요한 테이블, 인덱스를 생성하는 SQL 스크립트이다. OpenFrame Manager 설치과정에서 사용자로부터 입력받은 테이블 영역의 정보가 스크립트 안에 적용된다. |
create_tables.java |
create_tables.sql에 정의된 SQL 문을 실행시키는 소스코드이다. OpenFrame Manager 설치과정에서 사용자로부터 입력받은 DB 정보가 소스코드 안에 적용된다. |
create_compile.sh |
create_tables.java 소스코드를 JDBC 드라이버를 이용하여 컴파일 및 실행시키는 셸 스크립트이다. create_compile.sh 스크립트는 설치과정에서 수행되는 스크립트이다. 수동 설치하는 경우에도 수행시키면 된다. |
drop_tables.sql |
OpenFrame Manager에서 필요한 테이블, 인덱스를 삭제하는 SQL 스크립트이다. |
drop_tables.java |
drop_tables.sql에 정의된 SQL 문을 실행시키는 소스코드이다. OpenFrame Manager 설치과정에서 사용자로부터 입력받은 DB 정보가 소스코드 안에 적용된다. |
drop_compile.sh |
drop_tables.java 소스코드를 JDBC 드라이버를 이용하여 컴파일 및 실행시키는 셸스크립트이다. drop_compile.sh 스크립트는 삭제과정에서 수행되는 스크립트이다. 수동 삭제하는 경우에도 수행시키면 된다. |
2.2. 스크립트 실행
다음은 OpenFrame Manager에서 제공하는 datasource.sh, deploy.sh을 수행해서 수동으로 JEUS 환경설정을 하는 과정에 대한 설명이다.
-
JEUS가 설치된 경로의 다음 위치에서 domain.xml을 찾는다. OpenFrame Manager를 설치하는 경로에 domain_ofmanager_sample.xml 샘플 파일을 제공하므로 참고하도록 한다.
$JEUS_HOME/domains/<domain_name>/config/
-
domain.xml에 데이터소스 관련 <data-source>와 애플리케이션 관련 <deployed-application>, <database>를 추가해서 OpenFrame Manager 정보를 설정한다.
다음은 OpenFrame Manager를 설치한 서버 server1을 설정한 예제이다.
<?xml version="1.0" encoding="UTF-8"?> <domain xmlns="http://www.tmaxsoft.com/xml/ns/jeus" version="8.5"> ..... <server> <name>server1</name> <node-name>ofLinux64s</node-name> <listeners> <base>BASE</base> <listener> <name>BASE</name> <listen-port>9936</listen-port> <use-nio>true</use-nio> <selectors>1</selectors> <use-dual-selector>false</use-dual-selector> <backlog>128</backlog> <select-timeout>120000</select-timeout> <read-timeout>30000</read-timeout> <reserved-thread-num>0</reserved-thread-num> </listener> <listener> <name>http-server1</name> <listen-port>8088</listen-port> <use-nio>true</use-nio> <selectors>1</selectors> <use-dual-selector>false</use-dual-selector> <backlog>128</backlog> <select-timeout>120000</select-timeout> <read-timeout>30000</read-timeout> <reserved-thread-num>0</reserved-thread-num> </listener> ..... <!-- OpenFrame Manager Datasource Start --> <data-sources> <data-source>ds_ofm1</data-source> </data-sources> <!-- OpenFrame Manager Datasource End --> </server> </servers> <deployed-applications> <!-- OpenFrame Manager DEPLOY Start --> <deployed-application> <id>ofmanager</id> <path> /home/oframejeus1/jeus8_5/domains/jeus_domain/servers/server1/lib/application/ofmanager/ </path> <type>WAR</type> <targets> <server> <name>server1</name> </server> </targets> <options> <classloading>ISOLATED</classloading> <fast-deploy>false</fast-deploy> <keep-generated>false</keep-generated> <shared>false</shared> <security-domain-name>SYSTEM_DOMAIN</security-domain-name> </options> </deployed-application> <!-- OpenFrame Manager DEPLOY End --> </deployed-applications> <resources> <data-source> <!-- OpenFrame Manager Datasource Start --> <database> <data-source-id>ds_ofm1</data-source-id> <export-name>ds_ofm1</export-name> <data-source-class-name> com.tmax.tibero.jdbc.ext.TbConnectionPoolDataSource </data-source-class-name> <data-source-type>ConnectionPoolDataSource</data-source-type> <vendor>tibero</vendor> <server-name>192.168.105.207</server-name> <port-number>8444</port-number> <database-name>oframe4</database-name> <user>tibero</user> <password>tmax</password> <login-timeout>0</login-timeout> <auto-commit>DRIVER</auto-commit> <stmt-query-timeout>0</stmt-query-timeout> <pool-destroy-timeout>10000</pool-destroy-timeout> <support-xa-emulation>false</support-xa-emulation> <connection-pool> <pooling> <min>2</min> <max>30</max> <step>1</step> <period>3600000</period> </pooling> <wait-free-connection> <enable-wait>false</enable-wait> <wait-time>10000</wait-time> </wait-free-connection> <max-use-count>0</max-use-count> <dba-timeout>-1</dba-timeout> <stmt-caching-size>-1</stmt-caching-size> <stmt-fetch-size>-1</stmt-fetch-size> <connection-trace> <enabled>false</enabled> <get-connection-trace>true</get-connection-trace> <auto-commit-trace>false</auto-commit-trace> </connection-trace> <use-sql-trace>false</use-sql-trace> <keep-connection-handle-open>false</keep-connection-handle-open> </connection-pool> </database> <!-- OpenFrame Manager Datasource End --> </data-source> </resources> </domain>
설정에 대한 자세한 설명은 "JEUS XML Reference"를 참고한다.
-
domain.xml에 설정한 정보를 서버에 반영하기 위해서 JEUS 서버(server1)를 재기동(부팅)해야 한다. 관련된 내용은 JEUS 서버 기동 및 종료를 참고한다.
3. 설치 확인
OpenFrame Manager의 설치가 완료되면 정상적인 설치가 되었는지 확인한다.
3.1. 인스톨 로그 확인
인스톨러로 설치하는 경우 설치과정 및 결과를 인스톨 로그에서 확인이 가능하다.
$OFMANAGER_HOME/UninstallerData/log/install_script.log
해당 로그 파일에서 아래 순서로 설치과정 내용을 확인할 수 있다.
-
라이선스 복사
-
<data-source> 추가 및 적용
-
DB 테이블 및 인덱스 생성
-
JEUS(Managed Server) 서버 재기동
-
애플리케이션 디플로이
-
디플로이된 애플리케이션 상태 확인
다음은 OpenFrame Manager를 server1에 설치한 install_script.log 내용이다.
### [Install Scripts Start] #1 [Copy OpenFrame Manager License] [OpenFrame Manager License] License copy Complete. #2 [Run datasource.sh] ** Run Jeusadmin (Data-source) ** ** Run Add data-source ** Attempting to connect to 192.168.105.184:9736. The connection has been established to Domain Administration Server adminServer in the domain ofgw_domain. The specified data source [ds_ofm1] already exists in domain.xml, so it cannot be added. ** Run Add Data-sources to server ** Attempting to connect to 192.168.105.184:9736. The connection has been established to Domain Administration Server adminServer in the domain ofgw_domain. Successfully performed the ADD operation for data sources to the server [server1]. Check the results using "add-data-sources-to-server -server server1" ** End Jeusadmin (Data-source) ** #3 [Run create_compile.sh]* ===================================== DB_DRV : oracle.jdbc.driver.OracleDriver DB_URL : jdbc:oracle:thin:@192.168.105.64:1521:ORCL12C DB_ID : c##oframe5 DB_PWD : tmax123 ------------------------------------- DB Connect Success ===================================== ===================================== SQL File : create_tables.sql DB SQL Excute Success ===================================== #4 [Run deploy.sh] *** Server restart result : 0 *** Run Jeusadmin (Server Stop/Start) *** ** Run Stop Server ** Attempting to connect to 192.168.105.207:9736. The connection has been established to Domain Administration Server adminServer in the domain jeus_domain. Server [server1] was successfully stopped. ** Run Start Server ** /home/oframejeus1/jeus8_5/bin *************************************************************** - JEUS Home : /home/oframejeus1/jeus8_5 - JEUS Base Port : - Java Vendor : Sun - Added Java Option : *************************************************************** =============== JEUS LICENSE INFORMATION ================ == VERSION : JEUS 8.5 (8.5.0.0-b266025) == EDITION: Enterprise (Trial License) == NOTICE: This license restricts the number of allowed clients. == Max. Number of Clients: 5 ========================================================== [2017.07.01 00:09:00][2] [launcher-1] [SERVER-0201] Successfully connected to the Domain Administration Server(192.168.105.207:9736). [2017.09.05 00:09:00][2] [launcher-1] [Launcher-0058] All local configurations are up-to-date. ... [2017.09.05 00:09:05][2] [server1-12] [ShoalTransport-0010] Connection of SocketStream@2aa60941(192.168.105.207:9336(GMS) -> 192.168.105.207:9736(GMS)) has been allowed. [2017.09.05 00:09:05][2] [server1-1] [EJB-5501] EJB engine started successfully. [2017.09.05 00:09:05][2] [server1-1] [JMS-7374] The persistence store manager for the JMS broker 'server1' has been started. [2017.09.05 00:09:05][2] [server1-1] [JMS-6822] The JMS engine with the broker named server1 has started. [2017.09.05 00:09:05][2] [server1-1] [WEB-1003] Socket send buffer size of this operating system = [8192], JEUS default output buffer size = [8192] [2017.09.05 00:09:06][2] [server1-1] [WEB-1030] The web engine has started successfully. [2017.09.05 00:09:06][2] [server1-1] [SERVER-0248] The JEUS server is STANDBY. [2017.09.05 00:09:06][2] [server1-1] [SERVER-0248] The JEUS server is STARTING. [2017.09.05 00:09:06][2] [server1-1] [WEB-3413] The web engine is ready to receive requests. [2017.09.05 00:09:06][2] [server1-1] [UNIFY-0100] Listener information base (plain, 192.168.105.207 : 9336) - VIRTUAL - SecurityServer - FileTransfer - JNDI - JMXConnectionServer/JeusMBeanServer - JMXConnectionServer/JEUSMP_server1 - GMS-NetworkManager - TransactionManager - JMSServiceChannel-default - HTTP Listener http-server1 (plain, 0.0.0.0 : 8588) - HTTP Listener [2017.09.05 00:09:06][0] [server1-1] [SERVER-0242] Successfully started the server. [2017.09.05 00:09:06][2] [server1-1] [SERVER-0248] The JEUS server is RUNNING. [2017.09.05 00:09:06][2] [server1-1] [SERVER-0401] The elapsed time to start: 3891ms. [2017.09.05 00:09:06][2] [launcher-10] [Launcher-0034] The server[server1] initialization completed successfully[pid : 21247]. [2017.09.05 00:09:06][0] [launcher-1] [Launcher-0040] Successfully started the server. The server state is now RUNNING. *** End Jeusadmin (Server Stop/Start) *** *** Run Jeusadmin (deploy) *** ** Run deploy-application ** Attempting to connect to 192.168.105.207:9736. The connection has been established to Domain Administration Server adminServer in the domain jeus_domain. deploy the application for the application [ds_ofm1] succeeded. ** Run application info ** Attempting to connect to 192.168.105.207:9736. The connection has been established to Domain Administration Server adminServer in the domain jeus_domain. Application information for the domain [jeus_domain]. ================================================================================ +---------+----------+--------+---------+----------+----------------------------+ | Applicat| Applicati| State | Target | Target | Application Path | | ion ID | on Type | | Servers | Clusters | | +---------+----------+--------+---------+----------+----------------------------+ |ofmanager| WAR |RUNNING | server1 | |/home/oframejeus1/jeus8_5/do| | | | | | |mains/jeus_domain/servers/se| | | | | | |rver1/lib/application/ofmana| | | | | | |ger | +---------+----------+--------+---------+----------+-------------------------- ================================================================================ *** End Jeusadmin (deploy) *** ### [Install Scripts End]
3.2. 환경설정 확인
설치한 계정의 UNIX profile(환경설정 파일)에 $OFMANAGER_HOME 경로 설정이 추가된 것을 확인할 수 있다.
OFMANAGER_HOME=/home/oframejeus1/jeus8_5/domains/jeus_domain/servers/server1/lib/application/ofmanager export OFMANAGER_HOME
3.3. DB 정보 확인
OpenFrame Manager에서 사용하는 테이블들과 인덱스가 정상적으로 생성되었는지 확인한다. 설치과정에서 입력한 DB 계정에서 확인할 수 있다.
SQL> SELECT TABLE_NAME FROM ALL_TABLES WHERE TABLE_NAME LIKE 'OFM_MGR_PGM%' OR TABLE_NAME LIKE 'OFM_OFMANAGER%'; TABLE_NAME -------------------------------------------------------------------------------------------------------------------------------- OFM_MGR_PGM_ADMIN OFM_MGR_PGM_DPLY_HISTORY OFM_MGR_PGM_DPLY_INFO OFM_OFMANAGER_LOG_READ OFM_OFMANAGER_TRAN_STATICS 5 rows selected. SQL> SELECT INDEX_NAME FROM ALL_INDEXES WHERE INDEX_NAME LIKE 'OFM_MGR_PGM%'; INDEX_NAME -------------------------------------------------------------------------------------------------------------------------------- OFM_MGR_PGM_DPLY_INFO_IDX OFM_MGR_PGM_DPLY_HISTORY_IDX1 2 rows selected.
3.4. JEUS 서버 기동 확인
정상적으로 설치를 완료하면 JEUS 서버(Managed Server)가 기동된 상태로 되어 있다. JEUS의 서버(Managed Server)가 기동될 때 OpenFrame Manager도 함께 기동되고, OpenFrame Manager의 라이선스 정합성도 체크한다. JEUS의 DAS와 MS가 정상 기동되었는지 프로세스와 로그를 확인한다.
-
프로세스 확인
Java에서 제공하는 jps 툴로 해당 프로세스가 기동되었는지 확인할 수 있다.
[oframejeus1@ofLinux64 ~]$ jps 28754 DomainAdminServerBootstrapper 30160 Jps 29642 ServerBootstrapper
-
로그 확인
다음의 로그를 확인해서 서버와 OpenFrame Manager가 정상 기동되었는지 확인한다.
-
DAS 관련 로그
$JEUS_HOME/domains/<domain_name>/servers/adminServer/logs/JeusServer.log
-
MS 관련 로그
$JEUS_HOME/domains/<domain_name>/servers/<server_name>/logs/JeusServer.log
-
OpenFrame Manager 로그
logback.xml을 환경에 맞게 커스터마이징한 경우 OpenFrame Manager의 로그는 logback.xml에 지정된 위치의 파일에 기록된다. (디폴트 경로 예제)
$JEUS_HOME/domains/<domain_name>/servers/<server_name>/lib/application/<application_name>/ logs/ofmanager_{mm-dd-yyyy.#}.log
-
WebT 관련 로그
OpenFrame Manager에서 사용하는 WebT 관련 로그이다.
$JEUS_HOME/domains/<domain_name>/servers/<server_name>/lib/application/<application_name>/ logs/webt_{mm-dd-yyyy.#}.log
-
3.5. OpenFrame Manager 기동
JEUS가 정상 기동되면 사용자 컴퓨터에서 인터넷 브라우저를 실행한 후 주소 입력란에 OpenFrame Manager 접속 정보를 입력해서 OpenFrame Manager를 실행할 수 있다.
http://{JEUS가 설치된 IP}:{JEUS 서버의 HTTP 포트}/{Application Name}
현재 OpenFrame Manager는 Chrome, Edge, Firefox, Opera 브라우저를 지원한다. Internet Explorer는 지원하지 않는다. |
다음의 파일에서 JEUS가 설치된 IP와 JEUS 서버의 HTTP 포트 정보와 애플리케이션 이름을 확인할 수 있다.
$JEUS_HOME/domains/<domain_name>/config/domain.xml
다음은 JEUS 서버(server1)에 HTTP Listener PORT(8088), 'ofmanager'의 이름으로 OpenFrame Manager 애플리케이션이 디플로이된 domain.xml 예이다.
<?xml version="1.0" encoding="UTF-8"?> <domain xmlns="http://www.tmaxsoft.com/xml/ns/jeus" version="8.5"> ... <servers> <server> <name>server1</name> <node-name>ofLinux64</node-name> <listeners> <base>BASE</base> ... <listener> <name>http-server1</name> <listen-port>8088</listen-port> <use-nio>true</use-nio> <selectors>1</selectors> <use-dual-selector>false</use-dual-selector> <backlog>128</backlog> <select-timeout>120000</select-timeout> <read-timeout>30000</read-timeout> <reserved-thread-num>0</reserved-thread-num> </listener> ... <deployed-application> <id>ofmanager</id> <path> /home/oframejeus1/jeus8_5/domains/jeus_domain/servers/server1/lib/application/ofmanager </path> <type>WAR</type> <targets> <server> <name>server1</name> </server> </targets> <options> <classloading>ISOLATED</classloading> <fast-deploy>false</fast-deploy> <keep-generated>false</keep-generated> <shared>false</shared> </options> </deployed-application> ...
위 정보를 기준으로 인터넷 브라우저의 주소 입력란 다음의 주소를 입력하면 OpenFrame Manager 애플리케이션에 접속할 수 있다.
http://192.168.105.207:8088/ofmanager
OpenFrame Manager 애플리케이션에 접속하면 다음의 화면이 나타난다. OpenFrame Manager 로그인 화면에서 입력 항목 'ID'와 'Password'를 입력한 후 [Login] 버튼을 클릭한다.
4. 제거
본 절에서는 OpenFrame Manager를 제거하는 과정에 대해서 설명한다.
OpenFrame Manager를 제거하는 과정에서 jeusadmin 명령어인 undeploy-application가 수행된다. DAS가 종료 상태에서 제거하면 undeploy-application이 수행되지 않아서 JEUS의 domain 설정에 OpenFrame Manager 애플리케이션이 그대로 남아 있을 수 있다. 따라서 OpenFrame Manager를 제거하기 전에 JEUS의 DAS는 기동 상태여야 한다. |
다음은 OpenFrame Manager를 제거하는 과정에 대한 설명이다.
-
아래 경로에 있는 OFMANAGER_Uninstall 셸을 실행하거나 설치 폴더에 있는 콘솔 명령어를 실행해서 제거한다.
$JEUS_HOME/domains/<domain_name>/servers/<server_name>/lib/application/<application_name>/UninstallerData
-
다음은 OFMANAGER_Uninstall 셸을 사용해서 OpenFrame Manager를 제거하는 과정이다.
[oframejeus1@ofLinux64 UninstallerData]$ sh OFMANAGER_Uninstall Preparing CONSOLE Mode Installation... =============================================================================== OpenFrame Manager 7.1 Fix1 (created with InstallAnywhere by Macrovision) ------------------------------------------------------------------------------- =============================================================================== Uninstall OpenFrame Manager 7.1 Fix1 -------------------- About to uninstall... OpenFrame Manager 7.1 Fix1 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 ------------------ Some items could not be removed.
5. 제거 확인
OpenFrame Manager가 정상적으로 제거되었는지 다음과 같이 확인한다.
-
파일 및 폴더 확인
인스톨러에서 지정했던 설치 디렉터리가 완전히 삭제되었는지 확인한다. 설치할 때 생성되는 디렉터리 구조 외 다른 디렉터리를 생성했다면 해당 디렉터리는 남을 수 있다. 이것은 정상이므로 수동으로 삭제한다.
-
환경설정 확인
OpenFrame Manager를 설치할 때 설정된 환경변수 $OFMANAGER_HOME이 정상적으로 삭제되었는지 확인한다. JEUS 도메인 설정 파일에서 설치할 때 설정되었던 <deployed-application> 절과 설치된 MS의 <data-source> 절이 삭제되었는지 확인한다. 단, <resources> 절 아래의 <database> 절은 다른 MS에서도 참조하여 사용할 수 있으므로 삭제되지 않는다.
-
DB 테이블 확인
OpenFrame Manager를 설치할 때 생성된 DB 테이블들이 정상적으로 삭제되었는지 확인한다.