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

Satellite Server のアップグレード

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

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

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

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

2. オプション: /etc/zones.conf または /etc/dhcp/dhcpd.conf ファイルで DNS または DHCP の設定を手動で編集した場合には、設定ファイルをバックアップしてください。インストーラーはドメインまたはサブネット 1 つしかサポートしないので、このバックアップから変更を復元する必要がある場合があります。

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

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

   Copy to Clipboard Toggle word wrap

4. オプション: PostgreSQL を外部データベースとして使用する場合には、PostgreSQL サーバーで rh-postgresql12-postgresql-evr パッケージをインストールします。このパッケージは rhel-7-server-satellite-6.9-rpms リポジトリーから取得できます。

   # yum install rh-postgresql12-postgresql-evr

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

6. Satellite Maintenance リポジトリーが有効になっていることを確認します。

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

   Copy to Clipboard Toggle word wrap

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

   # satellite-maintain upgrade list-versions

   Copy to Clipboard Toggle word wrap

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

   # satellite-maintain upgrade check --target-version 6.9

   Copy to Clipboard Toggle word wrap

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

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

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

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

    # satellite-maintain upgrade run --target-version 6.9

    Copy to Clipboard Toggle word wrap

11. カーネルパッケージが最後に更新された日時を確認します。

    # rpm -qa --last | grep kernel

    Copy to Clipboard Toggle word wrap

12. オプション: 最後の再起動以降にカーネルが更新された場合には、satellite-maintain サービスを停止して、システムを再起動します。

    # satellite-maintain service stop
    # reboot

    Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap
14. オプション: DNS または DHCP 設定ファイルを手動で編集した場合には、作成するバックアップを使用して、DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。

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

    # satellite-maintain service restart

    Copy to Clipboard Toggle word wrap

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

    # foreman-rake foreman_openscap:bulk_upload:default

    Copy to Clipboard Toggle word wrap

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

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

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

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

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

   # foreman-rake katello:upgrade_check

   Copy to Clipboard Toggle word wrap
3. オプション: /etc/zones.conf または /etc/dhcp/dhcpd.conf ファイルで DNS または DHCP の設定を手動で編集した場合には、設定ファイルをバックアップしてください。インストーラーはドメインまたはサブネットを 1 つしかサポートしないので、これらのバックアップから変更を復元しなければならない場合があります。

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

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

   Copy to Clipboard Toggle word wrap

5. オプション: PostgreSQL を外部データベースとして使用する場合には、PostgreSQL サーバーで rh-postgresql12-postgresql-evr パッケージをインストールします。このパッケージは rhel-7-server-satellite-6.9-rpms リポジトリーから取得できます。

   # yum install rh-postgresql12-postgresql-evr

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

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

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

   Copy to Clipboard Toggle word wrap

9. satellite-maintain サービスを停止します。

   # satellite-maintain service stop

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

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

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

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

       Copy to Clipboard Toggle word wrap

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

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

       Copy to Clipboard Toggle word wrap

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

          [Satellite-6.9]

          Copy to Clipboard Toggle word wrap

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

          baseurl=file:///media/sat6/

          Copy to Clipboard Toggle word wrap

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

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

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

       Copy to Clipboard Toggle word wrap

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

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

       Copy to Clipboard Toggle word wrap

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

          [RHSCL]

          Copy to Clipboard Toggle word wrap

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

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

          Copy to Clipboard Toggle word wrap

14. 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

       Copy to Clipboard Toggle word wrap

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

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

       Copy to Clipboard Toggle word wrap

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

          [Satellite-Maintenance]

          Copy to Clipboard Toggle word wrap

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

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

          Copy to Clipboard Toggle word wrap

15. オプション: カスタムの Apache サーバー設定を適用している場合に、アップグレードを実行すると、カスタムの設定がインストール時のデフォルト設定に戻る点に注意してください。

    アップグレード時に適用された変更をプレビューするには、--noop (操作なし) オプションを指定して satellite-installer コマンドを実行します。これらの変更は、以下の手順で satellite-maintain upgrade コマンドを入力すると適用します。

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

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

       Copy to Clipboard Toggle word wrap

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

       # systemctl restart httpd

       Copy to Clipboard Toggle word wrap

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

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

       Copy to Clipboard Toggle word wrap

    4. --noop オプションを指定して、satellite-installer コマンドを入力します。

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

       Copy to Clipboard Toggle word wrap

       アップグレード時に適用された変更をプレビューするには、/var/log/foreman-installer/satellite.log を確認します。設定ファイルへの変更を示す +++ と --- シンボルの場所を特定します。--noop オプションを指定して satellite-installer コマンドを入力しても、Satellite に変更は適用されませんが、モジュール内の Puppet リソースによっては変更が適用されることを想定している場合があり、エラーのメッセージが表示される可能性があります。

    5. satellite-maintain サービスを停止します。

       # satellite-maintain service stop

       Copy to Clipboard Toggle word wrap

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

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

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

    # satellite-maintain upgrade list-versions

    Copy to Clipboard Toggle word wrap

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

    # satellite-maintain upgrade check --target-version 6.9 \
    --whitelist="repositories-validate,repositories-setup"

    Copy to Clipboard Toggle word wrap

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

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

    # satellite-maintain upgrade run --target-version 6.9 \
    --whitelist="repositories-validate,repositories-setup"

    Copy to Clipboard Toggle word wrap
    警告

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

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

    Copy to Clipboard Toggle word wrap

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

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

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

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

    Copy to Clipboard Toggle word wrap

21. カーネルパッケージが最後に更新された日時を確認します。

    # rpm -qa --last | grep kernel

    Copy to Clipboard Toggle word wrap

22. オプション: 最後の再起動以降にカーネルが更新された場合には、satellite-maintain サービスを停止して、システムを再起動します。

    # satellite-maintain service stop
    # reboot

    Copy to Clipboard Toggle word wrap
23. オプション: DNS または DHCP 設定ファイルを手動で編集した場合には、作成したバックアップを使用して、DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。

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

    # satellite-maintain service restart

    Copy to Clipboard Toggle word wrap

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

    # foreman-rake foreman_openscap:bulk_upload:default

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