第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 Maintenance リポジトリーが有効になっていることを確認します。

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

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

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

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

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

   # foreman-rake katello:upgrade_check

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

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

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

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

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

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

   Copy to Clipboard Toggle word wrap

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

    # satellite-maintain service stop

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

12. マウントポイントとして機能するディレクトリーを作成し、ISO イメージをマウントして、rhel7-server または rhel8 リポジトリーを設定します。

    Red Hat Enterprise Linux 8 の場合

    切断されたネットワーク環境での Satellite Server のインストール の RHEL 8 でのオフラインリポジトリーを使用したベースオペレーティングシステムの設定 手順に従います。

    Red Hat Enterprise Linux 7 の場合

    切断されたネットワーク環境での Satellite Server のインストール の RHEL 7 でのオフラインリポジトリーを使用した基本オペレーティングシステムの設定 手順に従います。

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

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

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

          [Satellite-6.11]

          Copy to Clipboard Toggle word wrap

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

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

          Copy to Clipboard Toggle word wrap

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

15. Satellite が Red Hat Enterprise Linux 7 で実行されている場合は、ISO ファイルから Ansible リポジトリーを設定します。

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

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

       Copy to Clipboard Toggle word wrap

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

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

       Copy to Clipboard Toggle word wrap

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

          [Ansible]

          Copy to Clipboard Toggle word wrap

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

          baseurl=file:///media/sat6/ansible/

          Copy to Clipboard Toggle word wrap

16. Satellite が Red Hat Enterprise Linux 7 で実行されている場合は、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

17. オプション: カスタムの 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 データベースサービスを開始します。

       # systemctl start postgresql

       Copy to Clipboard Toggle word wrap

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

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

       Copy to Clipboard Toggle word wrap

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

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

       # satellite-maintain service stop

       Copy to Clipboard Toggle word wrap

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

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

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

    # satellite-maintain upgrade list-versions

    Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap

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

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

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

    Copy to Clipboard Toggle word wrap

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

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

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

    Copy to Clipboard Toggle word wrap

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

    # rpm -qa --last | grep kernel

    Copy to Clipboard Toggle word wrap

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

    # satellite-maintain service stop
    # reboot

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

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

    # satellite-maintain service restart

    Copy to Clipboard Toggle word wrap

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

    # foreman-rake foreman_openscap:bulk_upload:default

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