第3章 Red Hat Satellite のアップグレード

Satellite Server のアップグレード

1. バックアップを作成します。

   • 仮想マシンで、スナップショットを作成します。

   • 物理マシンで、バックアップを作成します。

     バックアップに関する詳細は、『Red Hat Satellite 6.4 管理』ガイドの「Satellite Server および Capsule Server のバックアップと復元」を参照してください。

2. DNS と DHCP の設定ファイルである /etc/zones.conf と /etc/dhcp/dhcpd.conf のバックアップをそれぞれ作成します。インストーラーでは、ドメインまたはサブネットが 1 つしかサポートされないため、バックアップからの変更の復元が必要になる場合があります。

3. DNS または DHCP の設定ファイルを手動で編集し、変更を上書きしない場合は、以下のコマンドを実行します。

   # satellite-installer --foreman-proxy-dns-managed=false \
   --foreman-proxy-dhcp-managed=false

4. Satellite Web UI で、ホスト > 検出された ホストに移動します。検出されたホストページで、検出したホストの電源を切って削除します。組織の選択 メニューで、組織を順番に選択し、検出したホストの電源を切って削除するプロセスを繰り返します。アップグレードが完了したら、検出されたホストを再起動します。

5. サブスクリプションを更新します。

   # subscription-manager refresh

6. Satellite Maintenance と Red Hat Enterprise Linux Ansible のリポジトリーを有効にします。

   # subscription-manager repos \
   --enable rhel-7-server-satellite-maintenance-6-rpms \
   --enable rhel-7-server-ansible-2.6-rpms

7. 以下のコマンドを入力して、foreman-maintain をインストールするか、最新バージョンに更新します。

   # yum install rubygem-foreman_maintain

8. 利用可能なバージョンを確認して、希望のバージョンが表示されていることを確認します。

   # foreman-maintain upgrade list-versions

9. ヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。プロンプトが表示されたら、hammer の管理者ユーザー認証情報を入力して foreman-maintain を設定します。この変更は、/etc/foreman-maintain/foreman-maintain-hammer.yml ファイルに適用されます。

   # foreman-maintain upgrade check --target-version 6.5

   結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。

10. アップグレード時間は長くなるため、通信セッションの中断と再接続を可能にする screen などのユーティリティーを使用します。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。screen コマンドの使用方法は、Red Hat ナレッジベース の「How do I use the screen command?」を参照してください。

    アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、/var/log/foreman-installer/satellite.log のログで、プロセスが完全に終了したかどうかを確認できます。

11. アップグレードを実行します。

    # foreman-maintain upgrade run --target-version 6.5

12. Check when the kernel packages were last updated:

    # rpm -qa --last | grep kernel

13. If a kernel update occurred since the last reboot, reboot the system:

    # reboot

14. BASH シェルを使用している場合は、アップグレードに成功または失敗した後に、以下を入力します。

    # hash -d foreman-maintain service 2> /dev/null

15. 作成したバックアップを使用して、DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。

16. 以前の手順で変更を加えた場合には、Satellite サービスを再起動します。

    # foreman-maintain service restart

17. OpenSCAP プラグインがインストールされているにもかかわらず、デフォルトの OpenSCAP コンテンツが利用できない場合は、以下のコマンドを実行します。

    # foreman-rake foreman_openscap:bulk_upload:default

切断されている Satellite Server のアップグレード

1. バックアップを作成します。

   • 仮想マシンで、スナップショットを作成します。
   • 物理マシンで、バックアップを作成します。

2. アップグレード前スクリプトは競合を検出し、アップグレード後に登録解除および削除できる Satellite Server の重複エントリーがあるホストをリストできます。また、組織に割り当てられていないホストを検出します。ホスト > すべてのホスト で、組織の関連付けがないホストがリストされ、同じ名前のコンテンツホストに組織がすでに関連付けられている場合、コンテンツホストは自動的に登録解除されます。これは、アップグレード前にこのようなホストを組織に関連付けることによって回避できます。

   アップグレードの前に、アップグレード前チェックスクリプトを実行して、削除できるホストのリストを取得します。関連付けられていないホストが検出された場合は、アップグレードの前に組織にそれらのホストを関連付けることが推奨されます。

   # foreman-rake katello:upgrade_check

   アップグレードチェックで、タスクが実行中であることが原因の障害が報告された場合は、タスクが完了するまで待機することが推奨されます。一部のタスクはキャンセルすることができますが、Red Hat ナレッジベースソリューション「Red Hat Satellite 6 で一時停止したタスクを管理する 」に目を通して、安全にキャンセルできるタスクとできないタスクについて理解する必要があります。

