第5章 移行

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

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

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

   systemctl stop rh-mariadb102-mariadb.service

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

   yum install rh-mariadb103-mariadb-server rh-mariadb103-mariadb-server-utils

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

   systemctl start rh-mariadb103-mariadb.service

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

   scl enable rh-mariadb103 mysql_upgrade

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

   scl enable rh-mariadb103 -- mysql_upgrade -p

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

1. アップグレードできるようにするには、rh-mongodb34 インスタンスの featureCompatibilityVersion が 3.4 に設定されている必要があります。featureCompatibilityVersion を確認します。

   ~]$ scl enable rh-mongodb34 'mongo --host localhost --port 27017 admin' --eval 'db.adminCommand({getParameter: 1, featureCompatibilityVersion: 1})'

   mongod サーバーでアクセス制御が有効に設定されている場合は、mongo コマンドに --username および --password オプションを追加します。
2. rh-mongodb36 Software Collections から MongoDB サーバーおよびシェルをインストールします。

   ~]# yum install rh-mongodb36

3. MongoDB 3.4 サーバーを停止します。

   ~]# systemctl stop rh-mongodb34-mongod.service

4. データを新しい場所にコピーします。

   ~]# cp -a /var/opt/rh/rh-mongodb34/lib/mongodb/* /var/opt/rh/rh-mongodb36/lib/mongodb/

5. /etc/opt/rh/rh-mongodb36/mongod.conf ファイルで rh-mongodb36-mongod デーモンを設定します。
6. MongoDB 3.6 サーバーを起動します。

   ~]# systemctl start rh-mongodb36-mongod.service

7. 後方互換性のない機能を有効にします。

   ~]$ scl enable rh-mongodb36 'mongo --host localhost --port 27017 admin' --eval 'db.adminCommand( { setFeatureCompatibilityVersion: "3.6" } )'

   mongod サーバーでアクセス制御が有効に設定されている場合は、mongo コマンドに --username および --password オプションを追加します。
   注記
   アップグレード後、ダウングレードの可能性を最小限に抑えるために、焼き付き期間の間、下位互換性のない機能を有効にせずに、最初にデプロイメントを実行することが推奨されます。

手順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-postgresql12/lib/pgsql/data/ が存在しないことを確認します。

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

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

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

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

   scl enable rh-postgresql12 -- postgresql-setup --upgrade

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

   systemctl start rh-postgresql12-postgresql.service

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

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

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

   chkconfig postgresql off

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

   chkconfig rh-postgresql12-postgresql on

7. 設定がデフォルトと異なる場合は、設定ファイル (特に /var/opt/rh/rh-postgresql12/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-postgresql12 -- postgresql-setup initdb

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

   systemctl start rh-postgresql12-postgresql.service

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

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

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

   chkconfig postgresql off

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

   chkconfig rh-postgresql12-postgresql on

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

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

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

   systemctl stop rh-postgresql10-postgresql.service

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

   systemctl status rh-postgresql10-postgresql.service

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

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

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

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

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

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

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

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

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

   systemctl start rh-postgresql12-postgresql.service

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

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

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

   chkconfig rh-postgresql10-postgreqsql off

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

   chkconfig rh-postgresql12-postgresql on

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

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

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

   systemctl start rh-postgresql10-postgresql.service

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

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

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

   systemctl stop rh-postgresql10-postgresql.service

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

   scl enable rh-postgresql12 -- postgresql-setup initdb

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

   systemctl start rh-postgresql12-postgresql.service

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

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

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

   chkconfig rh-postgresql10-postgresql off

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

   chkconfig rh-postgresql12-postgresql on

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