はじめに
OpenBSD において 7.2 のリリースに伴って PostgreSQL が 14.5 にアップデートされました。
最新の OpenBSD に PostgreSQL をインストールする流れをご紹介します。
環境
- OS: OpenBSD 7.2
- データベース: PostgreSQL 14.5
概観
各ステップの詳細はこの後で記載します。
$ doas pkg_add postgresql-server
$ doas su - _postgresql
$ # 下記 --locale の指定は必要に応じて行います
$ # スーパーユーザーすなわち下記 "postgres" のパスワードを聞かれます
$ initdb -D /var/postgresql/data -U postgres \
-W -A scram-sha-256 -E UTF-8 --locale=xx_XX.UTF-8
$ exit
$ doas rcctl enable postgresql
$ doas rcctl start postgresql
チュートリアル
手順ごとの説明を以下に記します。
1. PostgreSQL サーバーのインストール
Ports システムからパッケージを取得してインストールします:
$ doas pkg_add postgresql-server
出力は以下の通りでした:
quirks-6.42 signed on 2023-01-13T18:22:41Z
postgresql-server-14.5:postgresql-client-14.5: ok
useradd: Warning: home directory `/var/postgresql' doesn't exist, and -m was not specified
postgresql-server-14.5: ok
The following new rcscripts were installed: /etc/rc.d/postgresql
See rcctl(8) for details.
New and changed readme(s):
/usr/local/share/doc/pkg-readmes/postgresql-server
2. データベースの初期環境構築
アクセス権限によるエラーを起こさないように、_postgresql ユーザーにスイッチします。こちらのユーザーは、上の手順で作成されています:
$ doas su - _postgresql
init_db を実行します。データベース・クラスターが作成されます。
この時 /var/postgresql ディレクトリが自動でつくられます:
$ initdb -D /var/postgresql/data -U postgres \
-W -A scram-sha-256 -E UTF-8 --locale=xx_XX.UTF-8
上の -U postgres (--user=... と同じ) にはスーパーユーザーの名前をセットします。
出力は以下のように始まりました:
The files belonging to this database system will be owned by user "_postgresql".
This user must also own the server process.
The database cluster will be initialized with locale "ja_JP.UTF-8".
initdb: could not find suitable text search configuration for locale "ja_JP.UTF-8"
The default text search configuration will be set to "simple".
Data page checksums are disabled.
ここで -W (--pwprompt と同じ) を指定した場合、パスワードをたずねられます。
-W と-A scram-sha-256 (--auth=... と同じ) を指定するのは、セキュリティ保護のためです。
ご参考までに readme (/usr/local/share/doc/pkg-readmes/postgresql-server) の内容を引用します:
It is strongly advised that you do not work with the postgres dba account other than creating more users and/or databases or for administrative tasks. Use the PostgreSQL permission system to make sure that a database is only accessed by programs/users that have the right to do so.
それから --locale=... ですが、こちらは必要に応じて指定します。en_US.UTF-8 で良い場合は、指定不要です。
さて、パスワードを入力しましょう:
Enter new superuser password:
Enter it again:
以下が出力されました:
creating directory /var/postgresql/data ... ok
creating subdirectories ... ok
selecting dynamic shared memory implementation ... posix
selecting default max_connections ... 20
selecting default shared_buffers ... 128MB
selecting default time zone ... Asia/Tokyo
creating configuration files ... ok
running bootstrap script ... ok
performing post-bootstrap initialization ... ok
syncing data to disk ... ok
Success. You can now start the database server using:
pg_ctl -D /var/postgresql/data -l logfile start
やりました。成功です。exit を実行して _postgersql ユーザーセッションを終了しましょう:
$ exit
3. PostgreSQL サーバーの起動
デーモンを有効化しましょう。そして起動します:
$ doas rcctl enable postgresql
postgresql(ok)
$ doas rcctl start postgresql
postgresql(ok)
4. サーバーを使う
Postgresql サーバーのデーモンが有効になり、起動されました。RDBMS として使うことができるようになっています。クライアントからのリクエストを処理してくれます。
設定ファイルには postgresql.conf や pg_hba.conf などがありますが、これらは自動で生成されています。また psql コマンドもインストールされています。
設定ファイル
サーバー周りの設定 (英語) を行う時に使います。
psql コマンド
ターミナルから利用できる PostgreSQL 操作用のフロントエンドツールです。先ほどたずねられたパスワードを入力することで、サーバーに接続できます:
$ psql -U postgres
Password for user postgres:
迎え入れられるでしょう :)
psql (14.5)
Type "help" for help.
postgres=#