Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel2

 

 

개요

...

본 문서는 사용자가 Altibase 제품을 설치하고자 할 때에 발생 할 수 있는 문제 유형별로 조치 방법에 대해 설명합니다.

...

Note

이 문서는 정보 제공을 목적으로 제공되며, 사전에 예고 없이 변경될 수 있습니다. 이 문서는 오류가 있을 수 있으며, 상업적 또는 특정 목적에 부합하는 명시적, 묵시적인 책임이 일절 없습니다.

이 문서에 포함된 Altibase 제품의 특징이나 기능의 개발, 발표 등의 시기는 Altibase 재량입니다.

Altibase는 이 문서에 대하여 관련된 특허권, 상표권, 저작권 또는 기타 지적 재산권을 보유할 수 있습니다.

 

 

공통 환경에서의 문제 상황 유형 및 조치법 

...

설치 시 발생할 수 있는 문제 유형을 나열하고 이에 맞는 조치 방법을 기술한다.

 

바이너리 해석 불가 

...

  •  Altibase 패키지는 지원하는 CPU의 분류에 맞게 compile 되어 배포된다.
  •  Altibase를 설치하려는 장비의 CPU와 맞지 않은 Altibase 패키지를 다운받아 설치하려는 경우 발생할 수 있다.
  • 설치한 실행파일이 정상적인지 확인하려 할 때에는 간단하게 altibase –v 명령을 이용한다.
  •  아래 예제의 에러 메시지는 가장 일반적인 에러 상황의 경우이다. 이 외에도 라이브러리 호환 등의 다른 에러메시지를 리턴 할 수 있다.

    Code Block
    title예제1: 장비의 CPU와 ALTIBASE 패키지가 맞지 않은 경우
    themeDJango
    languagebash
    $ ./altibase-HDB-server-6.5.1.6.8-LINUX-POWERPC-64bit-release.run 
    -bash: ./altibase-HDB-server-6.5.1.6.8-LINUX-POWERPC-64bit-release.run: cannot execute binary file
  • 해결방안 : 해당 장비의 CPU에 맞는 패키지를 다시 설치한다.

환경변수 미 등록 

