Red Hat Satellite のアップグレードおよび更新

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

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

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

   # 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-ansible-2.9-rpms \
   --enable=rhel-7-server-satellite-6.10-rpms

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

   # yum 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 を再設定し、有効にします。詳細については、Installing Satellite Server の Configuring External Services on Satellite Server を参照してください。

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. Satellite Web UI で、Content > Subscriptions に移動し、Manage Manifest をクリックします。
13. リフレッシュ ボタンをクリックして 終了 をクリックし、サブスクリプションのリストに戻ります。
14. 利用可能なサブスクリプションが正しいことを確認します。
15. /usr/share/satellite-clone/logs/reassociate_capsules.txt ファイルの説明に従い、Capsules とライフサイクル環境の間の関係を復元します。
16. ターゲットサーバーの IP アドレスと新規ホスト名が一致するように、DNS など、ネットワーク設定を更新します。satellite-clone ツールにより、ホスト名をソースサーバーのホスト名に変更します。ホスト名を別のものに変更する場合には、satellite-change-hostname ツールを使用してください。詳細は、Administrating Red Hat Satellite の Renaming a Satellite or Capsule Server を参照してください。
17. ソースサーバーが virt-who デーモンを使用する場合は、ターゲットサーバーにインストールして設定します。ソースサーバーのディレクトリー /etc/virt-who.d/ にある virt-who 設定ファイルをすべて、ターゲットサーバーにある同じディレクトリーに移動します。詳細は、Red Hat Satellite での仮想マシンサブスクリプションの設定 を参照してください。以下の章を使用してアップグレードを行った後に、安全にソースサーバーの使用を停止することができます。

Satellite Server のアップグレード

1. すべての Satellite サービスを停止します。

   # satellite-maintain service stop

2. スナップショットを作成するか、バックアップを作成します。

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

3. すべての Satellite サービスを起動します。

   # satellite-maintain service start

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

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

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

   # satellite-maintain upgrade list-versions

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

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

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

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

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

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

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

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

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

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

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

       # uname --kernel-release

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

    # reboot

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

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

接続されていない Satellite Server のアップグレード

1. すべての Satellite サービスを停止します。

   # satellite-maintain service stop

2. スナップショットを作成するか、バックアップを作成します。

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

3. すべての Satellite サービスを起動します。

   # satellite-maintain service start

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

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

   # foreman-rake katello:upgrade_check

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

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

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

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

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

    # satellite-maintain service stop

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

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

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

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

          [Satellite-6.11]

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

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

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

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

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

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

          [Satellite-Maintenance]

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

          baseurl=file:///media/sat6/Maintenance/

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

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

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

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

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

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

          [Ansible]

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

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

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

    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/

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

       # systemctl start postgresql

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

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

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

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

       # satellite-maintain service stop

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

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

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

    # satellite-maintain upgrade list-versions

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

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

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

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

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

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

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

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

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

    # rpm -qa --last | grep kernel

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

    # satellite-maintain service stop
    # reboot

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

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

    # satellite-maintain service restart

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

    # foreman-rake foreman_openscap:bulk_upload:default

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

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

   # satellite-maintain packages install tfm-rubygem-foreman_discovery

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

   # satellite-maintain service restart

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

   # satellite-maintain packages install foreman-discovery-image

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

   # satellite-maintain packages install tfm-rubygem-smart_proxy_discovery
   # service foreman-proxy restart

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

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

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

virt-who の手動アップグレード

1. virt-who をアップグレードします。

   # yum upgrade virt-who

2. virt-who サービスを再起動して、新しいバージョンを有効にします。

   # systemctl restart virt-who.service

1. Satellite Web UI で、コンテンツ > Red Hat リポジトリー に移動します。
2. Enabled Repositories エリアで、Red Hat Satellite Tools 6.10 for RHEL 7 Server RPMs x86_64 を探します。
3. 右側の 無効化 アイコンをクリックします。

手順

1. postgresql サービス以外の全サービスを停止します。

   # satellite-maintain service stop --exclude postgresql

2. postgres ユーザーに切り替えて、データベースの領域を回収します。

   # su - postgres -c 'vacuumdb --full --all'

3. Vacuum が完了したら、他のサービスを開始します。

   # satellite-maintain service start

1. /usr/share/foreman-installer/config/foreman.hiera/tuning/common.yaml ファイルで定義したデフォルトの tuning プロファイル
2. /usr/share/foreman-installer/config/foreman.hiera/tuning/sizes/ ディレクトリーで定義され、デプロイメントに適用する tuning プロファイル
3. オプション: /etc/foreman-installer/custom-hiera.yaml ファイルを設定した場合、Satellite はこれらの設定を適用します。

