第5章 マイグレーション

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

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

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

   service rh-mariadb101-mariadb stop

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

   yum install rh-mariadb102-mariadb-server

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

   service rh-mariadb102-mariadb start

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

   scl enable rh-mariadb102 mysql_upgrade

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

   scl enable rh-mariadb102 -- mysql_upgrade -p

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 オプションを追加します。
   注記
   アップグレード後、ダウングレードの可能性を最小限に抑えるために、焼き付き期間の間、下位互換性のない機能を有効にせずに、最初にデプロイメントを実行することが推奨されます。

1. rh-mongodb34 Software Collections から MongoDB サーバーおよびシェルをインストールします。

   ~]# yum install rh-mongodb34

2. MongoDB 3.2 サーバーを停止します。

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

   Red Hat Enterprise Linux 6 システムで service rh-mongodb32-mongodb stop コマンドを使用します。
3. データを新しい場所にコピーします。

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

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

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

   Red Hat Enterprise Linux 6 では、代わりに service rh-mongodb34-mongodb start コマンドを使用します。
6. 後方互換性機能を有効にします。

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

   mongod サーバーでアクセス制御が有効に設定されている場合は、mongo コマンドに --username および --password オプションを追加します。
   アップグレード後に、この機能を最初に有効にせずにデプロイメントを実行することが推奨されます。

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

   yum install rh-mysql57-mysql-server

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

   service rh-mysql56-mysqld stop

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

   service rh-mysql57-mysqld start

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

   scl enable rh-mysql57 mysql_upgrade

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

   scl enable rh-mysql57 -- mysql_upgrade -p

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

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

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

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

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

   scl enable rh-postgresql10 -- postgresql-setup --upgrade

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

   systemctl start rh-postgresql10-postgresql.service

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

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

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

   chkconfig postgresql off

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

   chkconfig rh-postgresql10-postgresql on

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

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

   systemctl start rh-postgresql10-postgresql.service

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

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

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

   chkconfig postgresql off

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

   chkconfig rh-postgresql10-postgresql on

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

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

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

   systemctl stop rh-postgresql96-postgresql.service

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

   systemctl status rh-postgresql96-postgresql.service

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

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

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

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

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

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

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

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

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

   systemctl start rh-postgresql10-postgresql.service

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

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

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

   chkconfig rh-postgresql96-postgreqsql off

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

   chkconfig rh-postgresql10-postgresql on

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

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

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

   systemctl start rh-postgresql96-postgresql.service

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

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

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

   systemctl stop rh-postgresql96-postgresql.service

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

   scl enable rh-postgresql10-postgresql -- postgresql-setup --initdb

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

   systemctl start rh-postgresql10-postgresql.service

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

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

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

   chkconfig rh-postgresql96-postgresql off

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

   chkconfig rh-postgresql10-postgresql on

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

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

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

   service postgresql stop

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

   service postgresql status

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

   file /var/lib/pgsql/data/

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

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

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

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

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

   scl enable rh-postgresql96 -- postgresql-setup --upgrade

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

   service rh-postgresql96-postgresql start

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

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

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

   chkconfig postgresql off

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

   chkconfig rh-postgresql96-postgresql on

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

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

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

   service postgresql start

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

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

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

   service postgresql stop

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

   scl enable rh-postgresql96-postgresql -- postgresql-setup --initdb

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

   service rh-postgresql96-postgresql start

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

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

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

   chkconfig postgresql off

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

   chkconfig rh-postgresql96-postgresql on

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

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

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

   service rh-postgresql95-postgresql stop

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

   service rh-postgresql95-postgresql status

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

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

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

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

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

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

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

   scl enable rh-postgresql96 -- postgresql-setup --upgrade --upgrade-from=rh-postgresql95-postgresql

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

   service rh-postgresql96-postgresql start

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

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

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

   chkconfig rh-postgresql95-postgreqsql off

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

   chkconfig rh-postgresql96-postgresql on

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

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

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

   service rh-postgresql95-postgresql start

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

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

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

   service rh-postgresql95-postgresql stop

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

   scl enable rh-postgresql96-postgresql -- postgresql-setup --initdb

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

   service rh-postgresql96-postgresql start

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

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

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

   chkconfig rh-postgresql95-postgresql off

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

   chkconfig rh-postgresql96-postgresql on

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