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

1. オプション: 既存の Satellite Server をクローンします。詳細は、2章Satellite Server のクローン を参照してください。
2. Satellite Server を 6.12 にアップグレードします。詳細は、「Satellite Server のアップグレード」 を参照してください。
3. すべての Capsule Server を 6.12 にアップグレードします。詳細は、「Capsule Server のアップグレード」 を参照してください。
4. 「アップグレード後のタスクの実行」 に進みます。

1. 長期にわたる停止期間の発生を避け、停止期間を複数回に分けて短くする場合。
2. 組織内の Capsule が複数のチームで管理されており、別の場所に配置されている場合。
3. 負荷分散設定を使用している場合は、1 つの負荷分散 Capsule だけをアップグレードして、残りの負荷分散 Capsule を 1 つ前のバージョンに保つことができます。こうすることで、サービスを停止せずに全 Capsule を順番にアップグレードできます。

1. ソースサーバーをバックアップします。
2. ソースサーバーからターゲットサーバーにクローンを作成します。
3. ソースサーバーの電源を切断します。
4. 新規ホスト名とターゲットサーバーの IP アドレスが一致するように、ターゲットサーバー上のネットワーク設定を更新します。
5. コンテンツホストと Capsule で goferd を再起動して、接続をリフレッシュします。
6. 新規ターゲットサーバーをテストします。

1. PostgreSQL データベースをアクティブにし、Pulp データは除外してバックアップを実行します。

   # satellite-maintain backup offline --skip-pulp-content \
   --assumeyes /var/backup

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

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

3. Pulp データをターゲットサーバーにコピーします。

   # rsync --archive --partial --progress --compress \
   /var/lib/pulp/ target_server.example.com:/var/lib/pulp/

手順

1. Satellite Web UI で、Content > Red Hat Repositories に移動します。
2. Recommended Repositories を、オン の位置に切り替えます。

3. 結果の一覧から、以下のリポジトリーを展開して、Enable アイコンをクリックして、リポジトリーを有効にします。

   • Satellite クライアントをアップグレードするには、クライアントが使用するすべての Red Hat Enterprise Linux バージョンで Red Hat Satellite Client 6 リポジトリーを有効にします。

   • Capsule Server を使用している場合に、Capsule Server をアップグレードするには、以下のリポジトリーも有効にします。

     Red Hat Satellite Capsule 6.12 (for RHEL 8 x86_64) (RPMs)

     Red Hat Satellite Maintenance 6.12 (for RHEL 8 x86_64) (RPMs)

     Red Hat Enterprise Linux 8 (for x86_64 – BaseOS) (RPMs)

     Red Hat Enterprise Linux 8 (for x86_64 – AppStream) (RPMs)

   注記

   6.12 リポジトリーが利用できない場合は、Red Hat Subscription Manifest を更新してください。Satellite Web UI で、Content > Subscriptions に移動し、Manage Manifest をクリックして、Refresh をクリックします。

4. Satellite Web UI で、Content > Sync Status に移動します。
5. 製品の横にある矢印をクリックして、利用可能なリポジトリーを表示します。
6. 6.12 のリポジトリーを選択します。Red Hat Satellite Client 6 には 6.12 バージョンがないことに注意してください。代わりに Red Hat Satellite Client 6 を選択してください。

7. Synchronize Now をクリックします。

   重要

   リポジトリーを同期しようとしたときにエラーが発生した場合は、マニフェストをリフレッシュしてください。問題が解決しない場合は、サポートリクエストを作成してください。カスタマーポータルまたは Satellite Web UI からマニフェストを削除しないでください。削除すると、コンテンツホストのエンタイトルメントがすべて削除されます。

8. コンテンツビューを使用して Capsule Server のベースオペレーティングシステムへの更新を制御する場合、そのコンテンツビューを新しいリポジトリーで更新し、更新済みのバージョンを公開して、プロモートします。詳細は、コンテンツの管理 の コンテンツビューの管理 を参照してください。

Capsule Server のアップグレード

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

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

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

     バックアップに関する詳細は、Red Hat Satellite の管理 の Satellite Server および Capsule Server のバックアップ を参照してください。

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

   # yum clean metadata

3. Satellite Server の satellite-capsule-6.15-for-rhel-8-x86_64-rpms リポジトリーを同期します。
4. Capsule が登録されているコンテンツビューの新しいバージョンを公開およびプロモートします。

