CUBRID | 블로그 - 기술지원 중 자주받는 질문들을 살펴보자 !

큐브리드 엔지니어로 기술지원을 수행하면서 자주 받는 질문들을 크게 10개 단락으로 나누어 모아 보았습니다.

큐브리드를 사용해주시는 많은 분들에게 작게나마 도움이 되기를 바라는 마음으로 작성해 보았습니다.

자세한 내용은 하단에 매뉴얼 링크를 달아 두었으니 참조 부탁 드립니다

1. DB 백업/복구

1) 백업 명령어를 알고 싶어요.

① $ cubrid backupdb -D <백업 경로> -z --no-check <DB명>

2) 증분 백업도 지원하나요?

① 큐브리드는 1차, 2차 증분 백업을 지원합니다.

② 증분 백업을 하기 위해서는 백업 옵션 중 -l 옵션을 사용하면 됩니다. 백업수준은 0,1,2 3가지로 나뉘어 지며 각각 전체 백업, 1차 증분 백업, 2차 증분 백업을 의미합니다.

③ 예시 : cubrid backupdb -D <백업 경로> -z --no-check -l 1 <DB명>

3) 복구는 어떻게 해야 하나요?

① $ cubrid restoredb -B <백업 파일 경로> <DB명>

4) 시점 복구도 지원하나요?

① 큐브리드는 어떠한 옵션도 지정되지 않은 경우 기본적으로 마지막 커밋 시점까지 데이터베이스가 복구됩니다. 시점 복구를 하기 위해서는 -d 옵션으로 시간을 지정할 수 있으나, 지정한 복구 시점까지 복구하기 위한 활성로그/보관 로그 파일이 존재해야만 하며 backuptime이라는 워드를 지정할 경우 마지막 백업이 수행된 시점까지 복구됩니다.

② 예시 : cubrid restoredb -B <백업 파일 경로> -d 30-12-2018:10:00:00 <DB명>

5) 백업이 실패했어요.

① 백업이 실패할 경우 $CUBRID/log/<DB명>_backup.err 파일을 확인하여 원인분석을 할 수 있습니다.

② 백업 실패 예시 #1 : 백업 경로 퍼미션 에러

Ø 백업 경로에 대한 접근, 쓰기 권한에 대한 확인 필요

Time: 12/26/18 10:42:10.901 - ERROR *** file Unknown from server, line -1 ERROR CODE = -8 Tran = 3, EID = 2

Unable to format disk volume "/home/cub938/CUBRID/log/backup/testdb_bk0v000" with -1 pages (244813135871 bytes).... Permission denied

③ 백업 실패 예시 #2 : DB가 내려가 있거나, DB명이 잘못된 경우

Ø DB가 내려가 있을 경우 -S 옵션 추가

Ø DB명이 잘못된 경우 정확한 DB명 확인 필요(cat $CUBRID/databases/databases.txt)

Time: 12/26/18 10:42:45.283 - ERROR *** file ../../src/transaction/boot_cl.c, line 1743 ERROR CODE = -677 Tran = -1, EID = 3

Failed to connect to database server, 'testdb', on the following host(s): localhost

④ 백업 실패 예시 #3 : Lock으로 인해 백업수행이 실패된 경우

Ø Lock 으로 인해 실패된 경우 --no-check 옵션을 사용하여 재 시도

Time: 12/26/18 10:44:24.395 - ERROR *** file Unknown from server, line -1 ERROR CODE = -74 Tran = 2, EID = 2

Your transaction (index 2, DBA@cub93|41813) timed out waiting on IS_LOCK lock on class jin. You are waiting for user(s) DBA@cub93|csql(41796) to finish.

2. 트랜잭션

1) 트랜잭션 확인 어떻게 하나요?

① $ cubrid tranlist -u dba -p <dba 패스워드> <DB명>@localhost

2) 트랜잭션 죽이는 방법 좀 알려주세요.

① $ cubrid killtran -p <dba 패스워드> -i <Tran Index 번호> <DB명>@localhost

3. 매니저

1) 매니저 연결이 안돼요.

① 큐브리드 매니저 서버 재 기동

- $ cubrid manager stop

- $ cubrid manager start

② 윈도우 PC와 큐브리드 서버 간 8001번 포트, 브로커 포트(30000) 방화벽 확인

2) 매니저가 느려요.

① 매니저 클라이언트 최신 버전으로 업그레이드 수행

