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

Satellite Server のアップグレード

1. すべての Satellite サービスを停止します。

   # satellite-maintain service stop

   Copy to Clipboard Toggle word wrap

2. スナップショットを作成するか、バックアップを作成します。

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

3. すべての Satellite サービスを起動します。

   # satellite-maintain service start

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

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

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

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

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

   # subscription-manager repos --enable \
   satellite-maintenance-6.13-for-rhel-8-x86_64-rpms

   Copy to Clipboard Toggle word wrap

8. メンテナンスモジュールを有効にします。

   # dnf module enable satellite-maintenance:el8

   Copy to Clipboard Toggle word wrap

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

   # satellite-maintain upgrade list-versions

   Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap

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

11. アップグレードには時間がかかるため、tmux などのユーティリティーを使用して、通信セッションを一時停止し、再接続してください。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。

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

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

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

    Copy to Clipboard Toggle word wrap

13. システムを再起動する必要があるかどうかを確認します。

    # dnf needs-restarting --reboothint

    Copy to Clipboard Toggle word wrap

14. オプション: 前のコマンドで再起動するように指示された場合は、システムを再起動します。

    # reboot

    Copy to Clipboard Toggle word wrap

接続されていない Satellite Server のアップグレード

1. すべての Satellite サービスを停止します。

   # satellite-maintain service stop

   Copy to Clipboard Toggle word wrap

2. スナップショットを作成するか、バックアップを作成します。

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

3. すべての Satellite サービスを起動します。

   # satellite-maintain service start

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

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

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

   Copy to Clipboard Toggle word wrap
6. Satellite Web UI で、Hosts > Discovered hosts に移動します。使用可能な検出されたホストがある場合は、それらをオフにして、Discovered hosts ページにあるすべてのエントリーを削除します。必要に応じて、組織設定メニューから、その他の組織を順番に選択し、すべてのエントリーを削除します。これらのホストは、アップグレード完了後に再起動します。

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

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

   Copy to Clipboard Toggle word wrap
8. オフラインネットワーク環境での Satellite Server のインストール ガイドの バイナリー DVD イメージのダウンロード の手順に従って、最新の ISO ファイルを取得します。

9. オフラインネットワーク環境での Satellite Server のインストール の RHEL 8 でのオフラインリポジトリーを使用したベースオペレーティングシステムの設定 の手順に従って、マウントポイントとして機能するディレクトリーを作成し、ISO イメージをマウントして、rhel8 リポジトリーを設定します。

   この段階では、パッケージのインストールや更新はしないでください。

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

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

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

       Copy to Clipboard Toggle word wrap

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

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

       Copy to Clipboard Toggle word wrap

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

          [Satellite-6.13]

          Copy to Clipboard Toggle word wrap

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

          baseurl=file:///media/sat6/Satellite

          Copy to Clipboard Toggle word wrap

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

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

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

       Copy to Clipboard Toggle word wrap

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

       # vi /etc/yum.repos.d/satellite-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/Maintenance/

          Copy to Clipboard Toggle word wrap

12. メンテナンスモジュールを有効にします。

    # dnf module enable satellite-maintenance:el8

    Copy to Clipboard Toggle word wrap

13. アップグレードには時間がかかるため、tmux などのユーティリティーを使用して、通信セッションを一時停止し、再接続してください。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。

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

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

    # satellite-maintain upgrade list-versions

    Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap

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

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

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

    Copy to Clipboard Toggle word wrap

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

17. システムを再起動する必要があるかどうかを確認します。

    # dnf needs-restarting --reboothint

    Copy to Clipboard Toggle word wrap

18. オプション: 前のコマンドで再起動するように指示された場合は、システムを再起動します。

    # reboot

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

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

    # satellite-maintain service restart

    Copy to Clipboard Toggle word wrap

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

    # foreman-rake foreman_openscap:bulk_upload:default

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