Real Alternative DBMS ALTIBASE, Since 1999 ALTIBASE 설치시발생할수있는문제상황과조치 ALTIBASE 5.3.3 2010. 03 Copyright c 2000~2013 ALTBASE Corporation. All Rights Reserved.
Document Control Change Record Date Author Change Reference 2010-03-08 fhan Created 2010-03-09 fhan Planning 2010-03-11 fhan Reify a concept 2010-03-30 fhan Alpha Review 2010-04-26 fhan Reflect alpha review 2010-04-26 fhan Beta Review 2010-04-27 fhan 1 st Reflect beta review 2010-04-28 fhan 2 nd Reflect beta review Reviews Date Name (Position) 2010-03-09 lim272(service Planning) 2010-03-30 lim272(service Planning) 2010-04-16 lim272(service Planning) 2010-04-27 durusari(service Planning) 2010-04-27 omegaman(solution Center) 2010-04-28 high7777(technical Support) 2010-04-28 omegaman(solution Center) 2010-04-28 durusari(service Planning) Distribution Name Location ALTIBASE 설치시발생할수있는문제상황과조치 2 page of 13
목차 개요... 4 공통환경에서의문제상황유형및조치법... 5 바이너리해석불가... 5 환경변수미등록... 5 사용자의파일권한문제... 6 altibase.properties 파일의부재... 6 license 파일의부재... 7 라이선스키값의오류... 7 라이선스키의기간만료... 8 Property 값의오류 1... 8 Property 값의오류 2... 8 Property 값의오류 3... 9 파일쓰기오류... 10 데이터베이스생성절차생략... 10 Listener port bind 실패... 11 Replication port bind 실패... 11 WINDOWS 환경에서의문제상황유형및조치법... 12 라이선스키값의오류... 12 ALTIBASE 설치시발생할수있는문제상황과조치 3 page of 13
개요 본문서는사용자가 ALTIBASE 제품을설치하고자할때에발생할수있는문제유형별로조치방법에대해설명합니다. 문서에없는상황이발생할수있으며, ALTIBASE 버전에따라발생유형이다를수있습니다. 문서에서설명되지않는문제상황에대해서는발생조건에대한설명과 ALTIBASE Trace 로그파일 (ALTIBASE 설치경로하위의 trc directory) 을첨부해서 support@altibase.com 으로메일을보내주십시오. 외에, 본문서에기술되지않은궁금한사항은 http://atc.altibase.com/ 이나 (02) 2082-1114 로문의하십시오. ALTIBASE 설치시발생할수있는문제상황과조치 4 page of 13
공통환경에서의문제상황유형및조치법 설치시발생할수있는문제유형을나열하고이에맞는조치방법을기술한다. 바이너리해석불가 ALTIBASE 패키지는지원하는 CPU 의분류에맞게 compile 되어배포된다. ALTIBASE 를설치하려는장비의 CPU 와맞지않은 ALTIBASE 패키지를다운받아설치하려는경우발생할수있다. 설치한실행파일이정상적인지확인하려할때에는간단하게 altibase v 명령을이용한다. 아래예제의에러메시지는가장일반적인에러상황의경우이다. 이외에도라이브러리호환등의다른에러메시지를리턴할수있다. 예제 1: 장비의 CPU 와 ALTIBASE 패키지가맞지않은경우 $ altibase v sh: altibase: cannot execute 예제 2: OS 버전이다른경우, 아래예제는 AIX5.2 장비에 AIX5.3 대응패키지설치 $ altibase -v Could not load program altibase: Symbol resolution failed for altibase because: Symbol fd_select (number 110) is not exported from dependent module /usr/lib/libc.a[shr_64.o]. Symbol pth_init (number 227) is not exported from dependent module /usr/lib/libpthreads.a[shr_xpg5_64.o]. Examine.loader section symbols with the 'dump -Tv' command. 해결 : 해당장비의 CPU 에맞는패키지를다시설치한다. 환경변수미등록 ALTIBASE 를 sysdba 모드로접속하기위해서는 ALTIBASE 가설치된경로가 ALTIBASE_HOME 란이름의변수에등록이되어있어야한다. 이변수가등록되어있지않을경우아래와같은에러가발생한다. $ 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 설치시발생할수있는문제상황과조치 5 page of 13
해결 : ALTIBASE_HOME 란이름의변수의값으로 ALTIBASE 설치경로를등록한다. 사용자의파일권한문제 ALTIBASE 를설치하고데이터베이스를생성할때에는 sysdba 모드로접속해야한다. 이때, sysdba 모드로의접속은 ALTIBASE 을설치한유저로만가능하다. $ isql -s 127.0.0.1 -u sys -p manager -sysdba -port 20300 ----------------------------------------------------------------- Altibase Client Query utility. Release Version 5.3.3.6 Copyright 2000, ALTIBASE Corporation or its subsidiaries. All Rights Reserved. ----------------------------------------------------------------- ISQL_CONNECTION = UNIX, SERVER = 127.0.0.1, PORT_NO = 20300 [ERR-9100B : Privilege Error on user account for sysdba.] 해결 : ALTIBASE 를설치한유저로다시시도하거나 ALTIBASE 설치경로이하모든파일의소유자권한을현재유저로변경해준다. altibase.properties 파일의부재 ALTIBASE 설치경로하위의 conf directory 안에 altibase.properties 파일이없을경우발생한다. isql(sysdba)> startup process Connecting to the DB server...startup Failure. Check Your Environment. 이경우 ALTIBASE 설치경로하위의 trc directory 에적재되어있는 Trace 로그파일 (altibase_boot.log) 을보면원인이직관적으로나와있다. [[[[[[ ALTIBASE STARTUP - Boot ]]]]]] [2010/03/15 20:24:13] [Thread-1] [Level-0] ==> Check & Loading of Altibase Properties. [2010/03/15 20:24:13] [Thread-1] [Level-0] ERR-0109a(errno=2) idp readconf() Error : Open File [/ALTIBASE/altibase_home/conf/altibase.properties] Error. [2010/03/15 20:24:13] [Thread-1] [Level-0] [FAILURE] idp readconf() Error : Open File [/ALTIBASE/altibase_home/conf/altibase.properties] Error. ALTIBASE 설치시발생할수있는문제상황과조치 6 page of 13
[2010/03/15 20:24:13] [Thread-1] [Level-0] ERR-0109a(errno=2) idp readconf() Error : Open File [/ALTIBASE/altibase_home/conf/altibase.properties] Error. 해결 : ALTIBASE 설치경로하위에 conf directory 안에는최초사용자를위한 altibase.properties.sample 파일이제공된다. 이파일을이용해서 altibase.properties 파일을사용자환경에맞게수정하여생성해준다. license 파일의부재 ALTIBASE 설치경로하위의 conf directory 안에 license 파일을생성하지않고진행할경우발생한다. TRANSITION TO PHASE : PROCESS License File(/ALTIBASE/altibase_home/conf/license) does not exist HostID->00000000 [FAILURE] License File does not exist. Startup Failed... 해결 : ALTIBASE 로부터발급받은라이선스를토대로해당위치에 license 파일을생성해야한다. 라이선스키값의오류 장비의네트워크카드가변경되는등의이유로 hostid 가변경될수있다. 혹은 ALTIBASE 측에 hostid 가잘못전달돼서잘못된라이선스를발급했을수도있다. TRANSITION TO PHASE : PROCESS invlid MEM_MAX_DB_SIZE, Availible DB Size is 0 key : [current_license_key_value] Invalid or expired license in License File(/ALTIBASE/altibase_home/conf/license) HostID->00000000 [FAILURE] License is invalid or expired. Startup Failed... 해결 : 라이선스를발급받을때의 hostid 와현재장비의그것이다를경우라이선스를재발급받아야한다. ALTIBASE 설치시발생할수있는문제상황과조치 7 page of 13
참고로 UNIX, LINUX 계열의 hostid 는모두소문자이고, WINDOWS 환경의 Mac address 는모두대문자이다. 라이선스키의기간만료 발급받은라이선스가기간이만료된경우에발생한다. TRANSITION TO PHASE : PROCESS invalid MEM_MAX_DB_SIZE, Available DB Size is 0 key : To be expired at XXXX-XX-XX. Invalid or expired license in License File(/ALTIBASE/altibase_home/conf/license) HostID->00000000 [FAILURE] License is invalid or expired. Startup Failed... 해결 : ALTIBASE 측에라이선스기간만료로새로운라이선스를신청해서발급받아적용한다. Property 값의오류 1 ALTIBASE 설치경로하위의 conf directory 안에 altibase.properties 파일에지정된값또는환경변수를통해지정된값이잘못된경우에발생한다. ALTIBASE Trace 로그파일중 altibase_boot.log 파일을확인해보면어떤속성이잘못되었는지나와있다. 예제 1: 현재설정된값이범위를벗어난경우 ERR-0109a(errno=0) idp checkrange() Error : Property [property_name] [current_value] Overflowed the Value Range. 예제 2: 현재설정된값이 data type 변환이불가능한경우 ERR-0109a(errno=0) idp convertfromstring() Error : The property [property_name] value [current_value] is not convertable. 해결 : 문제가되는속성을확인하고정상적인값으로수정해준다. Property 값의오류 2 발생원인은 Property 값의오류 1 항목과동일하다. 이때, isql 툴이속성값중에해석이불가능한값이있다면 altibase.properties 파일의부재 항목과동일한문제상황을보인다. 이경우역시 ALTIBASE Trace 로그파일중 altibase_boot.log 파일을확인해보면어떤속성이잘못되었는지나와있다. ALTIBASE 설치시발생할수있는문제상황과조치 8 page of 13
isql(sysdba)> startup process Connecting to the DB server...startup Failure. Check Your Environment. altibase_boot.log 내용 ERR-0109a(errno=0) idp checkrange() Error : Property [property_name] [current_value] Overflowed the Value Range. ERR-0109a(errno=0) idp convertfromstring() Error : The property [property_name] value [current_value] is not convertable. 해결 : 문제가되는속성을확인하고정상적인값으로수정해준다. Property 값의오류 3 발생원인은 Property 값의오류 2 항목과동일하다. 이때, is 혹은 server 스크립트를이용해작업을하고있다면어떤문제인지직관적으로알수가없다. 일반적으로 is 혹은 server 스크립트를이용해접속을할때는 ALTIBASE PortNo 항목의값을입력받지않는다. 하지만아래예제에서는 ALTIBASE PortNo 항목의값을입력받으려한다. 예를들어 server 스크립트는 isql -u sys -p manager sysdba 명령으로접속을시도하게되고 PortNo 에해당하는값은 altibase.properties 파일에서읽어오게되지만 altibase.properties 파일에잘못된값이있을경우 altibase.properties 파일이비정상적이라고판단을하고 altibase.properties 파일을무시한다. 그렇기때문에 isql 툴은 ALTIBASE 접속에필요한속성중누락된 PortNo 을입력받으려한다. $ server create ASCII UTF8 ----------------------------------------------------------------- Altibase Client Query utility. Release Version 5.3.3.6 Copyright 2000, ALTIBASE Corporation or its subsidiaries. All Rights Reserved. ----------------------------------------------------------------- Write PortNo (default:20300) : ISQL_CONNECTION = UNIX, SERVER = 127.0.0.1, PORT_NO = 0 [ERR-910FB : Connected to idle instance] $ is ----------------------------------------------------------------- Altibase Client Query utility. Release Version 5.3.3.6 Copyright 2000, ALTIBASE Corporation or its subsidiaries. ALTIBASE 설치시발생할수있는문제상황과조치 9 page of 13
All Rights Reserved. ----------------------------------------------------------------- Write PortNo (default:20300) : ISQL_CONNECTION = TCP, SERVER = 127.0.0.1, PORT_NO = 20300 [ERR-50032 : Client unable to establish connection.] 해결 : Property 값의오류 2 항목처럼 isql 을통해 control 해보고 ALTIBASE Trace 로그파일중 altibase_boot.log 파일을확인해서비정상적인값을수정해야한다. 해결 : 문제가되는속성을확인하고정상적인값으로 수정해준다. 파일쓰기오류 파일쓰기오류는여러가지문제요인에의해발생할수있다. 해당디스크에여유공간이부족하거나, 혹은해당 directory 에권한이누락되었을수도있다. 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 파일을찾게되므로해당파일이없다는에러메시지를돌려준다. ALTIBASE 설치시발생할수있는문제상황과조치 10 page of 13
TRANSITION TO PHASE : CONTROL [FAILURE] The log anchor file does not exist or it is not valid. Startup Failed... 해결 : 데이터베이스생성절차를수행한다. Listener port bind 실패 ALTIBASE 프로세스가사용할 TCP port를 bind하는단계에서실패할경우에발생한다. TRANSITION TO PHASE : SERVICE [CM] Listener failed : TCP on port 20300 [FAILURE] Unable to bind the socket. Startup Failed... 해결 : 해당포트를바인딩할수없는원인을찾아해결한다. 다른어플리케이션이선점했을경우어플리케이션이나 ALTIBASE 의사용포트를변경해주어야한다. Replication port bind 실패 ALTIBASE 의 Replication thread 가사용할포트를 bind 하는단계에서실패할경우에발생한다. TRANSITION TO PHASE : SERVICE [CM] Listener started : TCP on port 20300 [CM] Listener started : UNIX [RP] Initialization : FAIL [FAILURE] [Receiver] Failed to listen to a replication socket (Port No:30300) Startup Failed... 해결 : 해당포트를바인딩할수없는원인을찾아해결한다. 다른어플리케이션이선점했을경우어플리케이션이나 ALTIBASE 의사용포트를변경해주어야한다. ALTIBASE 설치시발생할수있는문제상황과조치 11 page of 13
WINDOWS 환경에서의문제상황유형및조치법 공통적으로발생할수있는문제외에 WINDOWS 환경에서만발생할수있는문제상황에대한조치법을제시합니다. 라이선스키값의오류 장비의네트워크카드가여러개인경우 ALTIBASE 는 OS 환경에따라라이선스키값을확인하는데사용하는 Mac address 가변경될수있다. 이문제는최초 ALTIBASE 설치작업외에운영시에도발생할수있다. TRANSITION TO PHASE : PROCESS invalid MEM_MAX_DB_SIZE, available DB Size is 0 key : [current_license_key_value] Invalid or expired license in License File(C:\altibase_home\conf\license) mac->000000000000 해결 : 에러메시지에안내되는 Mac address 에해당하는라이선스를발급받아적용한다. 추가적으로, WINDOWS 환경에서는네트워크카드가 disable 상태가되면 Mac address 를 000000000000 으로인식하는경우가있다. 이러한경우를모두고려해보았을때 WINDOWS 환경에설치를하고자할때에는모든네트워크카드의 Mac address 와 000000000000 에해당하는라이선스를모두발급받아적용하는것도좋은방법이다. ALTIBASE 설치시발생할수있는문제상황과조치 12 page of 13
알티베이스 서울특별시구로구구로 3 동 182-13 대륭포스트 2 차 1008 호 02-2082-1000 http://www.altibase.com 대전사무소대전광역시서구둔산동 921 주은리더스텔 901 호 042-489-0330 기술지원본부서울특별시구로구구로 3 동 182-13 대륭포스트 2 차 908 호 02-2082-1000 솔루션센터 02-2082-1114 http://support.altibase.com Copyright c 2000~2013 ALTIBASE Corporation. All Rights Reserved. 이문서는정보제공을목적으로제공되며, 사전에예고없이변경될수있습니다. 이문서는오류가있을수있으며, 상업적또는특정목적에부합하는명시적, 묵시적인책임이일체없습니다. 이문서에포함된 ALTIBASE 제품의특징이나기능의개발, 발표등의시기는 ALTIBASE 재량입니다. ALTIBASE는이문서에대하여관련된특허권, 상표권, 저작권또는기타지적재산권을보유할수있습니다. ALTIBASE 설치시발생할수있는문제상황과조치 13 page of 13