② C:\CUBRID\cubridmanager\cubridmanager.ini 파일 내 최대 메모리 설정 값 수정

- 수정 예시

--startup

plugins/org.eclipse.equinox.launcher_1.1.0.v20100507.jar

--launcher.library

plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.0.v20100503

--launcher.XXMaxPermSize

512m

-vmargs

-Dosgi.requiredJavaVersion=1.6

-XX:PermSize=256m

-XX:NewSize=128M

-XX:MaxNewSize=512M

-XX:MaxGCPauseMillis=20

-XX:MaxHeapFreeRatio=80

-XX:MaxGCPauseMillis=10

-XX:+UseFastAccessorMethods

-XX:+AggressiveOpts

-Xms768m

-Xmx4096m

-XX:PermSize=64M

-XX:MaxPermSize=512m

-XX:+UnlockExperimentalVMOptions

-XX:+UseG1GC

4. DBA 유저

1) DBA 그룹에 속해 있는 유저를 확인하고 싶어요.

① select u.name from db_user as u, TABLE(u.direct_groups) as g(x) where x.name = 'DBA'

2) 기존 유저를 DBA 그룹에 추가하고 싶어요.

① $ call find_user('dba') on class db_user to x1;

② $ call add_member('유저 명') on x1;

3) DBA 그룹에 포함되어 있는 유저를 DBA 그룹에서 제외시키고 싶어요.

① $ call find_user('dba') on class db_user to x1;

② $ call drop_member('유저 명') on x1;

5. DB 기동

1) DB 기동이 안돼요.

① 기동 실패 예시 #1 : Log가 손상된 경우

Ø 아래 에러 로그는 Log가 손상되어 발생하는 에러로, 손상된 Log에 대한 복구 작업이 필요합니다.

12/30/18 14:28:00.000 ERROR file ..\..\src\transaction\log_recovery.c, line 2898 ERROR CODE = -81 Tran = 0, CLIENT = (unknown):(unknown)(-1), EID = 1 : Internal error: logical log page 1223321 may be corrupted.

12/30/18 14:28:00.01 FATAL ERROR file ..\..\src\transaction\log_recovery.c, line 3031 ERROR CODE = -644 Tran = 0, CLIENT = (unknown):(unknown)(-1), EID = 3 : LOG FATAL ERROR: log_recovery_analysis

① cubrid emergency_patchlog <db명> : 정상적으로 완료될 경우 DB 기동, 오류 발생 시 2번 명령어 수행

② cubrid emergency_patchlog -r <db명> : 정상적으로 완료될 경우 DB 기동, 오류 발생 시 백업본을 통해 해당 DB 복구해야 함

② 기동 실패 예시 #2 : /etc/hosts 파일에 읽기 권한이 없는 경우

Ø 큐브리드 계정에 /etc/hosts 파일에 대한 읽기 권한이 주어져 있는지 확인 필요

Time: 12/30/18 13:37:09.494 - ERROR *** file /home1/build/workspace/CUBRID_10.1/cubrid/src/connection/tcp.c, line 287 ERROR CODE = -350 Tran = -1, EID = 1

Error getting local host by name for host "localhost". Host not found.

③ 기동 실패 예시 #3 : /etc/hosts 파일에 IP와 호스트 네임이 정상적으로 기재되지 않은 경우

Ø /etc/hosts 파일 내 해당 호스트에 대한 IP와 호스트네임 정보에 대한 확인 필요

Time: 12/30/18 13:42:49.828 - ERROR *** file /home1/build/workspace/CUBRID_10.1/cubrid/src/connection/tcp.c, line 141 ERROR CODE = -353 Tran = 0, CLIENT = (unknown):(unknown)(-1), EID = 3

Cannot make connection to master server on host "cub_test".... No route to host

6. DB 경로변경

1) DB 경로를 변경하고 싶어요.

① DB 볼륨 경로를 변경하기 위한 방법 중 가장 간편히 할 수 있는 방법은 백업/복구를 이용하는 것입니다. DB백업 수행 후 databases.txt 파일 내 vol-path 부분을 이동할 경로로 변경한 뒤 복구를 수행해야 합니다.

② DB 경로변경 절차 #1 : 백업 수행(DB 정지 후 수행)

$ cubrid backupdb -D <백업 경로> -z --no-check <DB명> -S

③ DB 경로변경 절차 #2 : databases.txt 파일 수정(이동할 경로로 수정)

$ vi $CUBRID/databases.txt

