[HA] PostgreSQL HA 구성

2026.02.04 - [OS&Server/WEB | WAS] - [WEB/WAS] Apache ↔ Tomcat 연동(Reverse Proxy)

[WEB/WAS] Apache ↔ Tomcat 연동(Reverse Proxy)

오늘은 저번에 WEB➡️WAS➡️DB 3-Tier로 구성했던 서버에서 DB 서버를 이중화해 Failover 발생 시 자동 복구가 되도록 구성하고자 한다. 참고로 사용하는 OS는 Rocky Linux 9.7이다.

---

1️⃣ Primary DB 서버 구성 확인

시작하기 전에 먼저 DB 버전을 확인한다. 버전을 보면 16인 것을 알 수 있다.

2️⃣외부 접속 및 복제 설정

postgresql.conf 설정

listen_addresses = '*'               # 모든 IP에서 접속 허용
wal_level = replica                  # 복제 로그 활성화
archive_mode = on                    # WAL 아카이브 활성화
archive_command = 'cp %p /var/lib/pgsql/16/archive/%f'  # WAL 파일 복사 명령
max_wal_senders = 10                 # WAL 송신 프로세스 수
wal_keep_size = 128MB                # WAL 보존 크기
hot_standby = on                     # 스탠바이 서버에서 읽기 허용

pg_hba.conf 설정

마지막 줄에 replicator 만 추가했고 이걸 저장한 후에 postgresql을 재시작한다.

---2026.04.25 추가---

일부 오류가 발생하여 scram-sha-256으로 된 것을 모두 md5로 변경하였다.

3️⃣복제용 사용자 생성

sudo -u postgres psql
CREATE USER replicator REPLICATION LOGIN ENCRYPTED PASSWORD '비밀번호';

pg_hba.conf에 작성한 복제용 사용자를 생성하면 된다.

4️⃣Standby 서버 구성

데이터 디렉토리 초기화

# Standby 서버 데이터 디렉토리 초기화
sudo systemctl stop postgresql-16
sudo rm -rf /var/lib/pgsql/16/data/

# Base Backup 수행
sudo systemctl start postgresql-16
sudo -u postgres psql

# PostgreSQL 접속 이후
SELECT pg_is_in_recovery();            # -- true면 Standby 상태입니다.
SELECT * FROM pg_stat_wal_receiver;    # -- WAL 수신 상태 확인

5️⃣Pgpool-II 설정

먼저 Pgpool을 primary 서버에 설치한다.

sudo dnf install -y pgpool-II

Pgpool -II 기본 설정

설치가 끝나면 /etc/pgpool-II/pgpool.conf를 수정하여 pgpool-Ⅱ의 기본적인 설정을 한다.

listen_addresses = '*'                # 외부 접속 허용
port = 9999                           # Pgpool 포트

backend_hostname0 = 'Master-IP' # Primary
backend_port0 = 5432
backend_weight0 = 1
backend_data_directory0 = '/var/lib/pgsql/16/data'
backend_flag0 = 'ALLOW_TO_FAILOVER'

backend_hostname1 = 'Stamdby-IP' # Standby
backend_port1 = 5432
backend_weight1 = 1
backend_data_directory1 = '/var/lib/pgsql/16/data'
backend_flag1 = 'ALLOW_TO_FAILOVER'

enable_pool_hba = on                  # 자체 인증 사용

sr_check_period = 10                  # 복제 점검 주기
sr_check_user = 'replicator'
sr_check_password = 'replicatorpass'

health_check_period = 10              # 헬스체크 주기
health_check_user = 'replicator'
health_check_password = 'replicatorpass'

이번에는 /etc/pgpool-II/pool_hba.conf를 설정한다. 지금은 우선 0.0.0.0/0으로 설정했지만 이 부분은 본인 환경에 맞춰서 바꾸면 될 것 같다.

설정 후 pgpool-II를 재시작하고 pool_passwd 파일을 구성한다. postgres, replicator와 이외에 사용하는 사용자 비밀번호를 입력하면 된다.

sudo pg_md5 -m -u 'db사용자' '사용자 비밀번호' # 지정한 사용자에 대한 pool_passwd가 생성됨 
chmod 600 /etc/pgpool-II/pool_passwd
chown postgres:postgres /etc/pgpool-II/pool_passwd

pool_passwd 파일을 구성하다가 initializing pool password, failed to open file:"/etc/pgpool-II/pool_passwd" 오류가 발생하면 권한을 먼저 부여하고 시도해봐도 좋을 것 같다.

그리고 /etc/pgpool-II/pgpool.conf에서 pool_passwd의 주석을 해제하고 다음과 같이 수정하고 pgpool-II를 재시작한다.

재시작한 후 다음 명령어를 이용해 연결이 되는지 확인한다.

psql -h 127.0.0.1 -p 9999 -U 'pool_passwd에 넣은 사용자' -d '해당 사용자 DB' -c "show pool_nodes;"

연결확인 결과

혹시 위 명령어를 입력 후 psql: 오류: "127.0.0.1" 포트 9999 서버에 접속 할 수 없음: ERROR: failed to authenticate with backend using SCRAM이 뜬다면 db 자체에서도 인증 방식을 md5로 바꿔보면 좋을 것 같다.

6️⃣자동 Failover 설정

pgpool이 연결이 되어있으니 자동 failover를 설정해보겠다. 이를 위해 failover.sh를 복사한다.

cp /etc/pgpool-II/sample_scripts/failover.sh.sample /etc/pgpool-II/failover.sh
chmod +x /etc/pgpool-II/failover.sh

그리고 /etc/pgpool-II/pgpool.conf에 다음 내용을 추가한다.

failover_command = '/etc/pgpool-II/failover.sh %d %h %p %D %m %H %M %P %r %R %N %S'
follow_primary_command = '/etc/pgpool-II/follow_primary.sh %d %h %p %D %m %H %M %P %r %R'

자동 전환이 목표이기 때문에 비밀번호를 누르지 않고 전환되도록 하고자 ssh 키를 설정한다.

cd ~/.ssh
ssh-keygen -t rsa -f id_rsa_pgpool
ssh-copy-id -i id_rsa_pgpool.pub postgres@master-IP
ssh-copy-id -i id_rsa_pgpool.pub root@master-IP
ssh-copy-id -i id_rsa_pgpool.pub postgres@slave-IP
ssh-copy-id -i id_rsa_pgpool.pub root@slave-IP

각 서버의 postgres 및 root 계정 모두 설정해야 한다.

7️⃣Failover 테스트

systemctl stop postgresql-16 #Primary DB 중지 
psql -U postgres -p 9999 -h 127.0.0.1 -c "show pool_nodes;"

primary db중단 후

Primary DB를 중지 후 아래 명령어를 이용하면 db2로 넘어갔음을 확인할 수 있다. 그리고 Primary DB를 다시 실행한 후 Pgpool도 재시작 하면 다시 Primary DB로 바꼈음을 알 수 있다.

primary db 재시작 후

---

참고자료

• https://tech.osci.kr/postgresql-ha-%EA%B5%AC%EC%84%B1-pgpool-ii%EB%A1%9C-%EC%9E%90%EB%8F%99-failover%EA%B9%8C%EC%A7%80-%EA%B5%AC%ED%98%84%ED%95%98%EB%8A%94-%EC%8B%A4%EC%A0%84-%EA%B0%80%EC%9D%B4%EB%93%9C/
• https://www.pgpool.net/docs/pgpool-II-4.4.9/en/html/example-basic.html