Denbun POP版マニュアル

■データベース(PostgreSQL)のインストールと設定

PostgreSQLは、オープンソースの本格的なRDBMS(Relational Database Management System)です。
PostgreSQLのダウンロードはこちら。
PostgreSQLに関する詳細は、「日本PostgreSQLユーザー会」の公式サイトをご参照ください。

DenbunPOP版をお使いいただけるPostgreSQLのバージョンについては、『動作環境』をご参照ください。

１．パッケージソースの展開

suコマンドにて、rootユーザーにスイッチしてください。

[guest@xxxxxx guest]# su -
Password:

ダウンロードサイトからダウンロードしたPostgreSQLのパッケージソースを展開します。ここでは、guestユーザーのホームディレクトリにあるものとします。

[root@xxxxxx guest]# cd /usr/local/src
[root@xxxxxx src]# tar xvzf /home/guest/postgresql-16.3.tar.gz

展開が完了すると、/usr/local/srcディレクトリ下に「postgresql-16.3」というディレクトリが作成されます。

２．パッケージのインストール

インストールするサーバー環境による構成を行います。

[root@xxxxxx src]# cd /usr/local/src/postgresql-16.3/
[root@xxxxxx postgresql-16.3]# ./configure --without-icu
　・
　・（中略）
　・
configure: creating ./config.status
config.status: creating GNUmakefile
config.status: creating src/Makefile.global
config.status: creating src/include/pg_config.h
config.status: creating src/include/pg_config_ext.h
config.status: creating src/interfaces/ecpg/include/ecpg_config.h
config.status: linking src/backend/port/tas/dummy.s to src/backend/port/tas.s
config.status: linking src/backend/port/posix_sema.c to src/backend/port/pg_sema.c
config.status: linking src/backend/port/sysv_shmem.c to src/backend/port/pg_shmem.c
config.status: linking src/include/port/linux.h to src/include/pg_config_os.h
config.status: linking src/makefiles/Makefile.linux to src/Makefile.port
[root@xxxxxx postgresql-16.3]#

※ここでは、デフォルトのインストール先（/usr/local/pgsql)にインストールされる構成で説明します。インストール先等変更したい場合には"--prefix"オプションなど、PostgreSQLのインストールガイドをご参照ください。

※サーバー上に不足しているパッケージなどがある場合、ここで構成エラーが発生しますので、不足しているパッケージを追加インストールするなどのご対応をお願いいたします。

次に、パッケージのコンパイルを行います。ここではGNU makeコマンドを使用してコンパイルします。

コンパイルは、お使いのハードウェアスペックにより、数分から数十分を要しますので、完了までお待ちください。

