Background Image
조회 수 558 추천 수 0 댓글 0
?

단축키

Prev이전 문서

Next다음 문서

크게 작게 위로 아래로 댓글로 가기 인쇄 첨부

CUBRID상에서 서비스 개발 및 운영 시 마주치게 되는 여러가지 문제를 해결하기 위해서는 오류코드(메세지)에 대한 해석과 서버에서 생성하는 다양한 로그에 대한 해석이 중요합니다.


이번 글에서는 해석에 치중하기 보다는 CUBRID 9.3 기준으로 어떤 종류의 오류코드(메세지)가 있는지 어떤 종류의 로그들이 생성되는지를 우선으로 살펴보겠습니다. 향후 시간이 되면 해석에 대해서도 글을 올리도록 하겠습니다.


C 또는 JAVA언어를 이용하여 서비스 개발시 참고할 수 있는 오류 코드 종류는 아래 표와 같으며, 이를 활용하여 Source Debugging과 다양한 조건 및 상태에 따른 분기가 가능한 프로그램을 개발할 수 있습니다.



응용관련 CCI 오류코드 (오류 메시지) JDBC 오류코드 (오류 메시지) CAS 오류코드 (오류 메시지) DB관련 데이터베이스 서버 오류코드 (오류 메시지)


 

먼저 발생하는 오류 코드 종류에 대해서 알아 보도록 하겠습니다.


1. 응용관련 메시지


1.1 CCI에서 발생한 오류 코드 구분


      CUBRID에서는 C기반 응용프로그램 개발을 위해 CCI(C Client Interface)제공하며, 오류 발생 시 음수 값을 반환합니다.

      발생하는 오류 코드 구분 규칙은 다음과 같습니다.

     

        -  20002 ~ -20999 : CCI API 함수내에서 발생한 오류 코드

        -  10000 ~ -10999 : CAS에서 발생한 오류 코드.

         -  20001                : 데이터베이스 서버에서 발생한 오류 코드


오류코드 목록, 각 항목에 대한 상세 메시지, 프로그램 예제 및 CCI 함수에서 사용하는 구조체에(struct) 대한 자세한 내용은 아래의 큐브리드 매뉴얼 CCI 오류코드 URL를 참고 바랍니다.


https://www.cubrid.org/manual/ko/9.3.0/api/cci.html#cci-error-codes

 

1.2 JDBC에서 발생한 오류 코드 구분


      CUBRID에서는 Java 기반 응용프로그램 개발을 위해 JDBC 드라이버(cubrid_jdbc.jar)를 제공합니다. CUBRID JDBC 드라이버는 2.0 스펙을 기준으로 개발되었으며 설치 위치는

     <CUBRID 설치 디렉터리>/jdbc 디렉터리에 위치하며 JDK 1.6에서 컴파일한 것을 기본으로 제공합니다.

     Java 응용프로그램에서 오류는 SQLException Class를 통해 오류 정보를 얻을 수 있으며, 오류 코드 구분 규칙은 다음과 같습니다. 


       -  21001 ~ -21999 : JDBC 메소드 내부에서 발생한 오류 코드

       -  10000 ~ -10999 : CAS에서 발생한 오류 코드

       -  0 ~ -9999           : 데이터베이스 서버에서 발생한 오류 코드


오류 코드 및 오류 메시지를 출력하는 예제는 아래의 URL를 참고 바랍니다.


https://www.cubrid.org/manual/ko/9.3.0/api/jdbc.html



1.3 데이터베이스 서버 오류 코드


데이터베이스 서버 프로세스는 오류 발생 시 서버 오류 코드 항목을 사용합니다. 서버 오류는 서버 프로세스를 사용하는 모든 작업에서 발생할 수 있습니다. 예를 들어 질의를 처리하는 프로그램 또는 cubrid 유틸리티 사용 중에도 발생할 수 있습니다.


CCI 에서는 dbi.h를 포함할 수 있으므로 오류 코드명을 사용하는 것이 프로그램 가독성을 위해 권장되며, JDBC 에서는 dbi.h 파일을 포함할 수 없으므로 오류 코드 번호를 직접 사용합니다. JDBC에서는 SQLException 클래스의 getErrorCode() 메서드를 통해 오류 번호를 얻을 수 있습니다.


