설치 및 제거

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

1. 설치

본 절에서는 콘솔 모드 Unix/Linux 환경에서 OpenFrame GW를 설치하는 방법에 대해서 설명한다.

  1. 설치 과정은 JEUS 8.5를 설치했다는 가정 하에 기술한다. 설치할 JEUS 서버가 생성 및 기동되어 있어야 하며, adminServer에 설치하는 것보다는 운영을 위하여 별도의 서버에 OpenFrame GW를 설치하는 것을 권장한다. JEUS 서버 생성 관련해서는 "JEUS Server 안내서"의 "2.2. 서버 추가"를 참고한다.

  2. 이미 설치한 경우에는 반드시 제거한 뒤에 재설치해야 한다. 만약 그렇지 않을 경우 정상적으로 설치되지 않으므로, 처음 설치하는 것을 전제로 한다.

OpenFrame GW 설치를 위해서는 해당 시스템에 맞는 인스톨러의 바이너리 파일이 필요하다. 설치 과정은 시스템에 구별 없이 동일하다. 설치 진행 중 이전 단계로 이동하려면 'back’을 입력하고, 설치를 중단하려면 'quit’을 입력하고 <Enter> 키를 누른다.

다음은 텍스트 기반 셸을 실행해서 제품을 설치하는 과정에 대한 설명이다.

  1. OpenFrame GW 설치 인스톨러 바이너리 파일(OpenFrame_GW7_3_Generic.bin)을 시스템의 원하는 위치에 복사한다.

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

    $tmaxh9@oframe1:/data3/oframe1>chmod a+x OpenFrame_GW7_3_Generic.bin
  3. 설치 인스톨러 바이너리 파일을 실행하는 다음의 2가지 방법 중 하나를 선택하고 <Enter> 키를 누른다.

    • 방법 1

      ./OpenFrame_GW7_3_Generic.bin
    • 방법 2

      sh OpenFrame_GW7_3_Generic.bin
  4. 설치 소개 화면이 나타나면 내용을 확인하고 <Enter> 키를 눌러 설치를 진행한다.

    [tmaxh4@kkh/EMC01/kkh]sh OpenFrame_GW7_3_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_GW_7_3                (created with InstallAnywhere by Macrovision)
    -------------------------------------------------------------------------------
    ===============================================================================
    Introduction
    ------------
    
    InstallAnywhere will guide you through the installation of OpenFrame_GW_7_3
    
    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:
  5. OpenFrame GW 라이선스 준수 화면이 나타난다.

    라이선스를 확인한 후 동의하면 'Y', 동의하지 않는 경우에는 'N’을 입력한 후 <Enter> 키를 누른다. 라이선스에 동의하지 않은 경우 OpenFrame GW 설치는 중지된다.

    ===========================================================
    License Agreement
    ---------------------------
    Installation and Use of OpenFrame_GW_7_3 Requires Acceptance of the Following
    License Agreement:
    
    TmaxSoft  Release
    TmaxSoft Co., Ltd. (hereafter, TmaxSoft) End-User License Agreement
    
    Product :  OpenFrame GW 7_3
    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 GW, 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):
  6. JEUS HOME 디렉터리를 지정한다.

    JEUS의 루트 디렉터리를 절대 경로로 입력한 후 <Enter> 키를 누른다. (기본값: $HOME/jeus8_5)

    ===============================================================================
    Choose JEUS Folder
    ------------------
    
    Please Enter JEUS HOME
    
      Default Install Folder: /data3/oframe1/jeus8_5
    
    ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
          : /data3/oframe1/jeus
    
    INSTALL FOLDER IS: /data3/oframe1/jeus
       IS THIS CORRECT? (Y/N): y

    만약 사용자가 지정한 JEUS_HOME 디렉터리를 찾을 수 없는 경우 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:

    사용자가 지정한 JEUS_HOME의 JEUS 7 이하 버전을 선택하면 JEUS HOME 디렉터리를 새로 지정하거나 설치를 중단할 것인지를 확인한다. JEUS HOME 디렉터리를 변경하는 경우 '1', 설치를 종료하는 경우 '2’를 선택하고 <Enter> 키를 누른다.

    ===============================================================================
    Invalid Version of JEUS Application Server
    ----------------------------------------
    
    OpenFrame GW 7_3 does not support the currently specified version.
    OpenFrame GW 7_3 supports JEUS 8_5.
    
    Specify a correct version. 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:
  7. OpenFrame GW를 설치할 JEUS의 도메인과 서버 이름을 입력한다.

    ===============================================================================
    Get Jeus Infomation
    -------------------
    
    Plase Enter the Domain Name and the Server name
    (Installation Server Folder)
    
    JEUS Domain Name (DEFAULT: jeus_domain):
    
    JEUS Server Name (DEFAULT: server1):
    
    JEUS Administrator Password (DEFAULT: ):
    
    JEUS DAS IP (DEFAULT: 192.168.37.12):
    
    JEUS DAS Base Port (DEFAULT: 9736):

    다음은 설정 항목에 대한 설명이다.

    항목 설명

    Domain Name

    JEUS의 도메인 이름을 입력한다.

    $JEUS_HOME/domains/ 하위의 <domain name>을 지정한다.

    (기본값: JEUS를 설치할 때 지정한 도메인명)

    Server Name

    JEUS의 서버 이름을 입력한다.

    $JEUS_HOME/domains/<domain_name>/servers/ 하위의 <server name>을 지정한다. (기본값: server1)

    Administrator Password

    JEUS의 관리자(Administrator)의 패스워드를 입력한다.

    DAS IP

    JEUS의 DAS(Domain Administration Server)가 설치된 환경의 IP를 입력한다. (기본값: Local IP)

    DAS Base Port

    JEUS의 DAS의 Base Port를 입력한다. (기본값: 9736)

    반드시 지정한 이름의 도메인과 서버가 생성되고 기동되어 있어야 한다. 만약 생성되어 있지 않은 경우 해당 이름으로 새로운 폴더가 생성되어 예기치 않은 문제가 발생할 수 있다.

  8. OpenFrame GW와 연동할 OpenFrame 온라인 제품중 AIM이 존재하는지 여부를 체크한다.

    따라서 MVS 타입의 OpenFrame 환경(OSC, OSI와 연동)이라면 NO를 선택하고 AIM과 연동하는 경우에만 YES를 선택한다. YES를 선택하는 경우 webterminal.properties에서 sosi=false로 설정된다.

    ===============================================================================
    Get Engine information
    ----------------------
    
    Check whether to use AIM in the OpenFrame environment connected to this GW.
    (default : NO)
    
      ->1- NO
        2- YES
    
    ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
       :
    
    ===============================================================================
  9. OpenFrame GW에서 사용할 데이터베이스의 JDBC 드라이버의 벤더를 선택한다.

    '4- other’를 선택한 경우 데이터베이스 관련 정보가 모두 빈값으로 설정되며, 설치 후 사용자가 수동으로 변경해야 한다.

    ===============================================================================
    Get DataBase Information
    ------------------------
    
    Choose vendor Name of JDBC driver
    
      ->1- tibero
        2- oracle
        3- mssql
        4- other
    
    ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
       :

    반드시 설치하는 환경에 따라 벤더의 JDBC 드라이버를 사용하는 데이터베이스 버전에 맞추어서 해당 위치에 넣어주어야 한다. OpenFrame GW 인스톨러에서는 기본적으로 해당 경로에 tibero6-jdbc.jar와 ojdbc7.jar 이 설치된다. (위치: $JEUS_HOME/lib/datasource)

  10. OpenFrame GW의 운영할 데이터베이스 정보를 입력한다.

    ===============================================================================
    Get DataBase Information
    ------------------------
    
    Please Enter Database Information
    
    DataBase Server Name (DEFAULT: 192.168.37.12):
    
    DataBase Port (DEFAULT: ):
    
    DataBase SID (DEFAULT: ):
    
    DataBase User ID (DEFAULT: ):
    
    DataBase User PW (DEFAULT: ):

    다음은 설정 항목에 대한 설명이다.

    항목 설명

    DataBase Server Name

    사용할 데이터베이스의 서버 이름을 입력한다. (기본값: Local IP)

    DataBase Port

    사용할 데이터베이스의 포트 번호를 입력한다.

    DataBase SID

    사용할 데이터베이스의 이름를 입력한다.

    설치하는 계정에 $TB_SID 환경변수의 설정 값이 있다면 해당 값을 기본값으로 셋팅하고, 환경변수가 존재하지 않는다면 기본값은 셋팅되지 않는다.

    DataBase User ID

    사용할 데이터베이스의 사용자 ID를 입력한다.

    DataBase User PW

    사용할 데이터베이스의 사용자 패스워드를 입력한다.

  11. OpenFrame GW의 운영할 게이트웨이 정보를 입력한다.

    ===============================================================================
    Get Gateway Infomation
    ----------------------
    
    Enter requested information
    
    Gateway Name (DEFAULT: ofgw):
    
    Gateway PORT (DEFAULT: 5556):
    
    Datasource ID (DEFAULT: ofgw):
    
    Application Name (DEFAULT: webterminal):

    다음은 설정 항목에 대한 설명이다.

    항목 설명

    Gateway Name

    DB에 생성할 게이트웨이 이름을 정의한다. (기본값: ofgw)

    Gateway Port

    3270 터미널이 사용할 포트 번호를 입력한다. 현재 사용하지 않는 포트 번호를 정의한다. (기본값: 5556)

    Datasource ID

    JEUS 설정 파일에 지정된 데이터소스 이름을 입력한다. (기본값: ofgw)

    JEUS 설정 파일 domain.xml은 $JEUS_HOME/domains/<domain_name>/config/에 위치한다.

    Application Name

    OpenFrame GW에서 제공하는 웹 터미널에서 사용할 애플리케이션 ID를 정의한다. 애플리케이션을 디플로이하는 경우 해당 ID로 사용된다.

    (기본값: webterminal)

  12. OpenFrame GW에서 사용할 언어를 선택한다.

    ===============================================================================
    Choose Language Set
    -------------------
    
    Please Enter WebTerminal Default Language
    (Default : US)
    
      ->1- US
        2- JP
        3- KR
        4- FI
        5- FR
        6- TW
    
    ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
       :
    ===============================================================================
  13. OpenFrame GW가 접속할 Tmax 노드와 접속 정보를 입력한다.

    ===============================================================================
    Get Tmax Information
    -------------------
    
    Enter requested information
    ($OPENFRAME_HOME/core/config/oframe.m)
    
    Tmax NODE Name (DEFAULT: NODE1):
    
    Tmax IP (DEFAULT: 192.168.37.12):
    
    Tmax PORT (DEFAULT:6511):

    다음은 설정 항목에 대한 설명이다.

    항목 설명

    Tmax NODE Name

    설치된 Tmax 노드 이름을 입력한다. (기본값: NODE1)

    Tmax IP

    설치된 Tmax IP를 입력한다. (기본값: Local IP)

    Tmax PORT

    설치된 Tmax 포트 번호를 입력한다.

    설치하는 계정에 $TMAX_HOST_PORT 환경변수의 설정 값이 있다면 해당 값을 기본값으로 셋팅하고, 환경변수가 존재하지 않는다면 기본값은 셋팅되지 않는다.

  14. 발급받은 OpenFrame GW의 라이선스 위치를 절대 경로로 입력한다(지정된 폴더로 OpenFrame GW 라이선스가 복사된다).

    ===============================================================================
    Get OpenFrame GW license Path
    ---------------------
    
    Enter requested information
    ex) /home/user/license/OFGWLicense
    
    OpenFrame GW License Path (DEFAULT: ):

    다음은 설정 항목에 대한 설명이다.

    항목 설명

    OpenFrame GW License Path

    OpenFrame GW 라이선스명을 포함하여 OpenFrame GW 라이선스가 위치한 경로를 입력한다.

  15. OpenFrame GW를 설치할 때 설정 사항을 반영하기 위해서 OpenFrame GW가 설치되는 JEUS 서버 재기동 여부를 선택한다. (기본값: 1(Yes))

    ===============================================================================
    Restart Server
    --------------
    
    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 GW가 설치되는 JEUS의 해당 서버에 웹 터미널 애플리케이션 디플로이와 설정 사항이 반영되도록 서버 재기동을 수행된다.

    2- No

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

  16. 모든 정보를 입력했으므로 설치에 관련된 요약정보를 보여준다.

    설정된 내용은 확인하고 <Enter> 키를 누르면 설치가 진행된다. 설정된 내용을 수정하려면 'quit’를 입력해서 설치를 중단하고 새로 설치하거나 'back’을 입력해서 수정할 단계로 이동한다.

    ===============================================================================
    Pre-Installation Summary
    ------------------------
    
    
    Please Review the Following Before Continuing:
    
    Product Name:
        OpenFrame_GW_7_3
    
    JEUS_HOME
        /home/oframe1/jeus8_5
    
    Jeus Domain Name
        jeus_domain
    
    Jeus Server Name
        server1
    
    Gateway Name
        ofgw
    
    Gateway PORT
        5556
    
    Application Name
        webterminal
    
    Datasource Name
        ofgw
    
    Datasource Class Name
        com.tmax.tibero.jdbc.ext.TbConnectionPoolDataSource
    
    Tmax NODE Name
        NODE1
    
    Tmax NODE IP
        192.168.37.12
    
    Tmax NODE PORT
        5511
    
    
    PRESS <ENTER> TO CONTINUE:
  17. 설치 과정을 확인할 수 있다.

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

    ===============================================================================
    Installation Complete
    ---------------------
    
    Congratulations! OpenFrame GW 7_3 has been successfully installed to:
    
    /data3/oframe1/jeus8_5/domains/jeus_domain/servers/server1/lib/application
    
    Press Done to quit the installer.
    
    PRESS <ENTER> TO EXIT THE INSTALLER:

2. 환경설정

설치 시 OpenFrame GW 설치할 대상 서버 재기동 여부에서 'No’로 선택한 경우에는 설정 사항이 반영되지 않고 스크립트가 수행되지 않으므로, 설치 후 수동으로 설정하거나 스크립트를 수행해야 한다.

서버 재기동 여부를 'Yes’를 선택한 경우에는 본 절에 설명한 과정을 생략한다.

2.1. 스크립트 실행

jeusadmin 툴을 이용하여 OpenFrame GW에 필요한 환경을 수동으로 설정한다. 수동 환경설정에 필요한 스크립트는 다음의 위치에 저장되어 있다.

$JEUS_HOME/domains/<domain_name>/servers/<server_name>/lib/application/scripts/*.sh

다음은 수동으로 실행되어야 하는 스크립트에 대한 설명이다.

파일명 설명

datasource.sh

OpenFrame GW에서 사용하는 <database>와 <data-source>를 추가한다.

lifecycle.sh

OpenFrame GW 기동을 위한 <lifecycle-invocation>을 추가한다.

(이 스크립트는 JEUS 7 Fix#4 이상만 지원)

deploy.sh

OpenFrame GW에서 제공하는 웹 터미널 애플리케이션을 deploy한다.

undeploy.sh

OpenFrame GW에서 제공하는 웹 터미널 애플리케이션을 undeploy한다.

만약 OpenFrame GW 사용에 문제가 있는 경우 해당 설치 과정을 재실행하거나 JEUS에 OpenFrame GW 설정을 다시 확인한다.

2.2. JEUS 환경설정

다음은 수동으로 JEUS 환경설정을 하는 과정에 대한 설명이다.

  1. JEUS가 설치된 경로에 다음 위치에서 domain.xml을 찾는다(같은 위치에 domain_ofgw_sample.xml 샘플 파일을 제공하므로 참고한다).

    $JEUS_HOME/domains/<domain_name>/config/
  2. domain.xml에 <lifecycle-invocation> 태그와 데이터소스 관련 <data-sources>, <data-source>를 추가해서 OpenFrame GW의 정보를 설정한다.

    다음은 OpenFrame GW를 설치한 서버 server1을 <server></server> 절 사이에 <lifecycle-invocation>, <data-sources>를 설정하고, <domain></domain> 절 사이에 <data-source>을 설정한 예제이다.

    <?xml version="1.0" encoding="UTF-8"?>
    <domain xmlns="http://www.tmaxsoft.com/xml/ns/jeus" version="7.0">
    ...
       <servers>
          <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>
    ...
             <lifecycle-invocation>
                <class-name>com.tmax.ofgw.Main</class-name>
                <invocation id="0">
                   <invocation-method>
                      <method-name>init</method-name>
                   </invocation-method>
                   <invocation-type>READY</invocation-type>
                </invocation>
             </lifecycle-invocation>
             <lifecycle-invocation>
                <class-name>com.tmax.ofgw.Main</class-name>
                <invocation id="0">
                   <invocation-method>
                      <method-name>shutdown</method-name>
                   </invocation-method>
                   <invocation-type>BEFORE_UNDEPLOY</invocation-type>
                </invocation>
             </lifecycle-invocation>
    
             <data-sources>
                <data-source>ds1</data-source>
             </data-sources>
    
          </server>
       </servers>
    ...
       <resources>
          <data-source>
             <database>
                <!-- datasource ID -->
                <data-source-id>ds1</data-source-id>
                <export-name>ds1</export-name>
    
                <!--- OpenFrame GW의 datasource.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>
    
                <!--- tibero IP -->
                <server-name>192.168.37.11</server-name>
    
                <!--- tibero listener port -->
                <port-number>8200</port-number>
    
                <!--- tibero DB_Name -->
                <database-name>oframe4</database-name>
    
                <!--- tibero user -->
                <user>tibero</user>
    
                <!--- tibero password -->
                <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>
          </data-source>
       </resources>
    </domain>

    설정에 대한 자세한 설명은 "JEUS XML Reference" 또는 OpenFrame GW "운영자 안내서"의 부록 "JEUS 설정 파일"을 참고한다.

  3. domain.xml에 설정한 정보를 서버에 반영하기 위해서 서버(JEUS)를 재기동(부팅)해야 한다.

3. 설치 확인

OpenFrame GW의 설치가 완료되면 JEUS를 기동해서 정상적인 설치가 되었는지 확인한다.

3.1. JEUS 기동

JEUS를 기동할 때 DomainAdminServerBootstrapper와 ServerBootstrapper가 정상 기동되었는지 확인한다. OpenFrame GW는 <lifecyle-invocation> 태그에 설정되어 JEUS가 기동될 때 함께 기동된다.

OpenFrame GW가 설치된 해당 서버를 기동할 때 OpenFrame GW의 라이선스 정합성을 체크한다.

Java에서 제공하는 jps 툴로 JEUS 프로세스가 기동되었는지 확인할 수 있다.

$jps
1642 Jps
4096 DomainAdminServerBootstrapper
33392 ServerBootstrapper

해당 서버 기동 및 종료는 JEUS 로그로 확인이 가능하다.

  • 다음은 DomainAdminServerBootstrapper 관련 로그이다.

    $JEUS_HOME/domains/<domain_name>/servers/adminServer/logs/JeusServer.log
  • 다음은 ServerBootstrapper 관련 로그이다.

    $JEUS_HOME/domains/<domain_name>/servers/<server_name>/logs/JeusServer.log
  • logback.xml을 환경에 맞게 커스터마이징한 경우 OpenFrame GW의 로그는 logback.xml에 지정된 위치의 파일에 기록된다. (디폴트 경로 예제)

    $JEUS_HOME/domains/<domain_name>/servers/<server_name>/lib/application/logs/

JEUS 기동 및 종료 관련해서는 본 매뉴얼에서 기술하지 않으며, OpenFrame GW "운영자 안내서"의 "OpenFrame GW 기동 및 종료"를 참고한다.

3.2. 환경변수

다음은 인스톨러에 의해 추가되는 OpenFrame GW의 환경변수이다.

# New environment setting added by OpenFrame_GW_7_3 on Tue Apr 06 00:35:50 KST 2021 1.
# The unmodified version of this file is saved in /home/oframejeus1/.bash_profile1174334331.
# Do NOT modify these lines; they are used to uninstall.
OFGW_HOME=/home/oframejeus1/jeus8_5/domains/jeus_domain/servers/server4/lib/application
export OFGW_HOME
# End comments by InstallAnywhere on Tue Apr 06 00:35:50 KST 2021 1.

# New environment setting added by OpenFrame_GW_7_3 on Tue Apr 06 00:35:50 KST 2021 2.
# The unmodified version of this file is saved in /home/oframejeus1/.bash_profile1174334331.
# Do NOT modify these lines; they are used to uninstall.
CPM_FILE_DIR=/home/oframejeus1/jeus8_5/domains/jeus_domain/servers/server4/lib/application/ofgwconf/cpm
export CPM_FILE_DIR
# End comments by InstallAnywhere on Tue Apr 06 00:35:50 KST 2021 2.

# New environment setting added by OpenFrame_GW_7_3 on Tue Apr 06 00:35:50 KST 2021 3.
# The unmodified version of this file is saved in /home/oframejeus1/.bash_profile1174334331.
# Do NOT modify these lines; they are used to uninstall.
TB_EBC_TO_ASC=EBCASCUS.cpm
export TB_EBC_TO_ASC
# End comments by InstallAnywhere on Tue Apr 06 00:35:50 KST 2021 3.

# New environment setting added by OpenFrame_GW_7_3 on Tue Apr 06 00:35:50 KST 2021 4.
# The unmodified version of this file is saved in /home/oframejeus1/.bash_profile1174334331.
# Do NOT modify these lines; they are used to uninstall.
TB_ASC_TO_EBC=ASCEBCUS.cpm
export TB_ASC_TO_EBC
# End comments by InstallAnywhere on Tue Apr 06 00:35:50 KST 2021 4.

CPM_FILE_DIR, TB_EBC_TO_ASC, TB_ASC_TO_EBC 환경변수는 GW와 Tibero간 통신하는 경우 Tibero의 NLS_NCHAR_CHARACTERSET이 EBCDIC_인경우 필요한 ChracterSet을 변환할 때 필요하다.

4. 제거

본 절에서는 OpenFrame GW를 제거하는 과정과 제거 확인하는 방법에 대해서 설명한다.

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

  1. 아래 경로에 있는 OpenFrame GW의 Uninstall을 실행하거나, 설치 폴더 자체를 콘솔 명령어를 실행해서 제거한다.

    $JEUS_HOME/domains/<domain_name>/servers/<server_name>/lib/application/UninstallerData

    설치된 OpenFrame GW를 제거하기 전에 JEUS의 adminServer는 기동상태여야 한다.

  2. 다음은 Uninstall 파일을 사용해서 OpenFrame GW를 제거하는 과정이다.

    tmaxh9@oframe1:/data3/oframe1/jeus8_5/domains/jeus_domain/servers/server1/lib/application/UninstallerData> sh OFGW_Uninstall
    Preparing CONSOLE Mode Installation...
    
    ===============================================================================
    OpenFrame GW 7_3                    (created with InstallAnywhere by Macrovision)
    -------------------------------------------------------------------------------
    
    
    ===============================================================================
    Uninstall OpenFrame GW 7_3
    ------------------------
    
    About to uninstall...
    
    OpenFrame GW 7_3
    
    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
    ------------------

5. 제거 확인

OpenFrame GW가 정상적으로 제거되었는지 다음과 같이 확인한다.

  • 파일 및 폴더 확인

    인스톨러에서 지정했던 설치 디렉터리가 완전히 삭제되었는지 확인한다. 설치할 때 생성되는 디렉터리 구조 외 다른 디렉터리를 생성했다면 해당 디렉터리는 남을 수 있다. 이것은 정상이므로 수동으로 삭제한다.