[root@xxxxxx postgresql-16.3]# gmake
　・
　・（中略）
　・
gmake -C test/perl all
gmake[2]: ディレクトリ `/usr/local/src/postgresql-16.3/src/test/perl' に入ります
gmake[2]: `all' に対して行うべき事はありません.
gmake[2]: ディレクトリ `/usr/local/src/postgresql-16.3/src/test/perl' から出ます
gmake[1]: ディレクトリ `/usr/local/src/postgresql-16.3/src' から出ます
gmake -C config all
gmake[1]: ディレクトリ `/usr/local/src/postgresql-16.3/config' に入ります
gmake[1]: `all' に対して行うべき事はありません.
gmake[1]: ディレクトリ `/usr/local/src/postgresql-16.3/config' から出ます
[root@xxxxxx postgresql-16.3]#

コンパイルが完了したら、インストールを行う前に、PostgreSQLが正しく動作するかを検証するためにリグレッションテストを行います。

リグレッションテストは、rootユーザーでは実行することができませんので、rootユーザー以外のユーザーにスイッチします。（ここでは「guest」ユーザーで実行します。）

[root@xxxxxx postgresql-16.3]# su guest
[guest@xxxxxx postgresql-16.3]# gmake check
　・
　・（中略）
　・
ok 211 + stats 2356 ms
# parallel group (2 tests): event_trigger oidjoins
ok 212 + event_trigger 131 ms
ok 213 + oidjoins 251 ms
ok 214 - fast_default 76 ms
ok 215 - tablespace 191 ms
1..215
# All 215 tests passed.
gmake[1]: ディレクトリ '/usr/local/src/postgresql-16.3/src/test/regress' から出ます
[guest@xxxxxx postgresql-16.3]#

"All 215 tests passed."が表示されればテストが正しく完了していますので、インストールを行います。

インストールは、rootユーザーで行います。先ほどスイッチした「guest」ユーザーから戻します。

[guest@xxxxxx postgresql-16.3]# exit
[root@xxxxxx postgresql-16.3]# gmake install
　・
　・（中略）
　・
gmake -C config install
gmake[1]: ディレクトリ `/usr/local/src/postgresql-16.3/config' に入ります
/usr/bin/mkdir -p '/usr/local/pgsql/lib/pgxs/config'
/usr/bin/install -c -m 755 ./install-sh '/usr/local/pgsql/lib/pgxs/config/install-sh'
/usr/bin/install -c -m 755 ./missing '/usr/local/pgsql/lib/pgxs/config/missing'
gmake[1]: ディレクトリ `/usr/local/src/postgresql-16.3/config' から出ます
[root@xxxxxx postgresql-16.3]#

"/usr/bin/install -c -m 755 ./missing '/usr/local/pgsql/lib/pgxs/config/missing'"が表示されればインストールは完了です。

最後に、パッケージのコンパイルで生成されたオブジェクトファイルを削除することで、使用しているディスク容量を空けることができますので、必要に応じて実行してください。

[root@xxxxxx postgresql-16.3]# gmake clean

３．データベース管理ユーザーの作成

次に、PostgreSQLデータベースの管理ユーザー"postgres"(以下、"postgres"ユーザー)を作成します。

※必要に応じて、ユーザーパスワードを設定してください。

[root@xxxxxx postgresql-16.3]# useradd postgres
[root@xxxxxx postgresql-16.3]# passwd postgres
Password:

作成したユーザーの環境変数に、PostgreSQLコマンドまでのパスを通します。これにより、作成した"postgres"ユーザーが、PostgreSQLデータベース管理コマンドなどを実行することができるようになります。

viコマンドで「.bash_profile」を開き、PATH変数を編集します。

[root@xxxxxx postgresql-16.3]# cd /home/postgres
[root@xxxxxx postgres]# vi .bash_profile

以下のパスを環境変数「PATH」に追加設定してください。

# .bash_profile

# Get the aliases and functions
if [ -f ~/.bashrc ]; then
. ~/.bashrc
fi

# User specific environment and startup programs

PATH=$PATH:$HOME/bin:/usr/local/pgsql/bin ←追加

export PATH

編集が完了したら、viコマンドの":wq"（保存して閉じる）を実行してください。

４．データベースクラスターの初期化

PostgreSQLのデータベースクラスターの初期化を行います。

データベース格納先のディレクトリを作成し、"postgres"ユーザーをディレクトリオーナーに設定します。

[root@xxxxxx ~]# mkdir /var/pgsql
[root@xxxxxx ~]# mkdir /var/pgsql/data
[root@xxxxxx ~]# chown -R postgres:postgres /var/pgsql

次に、"postgres"ユーザーにスイッチして、データベースクラスターを初期化します。

ここでは、先に作成した"/var/pgsql/data"をデータベースファイル格納先として指定します。

[root@xxxxxx postgres]# su - postgres
[postgres@xxxxxx postgres]# initdb --encoding=utf8 --locale=C -D /var/pgsql/data
　・
　・（中略）
　・
Success. You can now start the database server using:

pg_ctl -D /var/pgsql/data -l logfile start

[root@xxxxxx postgresql-16.3]#

ここまで完了すると、PostgreSQLデータベースを起動する準備が整いましたので、PostgreSQLを起動します。

正常に起動できたら、確認用のデータベースを作成し、接続確認しましょう。

[postgres@xxxxxx postgres]# pg_ctl -D /var/pgsql/data -l logfile start
waiting for server to start.... done
server started
[postgres@xxxxxx postgres]#

正常に起動できたら、確認用のデータベースを作成し、接続確認しましょう。

[postgres@xxxxxx postgres]# createdb test
[postgres@xxxxxx postgres]# psql test
psql (16.3)
Type "help" for help.

test=#

正常に接続できたら、データベース一覧（\lコマンド)を実行し、正しく作成できていることをご確認ください。

※作成した「test」データベースのCollate、Ctypeが"C"となっていない場合、Denbunが正しく動作しない可能性がありますので、ご注意ください。(クラスターの初期化に誤りがある可能性があります。)

５．PostgreSQLサーバーの自動起動設定

サーバーのリブート時などに、PostgreSQLデータベースが自動的に起動するように設定しましょう。

systemdで自動起動を行うにはユニットファイルを作成して、systemctlコマンドで自動起動登録をします。

/etc/systemd/system/にユニットファイルpostgresql.serviceを作成します。

viコマンドでエディタを開きます。

[root@localhost ~]# cd /etc/systemd/system
[root@localhost system]# vi postgresql.service

以下の内容を入力します。

[Unit]
Description=PostgreSQL database server

[Service]
Type=forking
User=postgres
PIDFile=/var/pgsql/data/postmaster.pid
OOMScoreAdjust=-1000
ExecStart=/usr/local/pgsql/bin/pg_ctl start -w -D /var/pgsql/data/
ExecReload= /bin/kill -HUP $MAINPID
KillMode=mixed
KillSignal=SIGINT
TimeoutSec=0
TimeoutStartSec=0
TimeoutStopSec=1h

[Install]
WantedBy=multi-user.target

編集が完了したら、":wq"（保存して閉じる）を実行してください。

リロードしてユニットファイルを反映します。

[root@localhost ~]# systemctl daemon-reload

systemctlコマンドで作成したユニットファイルが反映されているかを確認します。

[root@localhost system]# systemctl status postgresql
○ postgresql.service - PostgreSQL database server
　・
　・（中略）
　・
[root@localhost system]#

上記のように"PostgreSQL database server"と表示されていれば、作成したユニットファイルが正常に読み込まれています。

[root@localhost ~]# systemctl enable postgresql
Created symlink /etc/systemd/system/multi-user.target.wants/postgresql.service → /etc/systemd/system
/postgresql.service.
[root@localhost ~]#

以上で、PostgreSQLの自動起動の設定は完了です。

→引き続き「Denbunのインストールと各種設定」にお進みください

→Linux版インストールメニューに戻る