Red Hat Satellite のアップグレードおよびアップデート

1. Satellite サブスクリプションのプール ID を確認します。

   # subscription-manager list --consumed \
   --matches 'Red Hat Satellite'|grep "Pool ID:"|awk '{print $3}'

   Copy to Clipboard Toggle word wrap

   後で使用できるように、プール ID をメモしてください。

2. Red Hat Satellite のサブスクリプションを削除します。

   # subscription-manager remove --serial=$(subscription-manager list \
   --consumed \
   --matches 'Red Hat Satellite'|grep "Serial:"|awk '{print $2}')

   Copy to Clipboard Toggle word wrap

3. Pulp データのサイズを判断します。

   # du -sh /var/lib/pulp/

   Copy to Clipboard Toggle word wrap

4. Pulp データが 500 GB 未満の場合は、MongoDB と PostgreSQL のデータベースをアクティブにし、Pulp データを含めてバックアップを実行します。Pulp データが 500 GB 以上の場合には、以下の手順は省略して、続行する前に 「Pulp データの考慮事項」 の手順を実行してください。

   # satellite-maintain backup offline --assumeyes /var/backup

   Copy to Clipboard Toggle word wrap

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

   # satellite-maintain service stop
   # satellite-maintain service disable

   Copy to Clipboard Toggle word wrap

1. satellite-clone ツールはデフォルトで、/backup/ をバックアップフォルダーとして使用します。別のフォルダーにコピーする場合には、/etc/satellite-clone/satellite-clone-vars.yml ファイルの backup_dir 変数をアップデートしてください。
2. アップデート前の Satellite のバックアップファイルを、移行先のサーバーの /backup/ フォルダーに配置します。共有ストレージをマウントするか、移行先のサーバーの /backup/ フォルダーにバックアップファイルをコピーします。
3. ソースサーバーの電源を切断します。

4. 以下のコマンドを入力してカスタマーポータルに登録して、サブスクリプションのアタッチし、必要なサブスクリプションだけを有効化します。

   # subscription-manager register your_customer_portal_credentials
   # subscription-manager attach --pool=pool_ID
   # subscription-manager repos --disable=*
   # subscription-manager repos \
   --enable=rhel-7-server-rpms \
   --enable=rhel-server-rhscl-7-rpms \
   --enable=rhel-7-server-satellite-maintenance-6-rpms \
   --enable=rhel-7-server-satellite-6.5-rpms

   Copy to Clipboard Toggle word wrap

5. satellite-clone パッケージをインストールします。

   # satellite-maintain packages install satellite-clone

   Copy to Clipboard Toggle word wrap

   satellite-clone ツールをインストールした後に、独自のデプロイメントに合わせて /etc/satellite-clone/satellite-clone-vars.yml ファイルで設定を調節します。

6. satellite-clone ツールを実行します。

   # satellite-clone

   Copy to Clipboard Toggle word wrap
7. DHCP、DNS、TFTP、およびリモート実行サービスを再設定します。ソースの Satellite Server と競合しないように、クローンプロセスにより、ターゲットの Satellite Server でこのサービスが無効になります。
8. Satellite Web UI で DHCP、DNS、TFTP を再設定し、有効にします。詳細は、『オンラインネットワークからの Satellite Server のインストール』の「Satellite Server での DNS、DHCP および TFTP の設定」を参照してください。

9. リモート実行を有効にします。

   # satellite-installer --scenario satellite \
   --enable-foreman-plugin-remote-execution \
   --enable-foreman-proxy-plugin-remote-execution-ssh

   Copy to Clipboard Toggle word wrap
10. ユーザー名 admin とパスワード changeme で、Satellite Web UI にログインします。すぐに、管理者パスワードを変更して認証情報のセキュリティーを確保します。
11. 正しい組織が選択されていることを確認します。
12. コンテンツ > サブスクリプション に移動して、マニフェストの管理をクリックします。
13. リフレッシュ ボタンをクリックして 終了 をクリックし、サブスクリプションの一覧に戻ります。
14. 利用可能なサブスクリプションが正しいことを確認します。
15. /usr/share/satellite-clone/logs/reassociate_capsules.txt ファイルの説明に従い、Capsules とライフサイクル環境の間の関係を復元します。
16. ターゲットサーバーの IP アドレスと新規ホスト名が一致するように、DNS など、ネットワーク設定をアップデートします。satellite-clone ツールにより、ホスト名をソースサーバーのホスト名に変更します。ホスト名を別のものに変更する場合には、satellite-change-hostname ツールを使用してください。詳細は、『Red Hat Satellite の管理』の「Satellite または Capsule Server の名前変更」を参照してください。
17. ソースサーバーが virt-who デーモンを使用する場合は、ターゲットサーバーにインストールして設定します。ソースサーバーのディレクトリー /etc/virt-who.d/ にある virt-who 設定ファイルをすべて、ターゲットサーバーにある同じディレクトリーに移動します。詳細は、『Red Hat Satellite の仮想マシンサブスクリプションの設定』を参照してください。

