문제해결

본 장에서는 잘못된 설치용 속성 파일 작성으로 인해 발생할 수 있는 에러 중 자주 발생하는 유형을 소개하고, 유형별 해결방법을 기술한다.

1. 개요

Batch 설치 과정에서 발생하는 에러는 다음의 3가지 경로를 통해 발견할 수 있다.

${OPENFRAME_HOME}/UninstallerData/log/install_batch.log 파일을 텍스트 에디터로 직접 열어 확인한다.
Batch를 설치한 후 수동으로 스크립트를 실행할 때 기록된 에러 로그 정보를 확인한다.
OpenFrame의 기동 확인할 때 나타나는 서버 상태 로그 정보를 확인한다.

설치용 속성 파일 작성에 대한 자세한 내용은 설치용 속성 파일 작성을 참고한다.
에러 코드에 대한 자세한 내용은 OpenFrame Batch "에러 메시지 참조 안내서"를 참고한다.

2. 에러 유형 및 해결방법

다음은 잘못된 설치용 속성 파일 또는 라이선스 파일로로 인해 Batch 설치 중 빈번히 발생하는 에러 및 유형별 해결방법에 대해 소개한다.

2.1. 라이선스 파일

라이선스 파일이 존재하지 않거나 손상된 경우 또는 라이선스 기간이 만료된 경우 다음과 같은 에러가 발생한다.

유형
- Tmax 라이선스 파일이 없는 경우
  
  batch_init.sh 스크립트 파일을 실행하면 다음과 같은 에러가 발생한다.
  (E) CFL2141 failed to read license file : /home/oframe/OpenFrame/core/license/license.dat [COM0900]
- Tmax 라이선스 파일 기간이 만료된 경우
  
  batch_init.sh 스크립트 파일을 실행하면 다음과 같은 에러가 발생한다.
  (E) CFL2145 License is expired : [COM0906]
- Tmax 라이선스 파일이 손상된 경우
  
  batch_init.sh 스크립트 파일을 실행하면 다음과 같은 에러가 발생한다.
  (E) CFL2142 Corrupt license file : /home/oframe/OpenFrame/core/license/license.dat [COM0902]
- Batch 제품 라이선스가 없거나 잘못된 경우
  
  OpenFrame을 기동할 때 해당 모듈 서버가 올바르게 실행되지 않으며, tmadmin을 통해 서버 상태를 확인할 때 NRDY가 표시된다.
  
  서버가 올바르게 실행되고 있는지 확인하기 위해 tmadmin을 실행한 후 si 명령어를 실행한다. 자세한 내용은 설치 확인을 참고한다.
해결방법

Batch 제품 라이선스가 없거나 잘못된 경우 해당 서버 프로세스의 로그 파일을 조회하여 문제 원인을 파악할 수 있다. 예를 들어 Batch의 라이선스 파일인 lictjes.dat 파일에 문제가 발생하면 obmjinit 서버가 올바르게 실행되지 않는다. 이 경우 ${OPENFRAME_HOME}/core/log/ulog 디렉터리의 "obmjinit<execution_date>.err" 로그 파일을 통해 다음과 같은 에러 내용을 확인할 수 있다.
```
>> U 2015-07-05 13:14:46 [NODE1:OBMJINIT:1134860:tlic.c:567]
(CHK0001) /home/oframe/OpenFrame/license/lictjes.dat file open fail: 2
>> E 2015-07-05 13:14:46 [NODE1:OBMJINIT:1134860:obmjinit.c:58]
(JES1040E) invalid license. contact the publisher.
(I) SVR3016 SVR obmjinit (13/45) tpsvrinit fail. [SVR0027]
```

2.2. 공유 메모리

다음은 공유 메모리 키 값이 중복될 경우의 설명이다.

유형 : ALC0001E

Batch 제품을 설치한 후 tmboot할 때 서버가 정상적으로 기동되지 않고 아래와 같은 에러가 발생할 수 있다.

[ALC0001E] cannot get DATASET_SHMKEY value from config subject 'ds' - rc=-22208
[JES2070E] dsalc initialization failed. rc=-22208.
[JES6001E] svrinit failed. rc=-22208.

해결방법

설치용 속성 파일에 등록한 공유 메모리 키 값을 수정하고 다시 설치를 시도하거나, ${OPEN FRAME_HOME}/core/config 디렉터리에 위치한 TMAX config 에서 해당 값을 찾아 수정한 다음 수동으 로 반영시키면 된다.

아래 예제는 TMAX 공유 메모리 키를 수동으로 반영시키는 방법이다.
```
# vi $OPENFRAME_HOME/core/config/oframe.m
*DOMAIN
domain
SHMKEY = 38001
# $TMAXDIR/bin/pfmtcacheadmin -d
# $TMAXDIR/bin/pfmtcacheadmin -c

# vi $OPENFRAME_HOME/core/config/pfmtcache.cfg
* the configuration file of TCACHE
SHMKEY=39082
# $TMAXDIR/bin/cfl -i $TMAXDIR/config/oframe.m
```

2.3. 데이터베이스

다음은 데이터베이스 접속 정보를 잘못 입력한 경우의 설명이다.

유형

ODBC 접속 정보를 잘못 입력하여 인스톨러를 실행하면 설치 중 다음과 같은 에러가 발생한다.
```
[E] [COM0020E] ofcom_odbc: SQLConnect failed. State: IM002, Native Error: -2048, Message: [unixODBC] Data source was not found.
```
해결방법

스크립트 실행 도중 위와 같은 에러가 발생하면 ODBC 접속정보를 올바르게 수정한 다음 OpenFrame을 다시 설치한다.