설치 및 제거

본 장에서는 OpenFrame AIM의 설치 및 설치 검증, 설치 제거 방법에 대하여 기술한다.

1. 설치

설치용 속성파일에서 설명한 설치용 속성파일을 작성했다면, 인스톨러를 이용하여 간단하게 OpenFrame을 설치할 수 있다.

1.1. 인스톨러를 이용한 자동 설치

다음은 Linux 시스템에서 OpenFrame AIM을 설치하는 과정을 설명하며, 설치 방법은 모든 종류의 시스템에서 동일하게 적용된다.

OpenFrame을 설치할 시스템의 원하는 위치에 인스톨러 바이너리 파일과 설치 속성 파일을 복사한다.
인스톨러 바이너리에 실행권한이 주어지지 않은 경우에는 다음과 같이 chmod 명령어를 사용하여 실행권한을 부여한다.

다음은 Linux 64bit용 인스톨러 바이너리에 실행권한을 부여하는 예제이다.
```
tmaxh3@oframe:/home/oframe>chmod a+x OpenFrame_AIM7_3_NDB7_3_Linux_x86_64.bin
```

콘솔 프롬프트에서 인스톨러를 실행한다.

OpenFrame_AIM7_3_NDB7_3_Linux_x86_64.bin -f aim_ndb.properties

다음은 HP-UX Itanium 64bit용 인스톨러를 사용하여 설치하는 예제이다.

방법 1)

tmaxh3@oframe:/home/oframe>./OpenFrame_AIM7_3_NDB7_3_HP_Itanium_64.bin –f
aim_ndb.properties

방법 2)

tmaxh3@oframe:/home/oframe>sh OpenFrame_AIM7_3_NDB7_3_HP_Itanium_64.bin -f
aim_ndb.properties

다음과 같은 화면을 출력하면서 자동으로 OpenFrame 설치를 진행한다.

Preparing to install...
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

Preparing SILENT Mode Installation...

===============================================================================
OpenFrame_AIM7_3_NDB7_3             (created with InstallAnywhere by Macrovision)
-------------------------------------------------------------------------------


===============================================================================
Installing...
-------------

 [==================|==================|==================|==================]
 [------------------|------------------|------------------|------------------]

Installation Complete.

설치가 완료되면 다음과 같이 .profile(.bash_profile도 있으나 이하 .profile로 통일) 파일을 실행하여 인스톨러에 의해 수정된 사용자 환경변수를 시스템에 적용시킨다.

$ . ~/.profile

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

# New environment setting added by OpenFrame_AIM7_3_NDB7_3 on Tue Oct 29 10:58:44 KST 2019 1.
# The unmodified version of this file is saved in /home/oframe15/.bash_profile969728345.
# Do NOT modify these lines; they are used to uninstall.
COBCOPY="$OPENFRAME_HOME/aim/oivp/cpy:$OPENFRAME_HOME/cobcpy/subscpy:
$OPENFRAME_HOME/cobcpy/mapcpy:$OPENFRAME_HOME/cobcpy/aplcpy:${COBCOPY}"
export COBCOPY
# End comments by InstallAnywhere on Tue Oct 29 10:58:44 KST 2019 1.

1.2. 스크립트를 이용한 수동 설치

설치 중 스크립트가 정상적으로 실행되지 않았다면 다음 경로에 위치한 스크립트를 수동으로 실행해서 설치한다.

${OPENFRAME_HOME}/scripts

스크립트는 다음의 순서에 따라 실행하는 것을 권장한다.

link_lib_aim.sh
aim_map_compile.sh
create_ndbpds.sh
aim_oivp.sh
aim_init.sh
vtamgen.sh

2. 설치 확인

OpenFrame AIM을 설치한 후에는 다음을 통해 제품이 정상적으로 설치되었는지 확인할 것을 권장한다.

디렉터리 구조 확인
기동 확인

2.1. 디렉터리 구조 확인

OpenFrame AIM 제품을 설치한 후 생성되는 디렉터리 구조는 다음과 같다.

$OPENFRAME_HOME
   |---- UninstallerData
   |---- aim
   |---- bin
   |---- cobcpy
   |---- config
   |---- core
   |---- cpm
   |---- data
   |---- lib
   |---- license
   |---- ndb
   |---- ofdb_scripts
   |---- schema
   |---- scripts
   |---- util

