Configuring PgBouncer¶
PEMデータベースサーバと連携するようにPgBouncerを構成する必要があります。この例では、enterprisedbシステムユーザとしてPgBouncerを実行します。次の手順は、pgBouncer（バージョン>
= 1.9）を構成するプロセスの概要を示しています。
1.ターミナルウィンドウを開き、pgBouncerディレクトリに移動します。
pgBouncer（
pgbouncer.iniが存在する）のetcディレクトリの所有者をenterprisedbに変更し、ディレクトリ権限を0700に変更します。例：
* $ chown enterprisedb:enterprisedb /etc/edb/pgbouncer1.9
* $ chmod 0700 /etc/edb/pgbouncer1.9
pgbouncer.iniまたは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=/tmp dbname=pem auth_user=pgbouncer
* pool_size=80 pool_mode=transaction
* * = port=5444 host=/tmp dbname=pem auth_user=pgbouncer
* pool_size=10
* [pgbouncer]
* logfile = /var/log/edb/pgbouncer1.9/edb-pgbouncer-1.9.log
* pidfile = /var/run/edb/pgbouncer1.9/edb-pgbouncer-1.9.pid
* listen_addr = *
* ;; Agent needs to use this port to connect the pem database now
* listen_port = 6432
* ;; Require to support for the SSL Certificate authentications
* ;; 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/as11/data/root.crt
* client_tls_key_file = /var/lib/edb/as11/data/server.key
* client_tls_cert_file = /var/lib/edb/as11/data/server.crt
* ;; Use hba file for client connections
* auth_type = hba
* ;; Authentication file, Reference:
* ;; https://pgbouncer.github.io/config.html#auth_file
* auth_file = /etc/edb/pgbouncer1.9/userlist.txt
* ;; HBA file
* auth_hba_file = /etc/edb/pgbouncer1.9/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
* ;; 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
4.次のコマンドを使用して、PgBouncerの/etc/edb/pgbouncer1.9/userlist.txt認証ファイルを作成および更新します。
* pem=# COPY (
* SELECT 'pgbouncer'::TEXT, 'pgbouncer_password'
* UNION ALL
* SELECT 'pem_admin1'::TEXT, 'pem_admin1_password'
* TO '/etc/edb/pgbouncer1.9/userlist.txt'
* WITH (FORMAT CSV, DELIMITER ' ', FORCE_QUOTE *);
* COPY 2
!!! Note
スーパーユーザは、PEM認証クエリーファンクション
pem.get_proxy_auth(text)を呼び出すことができません。pem_adminユーザがスーパーユーザの場合、パスワードを認証ファイル（enterprisedb in the above example）に追加する必要があります。
5.次のコンテンツを含むPgBouncerのHBAファイル(/etc/edb/pgbouncer1.9/hba_file)を作成します。
* # Use authentication method md5 for the local connections to
* # connect pem database & pgbouncer (virtual) database.
* local pgbouncer all md5
* # Use authentication method md5 for the remote connections to
* # connect to pgbouncer (virtual database) using enterprisedb
* # user.
* host pgbouncer,pem pem_admin1 0.0.0.0/0 md5
* # Use authentication method cert for the TCP/IP connections to
* # connect the pem database using pem_agent_user1
* hostssl pem pem_agent_user1 0.0.0.0/0 cert
HBAファイル
(/etc/edb/pgbouncer1.9/hba_file)の所有者をenterprisedbに変更し、ディレクトリ権限を0600に変更します。例：
* $ chown enterprisedb:enterprisedb /etc/edb/pgbouncer1.9/hba_file
* $ chmod 0600 /etc/edb/pgbouncer1.9/hba_file
PgBouncerサービスを有効にして、サービスをスタートします。例：
* $ systemctl enable edb-pgbouncer-1.9
* Created symlink from
* /etc/systemd/system/multi-user.target.wants/edb-pgbouncer-1.9.service
* to /usr/lib/systemd/system/edb-pgbouncer-1.9.service.
* $ systemctl start edb-pgbouncer-1.9
