설치 전 준비사항

본 장에서는 OpenFrame OSC를 설치하기 전에 필요한 준비사항에 대해 기술한다.

1. 개요

OpenFrame OSC(이하 OSC)를 설치하기에 앞서 필요한 준비사항은 다음과 같다.

  • 시스템 요구사항 확인

  • OSC 설치를 위한 충분한 시스템 공간 확보

  • OpenFrame 제품군 설치 확인

  • 설치용 속성파일 작성

2. 시스템 요구사항

OSC 설치를 위한 시스템 요구사항은 다음과 같다.

요구사항

Platform

Solaris 11(SunOS 5.11) 이상 (32bit, 64bit)

Linux x86 2.6 이상 (32bit, 64bit)

Linux ia64 2.6 이상 (32bit, 64bit)

Hardware

최소 5GB 공간

최소 8GB 이상 메모리 공간

Database

Tibero 6 FS07

Compiler

MF-COBOL 컴파일러, NET-COBOL 컴파일러, OpenFrame COBOL 컴파일러

OpenFrame PL/I 컴파일러

OpenFrame ASM 컴파일러

OpenFrame 제품군

OpenFrame Base 7.1

IBM 혹은 HP-UX Platform은 TmaxSoft의 기술 지원에 문의한다.

3. 디스크 용량 확인

OSC 설치 전에 UNIX 시스템에 남아있는 디스크의 여유공간을 확인한다. 하드웨어 요구사항에 대한 자세한 내용은 시스템 요구사항을 참고한다.

UNIX/Linux 시스템에서 하드웨어의 여유공간을 확인하려면 프롬프트에서 df 명령어를 실행한다.

다음은 Linux 운영체제를 사용하는 Linux 머신에서 df 명령어를 실행하여 디스크 용량이 얼마나 남아있는지 확인하는 예제이다. 출력 결과를 KB 단위로 표시하기 위해 –k 옵션을 사용했다.

tmax@oframe:/home/oframe>df -k /home

다음은 위의 명령을 실행한 결과이다.

Filesystem               1K-blocks     Used         Available   Use%     Mounted on
/dev/mapper/centos-home  30425199      26002798     4422401     85%      /home

/home 디렉터리는 /dev/mapper/centos-home 디스크에 속해 있고, 전체 용량 30,425,199KB 중 사용한 용량은 26,002,798KB, 남은 용량은 4,422,401KB로 전체의 85%가 사용 중이라는 것을 의미한다.

4. OpenFrame 제품군 설치 확인

OSC 제품의 경우에는 다른 독립 제품의 영향을 받는다. 필수 설치 제품과 선택 설치 제품은 다음과 같다.

필수 설치

OSC를 설치 및 사용하기 위해서는 반드시 먼저 OpenFrame Base 제품이 설치되어 있어야 한다. OSC 설치 후에 OpenFrame GW가 설치되어야 기본적인 트랜잭션 동작 확인이 가능하다.

OpenFrame Base의 설치 및 확인에 대해서는 OpenFrame Base "설치 안내서"를 참고한다.

선택 설치

영향을 받는 제품으로는 OpenFrame Batch, OpenFrame OSI, OpenFrame TACF 등이 있으며, 필요에 따라 선택적으로 설치할 수 있다. OSC 인스톨러는 먼저 설치된 다른 독립 제품에 따라 다르게 설치되기 때문에 가장 마지막으로 설치되어야 한다. 단, GUI 기반 툴인 OpenFrame Manager의 경우에는 OSC까지 모두 설치한 후 정상 동작함을 확인하고 설치할 것을 권장한다.

5. 설치용 속성 파일

OSC의 설치를 위한 각종 속성 내용을 하나의 파일에 모두 작성한 후 인스톨러를 실행하면 인스톨러는 속성 파일에 작성된 설정 내용을 읽어 들여 설정된 항목에 따라 설치를 진행한다.

본 절에서는 OSC 설치용 속성 파일에 작성되어야 하는 항목에 대해 기술한다. 설치용 속성 파일의 예제는 설치용 속성파일 예제에서 확인할 수 있다.

설치용 속성 파일의 이름은 UNIX 시스템에서 허용하는 파일명 내에서 제약없이 작성할 수 있다. 단, 파일 형식은 일반 텍스트 파일 형식이어야 하며, 인스톨러와 함께 제공되는 예제 파일을 참고하여 작성할 것을 권장한다.

5.1. 컴파일러 설정

OSC를 설치하기 전에 설치하고자 하는 조건에 맞도록 컴파일러를 지정한다.

다음은 컴파일러의 타입을 설정하는 항목이다.

COBOL=[MFCOBOL|OFCOBOL|NO]
PLI=[YES|NO]
항목 설명