다음은 OpenFrame AIM의 디렉터리 구조에 대한 설명이다. 설명은 제품 설치 후 추가되는 디렉터리로만 한정한다.

UninstallerData: 시스템에 설치되어 있는 OpenFrame을 삭제하기 위한 파일들이 위치하는 디렉터리이다.
aim: OpenFrame AIM 실행을 위한 ACMG, map, oivp, psam, vtam 샘플 등 관련 파일들이 위치하는 디렉터리이다.
bin: OpenFrame 제품에서 사용하는 각종 실행 파일들(Tool)이 위치하는 디렉터리이다.
cobcpy: OpenFrame AIM, OpenFrame NDB 제품에서 사용하는 PSAM 맵, DB 서브스키마 관련 copybook 파일들이 위치하는 디렉터리이다.
config: OpenFrame 제품에서 사용하는 환경설정 파일들이 위치하는 디렉터리이다.
core: OpenFrame에서 사용하는 Tmax 관련 파일들이 위치하는 디렉터리이다. OpenFrame을 구성하는 Tmax 서버 프로그램, 서비스 프로그램 및 Tmax 설정 파일을 포함한다.
cpm: 동일한 문자 코드 내에서 문자별 코드 변환이 필요한 경우(일본어 전각-반각, 히라가나-가타가나 변환 등) 사용되는 변화 테이블 파일이 위치하는 디렉터리이다.
data: 에러 코드 테이블 및 Lock 서버에서 사용하는 데이터 파일들이 위치하는 디렉터리이다.
lib: OpenFrame 제품에서 사용하는 라이브러리 파일들이 위치하는 디렉터리이다.
license: OpenFrame 제품에서 사용하는 라이선스 파일들이 위치하는 디렉터리이다.
ndb: OpenFrame NDB가 데이터베이스와 연동하기 위해 필요한 Tibero Proc 파일 및 라이브러리 파일이 위치하는 디렉터리이다.
ofdb_scripts: OpenFrame NDB와 데이터베이스 연동을 위해 Tibero Proc 파일 컴파일을 수행할 파일들이 위치하는 디렉터리이다.
schema: ndbgensch 툴을 이용하여 NDB의 DB 스키마에 대해 생성되는 .conv 파일이 위치하는 디렉터리이다.
scripts: OpenFrame 각 제품의 초기 환경설정용 스크립트 파일들이 위치하는 디렉터리이다.
util: OpenFrame AIM, NDB의 JOB에서 사용하는 각종 유틸리티 파일들이 위치하는 디렉터리이다.

2.2. 기동 확인

OpenFrame을 설치한 후에는 다음의 과정을 실행하여 제품이 정상적으로 설치되었는지 확인할 것을 권장한다.

${OPENFRAME_HOME}/UninstallerData/log/install_AIM.log 파일을 vi 편집기로 열어 오류 로그가 없는지 확인한다.
tmboot를 실행하여 OpenFrame을 기동한다.
```
tmaxh3@oframe:/home/oframe>tmboot -W
```

다음과 같이 기동화면이 오류 없이 출력되는 것을 확인한다.

$ tmboot
TMBOOT for node(NODE1) is starting:
Welcome to Tmax demo system: it will expire 2020/9/6
Today: 2020/8/26
        TMBOOT: TMM is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: CLL is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: CLH is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: TLM(tlm) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(ofrcfsvr) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(ofrsasvr) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(ofrlhsvr) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(ofrdmsvr) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(ofrdsedt) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(ofrcmsvr) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(ofruisvr) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(ofruisvr) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(ofrsmlog) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(obmjmsvr) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(obmjschd) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(obmjinit) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(obmjhist) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(obmjspbk) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(ofrpmsvr) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(obmtsmgr) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(tmsvr) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(aimdcms) is starting: Wed Aug 26 11:00:21 2020
        TMBOOT: SVR(aimomsvr) is starting: Wed Aug 26 11:00:21 2020

tmadmin을 실행한 후 si 명령어로 서버 목록을 출력하여 모든 서버 프로세스가 정상적으로 기동되었는지 확인한다.

