설치 및 제거

본 장은 OpenFrame Manager의 설치와 제거 과정에 대해서 설명한다.

1. 설치

본 절은 콘솔 모드 UNIX/Linux 환경에서 OpenFrame Manager를 설치하는 방법을 설명한다.

  1. 설치 과정은 JEUS 8.5를 설치했다는 가정 하에 기술한다. 설치할 JEUS 서버가 생성 및 기동되어 있어야 하며, Domain Administration Server(이하 DAS)에 설치하는 것보다는 운영을 위하여 별도의 Managed Server(이하 MS)에 OpenFrame Manager를 설치하는 것을 권장한다. JEUS 서버 생성에 대한 자세한 내용은 "JEUS Server 안내서"의 "2.2. 서버 추가"를 참고한다.

  2. 설치 과정에서 DB SQL 문 수행이 필요하므로, 데이터베이스 서버가 기동되어 있어야 한다.

  3. 재설치를 위해서는 OpenFrame Manager를 정상적으로 제거한 뒤에 재설치를 해야 한다. 만약 그렇지 않을 경우 정상적으로 설치되지 않는다. 본 과정은 처음 설치하는 것을 전제로 한다.

다음은 텍스트 기반 셸을 실행해서 제품을 설치하는 과정에 대한 설명이다. 설치 과정은 시스템에 구별없이 동일하며, 설치 진행 중 이전 단계로 이동하려면 'back'을 입력하고, 설치를 중단하려면 'quit'을 입력하고 <Enter> 키를 누른다.

  1. OpenFrame Manager 설치를 위해서는 해당 시스템에 맞는 인스톨러의 바이너리 파일이 필요하다. OpenFrame Manager 설치 인스톨러 바이너리 파일(OpenFrame_Manager7_1_1_Generic.bin)을 시스템의 원하는 위치에 복사한다.

  2. 설치 바이너리 파일에 실행 권한이 없는 경우 콘솔에서 "chmod a+x " 명령을 사용하여 실행 권한을 부여한다.

    다음은 chmod a+x 명령을 사용하여 설치 인스톨러 바이너리 파일에 실행 권한을 부여하는 예제이다.

    [oframejeus1@ofLinux64 ~]$ chmod a+x OpenFrame_Manager7_1_1_Generic.bin
  3. 설치 인스톨러 바이너리 파일 실행하는 방법은 다음 2가지 방법 중 하나를 선택하여 실행할 수 있다. 둘 중 하나의 방법을 선택하고 <Enter> 키를 누른다.

    • 방법 1

      ./OpenFrame_Manager7_1_1_Generic.bin
    • 방법 2

sh OpenFrame_Manager7_1_1_Generic.bin
  1. 설치 소개 화면이 나타나면 내용을 확인하고 <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:
  2. 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):
  3. 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:
  4. 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)

  5. 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)

  6. 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 패스워드를 입력한다. 기본값이 없으므로 반드시 입력해야 한다.

  7. 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)

  8. 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' 항목을 변경해 사용해야 한다.

  9. 설치될 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:
       :
  10. 설치될 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)

  11. 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)

  12. 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)

  13. 발급받은 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
  14. 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

    설치 이후 사용자가 스크립트를 실행 및 수동으로 재기동해야 설정 사항이 반영된다. 자세한 내용은 수동 환경설정을 참고한다.

  15. 설치에 관련된 요약정보를 조회한다.

    설정된 내용은 확인하고 <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:
  16. 설치가 진행되는 동안 진행 과정을 확인할 수 있다.

    ===============================================================================
    Installing...
    -------------
     [==================|==================|==================|==================]
     [------------
  17. 설치가 완료되면 아래와 같은 설치 완료 메시지가 출력된다.

    ===============================================================================
    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 환경설정을 하는 과정에 대한 설명이다.

  1. JEUS가 설치된 경로의 다음 위치에서 domain.xml을 찾는다. OpenFrame Manager를 설치하는 경로에 domain_ofmanager_sample.xml 샘플 파일을 제공하므로 참고하도록 한다.

    $JEUS_HOME/domains/<domain_name>/config/
  2. 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"를 참고한다.

  3. domain.xml에 설정한 정보를 서버에 반영하기 위해서 JEUS 서버(server1)를 재기동(부팅)해야 한다. 관련된 내용은 JEUS 서버 기동 및 종료를 참고한다.

3. 설치 확인

OpenFrame Manager의 설치가 완료되면 정상적인 설치가 되었는지 확인한다.

3.1. 인스톨 로그 확인

인스톨러로 설치하는 경우 설치과정 및 결과를 인스톨 로그에서 확인이 가능하다.

$OFMANAGER_HOME/UninstallerData/log/install_script.log

해당 로그 파일에서 아래 순서로 설치과정 내용을 확인할 수 있다.

  1. 라이선스 복사

  2. <data-source> 추가 및 적용

  3. DB 테이블 및 인덱스 생성

  4. JEUS(Managed Server) 서버 재기동

  5. 애플리케이션 디플로이

  6. 디플로이된 애플리케이션 상태 확인

다음은 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] 버튼을 클릭한다.

figure login
OpenFrame Manager 로그인 화면
figure main
OpenFrame Manager 메인 화면

4. 제거

본 절에서는 OpenFrame Manager를 제거하는 과정에 대해서 설명한다.

OpenFrame Manager를 제거하는 과정에서 jeusadmin 명령어인 undeploy-application가 수행된다.

DAS가 종료 상태에서 제거하면 undeploy-application이 수행되지 않아서 JEUS의 domain 설정에 OpenFrame Manager 애플리케이션이 그대로 남아 있을 수 있다. 따라서 OpenFrame Manager를 제거하기 전에 JEUS의 DAS는 기동 상태여야 한다.

다음은 OpenFrame Manager를 제거하는 과정에 대한 설명이다.

  1. 아래 경로에 있는 OFMANAGER_Uninstall 셸을 실행하거나 설치 폴더에 있는 콘솔 명령어를 실행해서 제거한다.

    $JEUS_HOME/domains/<domain_name>/servers/<server_name>/lib/application/<application_name>/UninstallerData
  2. 다음은 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 테이블들이 정상적으로 삭제되었는지 확인한다.