CentOS 7にPostgreSQL11をインストールする

# 環境

CentOS 7にPostgreSQL11をインストールした際のメモです。

- CentOS 7.5(firewalldとSELinuxは無効化しています)
- Postgres 11.2


手順はほとんど同じですが、PostgreSQL12用は以下のとおりです。

- [CentOS 7.5にPostgreSQL12をインストールする](https://qiita.com/mkyz08/items/a768cceccdc6083f971e)


# PostgreSQLのyumリポジトリをインストール

CentOS用のPostgreSQLのリポジトリパッケージをインストールします。
各OS用のリポジトリパッケージのURL一覧は、以下のサイトに記載されています。

https://yum.postgresql.org/repopackages.php

```
# yum -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm
～省略～
Running transaction
  Installing : pgdg-redhat-repo-42.0-4.noarch                                                                                      1/1 
  Verifying  : pgdg-redhat-repo-42.0-4.noarch                                                                                      1/1 

Installed:
  pgdg-redhat-repo.noarch 0:42.0-4                                                                                                     

Complete!
```


# PostgreSQLのインストール

PostgreSQLをインストールします。

```
# yum -y install postgresql11-server postgresql11-contrib

～省略～
Running transaction
  Installing : postgresql11-libs-11.5-1PGDG.rhel7.x86_64                                                                                             1/6 
  Installing : libicu-50.2-3.el7.x86_64                                                                                                              2/6 
  Installing : postgresql11-11.5-1PGDG.rhel7.x86_64                                                                                                  3/6 
  Installing : libxslt-1.1.28-5.el7.x86_64                                                                                                           4/6 
  Installing : postgresql11-contrib-11.5-1PGDG.rhel7.x86_64                                                                                          5/6 
  Installing : postgresql11-server-11.5-1PGDG.rhel7.x86_64                                                                                           6/6 
  Verifying  : postgresql11-server-11.5-1PGDG.rhel7.x86_64                                                                                           1/6 
  Verifying  : libicu-50.2-3.el7.x86_64                                                                                                              2/6 
  Verifying  : postgresql11-contrib-11.5-1PGDG.rhel7.x86_64                                                                                          3/6 
  Verifying  : postgresql11-libs-11.5-1PGDG.rhel7.x86_64                                                                                             4/6 
  Verifying  : libxslt-1.1.28-5.el7.x86_64                                                                                                           5/6 
  Verifying  : postgresql11-11.5-1PGDG.rhel7.x86_64                                                                                                  6/6 

Installed:
  postgresql11-contrib.x86_64 0:11.5-1PGDG.rhel7                              postgresql11-server.x86_64 0:11.5-1PGDG.rhel7                             

Dependency Installed:
  libicu.x86_64 0:50.2-3.el7    libxslt.x86_64 0:1.1.28-5.el7    postgresql11.x86_64 0:11.5-1PGDG.rhel7    postgresql11-libs.x86_64 0:11.5-1PGDG.rhel7   

Complete!
```

PostgreSQLは「/usr/pgsql-11/」以下にインストールされます。

```
# ls -l /usr/pgsql-11/
total 12
drwxr-xr-x. 2 root root 4096 May  1 03:42 bin
drwxr-xr-x. 3 root root 4096 May  1 03:42 lib
drwxr-xr-x. 7 root root 4096 May  1 03:42 share
```


# PostgreSQLの自動起動

PostgreSQLを自動起動させるために以下のコマンドを実行します。

```
# systemctl enable postgresql-11.service
```

# データベースクラスタの作成

データベースクラスタを作成します。
rootユーザで実行しています。
データベースのファイルはデフォルトで「/var/lib/pgsql/11/data/」に作成されるのですが、これを「/data/」以下に変更します。
postgresql-11.serviceファイルの「PGDATA」環境変数によって指定できます。

```
$ vi /usr/lib/systemd/system/postgresql-11.service

変更前）
Environment=PGDATA=/var/lib/pgsql/11/data/
変更後）
Environment=PGDATA=/data/

$ systemctl daemon-reload
```

次にデータベースクラスタを作成するために以下のコマンドを実行します。（initdbコマンドでも作成できますが、今回はpostgresql-11-setupを使用しました）

```
# PGSETUP_INITDB_OPTIONS="-E UTF8 --no-locale" /usr/pgsql-11/bin/postgresql-11-setup initdb
Initializing database ... OK
```

「/data/」以下に生成されていることを確認します。

```
# cat /data/PG_VERSION 
11
```


# PostgreSQLを起動する

起動前にPostgreSQLのbinディレクトリをパスに追加します。

```
# su - postgres

/var/lib/pgsql/.pgsql_profileにパスを追加します。

# vi /var/lib/pgsql/.pgsql_profile
PATH=/usr/pgsql-11/bin:$PATH
export PATH

PGDATAを修正します。

# vi /var/lib/pgsql/.bash_profile
#PGDATA=/var/lib/pgsql/11/data
PGDATA=/data

# source ~/.bash_profile
```

PostgreSQLの起動は「pg_ctl start」で行います。

```
$ pg_ctl start
waiting for server to start....2019-05-01 03:58:27.020 CEST [12912] LOG:  listening on IPv6 address "::1", port 5432
2019-05-01 03:58:27.020 CEST [12912] LOG:  listening on IPv4 address "127.0.0.1", port 5432
2019-05-01 03:58:27.022 CEST [12912] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432"
2019-05-01 03:58:27.025 CEST [12912] LOG:  listening on Unix socket "/tmp/.s.PGSQL.5432"
2019-05-01 03:58:27.033 CEST [12912] LOG:  redirecting log output to logging collector process
2019-05-01 03:58:27.033 CEST [12912] HINT:  Future log output will appear in directory "log".
 done
server started
```
※　"systemctl start postgresql-11"でもOK


# データベース確認

作成したデータベースクラスタを確認してみます。
バージョンとデータベースの一覧を表示してみます。

```
-bash-4.2$ psql -V
psql (PostgreSQL) 11.2
-bash-4.2$ psql -l
                             List of databases
   Name    |  Owner   | Encoding | Collate | Ctype |   Access privileges   
-----------+----------+----------+---------+-------+-----------------------
 postgres  | postgres | UTF8     | C       | C     | 
 template0 | postgres | UTF8     | C       | C     | =c/postgres          +
           |          |          |         |       | postgres=CTc/postgres
 template1 | postgres | UTF8     | C       | C     | =c/postgres          +
           |          |          |         |       | postgres=CTc/postgres
```


# ユーザとデータベースの作成

ユーザ（"testuser"）とデータベース（"testdb"）を作成します。

```
$ createuser --login --pwprompt testuser
Enter password for new role: 
Enter it again:

$ createdb --owner=testuser testdb
```


# 外部からの接続を許可する

PostgreSQLはデフォルトではリモート接続できないので、設定を変更します。

```
# vi /data/postgresql.conf
※デフォルトでは「/var/lib/pgsql/11/data/postgresql.conf」

変更前）
#listen_addresses = 'localhost'
変更後）
listen_addresses = '*'
```

次にpg_hba.confを修正します。

```
# vi /data/pg_hba.conf
※デフォルトでは「/var/lib/pgsql/11/data/pg_hba.conf」

# "local" is for Unix domain socket connections only
local   testdb          testuser                                md5
→ローカルからtestdbへtestuserでmd5接続できるように1行追加。
local   all             all                                     peer
# IPv4 local connections:
host    all             all             192.168.10.0/24         md5
→192.168.10.0/24から接続できるように1行追加。
host    all             all             127.0.0.1/32            ident
```

設定変更をリロードします。

```
$ pg_ctl reload
※　もしくはsystemctl reload postgresql-11でもいいはず。
```

postgresユーザのパスワードを変更する（変更しなくても良いですが）

```
$ psql
psql (11.5)
Type "help" for help.

postgres=# alter role postgres with password 'postgres';
```

リモートから接続を確認します（A5:SQLから接続確認しましたが、説明は省略）

ローカルからの接続確認は以下のように実行します。

```
$ psql testdb testuser
Password for user testuser: 
psql (11.2)
Type "help" for help.

testdb=> 
```

# テーブル作成

テーブルを作成して、データを投入してみます。

```
testdb=> create table test (id int, value text);
CREATE TABLE
testdb=> insert into test (id, value) values (1, 'test text');
INSERT 0 1
testdb=> select * from test;
 id |   value   
----+-----------
  1 | test text
(1 row)
```

「\d」でテーブルの一覧、「\du」でロールの一覧を表示します。

```
testdb=> \d
        List of relations
 Schema | Name | Type  |  Owner   
--------+------+-------+----------
 public | test | table | testuser
(1 row)

testdb=> \du
                                   List of roles
 Role name |                         Attributes                         | Member of 
-----------+------------------------------------------------------------+-----------
 postgres  | Superuser, Create role, Create DB, Replication, Bypass RLS | {}
 testuser  |                                                            | {}
```


# その他の設定変更

PostgreSQLは全体的に各種パラメータが小さめの値が設定されているように思えます。
共有バッファだけ128MBから512MB（総メモリの20%～40%ぐらいが良いらしい）に変えてみました。それ以外も変えたほうが良いパラメータはたくさんあるのですが、共有バッファも含めてシステム依存なので今回は変更しません。

共有バッファの変更方法は以下のとおりです。

```
# vi /data/postgresql.conf
※デフォルトでは「/var/lib/pgsql/11/data/postgresql.conf」

変更前）
shared_buffers = 128MB
変更後）
shared_buffers = 512MB
```

あとはPostgreSQLを再起動するだけです。


# ログの設定

ログの設定を以下のように変更しました。

```
$ vi /data/postgresql.conf
```

変更前は以下のとおり。

```
log_filename = 'postgresql-%a.log'
log_rotation_size = 0
#log_min_duration_statement = -1
#log_checkpoints = off
#log_connections = off
#log_disconnections = off
#log_lock_waits = off
```

変更後は以下のとおり。

```
log_filename = 'postgresql-%Y-%m-%d_%H%M%S.log'
log_rotation_size = 1GB
log_min_duration_statement = 500ms
log_checkpoints = on
log_connections = on
log_disconnections = on
log_lock_waits = on
log_temp_files = 0
```


# pgbenchでベンチマークを実行する

PostgreSQLではベンチマーク用のツールpgbenchが標準で同梱されています。
まずは、pgbenchでベンチマーク用のテーブルとデータを作成します。

```
$ pgbench -i testdb
dropping old tables...
NOTICE:  table "pgbench_accounts" does not exist, skipping
NOTICE:  table "pgbench_branches" does not exist, skipping
NOTICE:  table "pgbench_history" does not exist, skipping
NOTICE:  table "pgbench_tellers" does not exist, skipping
creating tables...
generating data...
100000 of 100000 tuples (100%) done (elapsed 0.12 s, remaining 0.00 s)
vacuuming...
creating primary keys...
done.
```

データの準備ができたら、次はベンチマークを実行します。

```
$ pgbench -c 10 -t 1000 testdb
starting vacuum...end.
transaction type: <builtin: TPC-B (sort of)>
scaling factor: 1
query mode: simple
number of clients: 10
number of threads: 1
number of transactions per client: 1000
number of transactions actually processed: 10000/10000
latency average = 7.902 ms
tps = 1265.495967 (including connections establishing)
tps = 1265.842732 (excluding connections establishing)
```

"-c 10"はクライアント数が"10"、"-t 1000"は1クライアント当たりのトランザクション数を表します。

ベンチマーク実行後のキャッシュヒット率は以下のように見ることができます。

```
select relname,
   round(heap_blks_hit * 100 / (heap_blks_hit+heap_blks_read), 2)
   as cache_hit_ratio from pg_statio_user_tables
     where heap_blks_read > 0 order by cache_hit_ratio;

     relname      | cache_hit_ratio 
------------------+-----------------
 test             |           60.00
 pgbench_accounts |           98.00
 pgbench_history  |           99.00
 pgbench_tellers  |           99.00
 pgbench_branches |           99.00
```

インデックスのキャッシュヒット率は以下のとおり。

```
select relname, indexrelname,
   round(idx_blks_hit * 100 / (idx_blks_hit + idx_blks_read), 2)
   as cache_hit_ratio from pg_statio_user_indexes
     where idx_blks_read > 0 order by cache_hit_ratio;

     relname      |     indexrelname      | cache_hit_ratio 
------------------+-----------------------+-----------------
 pgbench_tellers  | pgbench_tellers_pkey  |           96.00
 pgbench_branches | pgbench_branches_pkey |           99.00
 pgbench_accounts | pgbench_accounts_pkey |           99.00

```


# 参考

- [PostgreSQL 11 を CentOS 7 にインストールするには](https://qiita.com/tom-sato/items/e1903cb974fb6c6d5664)
- [PostgreSQL 11.2 Documentation](https://www.postgresql.org/docs/11/index.html)
- [pgbenchの使いこなし by Let's Postgres](https://lets.postgresql.jp/documents/technical/contrib/pgbench)