5. rubygem-foreman_maintain は、Satellite Maintenance リポジトリーからインストールされるか、現在インストールされている場合は Satellite Maintenance リポジトリーからアップグレードされます。

   現在のアップグレードプロセスでは、Satellite 6.12 (または Capsule) リポジトリーを有効にして、Satellite Maintenance リポジトリー以外の更新を制限する必要があります。先に進む前に、回避策としてリリースノートの 既知の問題 をお読みください。

   Capsule が satellite-maintenance-6.12-for-rhel-8-x86_64-rpms にアクセスして、以下を実行します。

   # subscription-manager repos --enable \
   satellite-capsule-6.12-for-rhel-8-x86_64-rpms
   
   # satellite-maintain self-upgrade

   Leapp を使用して Capsule 6.11 システムを Red Hat Enterprise Linux 7 から Red Hat Enterprise Linux 8 にアップグレードした場合は、Capsule モジュールを手動で有効にします。

   # dnf module enable satellite-capsule:el8

6. Capsule Server で foreman_url 設定が Satellite FQDN を参照していることを確認します。

   # grep foreman_url /etc/foreman-proxy/settings.yml

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

   # satellite-maintain upgrade list-versions

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

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

9. ヘルスチェックオプションを使用して、システムがアップグレードの準備ができているかどうかを確認します。

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

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

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

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

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

    # rpm -qa --last | grep kernel

12. オプション: カーネルを更新してから再起動していない場合には、システムを再起動します。

    # reboot

13. オプション: DNS または DHCP 設定ファイルを手動で編集した場合には、以前に作成したバックアップを使用して、DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。
14. オプション: カスタムリポジトリーを使用する場合は、アップグレードの完了後にそのカスタムリポジトリーを必ず有効にしてください。

リモート実行を使用した Capsule Server のアップグレード

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

   バックアップに関する詳細は、Red Hat Satellite の管理 の Satellite Server および Capsule Server のバックアップ を参照してください。

2. Satellite Web UI で、Monitor > Jobs に移動します。
3. Run Job をクリックします。
4. Job category リストから Maintenance Operations を選択します。
5. Job template リストから Capsule Upgrade Playbook を選択します。
6. Search Query フィールドに Capsule のホスト名を入力します。
7. Resolves to に Apply to 1 host が表示されていることを確認します。
8. target_version フィールドに、Capsule のターゲットバージョンを入力します。
9. whitelist_options フィールドにオプションを入力します。
10. Schedule でジョブ実行のスケジュールを選択します。
11. Type of query セクションで、Static Query をクリックします。

手順

1. バックアップを作成します。
2. 新しいサーバーでバックアップを復元します。

3. Satellite が古い名前で新しいデータベースサーバーに到達する場合、それ以上の変更は必要ありません。それ以外の場合は、Satellite を再設定して新しい名前を使用します。

   # satellite-installer \
   --foreman-db-host newpostgres.example.com \
   --katello-candlepin-db-host newpostgres.example.com \
   --foreman-proxy-content-pulpcore-postgresql-host newpostgres.example.com

Satellite Server の更新手順:

1. Satellite Maintenance リポジトリーが有効になっていることを確認します。

   # subscription-manager repos --enable \
   satellite-maintenance-6.12-for-rhel-8-x86_64-rpms

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

   # satellite-maintain upgrade list-versions

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

   # satellite-maintain upgrade check --target-version 6.12.z

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

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

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

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

   # satellite-maintain upgrade run --target-version 6.12.z

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

   # rpm -qa --last | grep kernel

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

   # satellite-maintain service stop
   # reboot

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

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

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

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.12-for-rhel-8-x86_64-rpms]
   name=Red Hat Satellite 6.12 for RHEL 8 RPMs x86_64
   baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/layered/rhel8/x86_64/satellite/6.12/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.12-for-rhel-8-x86_64-rpms]
   name=Red Hat Satellite Maintenance 6.12 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.12/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 \
    --disableplugin=foreman-protector \
    --repoid rhel-8-for-x86_64-baseos-rpms \
    --repoid rhel-8-for-x86_64-appstream-rpms \
    --repoid satellite-6.12-for-rhel-8-x86_64-rpms \
    --repoid satellite-maintenance-6.12-for-rhel-8-x86_64-rpms

   これにより、接続されている 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.12-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.12-for-rhel-8-x86_64-rpms
   enabled=1
   
   [satellite-maintenance-6.12-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.12-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.12.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.12.z

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

    # rpm -qa --last | grep kernel

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

    # satellite-maintain service stop
    # reboot

手順

1. Satellite Maintenance リポジトリーが有効になっていることを確認します。

   # subscription-manager repos --enable \
   satellite-maintenance-6.12-for-rhel-8-x86_64-rpms

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

   # satellite-maintain upgrade list-versions

3. ヘルスチェックオプションを使用して、システムがアップグレードの準備ができているかどうかを確認します。

   # satellite-maintain upgrade check --target-version 6.12.z

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

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

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

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

   # satellite-maintain upgrade run --target-version 6.12.z

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

   # rpm -qa --last | grep kernel

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

   # satellite-maintain service stop
   # reboot