第5章 移行

1. rh-mariadb103 データベースサーバーが実行している場合は停止します。
   サーバーを停止する前に、innodb_fast_shutdown オプションを 0 に設定し、InnoDB が完全なパージや挿入バッファーマージを含む低速なシャットダウンを実行します。アップストリームのドキュメント で、このオプションの詳細を参照してください。この操作は、通常のシャットダウンの場合よりも長い時間がかかる可能性があります。

   mysql -uroot -p -e "SET GLOBAL innodb_fast_shutdown = 0"

   rh-mariadb103 サーバーを停止します。

   systemctl stop rh-mariadb103-mariadb.service

2. mysql_upgrade ユーティリティーを提供するサブパッケージを含む rh-mariadb105 Software Collection をインストールします。

   yum install rh-mariadb105-mariadb-server rh-mariadb105-mariadb-server-utils

   これらの Collections が競合しないため、rh-mariadb105 Software Collection のインストール中は rh-mariadb103 Software Collection をインストールすることができることに注意してください。
3. /etc/opt/rh/rh-mariadb105/my.cnf ファイルおよび /etc/ opt/rh/rh-mariadb105/my.cnf.d/ ディレクトリーに保存されている rh-mariadb105 の設定を検証します。これを /etc/opt/rh/rh-mariadb103/my.cnf および /etc/opt/rh/rh-mariadb103/my.cnf.d/ に保存されている rh-mariadb103 の設定と比較して、必要に応じて調整します。
4. rh-mariadb103 Software Collection のすべてのデータは、異なる設定しない限り、/var/opt/rh/rh-mariadb103/lib/mysql/ ディレクトリーに保存されます。このディレクトリーのすべての内容を /var/opt/rh/rh-mariadb105/lib/mysql/ にコピーします。コンテンツを移動することはできますが、アップグレードを続行する前にデータをバックアップすることを忘れないようにしてください。データが mysql ユーザーによって所有され、SELinux コンテキストが正しいことを確認します。
5. rh-mariadb105 データベースサーバーを起動します。

   systemctl start rh-mariadb105-mariadb.service

6. データ移行を実行します。MDEV-14637 で導入されたアップストリームの変更により、mysql_upgrade コマンドを実行する必要があることに注意してください。

   scl enable rh-mariadb105 mysql_upgrade

   root ユーザーに空ではないパスワードが定義されている場合 (パスワードを定義しておく必要あり) は、-p オプションを指定して mysql_upgrade ユーティリティーを呼び出してパスワードを指定する必要があります。

   scl enable rh-mariadb105 -- mysql_upgrade -p

   rh-mariadb105*-syspaths パッケージのインストール時には、scl enable コマンドは必要ありません。ただし、*-syspaths パッケージは、ベースの Red Hat Enterprise Linux システムと、rh-mariadb103 および rh-mysql80 Software Collections からの対応するパッケージと競合します。

1. rh-mysql80 Software Collection をインストールします。

   yum install rh-mysql80-mysql-server

2. /etc/opt/rh/rh-mysql80/my.cnf ファイルおよび /etc/opt/rh/rh-mysql80/my.cnf.d/ ディレクトリーに保存されている rh-mysql80 の設定を検証します。これを /etc/opt/rh/rh-mysql57/my.cnf と /etc/opt/rh/rh-mysql57/my.cnf.d/ に保存されている rh-mysql57 の設定と比較して、必要に応じて調整します。
3. rh-mysql57 データベースサーバーが実行している場合は停止します。

   systemctl stop rh-mysql57-mysqld.service

4. rh-mysql57 Software Collection のすべてのデータは /var/opt/rh/rh-mysql57/lib/mysql/ ディレクトリーに保存されます。このディレクトリーのすべての内容を /var/opt/rh/rh-mysql80/lib/mysql/ にコピーします。コンテンツを移動することもできますが、アップグレードを続行する前にデータのバックアップを作成することを忘れないようにしてください。
5. rh-mysql80 データベースサーバーを起動します。

   systemctl start rh-mysql80-mysqld.service

6. データ移行を実行します。

   scl enable rh-mysql80 mysql_upgrade

   root ユーザーに空ではないパスワードが定義されている場合 (パスワードを定義しておく必要あり) は、-p オプションを指定して mysql_upgrade ユーティリティーを呼び出してパスワードを指定する必要があります。

   scl enable rh-mysql80 -- mysql_upgrade -p

   rh-mysql80*-syspaths パッケージのインストール時には、scl enable コマンドは必要ありません。ただし、*-syspaths パッケージは、ベースの Red Hat Enterprise Linux システムと、rh-mariadb103 および rh-mariadb105 Software Collections からの対応するパッケージと競合します。