데이터베이스 오류 코드 및 메시지에 대한 자세한 내용은 아래의 URL를 참고 바랍니다.


https://www.cubrid.org/manual/ko/9.3.0/admin/control.html#database-server-error

 

1.4 CAS 오류 코드

 

브로커의 응용 서버(CAS) 프로세스에서 발생하는 오류로, CCI 또는 JDBC 드라이버를 이용하여 접속하는 모든 응용 프로그램에서 발생할 수 있습니다.

관련 오류코드 및 메시지에(CCI/JDBC)에 대한 자세한 내용은 아래의 URL를 참고 바랍니다.


https://www.cubrid.org/manual/ko/9.3.0/admin/control.html#cas-error


다음은 서버에서 발생하는 로그에 대한 내용을 살펴보겠습니다.


아래 표처럼 로그는 2개로 구분할 수 있습니다.


브로커/CAS 응용과 관련된 브로커 로그 DB관련 데이터베이스 서버 로그


브로커/CAS 브로커 로그, DB관련 데이터베이스 서버 로그


2.1 브로커 로그


브로커 로그의 경우 응용서버(WAS)에서 연결되는 과정을 시작으로 질의문 및 바인드 변수, 최종 수행시간 및 건수등에 대한 내용을 포함하고 있어, 성능이슈 및 장애발생에 대한 원인분석 시 사전 징후를 체크해 볼 수 있는 용도로 활용해 볼 수 있습니다. 운영 환경에서 APM 솔루션이 구축되어 실시간 및 사후 분석이 가능한 환경이라면 브로커 로그를 비활성화 할 수도 있습니다.

브로커 관련 로그에는 접속 로그, 오류 로그, SQL 로그가 있으며 각각의 로그는 설치 디렉터리의 log 디렉터리에서 확인할 수 있습니다.


- 접속 로그는 응용 클라이언트 접속에 관한 정보를 기록하며 $CUBRID/log/broker의 위치의 <broker_name>.access 형태로 저장됩니다.


접속로그.jpg


- 오류 로그는 응용 클라이언트의 요청을 처리하는 도중에 발생한 오류에 관한 정보를 기록하며, $CUBRID/log/broker/error_log 위치의 <broker_name>_<app_server_num>.err 형태로 저장됩니다.


오류로그.jpg

- SQL 로그는 응용 클라이언트가 요청하는 SQL을 기록하며, $CUBRID/log/broker/sql_log 위치의 <broker_name>_<app_server_num>.sql.log 형태로 저장된다. 저장여부 및 위치,용량(기본값 : 10MB)을 파라메타 설정으로 변경할 수 있다.


SQL로그.jpg




2.2 데이터베이스 서버 로그


데이터베이스 서버 로그는 master에서 발생하는 로그, 각 유틸리티에서 발생하는 로그 및 데이터베이스 서버에서 발생하는 로그로 구분됩니다.


 - master 로그는 HA에 대한 정보와 서버들의 연결에서 발생하는 오류 정보를 확인할 수 있습니다. 위치는 $CUBRID/log/<hostname>_master.err 입니다.

 

- 각 유틸리티에서 발생하는 로그는 유틸리티 실행시 발생하는 로그를 저장하는 것으로 위치는 $CUBRID/log/<db name>_<utility name>.err 입니다.

   대표적으로 cubrid_utility.err 로그는 DB 기동 및 정지와 관련 유틸리티들이 실행된 로그를 저장하는 로그 파일입니다.

 

- 데이터베이스 서버에서 발생하는 로그는 제한된 IP에서 접속을 시도하거나 정상 임계치를 벋어난 성능 이슈 및 오류 발생 등의 로그입니다.

   로그는 $CUBRID/log/server 위치하며, <db name>_<start date_time>.[access | event | err] 의 파일명으로 저장됩니다.


서버 로그에 대한 자세한 정보는 아래의 URL를 통해 자세한 내용을 참고 바랍니다.