Satellite Server のアップグレード

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

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

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

     バックアップに関する詳細は、『Red Hat Satellite 6.5 管理』ガイドの「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

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

5. yum のキャッシュを消去します。

   # yum clean all

   Copy to Clipboard Toggle word wrap

6. satellite-maintain がインストールされており、最新になっているのを確認します。

   # yum install rubygem-foreman_maintain

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

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

    Copy to Clipboard Toggle word wrap

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

    # rpm -qa --last | grep kernel

    Copy to Clipboard Toggle word wrap

12. カーネルをアップデートしてから再起動していない場合には、システムを再起動します。

    # 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 の設定ファイルに必要なすべての変更を確認し、復元します。

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

   アップグレードチェックで、タスクが実行中であることが原因の障害が報告された場合は、タスクが完了するまで待機することが推奨されます。一部のタスクはキャンセルすることができますが、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

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

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

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

   Copy to Clipboard Toggle word wrap

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

   # satellite-maintain service stop

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

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

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

          [Satellite-6.6]

          Copy to Clipboard Toggle word wrap

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

          baseurl=file:///media/sat6/

          Copy to Clipboard Toggle word wrap

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

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

       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

14. オプション: カスタムの 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

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

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

16. yum のキャッシュを消去します。

    # yum clean all

    Copy to Clipboard Toggle word wrap

17. satellite-maintain がインストールされており、最新になっているのを確認します。

    # yum install rubygem-foreman_maintain

    Copy to Clipboard Toggle word wrap

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

    # satellite-maintain upgrade list-versions

    Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap

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

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

    # satellite-maintain upgrade run --target-version 6.6 \
    --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 のインストール』ガイドの「パッケージの手動ダウンロード」の手順を参照してください。

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

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

    Copy to Clipboard Toggle word wrap

22. カーネルパッケージが最後にアップデートされた日時を確認します。

    # rpm -qa --last | grep kernel

    Copy to Clipboard Toggle word wrap

23. カーネルをアップデートしてから再起動していない場合には、システムを再起動します。

    # reboot

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

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

    # satellite-maintain service restart

    Copy to Clipboard Toggle word wrap

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

    # foreman-rake foreman_openscap:bulk_upload:default

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

1. Satellite Web UI で Discovery テンプレートをアップデートします。

   1. ホスト > プロビジョニングテンプレート に移動します。
   2. PXELinux global default 行で クローン をクリックします。
   3. 名前 フィールドに、テンプレートの新しい名前を入力します (例: ACME PXE global default)。
   4. テンプレートエディターフィールドで、ONTIMEOUT local 行を ONTIMEOUT discovery に変更し、送信 をクリックします。
   5. 管理 > 設定 に移動します。
   6. Global default PXELinux template の 値 をクリックします。
   7. 新しく作成したテンプレートの名前を選択し、チェックボタンをクリックします。
   8. ホスト > プロビジョニングテンプレート に移動します。
   9. PXE デフォルトのビルド をクリックして、OK をクリックします。
2. Satellite Web UI で 設定 > 検出ルール に移動し、選択した組織および場所を検出ルールに関連付けます。

1. Satellite Server で、Foreman Discovery パッケージが最新であることを確認します。

   # yum upgrade tfm-rubygem-foreman_discovery

   Copy to Clipboard Toggle word wrap

2. 以前の手順でアップデートが行われた場合には、satellite-maintain サービスを再起動します。

   # satellite-maintain service restart

   Copy to Clipboard Toggle word wrap

3. 検出されたホストでプロビジョニングネットワークに接続した Satellite Capsule の Discovery イメージ、または検出されたホストに TFTP サービスを提供する Satellite Capsule の Discovery イメージをアップグレードします。

   # yum upgrade foreman-discovery-image

   Copy to Clipboard Toggle word wrap

4. 同じインスタンスに、Proxy サービスを提供するパッケージをインストールして、foreman-proxy サービスを再起動します。

   # yum install rubygem-smart_proxy_discovery
   # service foreman-proxy restart

   Copy to Clipboard Toggle word wrap
5. Satellite Web UI で、インフラストラクチャー > Capsule に移動して、関連する Capsule の機能コラムに Discovery が表示されていることを確認します。必要に応じて、アクション ドロップダウンメニューから リフレッシュ を選択します。

6. インフラストラクチャー > サブネット に移動し、検出を使用する各サブネットで以下を行います。

   1. サブネット名をクリックします。
   2. Capsule タブで、上で設定した Capsule に Discovery Capsule が設定されているのを確認します。

検出されたホストが含まれる全サブネットに、テンプレート Capsule が設定されていることを確認します。

1. Satellite Web UI で、インフラストラクチャー > Capsule に移動します。
2. 確認するサブネットを選択します。
3. Capsule タブで、テンプレート Capsule が、このサブネットに設定されていることを確認します。