COBOL

설치할 OSC의 COBOL 사용 여부와 사용하는 컴파일러를 지정한다. 지정하는 값에 따라 $OPENFRAME_HOME/lib/libcics.so 모듈이 각 컴파일러에 맞는 링크가 설정된다. 모든 컴파일러 타입의 모듈이 제공되므로 설치 이후에도 변경 가능하다.

  • MFCOBOL

  • OFCOBOL

  • NO (COBOL을 사용하지 않는 경우)

PLI

설치할 OSC의 PL/I 사용 여부를 지정한다.

다음은 COBOL은 OFCOBOL을 사용하고 PL/I는 사용하지 않을 경우를 설정하는 예이다.

COBOL=OFCOBOL
PLI=NO

5.2. OpenFrame 디렉터리 설정

OSC를 설치할 디렉터리를 설정하는 항목으로 OpenFrame Base 제품이 설치되어 있는 절대 경로를 입력한다.

다음은 OpenFrame의 홈 디렉터리를 설정하는 항목이다.

OPENFRAME_HOME=<path>
항목 설명

OPENFRAME_HOME

OSC가 설치될 UNIX의 디렉터리 또는 파일 경로를 지정한다.

다음은 OpenFrame 홈 디렉터리를 /home/oframe/OpenFrame으로 설정하는 예이다.

OPENFRAME_HOME=/home/oframe/OpenFrame

5.3. Tmax 환경설정

OpenFrame 엔진에 포함된 Tmax에 관련된 환경을 설정한다. Tmax에 관련된 항목은 OpenFrame Base 설치할 때 작성한 값과 동일해야 한다. Tmax 환경설정 파일(${TMAXDIR}/config/oframe.m)을 참고한다.

다음은 Tmax 환경을 설정하는 항목이다.

TP_NODE_NAME=<tp_node_name>
항목 설명

TP_NODE_NAME

OpenFrame 및 Tmax에서 기본 노드로 사용될 노드명을 0~9, A~Z, a~z, @, #, $, -로 이루어진 문자열로 설정한다.

다음은 Tmax 관련 환경설정의 예이다.

TP_NODE_NAME=NODE1

5.4. 저장 장치 환경설정

OpenFrame에서 사용되는 VSAM 데이터 셋을 생성할 볼륨을 지정한다.

다음은 저장 장치의 환경설정을 위한 항목이다.

DEFAULT_VOLSER=<volser_dataset>
항목 설명

DEFAULT_VOLSER

OpenFrame에서 기본 볼륨으로 사용되는 볼륨 이름을 설정한다.

기본 볼륨 이름은 OpenFrame Base 설치할 때 생성한 볼륨 이름을 사용해야 한다.

다음은 저장 장치 관련 환경설정의 예이다.

DEFAULT_VOLSER=DEFVOL

5.5. OIVP 환경설정

본 절에서는 OSC를 설치한 후 자동으로 설정되는 기본 Region(OSCOIVP1) 환경설정 항목을 설명한다.

OSC의 설치를 확인하기 위한 데모 애플리케이션인 OIVP의 환경을 설정한다.

  1. OIVP의 실행에 대한 자세한 설명은 설치 검증을 참고한다.

  2. 각 항목에 대한 구체적인 설명에 대해서는 OpenFrame OSC "운영자 안내서"를 참고한다.

  3. OpenFrame 환경설정에 대한 자세한 내용은 OpenFrame OSC "환경설정 안내서"를 참고한다.

OSCOIVP1 Region 기본 설정

OIVP Region에서 사용하는 기본적인 항목을 설정한다. Region에서 사용하는 다양한 설정 값들은 권고하는 설정으로 설치되며, 중복을 허용하지 않는 값에 대해서만 설정한다. 여러 개의 Region을 사용하는 경우에도 중복을 허용하지 않는다.

OSC_APP_SYS_SHMKEY=<osc_app_sys_shmkey>
OSC_APP_USR_SHMKEY=<osc_app_usr_shmkey>
OSC_APP_TSQ_SHMKEY=<osc_app_tsq_shmkey>
CORE_TDL_SHMKEY=<core_tdl_shmkey>
항목 설명

OSC_APP_SYS_SHMKEY

OSCOIVP1에서 사용되는 시스템을 위한 공유 메모리 키를 10진수 또는 0x로 시작하는 16진수로 설정한다.

OpenFrame 환경설정에 osc.{servername} 서브젝트, GENERAL 섹션의 SYS_SHMKEY 키의 VALUE 항목에 기술된다.

OSC_APP_USR_SHMKEY

OSCOIVP1에서 사용되는 사용자를 위한 공유 메모리 키를 10진수 또는 0x로 시작하는 16진수로 설정한다.