아래 예와 같이 aimapsvr와 OIVPMQN(샘플 유저 애플리케이션 서버)를 제외한 모든 서버들이 RDY 상태로 표시되면 OpenFrame AIM이 정상적으로 설치되어 기동되고 있다는 것을 의미한다. aimapsvr 서버는 항상 NRDY 상태이며, 유저 애플리케이션 서버는 aimcmd로 업무 서버 기동을 실행하면 RDY로 변한다.

--- Welcome to Tmax Admin (Type "quit" to leave) ---

$$1 NODE1 (tmadm): si
------------------------------------------------------------------------
  clh   svrname    (svri)   status     count   qcount   qpcount  emcount
------------------------------------------------------------------------
    0   ofrcfsvr   (   4)      RDY       706        0         0        0
    0   ofrsasvr   (   5)      RDY         0        0         0        0
    0   ofrlhsvr   (   6)      RDY         0        0         0        0
    0   ofrdmsvr   (   7)      RDY         0        0         0        0
    0   ofrdsedt   (   8)      RDY         0        0         0        0
    0   ofrcmsvr   (   9)      RDY         0        0         0        0
    0   ofruisvr   (  10)      RDY         0        0         0        0
    0   ofrsmlog   (  11)      RDY         0        0         0        0
    0   obmjmsvr   (  12)      RDY         0        0         0        0
    0   obmjschd   (  13)      RDY         1        0         0        0
    0   obmjinit   (  14)      RDY         3        0         0        0
    0   obmjhist   (  15)      RDY         0        0         0        0
    0   obmjspbk   (  16)      RDY         0        0         0        0
    0   ofrpmsvr   (  17)      RDY         0        0         0        0
    0   obmtsmgr   (  18)      RDY         0        0         0        0
    0   tmsvr      (  19)      RDY         0        0         0        0
    0   aimdcms    (  20)      RDY         0        0         0        0
    0   aimomsvr   (  21)      RDY         0        0         0        0
    0   aimapsvr   (  22)      NRDY        0        0         0        0
    0   OIVPMQN    (  23)      NRDY        0        0         0        0

$$2 NODE1 (tmadm):

3. 설치 제거

시스템에 설치된 OpenFrame AIM은 다음과 같이 인스톨러에서 제공하는 제거 유틸리티를 실행하여 제거할 수 있다.

다음은 OpenFrame 제품을 제거하는 과정이다.

설치된 제품을 제거하기 전에 tmdown 명령을 실행하여 OpenFrame을 종료한다.
```
tmaxh3@oframe:/home/oframe>tmdown
```

다음과 같이 오류 없이 종료 메시지가 출력되는지 확인한다.

$ tmdown
Do you really want to down whole Tmax? (y : n): y

TMDOWN for node(NODE1) is starting:
        TMDOWN: SERVER(ofrdmsvr:39) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(ofrdsedt:40) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(aimomsvr:62) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(tmsvr:60) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(obmjhist:56) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(ofrlhsvr:38) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(ofrsasvr:37) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(ofrcmsvr:41) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(ofruisvr:42) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(obmjspbk:57) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(ofrcfsvr:36) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(ofruisvr:43) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(ofrpmsvr:58) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(obmjmsvr:53) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(obmjschd:54) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(obmtsmgr:59) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(obmjinit:55) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: SERVER(ofrsmlog:52) downed: Wed Aug 26 11:00:17 2020
        TMDOWN: CLH downed: Wed Aug 26 11:00:17 2020
        TMDOWN: CLL downed: Wed Aug 26 11:00:17 2020
        TMDOWN: TLM downed: Wed Aug 26 11:00:17 2020
        TMDOWN: TMM downed: Wed Aug 26 11:00:17 2020
        TMDOWN: TMAX is down

OpenFrame이 종료된 것을 확인한 후 Linux 콘솔에서 ${OPENFRAME_HOME}/UninstallerData 디렉터리에 있는 Uninstall_AIM 파일을 실행한다.
```
tmaxh3@oframe:/home/oframe/OpenFrame/UninstallerData>./Uninstall_AIM
```

4. 설치 제거 확인

설치 제거 프로그램은 OpenFrame AIM을 설치할 때 생성한 파일에 대해서만 삭제한다. 따라서 설치 후 작성한 파일 은 따로 삭제해야 한다.