#db-name vol-path db-host log-path lob-base-path

testdb /home/cub938/DB localhost /home/cub938/DB file:/home/cub938/DB/lob

④ DB 경로변경 절차 #3 : 복구 수행(-u 옵션 이용)

$ cubrid restoredb -B <백업 파일 경로> -u <DB명>

⑤ DB 경로변경 절차 #4 : DB 기동 후 서비스 확인

⑥ 주의 사항 : lob, java 파일의 경우 백업 시 포함되지 않기 때문에 별도 관리 필요

7. 패스워드 분실

1) DBA 패스워드를 분실했어요.

① CUBRID 엔진 내 DBA 패스워드를 찾거나 초기화 할 수 있는 방법이 별도로 존재하지 않기 때문에 DBA 패스워드 분실시에는 CUBRID 엔지니어에게 기술지원 요청을 해주시기 바랍니다.

2) 큐브리드 매니저 admin 계정 패스워드를 분실했어요.

① admin 패스워드 초기화(기본 admin 계정 패스워드 : admin)

② $CUBRID/conf/cm.pass 파일 내용을 admin:6e85f0f80f030451dc9e98851098dfb2 으로 수정

8. 로그 확인

1) 로그 위치를 알고 싶어요.

① 서버 로그 위치 : $CUBRID/log/server로 현재 서버 로그는 .err로 끝나는 파일 중 가장 최근시점에 생성된 파일을 확인하시면 됩니다.

② 브로커 SQL 로그 위치 : 기본 값은 $CUBRID/log/broker/sql_log이며, 별도 위치를 설정해놓은 경우 cat $CUBRID/conf/cubrid_broker.conf | grep -A 15 -i <브로커 명> | grep -w LOG_DIR 명령어를 통해 확인할 수 있습니다.

2) 지연 쿼리는 어떻게 확인할 수 있나요?

① 위의 SQL 로그 위치로 이동한 뒤 broker_log_top 명령어를 수행하면 log_top.q파일과 log_top.res 파일이 생성되며 해당 파일들을 통해 특정기간 동안 수행된 SQL들에 대한 최대 수행 시간, 최소 수행 시간, 평균 수행 시간 및 수행 횟수 등을 확인할 수 있습니다.

② 예시 : $ broker_log_top -F “분석 시작 시점” -T “ 분석 종료 시점” 브로커명*

9. 보안 취약점

1) public 계정은 삭제할 수 없나요?

① public 계정은 CUBRID 설치 시 기본적으로 생성되는 계정으로, 삭제 할 수 없습니다.

② 처음 제품 설치 시 패스워드가 설정되어 있지 않기 때문에 적절한 패스워드를 설정하여 보안취약점에 대해 대처할 수 있습니다.

③ $ csql -u dba -p <dba 패스워드> <DB명>@localhots

④ csql> alter user public password ‘패스워드’;

2) /etc/hosts 파일 권한을 온라인 중에 변경해도 되나요?

① CUBRID가 정상적으로 수행되기 위해서는 /etc/hosts 파일에 대한 읽기 권한이 필요합니다.

② 온라인으로 /etc/hosts 파일의 그룹 소유권을 변경 한 뒤 파일 권한을 변경하더라도 기존에 수행중인 CUBRID 프로세스는 해당 파일의 변경된 소유권 정보를 인지하지 못하기 때문에 해당 파일 소유권/권한 변경 시에는 CUBRID 서버의 재기동이 필요합니다.

3) demodb를 삭제해도 되나요?

① demodb는 CUBRID 설치 시 기본적으로 생성되는 DB로, 해당 DB를 사용하지 않는 것이 확인되었을 경우 삭제해도 무방합니다.

10. Fail-over

1) Fail-over 후 데이터가 보이지 않아요.

① 큐브리드 HA는 Primary Key가 있는 테이블만 데이터 동기화를 수행하기 때문에 Primary Key가 없거나 뒤늦게 설정된 테이블에 대해서는 정상적으로 동기화가 이루어 지지 않아 Fail-over가 발생 하여 기존의 Slave DB가 Master가 될 경우 특정 데이터가 보이지 않는 경우가 발생할 수 있습니다. 이 경우에는 즉시 Fail-back을 수행하여 정상적으로 운영할 수 있게 해야 하며, 동일한 이슈가 발생되지 않도록 테이블의 PK 여부를 파악하고 HA 재구성을 진행할 수 있도록 조치해야 합니다.