手順

1. オプション: Satellite Server で、custom-hiera.yaml ファイルを設定した場合、/etc/foreman-installer/custom-hiera.yaml ファイルを custom-hiera.original にバックアップします。/etc/foreman-installer/custom-hiera.yaml ファイルが破損した場合には、バックアップファイルを使用して、ファイルを元の状態に戻します。

   # cp /etc/foreman-installer/custom-hiera.yaml \
   /etc/foreman-installer/custom-hiera.original

2. オプション: Satellite Server で custom-hiera.yaml ファイルを設定した場合、/usr/share/foreman-installer/config/foreman.hiera/tuning/common.yaml のデフォルト tuning プロファイルの定義と、/usr/share/foreman-installer/config/foreman.hiera/tuning/sizes/ に適用する tuning プロファイルを確認します。/etc/foreman-installer/custom-hiera.yaml ファイルの設定内容と比較して、/etc/foreman-installer/custom-hiera.yaml ファイルで重複設定を削除します。

3. 適用するプロファイルに対して、--tuning オプションを指定して satellite-installer コマンドを入力します。たとえば、medium tuning プロファイル設定を適用するには、以下のコマンドを入力します。

   # satellite-installer --tuning medium

1. 接続されている Satellite Server で次のリポジトリーが同期されていることを確認します。

   rhel-8-for-x86_64-baseos-rpms
   rhel-8-for-x86_64-appstream-rpms
   satellite-6.11-for-rhel-8-x86_64-rpms
   satellite-maintenance-6.11-for-rhel-8-x86_64-rpms

2. 組織のデバッグ証明書をダウンロードして、/etc/pki/katello/certs/org-debug-cert.pem など、選択した場所にローカルに保存します。詳細は、コンテンツの管理 の 組織のデバッグ証明書の作成 を参照してください。

3. /etc/yum.repos.d の下に、次の内容の Yum 設定ファイル (satellite-disconnected.repo など) を作成します。

   [rhel-8-for-x86_64-baseos-rpms]
   name=Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs)
   baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/rhel8/8/x86_64/baseos/os
   enabled=1
   sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
   sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
   sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
   sslverify = 1
   
   [rhel-8-for-x86_64-appstream-rpms]
   name=Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs)
   baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/rhel8/8/x86_64/appstream/os
   enabled=1
   sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
   sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
   sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
   sslverify = 1
   
   [satellite-6.11-for-rhel-8-x86_64-rpms]
   name=Red Hat Satellite 6.11 for RHEL 8 RPMs x86_64
   baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/layered/rhel8/x86_64/satellite/6.11/os
   enabled=1
   sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
   sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
   sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
   
   [satellite-maintenance-6.11-for-rhel-8-x86_64-rpms]
   name=Red Hat Satellite Maintenance 6.11 for RHEL 8 RPMs x86_64
   baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/layered/rhel8/x86_64/sat-maintenance/6.11/os
   enabled=1
   sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
   sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
   sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
   sslverify = 1

4. 設定ファイルの sslclientcert および sslclientkey の /etc/pki/katello/certs/org-debug-cert.pem は、ダウンロードした組織のデバッグ証明書の場所に置き換えます。
5. お使いのデプロイメントに適した FQDN で satellite.example.com を更新します。

6. baseurl 内の My_Organization は、正しい組織ラベルに置き換えます。組織ラベルを取得するには、次のコマンドを入力します。

   # hammer organization list

