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 データの考慮事項」 の手順を実行してください。

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

   Copy to Clipboard Toggle word wrap

5. Satellite サービスをすべて停止および無効にします。

   # foreman-maintain service stop
   # foreman-maintain service disable

   Copy to Clipboard Toggle word wrap

1. satellite-clone ツールはデフォルトで、'/backup/' をバックアップフォルダーとして使用します。別のフォルダーにコピーする場合には、/etc/satellite-clone/satellite-clone-vars.yml ファイルの backup_dir 変数を更新してください。
2. /backup フォルダーにバックアップファイルを配置します。共有ストレージをマウントするか、candlepin.dump、config_files.tar.gz、foreman.dump のファイルと、mongo_dump フォルダーをコピーすることができます。
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.4-rpms

   Copy to Clipboard Toggle word wrap

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

   # yum 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 デーモンを使用する場合は、ターゲットサーバーにインストールして設定します。ソースサーバーのディレクトリーにある virt-who 設定ファイルをすべて、ターゲットサーバーにある同じディレクトリーに移動します。詳細情報は、『仮想インスタンスガイド』の「Virt-who インストールと設定の概要」を参照してください。

18. 登録したすべてのコンテンツホストと Capsule で、goferd を再起動します。

    systemctl restart goferd

    Copy to Clipboard Toggle word wrap

Satellite Server のアップグレード

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

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

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

     バックアップに関する詳細は、『Red Hat Satellite 6.4 管理』ガイドの「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. サブスクリプションを更新します。

   # subscription-manager refresh

   Copy to Clipboard Toggle word wrap

6. Satellite Maintenance と Red Hat Enterprise Linux Ansible のリポジトリーを有効にします。

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

   Copy to Clipboard Toggle word wrap

7. 以下のコマンドを入力して、foreman-maintain をインストールするか、最新バージョンに更新します。

   # yum install rubygem-foreman_maintain

   Copy to Clipboard Toggle word wrap

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

   # foreman-maintain upgrade list-versions

   Copy to Clipboard Toggle word wrap

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

   # foreman-maintain upgrade check --target-version 6.5

   Copy to Clipboard Toggle word wrap

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

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

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

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

    # foreman-maintain upgrade run --target-version 6.5

    Copy to Clipboard Toggle word wrap

12. Check when the kernel packages were last updated:

    # rpm -qa --last | grep kernel

    Copy to Clipboard Toggle word wrap

13. If a kernel update occurred since the last reboot, reboot the system:

    # reboot

    Copy to Clipboard Toggle word wrap

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

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

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

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

    # foreman-maintain service restart

    Copy to Clipboard Toggle word wrap

17. 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 サービスを停止します。

   # foreman-maintain service stop

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

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

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

          [Satellite-6.5]

          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 (no operation) オプションとともにアップグレードコマンドを入力し、次の手順でアップグレードコマンドを入力するときに適用される変更内容を確認できます。このテストを行わない場合は、次の手順に進みます。テストを行う場合は、以下の手順を行います。

    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 --scenario satellite --upgrade --verbose --noop

       Copy to Clipboard Toggle word wrap

       /var/log/foreman-installer/satellite.log を参照して、--noop オプションを付けずに実行した場合に 適用される変更 を確認します。設定ファイルへの変更を示す +++ と --- の記号を探します。この "no operation" オプションにより、実際にはファイルは作成されませんが、モジュール内の一部の Puppet リソースではファイルが作成されていることが期待されるため、エラーメッセージが表示されるはずです。

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

       # foreman-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. 以下のコマンドを入力して、foreman-maintain をインストールするか、最新バージョンに更新します。

    # yum install rubygem-foreman_maintain

    Copy to Clipboard Toggle word wrap

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

    # foreman-maintain upgrade list-versions

    Copy to Clipboard Toggle word wrap

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

    # foreman-maintain upgrade check --target-version 6.5 \
    --whitelist="repositories-validate,repositories-setup"

    Copy to Clipboard Toggle word wrap

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

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

    # foreman-maintain upgrade run --target-version 6.5 \
    --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 foreman-maintain service 2> /dev/null

    Copy to Clipboard Toggle word wrap

21. Check when the kernel packages were last updated:

    # rpm -qa --last | grep kernel

    Copy to Clipboard Toggle word wrap

22. If a kernel update occurred since the last reboot, reboot the system:

    # reboot

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

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

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

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 サービスを再起動します。

   # foreman-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 が、このサブネットに設定されていることを確認します。