3. DNS と DHCP の設定ファイルである /etc/zones.conf と /etc/dhcp/dhcpd.conf のバックアップをそれぞれ作成します。インストーラーでは、ドメインまたはサブネットが 1 つしかサポートされないため、バックアップからの変更の復元が必要になる場合があります。

4. DNS または DHCP の設定ファイルを手動で編集し、変更を上書きしない場合は、以下のようにインストーラースクリプトを実行します。

   # satellite-installer --foreman-proxy-dns-managed=false \
   --foreman-proxy-dhcp-managed=false

5. Satellite Web UI で、ホスト > 検出されたホスト に移動します。検出されたホストが利用可能な場合は無効にし、検出されたホスト ページにあるエントリーをすべて削除します。必要に応じて、組織設定メニューから、その他の組織を順番に選択し、すべてのエントリーを削除します。アップグレードが完了したら、検出されたホストを再起動します。
6. すべての外部 Capsule Server が組織に割り当てられていることを確認します。割り当てられていない場合、これらのサーバーは、ホスト統合の変更により登録解除された可能性があります。

7. 以前のリポジトリーを削除します。

   # rm /etc/yum.repos.d/*

8. Satellite サービスを停止します。

   # foreman-maintain service stop

9. 『オフラインネットワークからの Satellite SERVER のインストール』ガイドの「バイナリー DVD イメージのダウンロード」の手順に従って、最新の ISO ファイルを取得します。
10. 『オフラインネットワークからの Satellite SERVER のインストール』ガイドの「オフラインリポジトリーでベースシステムの設定」の手順に従い、マウントポイントとして使用するディレクトリーを作成し、ISO イメージをマウントして、rhel7-server リポジトリーを設定します。この段階では、パッケージのインストールや更新はしないでください。

11. ISO ファイルから Satellite 6.5リポジトリーを設定します。

    1. Red Hat Satellite パッケージ用に ISO ファイルのリポジトリーデータファイルをコピーします。

       # cp /media/sat6/media.repo /etc/yum.repos.d/sat6.repo

    2. /etc/yum.repos.d/sat6.repo ファイルを編集します。

       # vi /etc/yum.repos.d/sat6.repo

       1. デフォルトの InstallMedia リポジトリー名を Satellite-6.5 に変更します。

          [Satellite-6.5]

       2. baseurl ディレクティブを追加します。

          baseurl=file:///media/sat6/

12. ISO ファイルからの Red Hat Software Collections リポジトリーを設定します。

    1. Red Hat Software Collections パッケージ用に ISO ファイルのリポジトリーデータファイルをコピーします。

       # cp /media/sat6/RHSCL/media.repo /etc/yum.repos.d/RHSCL.repo

    2. /etc/yum.repos.d/RHSCL.repo ファイルを編集します。

       # vi /etc/yum.repos.d/RHSCL.repo

       1. デフォルトの InstallMedia リポジトリー名を RHSCL に変更します。

          [RHSCL]

       2. baseurl ディレクティブを追加します。

          baseurl=file:///media/sat6/RHSCL/

13. ISO ファイルからの Red Hat Satellite Maintenance リポジトリーを設定します。

    1. Red Hat Satellite Maintenance パッケージ用に ISO ファイルのリポジトリーデータファイルをコピーします。

       # cp /media/sat6/sat-maintenance/media.repo /etc/yum.repos.d/sat-maintenance.repo

    2. /etc/yum.repos.d/sat-maintenance.repo ファイルを編集します。

       # vi /etc/yum.repos.d/sat-maintenance.repo

       1. デフォルトの InstallMedia リポジトリー名を Satellite-Maintenance に変更します。

          [Satellite-Maintenance]

       2. baseurl ディレクティブを追加します。

          baseurl=file:///media/sat6/sat-maintenance/