https://www.cubrid.org/manual/ko/9.3.0/admin/control.html#server-logs


  1. 2018년 CUBRID 정기교육을 마무리 하며..

    큐브리드에서는 매년 정기적으로 정기교육을 실시하고 있습니다.   금년도에는 공개SW개발자센터에 공개SW커뮤니티를 등록하여 커뮤니티 활성화 및 큐브리드를 사용자를 위한 교육을 진행했습니다. 정기교육이 어떻게 진행되고 있는지, 커리큘럼, 자주 듣는 궁금증 등에 대해 알아보겠습니다. 『2018년 정기교육 일정』 일시 장소 참석인원 03월 20일 ~ 21일 공개SW역량프라자(상암) 23명 05월 29일 ~ 30일 공개SW개발자센터(선릉) 06명 09월 04일 ~ 05일 공개SW역량프라자(상암) 24명 10월 16일 ~ 17일 공개SW역량프라자(상암) 13명       정기교육은 2일 과정으로 4회 진행되며, 교육에 참여해주신 분들에게 교육 교재와 자료를 나눠드리고, 점심식사도 제공하고 있습니다. 『신청방법』      http://www.cubrid.com/education에서 일정을 확인할 수 있으며, 교육일정 1개월 전에 온라인 신청을 오픈합니다. 『커리큘럼』      다음과 같이 1일차, 2일차로 교육내용이 다르며, 2일동안 교육을 참여해주시는 것이 도움이 됩니다. 또한 실습과정도 포함되어 있습니다.       2일 과정을 수료해주신 분들에게는 큐브리드에서 발급한 수료증을 나눠드립니다. 1일차 CUBRID 소개 ...
    Date2018.11.15 Category알려요~ By정훈 Views15
    Read More
  2. timezone, tz data

    Timezone Timezone 하면 딱 생각나는 것은 +09:00, 우리나라는 그리니치 표준시 (GMT)보다 9시간 빠르다는 것이다.  해외 여행중 한국에 국제 전화할 때 꼭 알아야 할 것, "한국 시간 몇시인가?" 잘못하면 식구들 자는 중에 집에 전화할 수 있다. Timezone이 뭔가? 사전적 정의는 “특정 국가나 지역의 현지시간 (local time)” 이다. 그리니치 표준시의 정오는 경도 0도에 위치한 그리니치 천문대 남중 자오선을 태양이 지나가는 시간이다. 1925년 부터, 특정 지역의 local-time은 그리니치 표준시를 기준으로 몇시간 빠르고 느린가로 표현되어왔다. 그리니치 동쪽은 +, 서쪽은 -로 표현한다. GMT 시간이 그리니치 천문대를 지나는 태양을 기준으로 하기 때문에 시간이 지구의 자전 주기와 관련 되며, 자전의 흐름이 늦어지면서 오차가 발생되었고 새로운 표준시 제정에 대한 요구가 나오게 되었다. 1972년, 국제 표준시는 그리니치 표준시에서 UTC (Coordinated Universal Time)로 변경되었다.   UTC는 세슘 원자 시계 기반의 세계 표준시이며,  UTC와 GMT는 소숫점 단위에서만 차이가 나기 때문에 일상적으로 같은 수준으로 혼용해서 사용하기도 하나 기술적인 표현에서는 UT...
    Date2018.11.14 Category제품 여행 By한기수 Views19
    Read More
  3. CUBRID-HA 제약사항을 극복해보자

     Charpter0. 들어가며.. 주요한 시스템인 경우, 장애가 발생하더라도 실시간으로 서비스를 제공해야 함으로 CUBRID이중화 방식은 필히 적용해야 할 구성방식입니다. 그러나 LOB 를 사용하지 못하는 제약사항이 있어 이를 극복할 수 있는 방법이 있지 않을까해서 테스트한 내용입니다. 본 장에서는 Linux에서, fail-over, fail-back상황에서 테스트했지만, 더 많은 OS, 더 많은 상황에서도 동기화가 되는지 종합적인 테스트가 이루어져야 할 것입니다. Chapter1. HA란 무엇인가 CUBRID에서는 HA기능을 기본적으로 제공하고 있다. HA란 무엇인가??  High Availability(HA)란, 하드웨어, 소프트웨어, 네트워크 등에 장애가 발생해도 지속적인 서비스를 제공하는 기능이다. 이 기능은 하루 24시간 1년 내내 서비스를 제공해야 하는 네트워킹 컴퓨팅 부분에서 필수적인 요소이다. HA 시스템은 두 대 이상의 서버 시스템으로 구성하여 시스템 구성 요소 중의 한 요소에 장애가 발생해 서비스를 중단 없이 제공할 수 있다.  운영중인 하나의 서버(master-node)에 이상이 발생하여도 대기중 이였던 서버(slave-node)를 활용하여 중단없는 서비스를 제공한다는 것이다.  어떠한 방식으...
    Date2018.11.07 Category제품 여행 By큐브리드_김주현 Views59
    Read More
  4. CUBRID contribute의 두번째 걸음, CUBRID 디버깅 하기

    디버깅은 실행중인 프로세스를 컨트롤할 수 있어 문제점을 찾거나 현재 로직을 확인 할 때 유용한 방법입니다. 이번에는 GDB를 활용하여 CUBRID server 프로세스를 디버깅해보도록 하겠습니다. GDB 사용에 앞서 CUBRID 빌드가 되어 있어야 합니다. CUBRID  빌드 관련 내용은 아래 링크를 확인하세요. http://www.cubrid.com/blog/3814572   디버깅을 위해서는 'debug' 모드로 빌드해주세요.  1 2 [root]vi build.sh build_mode="debug" cs   빌드시 에러가 발생한다면 표준에러만 파일로 리다이렉션하여 확인하는 것이 좋습니다.  1 2 [root]vi build.sh 2> error.out vi error.out cs 빌드가 완료가 되었다면 bash_profile 파일에 PATH 관련 정보를 추가 저장합니다. CUBRID 위치는 build시 저장한 위치로 변경하세요.  1 2 3 4 5 6 7 8 9 10 cd ~ [root]vi .bash_profile export CUBRID=/cubrid10.1/CUBRID   export CUBRID_DATABASES=$CUBRID/databases export PATH=$PATH:$CUBRID/bin export LD_LIBRARY_PATH=$CUBRID/lib:$LD_LIBRARAY_PATH CLASSPATH=$CUBRID/jdbc/cubrid_jdbc.jar export CLASSPATH [root]source .bash_profile cs demo DB를 생성합니다.​ 1 2 3 4 5 6 c...
    Date2018.08.09 Category제품 여행 By박세훈 Views342
    Read More
  5. No Image

    CUBRID 사용 포트와 OS명령어로 포트 오픈 상태 점검하기

    CUBRID를 설치 후 사용자들이 응용 프로그램과 CUBRID Manager 또는 CUBRID Migration Toolkit(CMT)를 연결 할 때 어떤 포트를 사용해야 하는지 "방화벽 문제로 CUBRID DB서버와 접속이 안되는 현상" 때문에 Q&A 문의가 생각보다 많이 있어 이번 블로그 내용에서는 접속대상 서버(PC)와 CUBRID DB서버간 포트개방 생태를 OS명령어로 확인하는 방법을 소개하고자 합니다.  우선, CUBRID 포트관련 내용을 간단하게 정리하면 설정 파일들은 $CUBRID/conf 디렉토리에 위치해 있고 cubrid.conf에 cubrid_port_id=1523, cubrid_broker.conf에 BROKER_PORT=30000,33000, cubrid_ha.conf에 ha_port_id=59901, cm.conf에 cm_port=8001 포트로 기본설정되어 있습니다, 아래 표는 CUBRID가 사용하는 포트를 정리한 것입니다.   1, CUBRID 포트 정리표 구분 대상 장비 Linux 포트 Windows 포트 방화벽 Single DB WEB/WAS Server 33000(TCP) 33000~33040(TCP) 개방 CUBRID Manager 30000(TCP) 8001(TCP) 30000~30040(TCP) 8001(TCP) 개방 CUBRID CMT 30000(TCP) 30000~30040(TCP) 개방 CUBRID HA WEB/WAS Server 33000(TCP) 33000~33040(TCP) 개방 CUBRID Manager 30000(TCP) 8001(TCP) ...
    Date2018.07.03 Category제품 여행 By정만영 Views507
    Read More
  6. Windows 10에서 CUBRID linux 버전 사용하기

    MS에서 2016.08.02 기준으로 Windows 1주년 업데이트 버전을 배포했다. 해당 업데이트의 믄 변화에는 bash(Linux 용 Windows 하위시스템 beta)를 사용할 수 있다는 것이다. 해당 버전에서 정상 동작 하는지 테스트를 해 보았으나, 초기 버전에는 linux의 shared memory 관리 부분이 구현이 덜 되어 데이터베이스 서버 엔진은 구동이 가능하지만  쉐어드 메모리를 사용하는 브로커는 정상 작동하지 않았다. 해당 버그는 MS의 GitHUB https://github.com/Microsoft/WSL/issues/92 에 보고 되어 수정이 되었다. Windows 16215 버전 이후 버전 및 작년 가을에 레드스톤3 업데이트 Fall Creators Update 에 와서는 CUBRID가 정상 구동 할 수 있는 shared memory 환경이 되었다. Windows 10 버전를 꾸준히 업데이트만 받았다면, 이제 CUBRID를 bash 환경에서 구동이 가능하다. 일단 기본적으로 활성화되는 기능은 아니기 때문에 제어판 > 프로그램 > 프로그램 및 기능 > Windows 기능 켜기/끄기에서 해당 기능을 활성화 해야한다. 활성화 이후에는 재부팅이 필요 할 수 있다. 또는 MS의 Install the Windows Subsystem for Linux 가이드 (https://docs.microsoft.com/ko-kr/windows/w...
    Date2018.06.27 Category제품 여행 By성진 Views422
    Read More
  7. 큐브리드의 유용한 명령어 살펴보기

    데이터베이스 시스템을 운영하면서 성능 개선은 매우 중요한 일입니다. CUBRID는 다른 DBMS와 다르게 JDBC 드라이버-브로커-데이터베이스 서버의 3계층(3-tier) 구조로 구성되어 있습니다. 3계층 중 브로커는 서버와 외부 응용 프로그램 간의 통신을 중계하는 CUBRID 전용 미들웨어로서, 커넥션 풀링, 모니터링, 로그 추적 및 분석 기능을 제공합니다. CUBRID는 CUBRID BROKER프로세스가 생성한 SQL LOG파일을 통해 SQL 성능 분석을 할 수 있습니다. (다른 DBMS 성능 모니터링은 시스템 DMV를 조회하여 확인합니다.)  이번 블러그에서는 CUBRID BROKER가 생성한 SQL LOG 파일을 이용하여 성능 문제를 분석하고 개선하는데 유용한 유틸리티에 대해 3회에 걸쳐 소개할 예정이며, 첫번째로 소개할 유틸리티는 broker_log_top 입니다. ▣ broker_log_top broker_log_top 유틸리티는 수행 시 특정 기간 동안 생성된 SQL LOG 파일를 분석하여 실행 시간이 긴 순서대로 나열합니다. 이 유틸리티는 수행시 log_top.res와 log_top.q와 같이 2개의 결과 파일을 남깁니다. log_top.res 파일에는 특정기간 동안 수행된 SQL들에 대한 최대 수행 시간, 최소 수행 시간, 평균 수행 시간 및 수...
    Date2018.01.04 Category제품 여행 By성진 Views1050
    Read More
  8. 젊은 열정 대학생들과 함께한 컨트리뷰톤(contributon) 2017

    프롤로그 컨트리뷰톤 2017(https://www.kosshackathon.kr). 약 2달간의 일정으로 진행되는 오픈소스 멘토링 행사에 멘토 자격으로 참여하였습니다. 총 10개의 프로젝트에 각각 12~15명 내외의 멘티들이 선발되어 git 사용법부터 오픈소스에 컨트리뷰션(contribution)까지 진행해보는 과정으로 대학생들이 주를 이루었지만 간혹 경력이 상당한 개발자 분들도 멘티로써 참석하셨습니다. 뜨거운 열정이 느껴집니다. 저희는 CUBRID Manager(GUI 도구)를 진행 프로젝트로 선정하였는데, 오픈소스를 거의 처음 접해보는 멘티들에게 적절한 선택이지 않았나 생각합니다. 아래 사진 속에 저와 멘티들이 보이네요. 아마 진행할 프로젝트와 멘토 소개를 했던 것으로 기억하는데, 오랜만에 100명이 넘는 사람들 앞에서 잡은 마이크라 그런지 긴장한 모습이 역력합니다. 오픈소스 참여하고 싶어요 멘티들과의 첫만남. 저는 “컨트리뷰톤에 등록된 프로젝트 중 왜 CUBRID Manager에 지원하셨어요”란 질문을 던졌습니다. 아마 “CUBRID에 관심이 많아요.”, “DBMS 개발을 해보고 싶어요.”란 답변을 기대했던거 같은데, 의외로 “쉬워보여서요.”, “오픈소스가 처음인데, 멘토님이 친절하실 것 같아...
    Date2017.12.28 Category오픈소스 이야기 By민준 Views810
    Read More
  9. CUBRID 전환 시에 어떤 고민을 해야 할까요?

    최근 공개소프트웨어에 대한 관심이 높아지면서 국내 유일의 오픈소스 DBMS인 CUBRID도 많은 주목을 받고 있습니다.  전환을 생각하는 사용자로부터 많이 받는 질문 중 하나는 “우리가 운영하고 있는 시스템의 DBMS가 오라클/MySQL/MS-SQL 인데 CUBRID로 전환이 가능한가요?” 입니다. 그래서, 오라클 기반의 서비스를 CUBRID로 전환할때 전환에 절차 및 고려 사항들에 대한 대략적인 내용을 정리해보았습니다. 우선, CUBRID로 전환하기 위한 절차는 1)전환 가능성 분석  2) 기존 환경분석  3) 개발환경 구성 4) SQL 전환 순으로 진행됩니다. 이후의 절차인 운영환경 전환, 성능테스트, 운영 유지보수 등의 내용은 생략하도록 하겠습니다. 그럼, 각 절차에 대해서 상세히 알아보도록 하겠습니다 1) 전환 가능성 분석 아래 표와 같이 각 항목별로 배점을 부여하여 DBMS 전환이 가능한지를 확인합니다.  각 항목별배점 예시는 50:30:20, 60:20:20 등과 같이 배점기준을 정하여 가능성을 분석하며, 배점결과가 약 70~80 이상일 경우에는 전환이 가능하다고 판단하면 됩니다. 2) 기존 환경 분석 전환이 가능하다고 판단되면, 전환범위와 DBMS 스키마, DB크기 등에 대한 시스템 전반...
    Date2017.12.26 Category제품 여행 By권호일 Views957
    Read More
  10. CUBRID의 오류 종류와 생성되는 로그 종류는 ?

    CUBRID상에서 서비스 개발 및 운영 시 마주치게 되는 여러가지 문제를 해결하기 위해서는 오류코드(메세지)에 대한 해석과 서버에서 생성하는 다양한 로그에 대한 해석이 중요합니다. 이번 글에서는 해석에 치중하기 보다는 CUBRID 9.3 기준으로 어떤 종류의 오류코드(메세지)가 있는지 어떤 종류의 로그들이 생성되는지를 우선으로 살펴보겠습니다. 향후 시간이 되면 해석에 대해서도 글을 올리도록 하겠습니다. C 또는 JAVA언어를 이용하여 서비스 개발시 참고할 수 있는 오류 코드 종류는 아래 표와 같으며, 이를 활용하여 Source Debugging과 다양한 조건 및 상태에 따른 분기가 가능한 프로그램을 개발할 수 있습니다. 응용관련 CCI 오류코드 (오류 메시지) JDBC 오류코드 (오류 메시지) CAS 오류코드 (오류 메시지) DB관련 데이터베이스 서버 오류코드 (오류 메시지)   먼저 발생하는 오류 코드 종류에 대해서 알아 보도록 하겠습니다. 1. 응용관련 메시지 1.1 CCI에서 발생한 오류 코드 구분       CUBRID에서는 C기반 응용프로그램 개발을 위해 CCI(C Client Interface)제공하며, 오류 발생 시 음수 값을 반환합니다.       발생하는 오류 코드 구분 규칙은 다음과 같...
    Date2017.12.26 Category제품 여행 By김창휘 Views558
    Read More
Board Pagination Prev 1 2 3 4 5 6 7 8 9 Next
/ 9

Contact Cubrid

Tel. 070-4077-2110 / Email. contact_at_cubrid.com
Contact Sales