...

  • Altibase를 sysdba 모드로 접속 하기 위해서는 Altibase가 설치된 경로가 ‘ALTIBASE_HOME’란 이름의 변수에 등록이 되어있어야 한다.
  • 이 변수가 등록되어 있지 않을 경우 아래와 같은 에러가 발생한다.

    Code Block
    themeDJango
    languagebash
    $ isql -s 127.0.0.1 -u sys -p manager -port 20300 -sysdba
    ISQL_CONNECTION = UNIX, SERVER = 127.0.0.1, PORT_NO = 20300
    [ERR-91003 : Environment  (ALTIBASE_HOME) does not exists.
  • 해결방안 : ‘ALTIBASE_HOME’란 이름의 변수의 값으로 ALTIBASE 설치 경로를 등록한다.

사용자의 파일 권한 문제 

...

  • Altibase를 설치하고 데이터베이스를 생성할 때에는 sysdba 모드로 접속해야 한다.
  • 이 때, sysdba 모드로의 접속은 Altibase을 설치한 유저로만 가능하다.

    Code Block
    themeDJango
    languagebash
    $ isql -s 127.0.0.1 -u sys -p manager -port 26084 -sysdba
    -----------------------------------------------------------------
         Altibase Client Query utility.
         Release Version 6.5.1.6.8
         Copyright 2000, ALTIBASE Corporation or its subsidiaries.
         All Rights Reserved.
    -----------------------------------------------------------------
    WARNING: A port number is not required when connecting via IPC or UNIX, so the -port option was ignored.
    ISQL_CONNECTION = UNIX, SERVER = 127.0.0.1
    [ERR-9100B : Privilege error for sysdba user account.]
  • 해결방안 : ALTIBASE를 설치한 유저로 다시 시도하거나 ALTIBASE 설치 경로 이하 모든 파일의 소유자 권한을 현재 유저로 변경해준다.

altibase.properties 파일의 부재 

...

  • Altibasae 설치 경로 하위의 ‘conf’ directory 안에 altibase.properties 파일이 없을 경우 발생한다.

    Code Block
    themeDJango
    languagebash
    iSQL(sysdba)> startup process
    idp readConf() Error : Open File [/hdb_home/651/conf/altibase.properties] Error.
  • 해결방안 : ALTIBASE 설치 경로 하위에 ‘conf’ directory 안에는 최초 사용자를 위한 ‘altibase.properties.sample’ 파일이 제공된다.
                   이 파일을 altibase.properties 파일을 사용자 환경에 맞게 수정한다.

license 파일의 부재 

...

  • Altibase 설치 경로 하위의 ‘conf’ directory 안에 license 파일을 생성하지 않고 진행할 경우 발생한다.

    Code Block
    themeDJango
    languagebash
    TRANSITION TO PHASE : PROCESS
    Commencing Server as Community Edition
    DISK_MAX_DB_SIZE(Unlimited) exceeded limit 8192M
    [FAILURE] License invalid or expired.
    Startup Failed....
    [ERR-91015 : Communication failure.]
  • 해결방안 : ALTIBASE로부터 발급받은 라이선스를 토대로 해당 위치에 license 파일을 생성해야 한다.

라이선스의 오류 

...

  • 장비의 네트워크 카드가 변경되는 등의 이유로 MAC ADDRESS가 변경될 수 있다. 혹은 Altibase 측에 라이선스 발급정보가 잘못 전달되어 잘못된 라이선스를 발급했을 수도 있다.

    Code Block
    themeDJango
    languagebash
    TRANSITION TO PHASE : PROCESS
    Invalid or expired license in License File(/hdb_home/651/conf/license)
    [FAILURE] License invalid or expired.
    Startup Failed....
    [ERR-91015 : Communication failure.]
  • 해결방안 : 라이선스를 발급받을 때의 hostid 또는 Mac Address 가 대상 장비의 정보와 상이할 경우 라이선스를 재발급 받아야 한다.

라이선스의 기간 만료

...

  • 발급받은 라이선스가 기간이 만료된 경우에 발생한다.

    Code Block
    themeDJango
    languagebash
    TRANSITION TO PHASE : PROCESS
    Invalid or expired license in License File(/hdb_home/651/conf/license)
    [FAILURE] License invalid or expired.
    Startup Failed....
    [ERR-91015 : Communication failure.]
  • 해결방안 : Altibase 기술지원 포털(http://support.altibase.com) 에서 새로운 라이선스를 신청해서 발급받아 적용한다.

Property 값의 오류  

...

  • Altibase 설치 경로 하위의 ‘conf’ directory 안에 altibase.properties 파일에 지정된 값 또는 환경변수를 통해 지정된 값이 잘못된 경우에 발생한다.

    Code Block
    title현재 설정 된 값이 범위를 벗어난 경우
    themeDJango
    languagebash
    idp checkRange() Error : Property [property_name] [current_value] Overflowed the Value Range.(min_value~max_value)
    Code Block
    title현재 설정 된 값이 data type 변환이 불가능한 경우
    themeDJango
    languagebash
    idp convertFromString() Error : The property [property_name] value [current_value] is not convertable.
    Code Block
    title동일한 프로퍼티가 중복 설정되어 있는 경우
    themeDJango
    languagebash
    idp insertBySrc() Error : Property [property_name] Can't Store Multiple Values.
  • 해결방안 : 문제가 되는 속성을 확인하고 정상적인 값으로 수정해 준다

 

파일 쓰기 오류 

...

  • 파일 쓰기 오류는 여러 가지 문제 요인에 의해 발생할 수 있다.
  • 해당 디스크에 여유공간이 부족하거나, 혹은 해당 directory에 권한이 누락되었을 수도 있다.

    Code Block
    themeDJango
    languagebash
    TRANSITION TO PHASE : PROCESS
    Command execute success.
    
    DB Info (Page Size     = 32768)
            (Page Count    = 257)
            (Total DB Size = 8421376)
            (DB File Size  = 1073741824)
    
    FAILURE of createdb.
    
    [ERR-0103C : Unable to invoke create() function on [/ALTIBASE/altibase_home/dbs/dwfile0.dwf]]
  • 해결방안 : 해당 디스크의 여유공간, 해당 directory의 권한을 확인해 본다.

데이터베이스 생성 절차 생략 

...

  • Altibase를 서비스모드로 구동시키기 위해서는 데이터베이스 생성 절차가 선행되어야 한다.
  • 이 절차를 생략하고 Shell prompt 상에서 server start, isql에서 startup 혹은 WINDOWS 환경에서 서비스로 Altibase를 기동 시킬 경우 발생한다.
  • 보통 Altibase 기동 시 제일 처음 loganchor 파일을 찾게 되므로 해당 파일이 없다는 에러메시지를 돌려준다.

    Code Block
    themeDJango
    languagebash
    TRANSITION TO PHASE : CONTROL
    [FAILURE] The log anchor file does not exist or it is not valid.
    
    Startup Failed....
    
    [ERR-91015 : Communication failure.]
  • 해결방안 : 데이터베이스 생성 절차를 수행한다.

Listener port bind 실패 

...

  • Altibase 프로세스가 사용할 TCP port를 bind하는 단계에서 실패할 경우에 발생한다.

    Code Block
    themeDJango
    languagebash
    TRANSITION TO PHASE : SERVICE
      [CM] Listener failed  : TCP on port 20300 [IPV4]
    [FAILURE] Unable to bind the socket.
    Startup Failed....
    [ERR-91015 : Communication failure.]
  • 해결방안 : 해당 포트를 바인딩 할 수 없는 원인을 찾아 해결한다.
                   다른 어플리케이션이 선점했을 경우 어플리케이션이나 ALTIBASE의 사용 포트를 변경해 주어야 한다.


Replication port bind 실패 

...

  • Altibase의 Replication thread가 사용할 포트를 bind하는 단계에서 실패할 경우에 발생한다.

    Code Block
    themeDJango
    languagebash
    TRANSITION TO PHASE : SERVICE
      [CM] Listener started : TCP on port 20300 [IPV4]
      [CM] Listener started : UNIX
      [CM] Listener started : IPC
      [RP] Initialization : FAIL
    [FAILURE] [Receiver] Failed to listen to a replication socket (Port No:30300)
    Startup Failed....
    [ERR-91015 : Communication failure.]
  • 해결방안 : 해당 포트를 바인딩 할 수 없는 원인을 찾아 해결한다.
                   다른 어플리케이션이 선점했을 경우 어플리케이션이나 ALTIBASE의 사용 포트를 변경해 주어야 한다.

...