Configuring PgBouncer

Configuring PgBouncer#

PEMデータベースサーバーと連携するようにPgBouncerを構成する必要があります。

前提条件#

  • EDB Postgres Advanced Serverを実行している場合、 EDB PgBouncer をインストールします。

  • EDB Postgres Extended ServerまたはPostgreSQLを実行している場合、コミュニティ PgBouncer をインストールします。

EDB PgBouncerおよびPgBouncerインストールの考慮事項#

構成手順でのディレクトリとファイルの名前と場所、およびユーザーは、PgBouncerのコミュニティバージョンとEDB PgBouncerのどちらをインストールしたかによって異なります。コミュニティPgBouncerをインストールした場合コミュニティリポジトリとEDBリポジトリからインストールするかにかかわらず、作業例のファイルとディレクトリの名前をPgBouncerの値に置き換えます。

Name

PgBouncer

EDB PgBouncer

PgBouncer directory

/etc/pgbouncer

/etc/edb/pgbouncer<1.x>

ini file

pgbouncer.ini

edb-pgbouncer.ini

HBA file

/etc/pgbouncer/hba_file

/etc/edb/pgbouncer<1.x>/hba_file

Service file

pgbouncer

edb-pgbouncer-<1.x>

User

postgres

enterprisedb

PgBouncerの構成#

この例では、enterprisedbシステムユーザーを使用してEDB PgBouncerを構成します。

コミュニティPgBouncerを実行している場合は、 EDB PgBouncerおよびPgBouncerインストールの考慮事項 の説明に従って、ディレクトリ、ファイル、およびユーザーの名前を置き換えます。

  1. ターミナルウィンドウを開き、PgBouncerディレクトリに移動します。

  2. PgBouncerのetc ディレクトリedb-pgbouncer.ini が存在する場所の所有者をenterprisedb に変更し、ディレクトリのアクセス許可を0700 に変更します。

chown -R enterprisedb:enterprisedb /etc/edb/pgbouncer<1.x>
chmod 0700 /etc/edb/pgbouncer<1.x>

  1. edb-pgbouncer.ini ファイルの内容を変更します。

  [databases]
  ;; Change the pool_size according to maximum connections allowed
  ;; to the PEM database server as required.
  ;; auth_user will be used for authenticate the db user (proxy
  ;; agent user in our case)
  pem = port=5444 host=127.0.0.1 dbname=pem auth_user=pgbouncer pool_size=80 pool_mode=transaction
- = port=5444 host=127.0.0.1 dbname=pem auth_user=pgbouncer pool_size=10

  [pgbouncer]
  logfile = /var/log/edb/pgbouncer<1.x>/edb-pgbouncer-<1.x>.log
  pidfile = /var/run/edb/pgbouncer<1.x>/edb-pgbouncer-<1.x>.pid
  listen_addr = *
  ;; Agent needs to use this port to connect the pem database now
  listen_port = 6432
  ;; Set to require to ensure SSL certificates are used for connections
  ;; for PEM Agents
  client_tls_sslmode = require
  ;; These are the root.crt, server.key, server.crt files present
  ;; in the present under the data directory of the PEM database
  ;; server, used by the PEM Agents for connections.
  client_tls_ca_file = /var/lib/edb/as16/data/root.crt
  client_tls_key_file = /var/lib/edb/as16/data/server.key
  client_tls_cert_file = /var/lib/edb/as16/data/server.crt
  ;; Allow pgBouncer to use pem_agent_pool certificate
  ;; and key for connections to the server.
  server_tls_key_file = /var/lib/edb/.postgresql/pem_agent_pool.key
  server_tls_cert_file = /var/lib/edb/.postgresql/pem_agent_pool.crt
  ;; Use hba file for client connections
  auth_type = hba
  ;; HBA file
  auth_hba_file = /etc/edb/pgbouncer<1.x>/hba_file
  ;; Use pem.get_agent_pool_auth(TEXT) function to authenticate
  ;; the db user (used as a proxy agent user).
  auth_query = SELECT * FROM pem.get_agent_pool_auth($1)
  ;; DB User for administration of the pgbouncer
  admin_users = pem_admin1
  ;; auth_dbname and auth_user allow
  ;; admin console login by admin_users and stats_users
  auth_dbname = pem
  auth_user = pgbouncer
  ;; DB User for collecting the statistics of pgbouncer
  stats_users = pem_admin1
  server_reset_query = DISCARD ALL
  ;; Change based on the number of agents installed/required
  max_client_conn = 500
  ;; Close server connection if its not been used in this time.
  ;; Allows to clean unnecessary connections from pool after peak.
  server_idle_timeout = 60
!!!note auth_user の詳細については、 Authentication settings を参照してください。 .. ::

1.次のコンテンツを含むPgBouncerのHBAファイル /etc/edb/pgbouncer<1.x>/hba_file を作成します。

# Use the authentication method scram-sha-256 for local connections
# between the pem database & the pgbouncer (virtual) database.
local pgbouncer all scram-sha-256
# Use the authentication method scram-sha-256 for remote connections
# to pgbouncer (virtual database) using the enterprisedb user.
host pgbouncer,pem pem_admin1 0.0.0.0/0 scram-sha-256
# Use the authentication method cert for TCP/IP connections
# to the pem database using pem_agent_user1
hostssl pem pem_agent_user1 0.0.0.0/0 cert

  1. HBAファイル(/etc/edb/pgbouncer<1.x>/hba_file) の所有者をenterprisedb に変更し、ディレクトリ権限を0600 に変更します。

chown enterprisedb:enterprisedb /etc/edb/pgbouncer<1.x>/hba_file
chmod 0600 /etc/edb/pgbouncer<1.x>/hba_file

  1. PgBouncerサービスを有効にし、サービスを開始します。

systemctl enable edb-pgbouncer-<1.x>
__OUTPUT__
Created symlink from
/etc/systemd/system/multi-user.target.wants/edb-pgbouncer-<1.x>.service
to /usr/lib/systemd/system/edb-pgbouncer-<1.x>.service.

systemctl start edb-pgbouncer-<1.x>
目次