문제해결

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

1. 개요

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

  • ${OPENFRAME_HOME}/UninstallerData/log/install_batch.log 파일을 텍스트 에디터로 직접 열어 확인한다.

  • OpenFrame을 설치한 후 수동으로 스크립트를 실행할 때 기록된 에러 로그 정보를 확인한다.

  • OpenFrame의 기동 확인할 때 나타나는 서버 상태 로그 정보를 확인한다.

  1. 설치용 속성 파일 작성에 대한 자세한 내용은 설치용 속성 파일 작성을 참고한다.

  2. 에러 코드에 대한 자세한 내용은 OpenFrame Batch "에러 메시지 참조 안내서"를 참고한다.

2. 에러 유형 및 해결방법

본 절에서는 잘못된 설치로 인해 OpenFrame 설치 중 빈번히 발생하는 에러 및 유형별 해결방법에 대해 소개한다.

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]
    • OpenFrame Batch for MSP 제품 라이선스가 없거나 잘못된 경우

      OpenFrame을 기동할 때 해당 모듈 서버가 올바르게 실행되지 않으며, tmadmin을 통해 서버 상태를 확인할 때 NRDY가 표시된다.

  • 해결방법

    OpenFrame Batch for MSP 제품 라이선스가 없거나 잘못된 경우 해당 서버 프로세스의 로그 파일을 조회하여 문제 원인을 파악할 수 있다. 예를 들어 OpenFrame Batch for MSP의 라이선스 파일인 lictjes.dat 파일에 문제가 발생하면 obmjinit 서버가 올바르게 실행되지 않는다.

    이 경우 ${OPENFRAME_HOME}/core/log/ulog 디렉터리의 obmjinit<execution_date>.err 로그 파일을 통해 다음과 같은 에러 내용을 확인할 수 있다.

    [2025-03-17T15:21:31.817174] [OBMJINIT(23474)         ] [U] [CHK0001] /home/oframe7/OpenFrame/license/lictjes.dat file open fail: 2
    [2025-03-17T15:21:31.817226] [OBMJINIT(23474)         ] [E] [JES1040E] invalid license. contact the publisher.
    23474.152131:(I) SVR3016 SVR obmjinit (14/55) tpsvrinit fail. [SVR0031]

    서버가 올바르게 실행되고 있는지 확인하기 위해 tmadmin을 실행한 후 si 명령어를 실행한다. 자세한 내용은 설치 확인을 참고한다.

2.2. 공유 메모리

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

  • 유형

    설치용 속성 파일에 등록한 공유 메모리 키 값이 다른 사용자 또는 프로그램에 의해 사용 중인 키 값과 중복될 경우 OpenFrame 서버는 기동되지 않는다. 이 경우 ${OPENFRAME_HOME}/UninstallerData/log 디렉터리의 install_batch.log 파일을 보면 아래와 같은 에러를 확인 할 수 있다.

    (E) CFL0096 shared memory : different owner 1010 [COM3517]: File exists
    (E) CFL0096 shared memory : different owner 1010 [COM3517]: File exists
    (E) CFL0096 shared memory : different owner 1010 [COM3517]: File exists
    (E) CFL0096 shared memory : different owner 1010 [COM3517]: File exists
  • 해결방법

    설치용 속성 파일에 등록한 공유 메모리 키 값을 수정하고 다시 설치를 시도하거나, ${OPENFRAME_HOME}/config 디렉터리 또는 ${OPENFRAME_HOME}/core/config 디렉터리에 위치한 oframe.m 파일에서 해당 값을 찾아 수정한 다음 재실행한다.

2.3. 데이터베이스

다음은 OpenFrame 데이터베이스 접속 정보 설정이 잘못된 경우 발생하는 경우의 설명이다.

  • 유형

    설치용 속성 파일을 작성할 때 데이터베이스 접속 정보를 잘못 입력했을 경우 OpenFrame 서버는 기동되지 않는다. ${OPENFRAME_HOME}/UninstallerData/log 디렉터리의 install_batch.log 파일을 보면 아래와 같은 에러를 확인 할 수 있다.

    ofcom_odbc: SQLConnect failed. State: 08001, Native Error: -17001, Message: [unixODBC] Login failed: invalid user name or password.
  • 해결방법

    설치용 속성 파일에서 데이터베이스 접속 정보를 올바르게 수정하고 다시 설치를 실행한다. 자세한 내용은 ODBC 환경 설정을 참고한다.