개요
본 문서는 사용자가 Altibase 제품을 설치하고자 할 때에 발생 할 수 있는 문제 유형별로 조치 방법에 대해 설명합니다.
문서에 없는 상황이 발생 할 수 있으며, Altibase 버전에 따라 발생 유형이 다를 수 있습니다.
문서에서 설명되지 않는 문제상황에 대해서는 발생 조건에 대한 설명과 ALTIBASE Trace 로그파일(Altibase 설치 경로 하위의 ‘trc’ directory)을 첨부해서 support@altibase.com으로 메일을 보내주십시오.
- Altibase v6.5 이상
공통 환경에서의 문제 상황 유형 및 조치법
설치 시 발생할 수 있는 문제 유형을 나열하고 이에 맞는 조치 방법을 기술한다.
바이너리 해석 불가
- Altibase 패키지는 지원하는 CPU의 분류에 맞게 compile 되어 배포된다.
- Altibase를 설치하려는 장비의 CPU와 맞지 않은 Altibase 패키지를 다운받아 설치하려는 경우 발생할 수 있다.
- 설치한 실행파일이 정상적인지 확인하려 할 때에는 간단하게 altibase –v 명령을 이용한다.
아래 예제의 에러 메시지는 가장 일반적인 에러 상황의 경우이다. 이 외에도 라이브러리 호환 등의 다른 에러메시지를 리턴 할 수 있다.
예제1: 장비의 CPU와 ALTIBASE 패키지가 맞지 않은 경우- 해결방안 : 해당 장비의 CPU에 맞는 패키지를 다시 설치한다.
환경변수 미 등록
- Altibase를 sysdba 모드로 접속 하기 위해서는 Altibase가 설치된 경로가 ‘ALTIBASE_HOME’란 이름의 변수에 등록이 되어있어야 한다.
이 변수가 등록되어 있지 않을 경우 아래와 같은 에러가 발생한다.
- 해결방안 : ‘ALTIBASE_HOME’란 이름의 변수의 값으로 ALTIBASE 설치 경로를 등록한다.
사용자의 파일 권한 문제
- Altibase를 설치하고 데이터베이스를 생성할 때에는 sysdba 모드로 접속해야 한다.
이 때, sysdba 모드로의 접속은 Altibase을 설치한 유저로만 가능하다.
- 해결방안 : ALTIBASE를 설치한 유저로 다시 시도하거나 ALTIBASE 설치 경로 이하 모든 파일의 소유자 권한을 현재 유저로 변경해준다.
altibase.properties 파일의 부재
Altibasae 설치 경로 하위의 ‘conf’ directory 안에 altibase.properties 파일이 없을 경우 발생한다.
- 해결방안 : ALTIBASE 설치 경로 하위에 ‘conf’ directory 안에는 최초 사용자를 위한 ‘altibase.properties.sample’ 파일이 제공된다.
이 파일을 altibase.properties 파일을 사용자 환경에 맞게 수정한다.
license 파일의 부재
Altibase 설치 경로 하위의 ‘conf’ directory 안에 license 파일을 생성하지 않고 진행할 경우 발생한다.
- 해결방안 : ALTIBASE로부터 발급받은 라이선스를 토대로 해당 위치에 license 파일을 생성해야 한다.
라이선스의 오류
장비의 네트워크 카드가 변경되는 등의 이유로 MAC ADDRESS가 변경될 수 있다. 혹은 Altibase 측에 라이선스 발급정보가 잘못 전달되어 잘못된 라이선스를 발급했을 수도 있다.
- 해결방안 : 라이선스를 발급받을 때의 hostid 또는 Mac Address 가 대상 장비의 정보와 상이할 경우 라이선스를 재발급 받아야 한다.
라이선스의 기간 만료
발급받은 라이선스가 기간이 만료된 경우에 발생한다.
- 해결방안 : Altibase 기술지원 포털(http://support.altibase.com) 에서 새로운 라이선스를 신청해서 발급받아 적용한다.
Property 값의 오류
Altibase 설치 경로 하위의 ‘conf’ directory 안에 altibase.properties 파일에 지정된 값 또는 환경변수를 통해 지정된 값이 잘못된 경우에 발생한다.
현재 설정 된 값이 범위를 벗어난 경우현재 설정 된 값이 data type 변환이 불가능한 경우동일한 프로퍼티가 중복 설정되어 있는 경우- 해결방안 : 문제가 되는 속성을 확인하고 정상적인 값으로 수정해 준다
파일 쓰기 오류
- 파일 쓰기 오류는 여러 가지 문제 요인에 의해 발생할 수 있다.
해당 디스크에 여유공간이 부족하거나, 혹은 해당 directory에 권한이 누락되었을 수도 있다.
- 해결방안 : 해당 디스크의 여유공간, 해당 directory의 권한을 확인해 본다.
데이터베이스 생성 절차 생략
- Altibase를 서비스모드로 구동시키기 위해서는 데이터베이스 생성 절차가 선행되어야 한다.
- 이 절차를 생략하고 Shell prompt 상에서 server start, isql에서 startup 혹은 WINDOWS 환경에서 서비스로 Altibase를 기동 시킬 경우 발생한다.
보통 Altibase 기동 시 제일 처음 loganchor 파일을 찾게 되므로 해당 파일이 없다는 에러메시지를 돌려준다.
- 해결방안 : 데이터베이스 생성 절차를 수행한다.
Listener port bind 실패
Altibase 프로세스가 사용할 TCP port를 bind하는 단계에서 실패할 경우에 발생한다.
- 해결방안 : 해당 포트를 바인딩 할 수 없는 원인을 찾아 해결한다.
다른 어플리케이션이 선점했을 경우 어플리케이션이나 ALTIBASE의 사용 포트를 변경해 주어야 한다.
Replication port bind 실패
Altibase의 Replication thread가 사용할 포트를 bind하는 단계에서 실패할 경우에 발생한다.
- 해결방안 : 해당 포트를 바인딩 할 수 없는 원인을 찾아 해결한다.
다른 어플리케이션이 선점했을 경우 어플리케이션이나 ALTIBASE의 사용 포트를 변경해 주어야 한다.