OpenFrame 환경설정에 osc.{servername} 서브젝트, GENERAL 섹션의 USR_SHMKEY 키의 VALUE 항목에 기술된다.

OSC_APP_TSQ_SHMKEY

OSCOIVP1에서 사용하는 TSQ를 위한 공유 메모리 키를 10진수 또는 0x로 시작하는 16진수로 설정한다.

OpenFrame 환경설정에 osc.{servername} 서브젝트, TSQ 섹션의 TSQ_SHMKEY 키의 VALUE 항목에 기술된다.

CORE_TDL_SHMKEY

OSCOIVP1에서 TDL 공유 메모리 키를 설정한다.

CORE_TDL_SHMKEY은 Region의 TDL 환경설정 파일(${OPENFRAME_HOME}/osc/region/OSCOIVP1/tdl/config/tdl.cfg)에 기술된다.

다음은 OSCOIVP1 Region의 기본 정보를 설정한 예이다.

OSC_APP_SYS_SHMKEY=25140
OSC_APP_USR_SHMKEY=21477
OSC_APP_TSQ_SHMKEY=23658
CORE_TDL_SHMKEY=35211
OSCOIVP1 Region CPM 설정

OSCOIVP1 Region에서 사용하는 언어 관련 항목을 설정한다.

해당 항목은 OpenFrame 환경설정에 osc.{servername} 서브젝트, CPM 섹션의 REGION_CCSID 키와 3270_CCSID 키에 각각 기술된다.

OSC_APP_CPM_REGION_CCSID=<osc_app_cpm_region_ccsid>
OSC_APP_CPM_3270_CCSID=<osc_app_cpm_3270_ccsid>,[<osc_app_cpm_3270_ccsid>]
항목 설명

OSC_APP_CPM_REGION_CCSID

Region에서 사용할 CCSID를 10진수로 설정한다.

OSC_APP_CPM_3270_CCSID

TN3270 게이트웨이에서 사용할 CCSID를 10진수로 설정한다. 만약 1Byte 캐릭터 코드 페이지와 2Bytes 캐릭터의 코드 페이지가 함께 사용될 경우 2개까지 기술이 가능하다.

다음은 OSCOIVP1 Region에서 사용하는 언어를 영어로 설정할 경우의 예이다.

OSC_APP_CPM_REGION_CCSID=437
OSC_APP_CPM_3270_CCSID=37
OSCOIVP1 Region TL 서버 설정

OIVP Region에서 사용하는 TDQ Log 서버 관련 항목을 설정한다.

해당 항목은 OpenFrame 환경설정에 osc.{servername} 서브젝트에 TDQ 섹션의 TDQ_LOG_ADDRESS 키와 osc.{osctlsvrname} 서브젝트에 OSCTLSVR 섹션의 PORT 키에 기술된다.

OSC_TL_OSCTLSVR_PORT=<port>
항목 설명

OSC_TL_OSCTLSVR_PORT

OSCTLSVR에서 사용할 포트 번호를 10진수로 설정한다.

다음은 OSCOIVP1 Region에서 사용하는 TDQ Log 서버를 설정한 예이다.

OSC_TL_OSCTLSVR_PORT=8696

5.6. VTAM 포트설정

OpenFrame 엔진에 포함된 VTAM에서 사용할 포트를 설정한다. VTAM_PORT 항목은 OpenFrame GW 환경의 lu.port 값과 동일해야 한다. OpenFrame GW 환경설정 파일(${OFGW_HOME}/ofgwconf/ofgw.properties)을 참고한다. 해당 항목은 DB 테이블에 저장되어 vtamdump 툴을 이용하여 확인 가능하다.

vtamdump 툴에 대한 자세한 내용은 OpenFrame Base "툴 참조 안내서"를 참고한다.

다음은 VTAM 포트를 설정하는 항목이다.

VTAM_PORT=<port>
항목 설명

VTAM_PORT

VTAM에서 사용할 포트 번호를 10진수로 설정한다.

다음은 vtamdump로 확인할 수 있는 vtam 포트의 예이다.

BEGINVTAM
 PORT 5556
 LUGROUP LUGRP1 TESTTERM ENDLUGROUP
 LUGROUP LUGRP2 TESTTRM0..TESTTRM9..FFFFFFFN ENDLUGROUP
 IPGROUP IPGRP1 1.1.1.1..100.100.100.100 ENDIPGROUP
 IPGROUP IPGRP2 100.100.100.101..255.255.255.255 ENDIPGROUP
 LUMAP LUGRP1 IPGRP1
 LUMAP LUGRP2 IPGRP2
ENDVTAM