手順5.1 pg_upgrade ツールを使用した高速アップグレード

1. 古い PostgreSQL サーバーを停止し、データが一貫性のない状態にあることを確認します。これを行うには、root で次のコマンドを実行します。

   systemctl stop postgresql.service

   サーバーが起動していないことを確認するには、以下を入力します。

   systemctl status postgresql.service

2. 古いディレクトリー /var/lib/pgsql/data/ が存在することを確認します。

   file /var/lib/pgsql/data/

   データのバックアップを作成します。
3. 新しいデータディレクトリー /var/opt/rh/rh-postgresql13/lib/pgsql/data/ が存在しないことを確認します。

   file /var/opt/rh/rh-postgresql13/lib/pgsql/data/

   PostgreSQL 13 の新規インストールを実行している場合は、このディレクトリーはシステムに存在しないはずです。その場合は、root で以下のコマンドを実行してバックアップを作成します。

   mv /var/opt/rh/rh-postgresql13/lib/pgsql/data{,-scl-backup}

4. root で以下のコマンドを実行して、新しいサーバーのデータベースデータをアップグレードします。

   scl enable rh-postgresql13 -- postgresql-setup --upgrade

   または、/opt/rh/rh-postgresql13/root/usr/bin/postgresql-setup --upgrade コマンドを使用できます。
   別のバージョンの PostgreSQL からアップグレードする場合には、--upgrade-from オプションを使用できます。可能なアップグレードシナリオのリストは、--upgrade-ids オプションを使用して利用できます。
   作成された /var/lib/pgsql/upgrade_rh-postgresql13-postgresql.log ログファイルを読み取り、アップグレード中に問題が発生したかどうかを確認することが推奨されます。
5. root で新しいサーバーを起動します。

   systemctl start rh-postgresql13-postgresql.service

   また、以下のように analyze_new_cluster.sh スクリプトを実行することが推奨されます。

   su - postgres -c 'scl enable rh-postgresql13 ~/analyze_new_cluster.sh'

6. 必要に応じて、システムの起動時に PostgreSQL 13 サーバーが自動的に起動するように設定できます。古いシステム PostgreSQL サーバーを無効にするには、root で以下のコマンドを入力します。

   chkconfig postgresql off

   PostgreSQL 13 サーバーを有効にするには、root で以下を入力します。

   chkconfig rh-postgresql13-postgresql on

7. デフォルトの設定と異なる場合は、設定ファイル (特に /var/opt/rh/rh-postgresql13/lib/pgsql/data/pg_hba.conf 設定ファイル) を必ず更新してください。それ以外の場合は、postgres ユーザーのみがデータベースにアクセスできます。

手順5.2 ダンプおよびリストアアップグレードの実行

1. シェルプロンプトで、root で以下を入力し、古い PostgreSQL サーバーが実行中であることを確認します。

   systemctl start postgresql.service

2. PostgreSQL データベースの全データをスクリプトファイルにダンプします。root で以下のコマンドを実行します。

   su - postgres -c 'pg_dumpall > ~/pgdump_file.sql'

3. root で以下のコマンドを実行して、古いサーバーを停止します。

   systemctl stop postgresql.service

4. 新規サーバーのデータディレクトリーを root として初期化します。

   scl enable rh-postgresql13 -- postgresql-setup initdb

5. root で新しいサーバーを起動します。

   systemctl start rh-postgresql13-postgresql.service

6. 以前に作成した SQL ファイルからデータをインポートします。

   su - postgres -c 'scl enable rh-postgresql13 "psql -f ~/pgdump_file.sql postgres"'

7. 必要に応じて、システムの起動時に PostgreSQL 13 サーバーが自動的に起動するように設定できます。古いシステム PostgreSQL サーバーを無効にするには、root で以下のコマンドを入力します。

   chkconfig postgresql off

   PostgreSQL 13 サーバーを有効にするには、root で以下を入力します。

   chkconfig rh-postgresql13-postgresql on

8. デフォルトの設定と異なる場合は、設定ファイル (特に /var/opt/rh/rh-postgresql13/lib/pgsql/data/pg_hba.conf 設定ファイル) を必ず更新してください。それ以外の場合は、postgres ユーザーのみがデータベースにアクセスできます。

手順5.3 pg_upgrade ツールを使用した高速アップグレード