14. カスタム Apache サーバー設定がある場合は、次の手順でインストールデフォルト値に戻ります。アップグレードの実行時に変更する内容を確認する場合は、--noop (no operation) オプションとともにアップグレードコマンドを入力し、次の手順でアップグレードコマンドを入力するときに適用される変更内容を確認できます。このテストを行わない場合は、次の手順に進みます。テストを行う場合は、以下の手順を行います。

    1. 次の行を /etc/httpd/conf/httpd.conf 設定ファイルに追加します。

       Include /etc/httpd/conf.modules.d/*.conf

    2. httpd サービスを再起動します。

       # systemctl restart httpd

    3. postgresql データベースサービスおよび rh-mongodb34-mongod データベースサービスを起動します。

       # systemctl start postgresql
       # systemctl start rh-mongodb34-mongod

    4. --noop オプションを付けて、インストーラースクリプトを実行します。

       # satellite-installer --scenario satellite --upgrade --verbose --noop

       /var/log/foreman-installer/satellite.log を参照して、--noop オプションを付けずに実行した場合に 適用される変更 を確認します。設定ファイルへの変更を示す +++ と --- の記号を探します。この "no operation" オプションにより、実際にはファイルは作成されませんが、モジュール内の一部の Puppet リソースではファイルが作成されていることが期待されるため、エラーメッセージが表示されるはずです。

    5. Satellite サービスを停止します。

       # foreman-maintain service stop

15. アップグレード時間は長くなるため、通信セッションの中断と再接続を可能にする screen などのユーティリティーを使用します。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。screen コマンドの使用方法は、Red Hat ナレッジベース の「How do I use the screen command?」を参照してください。

    アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、/var/log/foreman-installer/satellite.log のログで、プロセスが完全に終了したかどうかを確認できます。

16. 以下のコマンドを入力して、foreman-maintain をインストールするか、最新バージョンに更新します。

    # yum install rubygem-foreman_maintain

17. 利用可能なバージョンを確認して、希望のバージョンが表示されていることを確認します。

    # foreman-maintain upgrade list-versions

18. ヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。プロンプトが表示されたら、hammer の管理者ユーザー認証情報を入力して foreman-maintain を設定します。この変更は、/etc/foreman-maintain/foreman-maintain-hammer.yml ファイルに適用されます。

    # foreman-maintain upgrade check --target-version 6.5 \
    --whitelist="repositories-validate,repositories-setup"

    結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。

19. アップグレードを実行します。

    # foreman-maintain upgrade run --target-version 6.5 \
    --whitelist="repositories-validate,repositories-setup"

    警告

    config サブディレクトリーを含むディレクトリーからコマンドを実行すると、以下のエラーが発生します。

    ERROR: Scenario (config/satellite.yaml) was not found, can not continue.

    このような場合は、root ユーザーのホームディレクトリーに移動し、コマンドを再実行します。

    パッケージが古いか、足りないためにスクリプトに失敗した場合には、これらのパッケージを個別にダウンロードしてインストールする必要があります。詳細は、『オフラインネットワークからの Satellite SERVER のインストール』ガイドの「パッケージの手動ダウンロード」の手順を参照してください。

20. BASH シェルを使用している場合は、アップグレードに成功または失敗した後に、以下を入力します。

    # hash -d foreman-maintain service 2> /dev/null

21. Check when the kernel packages were last updated:

    # rpm -qa --last | grep kernel

22. If a kernel update occurred since the last reboot, reboot the system:

    # reboot

23. 作成したバックアップを使用して、DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。

24. 以前の手順で変更を加えた場合には、Satellite サービスを再起動します。

    # foreman-maintain service restart

25. OpenSCAP プラグインがインストールされているにもかかわらず、デフォルトの OpenSCAP コンテンツが利用できない場合は、以下のコマンドを実行します。

    # foreman-rake foreman_openscap:bulk_upload:default

26. Satellite Web UI で 設定 > 検出ルール に移動し、選択した組織および場所を検出ルールに関連付けます。