7. reposync コマンドを入力します。

   • Red Hat Enterprise Linux 7 で実行されている Satellite Server の場合:

     # reposync --delete --download-metadata -p ~/Satellite-repos -n \
      -r rhel-8-for-x86_64-baseos-rpms \
      -r rhel-8-for-x86_64-appstream-rpms \
      -r satellite-6.11-for-rhel-8-x86_64-rpms \
      -r satellite-maintenance-6.11-for-rhel-8-x86_64-rpms

   • Red Hat Enterprise Linux 8 で実行されている Satellite Server の場合:

     # reposync --delete --download-metadata -p ~/Satellite-repos -n \
      --repoid rhel-8-for-x86_64-baseos-rpms \
      --repoid rhel-8-for-x86_64-appstream-rpms \
      --repoid satellite-6.11-for-rhel-8-x86_64-rpms \
      --repoid {RepoRHEL8ServerSatelliteMaintenanceProductVersion

   これにより、接続された Satellite Server からリポジトリーのコンテンツがダウンロードされ、~/Satellite-repos ディレクトリーに保存されます。

8. RPM がダウンロードされ、リポジトリーデータディレクトリーが ~/Satellite-repos の各サブディレクトリーに生成されていることを確認します。

9. ディレクトリーの内容をアーカイブします。

   # cd ~
   # tar czf Satellite-repos.tgz Satellite-repos

10. 生成された Satellite-repos.tgz ファイルを使用して、接続されていない Satellite Server でアップグレードします。

1. 生成された Satellite-repos.tgz ファイルを、接続されていない Satellite Server にコピーします。

2. root ユーザーがアクセスできる場所にアーカイブを展開します。次の例では、/root が展開場所です。

   # cd /root
   # tar zxf Satellite-repos.tgz

3. /etc/yum.repos.d の下に、次の内容の Yum 設定ファイル (satellite-disconnected.repo など) を作成します。

   [rhel-8-for-x86_64-baseos-rpms]
   name=Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs)
   baseurl=file:///root/Satellite-repos/rhel-8-for-x86_64-baseos-rpms
   enabled=1
   
   [rhel-8-for-x86_64-appstream-rpms]
   name=Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs)
   baseurl=file:///root/Satellite-repos/rhel-8-for-x86_64-appstream-rpms
   enabled=1
   
   [satellite-6.11-for-rhel-8-x86_64-rpms]
   name=Red Hat Satellite 6 for RHEL 8 Server RPMs x86_64
   baseurl=file:///root/Satellite-repos/satellite-6.11-for-rhel-8-x86_64-rpms
   enabled=1
   
   [satellite-maintenance-6.11-for-rhel-8-x86_64-rpms]
   name=Red Hat Satellite Maintenance 6 for RHEL 8 Server RPMs x86_64
   baseurl=file:///root/Satellite-repos/satellite-maintenance-6.11-for-rhel-8-x86_64-rpms
   enabled=1

4. 設定ファイルの /root/Satellite-repos は、展開先の場所に置き換えます。

5. 利用可能なバージョンを確認して、次のマイナーバージョンがリストされていることを確認します。

   # satellite-maintain upgrade list-versions

6. ヘルスチェックオプションを使用して、システムをアップグレードする準備ができているかどうかを判断します。このコマンドを最初に使用したときに、satellite-maintain により hammer 管理者ユーザー認証情報を入力して、/etc/foreman-maintain/foreman-maintain-hammer.yml ファイルに保存します。

   # satellite-maintain upgrade check --whitelist="check-upstream-repository,repositories-validate" --target-version 6.11.z

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

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

   アップグレードコマンドが実行されているコマンドシェルへの接続が失われた場合は、ログに記録されたメッセージを /var/log/foreman-installer/satellite.log ファイルに表示して、プロセスが正常に完了したかどうかを確認できます。

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

   # satellite-maintain upgrade run --whitelist="check-upstream-repository,repositories-validate" --target-version 6.11.z

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

    # rpm -qa --last | grep kernel

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

    # satellite-maintain service stop
    # reboot

1. 接続されている Satellite Server で次のリポジトリーが同期されていることを確認します。

   rhel-7-server-ansible-2.9-rpms
   rhel-7-server-rpms
   rhel-7-server-satellite-6.11-rpms
   rhel-7-server-satellite-maintenance-6.11-rpms
   rhel-server-rhscl-7-rpms

2. 組織のデバッグ証明書をダウンロードして、たとえば /etc/pki/katello/certs/org-debug-cert.pem または選択した場所にローカルに保存します。

3. 次のリポジトリー情報を使用して、/etc/yum.repos.d の下に Yum 設定ファイルを作成します。

   [rhel-7-server-ansible-2.9-rpms]
   name=Ansible 2.9 RPMs for Red Hat Enterprise Linux 7 Server x86_64
   baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/rhel/server/7/$releasever/$basearch/ansible/2.9/os/
   enabled=1
   sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
   sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
   sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
   sslverify = 1
   
   [rhel-7-server-rpms]
   name=Red Hat Enterprise Linux 7 Server RPMs x86_64
   baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/os/
   enabled=1
   sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
   sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
   sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
   sslverify = 1
   
   [rhel-7-server-satellite-6.11-rpms]
   name=Red Hat Satellite 6 for RHEL 7 Server RPMs x86_64
   baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/satellite/6.11/os/
   enabled=1
   sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
   sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
   sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
   
   [rhel-7-server-satellite-maintenance-6.11-rpms]
   name=Red Hat Satellite Maintenance 6 for RHEL 7 Server RPMs x86_64
   baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/sat-maintenance/6/os/
   enabled=1
   sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
   sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
   sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
   sslverify = 1
   
   [rhel-server-rhscl-7-rpms]
   name=Red Hat Software Collections RPMs for Red Hat Enterprise Linux 7 Server x86_64
   baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/rhscl/1/os/
   enabled=1
   sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
   sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
   sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
   sslverify = 1