1. 古い PostgreSQL サーバーを停止し、データが一貫性のない状態にあることを確認します。これを行うには、root で次のコマンドを実行します。

   systemctl stop rh-postgresql12-postgresql.service

   サーバーが起動していないことを確認するには、以下を入力します。

   systemctl status rh-postgresql12-postgresql.service

2. 古いディレクトリー /var/opt/rh/rh-postgresql12/lib/pgsql/data/ が存在することを確認します。

   file /var/opt/rh/rh-postgresql12/lib/pgsql/data/

   データのバックアップを作成します。
3. 新しいデータディレクトリー /var/opt/rh/rh-postgresql13/lib/pgsql/data/ が存在しないことを確認します。

   file /var/opt/rh/rh-postgresql13/lib/pgsql/data/

   PostgreSQL 13 の新規インストールを実行している場合は、このディレクトリーはシステムに存在しないはずです。その場合は、root で以下のコマンドを実行してバックアップを作成します。

   mv /var/opt/rh/rh-postgresql13/lib/pgsql/data{,-scl-backup}

4. root で以下のコマンドを実行して、新しいサーバーのデータベースデータをアップグレードします。

   scl enable rh-postgresql13 -- postgresql-setup --upgrade --upgrade-from=rh-postgresql12-postgresql

   または、/opt/rh/rh-postgresql13/root/usr/bin/postgresql-setup --upgrade --upgrade-from=rh-postgresql12-postgresql コマンドを使用できます。
   別のバージョンの PostgreSQL からアップグレードする場合には、--upgrade-from オプションを使用できます。可能なアップグレードシナリオのリストは、--upgrade-ids オプションを使用して利用できます。
   作成された /var/lib/pgsql/upgrade_rh-postgresql13-postgresql.log ログファイルを読み取り、アップグレード中に問題が発生したかどうかを確認することが推奨されます。
5. root で新しいサーバーを起動します。

   systemctl start rh-postgresql13-postgresql.service

   また、以下のように analyze_new_cluster.sh スクリプトを実行することが推奨されます。

   su - postgres -c 'scl enable rh-postgresql13 ~/analyze_new_cluster.sh'

6. 必要に応じて、システムの起動時に PostgreSQL 13 サーバーが自動的に起動するように設定できます。古い PostgreSQL 12 サーバーを無効にするには、root で以下のコマンドを入力します。

   chkconfig rh-postgresql12-postgreqsql off

   PostgreSQL 13 サーバーを有効にするには、root で以下を入力します。

   chkconfig rh-postgresql13-postgresql on

7. デフォルトの設定と異なる場合は、設定ファイル (特に /var/opt/rh/rh-postgresql13/lib/pgsql/data/pg_hba.conf 設定ファイル) を必ず更新してください。それ以外の場合は、postgres ユーザーのみがデータベースにアクセスできます。

手順5.4 ダンプおよびリストアアップグレードの実行

1. シェルプロンプトで、root で以下を入力し、古い PostgreSQL サーバーが実行中であることを確認します。

   systemctl start rh-postgresql12-postgresql.service

2. PostgreSQL データベースの全データをスクリプトファイルにダンプします。root で以下のコマンドを実行します。

   su - postgres -c 'scl enable rh-postgresql12 "pg_dumpall > ~/pgdump_file.sql"'

3. root で以下のコマンドを実行して、古いサーバーを停止します。

   systemctl stop rh-postgresql12-postgresql.service

4. 新規サーバーのデータディレクトリーを root として初期化します。

   scl enable rh-postgresql13 -- postgresql-setup initdb

5. root で新しいサーバーを起動します。

   systemctl start rh-postgresql13-postgresql.service

6. 以前に作成した SQL ファイルからデータをインポートします。

   su - postgres -c 'scl enable rh-postgresql13 "psql -f ~/pgdump_file.sql postgres"'

7. 必要に応じて、システムの起動時に PostgreSQL 13 サーバーが自動的に起動するように設定できます。古い PostgreSQL 12 サーバーを無効にするには、root で以下のコマンドを入力します。

   chkconfig rh-postgresql12-postgresql off

   PostgreSQL 13 サーバーを有効にするには、root で以下を入力します。

   chkconfig rh-postgresql13-postgresql on

8. デフォルトの設定と異なる場合は、設定ファイル (特に /var/opt/rh/rh-postgresql13/lib/pgsql/data/pg_hba.conf 設定ファイル) を必ず更新してください。それ以外の場合は、postgres ユーザーのみがデータベースにアクセスできます。