第3章 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 6.12 (または Capsule) リポジトリーを有効にして、Satellite Maintenance リポジトリー以外の更新を制限する必要があります。先に進む前に、回避策としてリリースノートの 既知の問題 をお読みください。

   Satellite Maintenance リポジトリーと Satellite 6.12 リポジトリーを有効にします。

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

   Copy to Clipboard Toggle word wrap

   Leapp を使用して Satellite 6.11 システムを Red Hat Enterprise Linux 7 から Red Hat Enterprise Linux 8 にアップグレードした場合は、Satellite モジュールを手動で有効にします。

   # dnf module enable satellite:el8

   Copy to Clipboard Toggle word wrap

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

   # satellite-maintain upgrade list-versions

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

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

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

    Copy to Clipboard Toggle word wrap

12. システムが再起動する必要があるかどうかを判断します。

    1. 最新のインストールされているカーネルのバージョンを確認します。

       # rpm --query --last kernel | head -n 1

       Copy to Clipboard Toggle word wrap

    2. これを、現在実行中のカーネルのバージョンと比較します。

       # uname --kernel-release

       Copy to Clipboard Toggle word wrap

13. オプション: 最新のカーネルが現在実行中のカーネルと異なる場合は、システムを再起動します。

    # reboot

    Copy to Clipboard Toggle word wrap

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

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

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

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

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

    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.12 に変更します。

          [Satellite-6.12]

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

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

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

    # satellite-maintain upgrade list-versions

    Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap

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

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

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

    Copy to Clipboard Toggle word wrap

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

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

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

    Copy to Clipboard Toggle word wrap

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

    # rpm -qa --last | grep kernel

    Copy to Clipboard Toggle word wrap

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

    # satellite-maintain service stop
    # 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 に移動し、選択した組織および場所を検出ルールに関連付けます。