3. 설치
이 장을 마치면: 표준 경로(
~/gritdb1)에 GritDB를 설치하고, 설치가 온전한지 판정한다.소요: 20분 | 선행: 2장 전 항목 합격
3.1 설치 실행
옵션 없이 실행해 표준 경로(~/gritdb1, 포트 5432)에 설치한다.
cd ~/pkg/gritdb-*/
./install_gritdb.sh
예상 출력:
======================================================================
GritDB Install (from dist)
----------------------------------------------------------------------
Edition = <STANDARD 또는 ENTERPRISE>
Version = 1.1
Build commit = <커밋 번호>
Prefix = /home/gritdb/gritdb1
Install Log = /home/gritdb/gritdb1/log/install_gritdb_<일시>.log
======================================================================
▶ 1.1 Verifying dist integrity (manifest) ... OK
▶ 2.1 Deploying files to prefix ... OK
▶ 3.1 Initializing PostgreSQL data directory ... OK
[INFO] PostgreSQL memory: shared_buffers=<값> effective_cache_size=<값> work_mem=<값> (memory <M>MB - engine storage <U>MB - engine query <B>MB = PostgreSQL <P>MB)
▶ 4.1 Merging postgresql.conf (managed block) ... OK
▶ 5.1 Recording install anchor (.gritdb_installed) ... OK
Verifying installation...
postgres CHECK
gritsurfer.so CHECK
gritsurfer.control CHECK
gritsurfer--1.0.sql CHECK
grit_admin CHECK
grit_admin_client CHECK
grit_catalog_process CHECK
shared_preload_libraries = gritsurfer CHECK
wal_level = logical CHECK
search_path includes gritdb CHECK
build commit = <커밋 번호>
pg port = 5432 (source of truth: /home/gritdb/gritdb1/datafiles/pgdata/postgresql.conf)
instance id = <인스턴스 ID>
======================================================================
Install complete.
Install log written to: /home/gritdb/gritdb1/log/install_gritdb_<일시>.log
NEXT:
Start: /home/gritdb/gritdb1/bin/gritdb-start
Stop: /home/gritdb/gritdb1/bin/gritdb-stop
After start, confirm preload took effect:
/home/gritdb/gritdb1/bin/psql -p 5432 -d postgres -c "SHOW shared_preload_libraries;"
3.2 설치 결과 판독
| 보이는 것 | 뜻 | 할 일 |
|---|---|---|
5단계 모두 OK, 전 항목 CHECK, Install complete. |
설치 성공 | 3.3으로 |
[INFO] PostgreSQL memory: …(3.1과 4.1 사이) |
이 서버 메모리로 정한 PostgreSQL 메모리 값 | 할 일 없음(Admin 5장) |
[WARN] PostgreSQL memory share is below 4GB … |
메모리가 작아 PostgreSQL 기본값으로 둔다 | 할 일 없음. 성능 문의는 서버를 최소 사양으로 올린 뒤 받는다(2.4 점검표 5) |
어느 단계에 FAIL과 Install failed at step: ... |
설치가 그 단계에서 멈춘다. 로그 끝 5줄이 줄마다 |를 달고 함께 보인다 |
보이는 에러 문구로 7장 검색 |
CHECK 대신 missing! FAIL |
설치 파일 누락 | GDB-INSTALL-003(재반입) |
3.3 설치 확인
ls -a ~/gritdb1/.gritdb_installed
jq -r .product_version ~/gritdb1/share/gritdb/manifest.json
예상 출력:
/home/gritdb/gritdb1/.gritdb_installed
1.1
3.4 알아둘 것
- 같은 경로에 다시 설치해도 기존 데이터는 그대로 남는다. 이때 3.1단계가
SKIP (existing data kept; --reinit-data to reinitialize)로 보인다. 데이터를 새로 만드는 재초기화는 Admin 3장을 본다. ~/pkg의 설치 파일은 다음 버전 설치 전까지 보관한다. 재설치와 재검수에 쓴다.- ⚠ root로 설치하지 않는다(GDB-INSTALL-001). root 설치가 꼭 필요하면 Admin 2장을 본다.
- ⚠ 설치 기본 인증은
trust이므로 같은 서버의 모든 OS 사용자가 superuser로 접속할 수 있다. 다른 OS 사용자가 있는 서버면 첫 기동(4.1) 전에 Admin 11.3의 2번을 먼저 하고, 다른 번호는 기동 뒤에 한다.
문제가 생기면
- 설치 에러가 나면 GDB-INSTALL-001~005를 본다.