4. 設定ファイルの sslclientcert および sslclientkey の /etc/pki/katello/certs/org-debug-cert.pem は、ダウンロードした組織のデバッグ証明書の場所に置き換えます。
5. satellite.example.com は、デプロイメントに合わせて、正しい FQDN で更新します。

6. baseurl 内の My_Organization は、正しい組織ラベルに置き換えます。組織ラベルを取得するには、次のコマンドを入力します。

   # hammer organization list

7. reposync コマンドを入力します。

   # reposync --delete --download-metadata -p ~/Satellite-repos -n \
    -r rhel-7-server-ansible-2.9-rpms \
    -r rhel-7-server-rpms \
    -r rhel-7-server-satellite-6.11-rpms \
    -r rhel-7-server-satellite-maintenance-6.11-rpms \
    -r rhel-server-rhscl-7-rpms

   これにより、接続された Satellite Server からリポジトリーのコンテンツがダウンロードされ、ディレクトリー ~/Satellite-repos に保存されます。Red Hat Enterprise Linux 7 の reposync コマンドは、RPM をダウンロードしますが、Yum メタデータはダウンロードしません。

   このため、Satellite-repos の各サブディレクトリーで createrepo を手動で実行する必要があります。createrepo rpm がインストールされていることを確認してください。そうでない場合は、次のコマンドを使用してインストールします。

   # satellite-maintain packages install createrepo

   次のコマンドを実行して、~/Satellite-repos の各サブディレクトリーにリポジトリーデータを作成します。 :

   # cd ~/Satellite-repos
   # for directory in */
   do
     echo "Processing $directory"
     cd $directory
     createrepo .
     cd ..
   done

8. RPM がダウンロードされ、リポジトリーデータディレクトリーが ~/Satellite-repos の各サブディレクトリーに生成されていることを確認します。

9. ディレクトリーの内容をアーカイブします。

   # cd ~
   # tar czf Satellite-repos.tgz Satellite-repos

10. 生成された Satellite-repos.tgz ファイルを使用して、切断された Satellite Server でアップグレードします。

1. 生成された Satellite-repos.tgz ファイルを切断された Satellite Server にコピーします

2. root ユーザーがアクセスできる場所にアーカイブを展開します。次の例では、/root が展開場所です。

   # cd /root
   # tar zxf Satellite-repos.tgz

3. 次のリポジトリー情報を使用して、/etc/yum.repos.d の下に Yum 設定ファイルを作成します。

   [rhel-7-server-ansible-2.9-rpms]
   name=Ansible 2.9 RPMs for Red Hat Enterprise Linux 7 Server x86_64
   baseurl=file:///root/Satellite-repos/rhel-7-server-ansible-2.9-rpms
   enabled=1
   
   [rhel-7-server-rpms]
   name=Red Hat Enterprise Linux 7 Server RPMs x86_64
   baseurl=file:///root/Satellite-repos/rhel-7-server-rpms
   enabled=1
   
   [rhel-7-server-satellite-6.11-rpms]
   name=Red Hat Satellite 6 for RHEL 7 Server RPMs x86_64
   baseurl=file:///root/Satellite-repos/rhel-7-server-satellite-6.11-rpms
   enabled=1
   
   [rhel-7-server-satellite-maintenance-6.11-rpms]
   name=Red Hat Satellite Maintenance 6 for RHEL 7 Server RPMs x86_64
   baseurl=file:///root/Satellite-repos/rhel-7-server-satellite-maintenance-6.11-rpms
   enabled=1
   
   [rhel-server-rhscl-7-rpms]
   name=Red Hat Software Collections RPMs for Red Hat Enterprise Linux 7 Server x86_64
   baseurl=file:///root/Satellite-repos/rhel-server-rhscl-7-rpms
   enabled=1

4. 設定ファイルの /root/Satellite-repos は、展開先の場所に置き換えます。

5. 利用可能なバージョンを確認して、次のマイナーバージョンがリストされていることを確認します。

   # satellite-maintain upgrade list-versions

6. ヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。このコマンドを最初に使用したときに、satellite-maintain により hammer 管理者ユーザー認証情報を入力して、/etc/foreman-maintain/foreman-maintain-hammer.yml ファイルに保存します。

   # satellite-maintain upgrade check --whitelist="check-upstream-repository,repositories-validate" --target-version 6.11.z

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

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

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

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

   # satellite-maintain upgrade run --whitelist="check-upstream-repository,repositories-setup,repositories-validate" --target-version 6.11.z

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

    # rpm -qa --last | grep kernel

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

    # satellite-maintain service stop
    # reboot