0. 이 문서에 대하여
이 장을 마치면: Admin 가이드가 무엇을 다루고, 어떤 작업을 어느 장에서 하는지 안다.
대상
- GritDB 1.1을 혼자 운영하는 엔지니어
- 이 문서는 QuickStart 전 장을 먼저 마친 상태를 전제로 한다. 즉 설치, 기동, 정지, 매일 점검을 한 번 해 본 상태다.
구성
| 장 | 내용 |
|---|---|
| 1 | 설치 계획 — 구성 방식, 사양, OS 설정, 디스크 배치, 반입 |
| 2 | 설치 상세 — 옵션 전체, 경로, 데이터 볼륨, 포트, root 설치 |
| 3 | 재초기화, 업그레이드, 제거 |
| 4 | 기동과 정지 운영 |
| 5 | 설정 |
| 6 | 데이터베이스와 테이블 운영 — 등록, 분석계, 분석 세션 |
| 7 | 모니터링과 정기 점검 |
| 8 | 백업과 복구 |
| 9 | 로그 관리 |
| 10 | 제약 사항 |
| 11 | 보안 |
| A | 레퍼런스 — 옵션, 설정, SQL 함수, 로그, 디렉토리, 진단 쿼리, 용어 |
작업 지도
- 처음 운영을 맡으면 1 → 2 → 5 → 11 → 10 → 6 → 7 → 8 순서로 읽는다. 10장은 PostgreSQL과 다르게 움직이는 곳과 지켜야 할 운영 규칙을 다룬다.
- 운영 서버에 새로 설치하는 순서: 1장(계획, OS 설정, 1.9 점검표) → QuickStart 2장(계정, 반입 검수, 서버 점검표) → 설치 명령(1.9 아래 줄, 2장) → QuickStart 3.2와 3.3(설치 확인) → 2.10(기동, 인증, 권한, 설정, 부팅 기동, 백업)
- 장 번호는 QuickStart가 가리키는 번호 그대로 고정했다.
| 작업 | 주기 | 명령과 도구 | 장 |
|---|---|---|---|
| 서버와 구성 정하기 | 설치 전 | 계획 점검표 | 1 |
| 표준이 아닌 설치 | 설치 때 | install_gritdb.sh 옵션 |
2 |
| 인증과 원격 접속 설정 | 설치 직후 | pg_hba.conf와 listen_addresses |
11 |
| 설정 바꾸기 | 필요할 때 | ALTER SYSTEM과 config/grit_*.config |
5 |
| 테이블 등록과 분석계 연결 | 필요할 때 | register_gritsurfer_table과 CREATE SUBSCRIPTION |
6 |
| 데이터 넣기와 분석 조회 관리 | 필요할 때 | COPY와 get_gritsurfer_active_queries() |
6.8과 6.9 |
| 점검과 정비 | 일, 주, 월 | 정기 점검표, 진단 쿼리, VACUUM 감시 | 7과 A.6 |
| OS 패치와 재부팅 | 정한 때 | 정상 정지 → 작업 → 기동 | 4.7 |
| 백업 | 정한 주기 | 정지 후 datafiles/ 복사 |
8 |
| 로그와 core 정리 | 주나 월 | 회전과 정리 | 9 |
| 패치와 업그레이드 | 새 설치 파일 | 새로 압축을 푼 디렉토리의 install_gritdb.sh |
3 |
| 다른 서버로 옮기기와 대기 서버 | 정한 때 | 정지 후 백업, 복원, 분석계 다시 받기 | 8.7 |
| 보안 점검과 감사 | 운영 전과 정기 | 보안 점검표와 로그 설정 | 11.9와 11.10 |
| 장애 | 생길 때 | QuickStart 7장 → 상태 남기기 → 지원 문의(0장) | 7장 “문제가 생기면”과 9.7 |
이 문서에서 다루지 않는 것
| 주제 | 볼 곳 |
|---|---|
| 처음 설치하는 표준 절차 | QuickStart |
| 에러 항목 전체, 증상별 진단, 자료 수집 상세 | TroubleShooting |
| 버전별 변경 사항 | 설치 경로의 docs/RELEASE-NOTES.md |
- TroubleShooting을 받지 못했으면 이 문서가 TroubleShooting을 가리키는 곳은 지원 문의(아래 “지원 문의”)로 읽는다.
표기 규칙
QuickStart 0장과 같다. 표준 경로(gritdb 계정, ~/gritdb1, 포트 5432)와 다른 값을 쓰는 절은 절 첫머리에 밝힌다.
근거 버전
- 이 문서는 GritDB 1.1 정식 배포용(release) 설치 파일을 기준으로 한다.
- 설치본의 판 번호는
jq -r .product_version ~/gritdb1/share/gritdb/manifest.json을 실행해1.1이 나오는지 확인한다. - GritDB 1.1에 든 PostgreSQL 판은 PostgreSQL 17.11이다. 따로 설치하지 않는다.
jq -r .db_version ~/gritdb1/share/gritdb/manifest.json을 실행해17.11이 나오는지 확인한다. - PostgreSQL이 정한 동작, 설정 키, 명령은 PostgreSQL 17 공식 문서를 본다. 장마다 그 자리에 링크를 둔다. 이 문서는 GritDB가 PostgreSQL과 다르게 움직이는 곳을 적는다(10.3).
gritsurfer_version()은 확장 SQL의 버전을 돌려준다. 판 번호와 다를 수 있으므로 판 번호는 위 명령으로 본다.
설치본이 정식 배포용인지 확인한다.
jq -r .channel ~/gritdb1/share/gritdb/manifest.json
ls -d ~/gritdb1/run/gritdb ~/gritdb1/tools ~/gritdb1/.bashrc ~/gritdb1/build 2>/dev/null
- 첫 명령이
release를 내고 둘째 명령이 아무것도 내지 않으면 정상이다. dev가 나오거나 둘째 명령에 경로가 나오면 개발용 패키지다. 그 파일을 쓰지 않고, 산 곳에서 정식 배포용 설치 파일을 받는다.
사용권 · 오픈소스 고지
- 1.1에는 사용권 키, 사용권 파일, 사용권 확인 통신이 없다. 인터넷이 없는 망에서도 같은 절차로 설치하고 운영한다.
- 구독 범위(서버 수, Unit)는 계약 문서를 따른다.
- 함께 들어 있는 오픈소스 라이선스는 설치 경로의
licenses/THIRD_PARTY_LICENSES에 있다. 설치 파일의licenses/와 같다.
판 이력
| 판 | 바뀐 곳 |
|---|---|
| GritDB 1.1 첫 판 | 처음 펴냄 |
- 1.0에서 올리는 절차는 3.4와 3.5에 있다.
지원 문의
문제가 풀리지 않으면 QuickStart 7.4 절차로 자료를 모은 뒤 Datagrit에 문의한다. 총판이나 파트너를 통해 샀으면 그 회사에 먼저 문의한다. 그 회사가 필요하면 Datagrit으로 넘긴다.
- 연락처는 구매나 계약 때 받은 기술 지원 연락처다. 총판이나 파트너를 통해 샀으면 그 회사가 연락처다.
- QuickStart 7.4의 3번 기록, 판 번호, 보낼 묶음 이름을 알린다. 판 번호는
jq -r .product_version ~/gritdb1/share/gritdb/manifest.json으로 본다. 묶음 이름은 9.7의$S.masked.tar.gz다.
이 문서에서 “지원 문의(0장)“는 이 절의 경로를 뜻한다.