環境・背景
- OS: CentOS7
- DB: Postgresql 9.6
もともとのPostgresql9.6は、yumを使用してインストールしました。
この環境に Postgresql 14.6 をインストールし、既存のDB等を移行したい。
Postgresql 14.6 のインストール
yum リポジトリの追加
yum searchで探してみましたが、見つけられる最新版はv13だったため、v14を取得するためのリポジトリを追加します。
$ sudo yum -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm
インストール
$ sudo yum -y install postgresql14-server postgresql14-contrib
初期化
ちなみに、必要かどうかは検証していませんが、ここから先は postgres ユーザーで行っています。
$ su - postgres
$ /usr/pgsql-14/bin/initdb -D /var/lib/pgsql/14/data/
移行開始
v9.6サービス停止
$ sudo systemctl stop postgresql-9.6.service
アップグレード開始！
$ /usr/pgsql-14/bin/pg_upgrade -b /usr/pgsql-9.6/bin/ -B /usr/pgsql-14/bin/ -d /var/lib/pgsql/9.6/data/ -D /var/lib/pgsql/14/data/
ところが
エラーが出ました。どうやらログインのセキュリティ設定に問題がある模様。
Checking cluster versions ok
ソケット"/var/lib/pgsql/.s.PGSQL.50432"上でのサーバーへの接続に失敗しました: fe_sendauth: no password supplied
以下のコマンドで起動した移行元postmasterに接続できませんでした:
"/usr/pgsql-9.6/bin/pg_ctl" -w -l "pg_upgrade_server.log" -D "/var/lib/pgsql/9.6/data" -o "-p 50432 -b -c listen_addresses='' -c unix_socket_permissions=0700 -c unix_socket_directories='/var/lib/pgsql'" start
失敗しました、終了しています
設定を変更して再実行
v9.6 の設定ではmd5パスワード認証を指定しているところ、認証を外して trust にしてやらないと pg_upgrade がエラーになるらしいので、設定を変更します。
- /var/lib/pgsql/9.6/data/pg_hba.conf
# "local" is for Unix domain socket connections only
local all all trust
# IPv4 local connections:
host all all 127.0.0.1/32 trust
# IPv6 local connections:
host all all ::1/128 trust
改めて pg_upgrade を実行すると、別のエラーが出ました。
Checking for presence of required libraries 致命的
旧の環境で、新の環境にはないローダブルライブラリを参照しています。
これらのライブラリを新の環境に追加するか、もしくは旧の環境から
それらを使っている関数を削除してください。 問題のライブラリの一覧は、
以下のファイルに入っています:
loadable_libraries.txt
失敗しました、終了しています
loadable_libraries.txtを確認し、記述されている必要なライブラリをv14環境に追加します。
必要なライブラリをv14環境に追加
v14 のサービスを起動します。
$ sudo systemctl start postgresql-14
今回は pgcryptoが不足していたので、追加します。
$ psql
# create extension pgcrypto;
CREATE EXTENSION
# \q
v14 のサービスを停止します。
$ sudo systemctl stop postgresql-14
改めてアップグレード開始
$ /usr/pgsql-14/bin/pg_upgrade -b /usr/pgsql-9.6/bin/ -B /usr/pgsql-14/bin/ -d /var/lib/pgsql/9.6/data/ -D /var/lib/pgsql/14/data/
リレーション"ほげほげテーブル"のコピー中にエラー: ファイル"コピー先ディレクトリ"に書けませんでした: デバイスに空き領域がありませ ん
失敗しました、終了しています
ほげええ
管理者に仮想マシンの容量を拡張してもらうまで中断じゃ中断
再開そして完了
- initDBをやり直してv14の環境を再構築します。
- 途中まで進んだupgrade作業の結果作成されたファイルやディレクトリを削除します。
（残ったままpg_upgradeするとエラーになりますが、表示される問題のディレクトリを都度削除して再実行。を繰り返しました）
$ /usr/pgsql-14/bin/pg_upgrade -b /usr/pgsql-9.6/bin/ -B /usr/pgsql-14/bin/ -d /var/lib/pgsql/9.6/data/ -D /var/lib/pgsql/14/data/
整合性チェックを実行しています。
-----------------------------
Checking cluster versions ok
Checking database user is the install user ok
Checking database connection settings ok
Checking for prepared transactions ok
Checking for system-defined composite types in user tables ok
Checking for reg* data types in user tables ok
Checking for contrib/isn with bigint-passing mismatch ok
Checking for user-defined encoding conversions ok
Checking for user-defined postfix operators ok
Checking for incompatible polymorphic functions ok
Checking for tables WITH OIDS ok
Checking for invalid "sql_identifier" user columns ok
Checking for invalid "unknown" user columns ok
Creating dump of global objects ok
Creating dump of database schemas
ok
Checking for presence of required libraries ok
Checking database user is the install user ok
Checking for prepared transactions ok
Checking for new cluster tablespace directories ok
この後pg_upgradeが失敗した場合は、続ける前に新しいクラスタを
initdbで再作成する必要があります。
アップグレードを実行しています。
------------------
Analyzing all rows in the new cluster ok
Freezing all rows in the new cluster ok
Deleting files from new pg_xact ok
Copying old pg_clog to new server ok
Setting oldest XID for new cluster ok
Setting next transaction ID and epoch for new cluster ok
Deleting files from new pg_multixact/offsets ok
Copying old pg_multixact/offsets to new server ok
Deleting files from new pg_multixact/members ok
Copying old pg_multixact/members to new server ok
Setting next multixact ID and offset for new cluster ok
Resetting WAL archives ok
Setting frozenxid and minmxid counters in new cluster ok
Restoring global objects in the new cluster ok
Restoring database schemas in the new cluster
ok
ユーザーリレーションのファイルをコピーしています
ok
Setting next OID for new cluster ok
Sync data directory to disk ok
Creating script to delete old cluster ok
Checking for hash indexes ok
Checking for extension updates ok
アップグレードが完了しました
----------------
オプティマイザーの統計情報は、pg_upgrade では転送されません。
新サーバーを起動した後、以下のコマンドを実行することを検討してください:
/usr/pgsql-14/bin/vacuumdb --all --analyze-in-stages
このスクリプトを実行すると、旧クラスタのデータファイル ./delete_old_cluster.shが削除されます:
アップグレードが完了しました！指示された通り新サーバーを起動します
$ systemctl start postgresql-14
指示された通り、統計情報の算出を行います。
$ su - postgres
# /usr/pgsql-14/bin/vacuumdb --all --analyze-in-stages
完了！
あとは /var/lib/pgsql/14/data/postgresql.confや/var/lib/pgsql/14/data/pg_hba.confを編集して外部からの接続を許可して再起動して、接続確認をして移行完了です。
そのあとで旧環境（v9.6）を消すのがいいと思います。私はいろいろあってしばらく残しておきますが。
以上です。
参考資料
PostgreSQL を CentOS にインストールするには
PostgreSQL 14.5文書 pg_upgrade