Ubuntu에서 EDB Postgres Distributed 단일 노드 클러스터 설정하기

작성자: Phil Eaton
게시일: 2025년 8월 14일
최종 수정일: 2026년 8월 27일

이 가이드에서는 Ubuntu 환경에 EDB Postgres Distributed(PGD)와 EDB Postgres Extended를 설치하고, PGD CLI를 사용해 단일 노드 클러스터를 구성하는 방법을 단계별로 설명합니다. 마지막으로 SQL 쿼리를 실행해 PGD 노드가 정상적으로 활성화되었는지 확인합니다.

목차

1. EDB 구독 토큰 준비
2. PGD 및 EDB Postgres Extended 리포지토리 설정
3. PGD 패키지 설치
4. 단일 노드 PGD 클러스터 구성
5. PGD 노드 상태 확인
6. 자주 묻는 질문

1. EDB 구독 토큰 준비

EDB 계정에 로그인하거나 무료로 등록한 뒤 구독 토큰(subscription token)을 발급받으세요. 그런 다음 다음 명령어를 사용해 구독 토큰을 환경 변수로 내보냅니다.

$ export EDB_SUBSCRIPTION_TOKEN=whatever-it-is

2. PGD 및 EDB Postgres Extended 리포지토리 설정

이제 EDB Postgres Distributed(PGD)와 EDB Postgres Extended(EDB의 Postgres 배포판)용 리포지토리를 설정합니다.

$ curl -1sLf "https://downloads.enterprisedb.com/$EDB_SUBSCRIPTION_TOKEN/postgres_distributed/setup.deb.sh" | sudo -E bash
$ curl -1sLf "https://downloads.enterprisedb.com/$EDB_SUBSCRIPTION_TOKEN/enterprise/setup.deb.sh" | sudo -E bash

3. PGD 패키지 설치

패키지 목록을 업데이트한 다음 PGD 및 EDB Postgres Extended 패키지를 설치합니다.

$ sudo apt-get update -y
$ sudo apt-get install -y edb-pgd6-expanded-pgextended17

4. 단일 노드 PGD 클러스터 구성

postgres 사용자로 전환한 다음 홈 디렉터리로 이동합니다.

$ sudo su postgres
$ cd ~

PGD CLI를 사용해 새로운 Postgres 인스턴스를 생성하고 단일 노드 PGD 클러스터를 설정합니다.

$ PGPASSWORD=secret /usr/lib/edb-pge/17/bin/pgd node db1 setup \
--dsn 'host=localhost dbname=pgd' \
--pgdata /var/lib/postgresql/db \
--log-file logfile \
--group-name pgd-group

5. PGD 노드 상태 확인

이제 Postgres가 실행 중이고 PGD가 설정되었습니다. 다음 명령어로 PGD 클러스터의 노드 상태를 확인할 수 있습니다. 현재 구성에는 단일 노드만 존재합니다.

$ /usr/lib/edb-pge/17/bin/psql -P expanded=auto -h localhost pgd \
 -c 'SELECT * FROM bdr.node_summary'

출력 예시는 다음과 같습니다.

-[ RECORD 1 ]----------+-------------------------------------
node_name | db1
node_group_name | pgd-group
interface_connstr | host=localhost dbname=pgd
peer_state_name | ACTIVE
peer_target_state_name | ACTIVE
node_seq_id | 1
node_local_dbname | pgd
node_id | 2084062396
node_group_id | 1693353463
node_kind_name | data
node_uuid | 19207a60-298e-4d2e-88e5-7cfc9ab3035c

peer_state_name과 peer_target_state_name이 모두 ACTIVE로 표시되면 단일 노드 PGD 클러스터 구성이 완료된 것입니다.

EDB Postgres Distributed 설치 FAQ

EDB Postgres Distributed를 설치하려면 구독 토큰이 필요한가요?

이 가이드의 설치 방식에서는 EDB 리포지토리를 설정하기 위해 구독 토큰이 필요합니다. EDB 계정에 로그인하거나 무료로 등록한 뒤 발급받은 토큰을 EDB_SUBSCRIPTION_TOKEN 환경 변수로 설정합니다.

이 가이드에서는 어떤 패키지를 설치하나요?

이 가이드에서는 edb-pgd6-expanded-pgextended17 패키지를 설치합니다. 설치 전 EDB Postgres Distributed와 EDB Postgres Extended용 리포지토리를 모두 설정합니다.

PGD 단일 노드 클러스터는 어떻게 생성하나요?

postgres 사용자로 전환한 뒤 PGD CLI의 pgd node db1 setup 명령어를 실행합니다. 이때 DSN, 데이터 디렉터리, 로그 파일 및 그룹 이름을 함께 지정합니다.

PGD 노드가 정상적으로 활성화되었는지 어떻게 확인하나요?

bdr.node_summary를 조회해 노드 상태를 확인할 수 있습니다. 이 가이드의 출력 예시에서는 peer_state_name과 peer_target_state_name이 모두 ACTIVE로 표시됩니다.

EDB 제품 및 도입 관련 문의: salesinquiry@enterprisedb.com