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

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

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

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

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

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

   # du -sh /var/lib/pulp/

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

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

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

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

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

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

   # satellite-maintain packages install satellite-clone

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

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

   # satellite-clone

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

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.6 管理 』ガイドの「Satellite Server および Capsule Server のバックアップ」を参照してください。

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

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

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

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

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

   # yum clean all

6. satellite-maintain が含まれる rubygem-foreman_maintain パッケージがインストールされており、最新の状態になっていることを確認します。

   # yum install rubygem-foreman_maintain

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

   # satellite-maintain upgrade list-versions

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

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

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

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

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

    # rpm -qa --last | grep kernel

12. オプション: 最後の再起動以降にカーネルがアップデートされた場合には、satellite-maintain サービスを停止して、システムを再起動します。

    # satellite-maintain service stop
    # reboot

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

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

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

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

    # satellite-maintain service restart

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

    # foreman-rake foreman_openscap:bulk_upload:default

切断されている Satellite Server のアップグレード

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

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

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

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

   # foreman-rake katello:upgrade_check

   アップグレードチェックで、タスクが実行中であることが原因の障害が報告された場合は、タスクが完了するまで待機することが推奨されます。一部のタスクはキャンセルできますが、Red Hat ナレッジベースソリューション「How to manage paused tasks on Red Hat Satellite 6」に目を通して、安全にキャンセルできるタスクとできないタスクについて理解する必要があります。

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

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

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

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

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

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

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

   # satellite-maintain service stop

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

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

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

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

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

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

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

          [Satellite-6.7]

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

          baseurl=file:///media/sat6/

12. ISO ファイルからの Red Hat Software Collections リポジトリーを設定します。

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

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

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

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

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

          [RHSCL]

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

          baseurl=file:///media/sat6/RHSCL/

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

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

       # vi /etc/yum.repos.d/sat-maintenance.repo

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

          [Satellite-Maintenance]

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

          baseurl=file:///media/sat6/sat-maintenance/

14. オプション: カスタムの Apache サーバー設定を適用している場合に、アップグレードを実行すると、カスタムの設定がインストール時のデフォルト設定に戻る点に注意してください。

    アップグレード時に適用された変更をプレビューするには、--noop (操作なし) オプションを指定して satellite-installer コマンドを実行します。これらの変更は、以下の手順で satellite-maintain upgrade コマンドを入力すると適用します。

    1. 次の行を /etc/httpd/conf/httpd.conf 設定ファイルに追加します。

       Include /etc/httpd/conf.modules.d/*.conf

    2. httpd サービスを再起動します。

       # systemctl restart httpd

    3. postgresql データベースサービスおよび rh-mongodb34-mongod データベースサービスを起動します。

       # systemctl start postgresql
       # systemctl start rh-mongodb34-mongod

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

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

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

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

       # satellite-maintain service stop

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

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

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

    # yum clean all

17. satellite-maintain が含まれる rubygem-foreman_maintain パッケージがインストールされており、最新の状態になっていることを確認します。

    # yum install rubygem-foreman_maintain

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

    # satellite-maintain upgrade list-versions

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

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

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

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

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

    警告

    config サブディレクトリーを含むディレクトリーからコマンドを実行すると、以下のエラーが発生します。

    ERROR: Scenario (config/satellite.yaml) was not found, can not continue.

    このような場合は、root ユーザーのホームディレクトリーに移動し、コマンドを再実行します。

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

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

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

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

    # rpm -qa --last | grep kernel

23. オプション: 最後の再起動以降にカーネルがアップデートされた場合には、satellite-maintain サービスを停止して、システムを再起動します。

    # satellite-maintain service stop
    # reboot

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

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

    # satellite-maintain service restart

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

    # foreman-rake foreman_openscap:bulk_upload:default

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

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

   # satellite-maintain service restart

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

   # yum upgrade foreman-discovery-image

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

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

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

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

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

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

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