第3章 Red Hat Satellite のアップグレード

手順

1. 以下のコマンドを使用して、Satellite Server をアップグレードする前にファイルパーミッションを更新します。

   # satellite-maintain prep-6.10-upgrade

   レイテンシーが高いシステムでは時間がかかる場合があります。

2. 以下のコマンドを使用して、事前に移行するコンテンツの詳細を表示します。

   # satellite-maintain content migration-stats

   移行プロセス中に必要に応じてこのコマンドを使用して、プロセスにかかる時間を判断します。また、移行失敗の原因となる可能性のある破損または不足しているコンテンツも特定します。出力は以下のようになります。

   Running Retrieve Pulp 2 to Pulp 3 migration statistics
   ============================================
   Retrieve Pulp 2 to Pulp 3 migration statistics:
   ============Migration Summary================
   Migrated/Total RPMs: 0/367633
   Migrated/Total errata: 0/20780140
   Migrated/Total repositories: 0/33924
   Estimated migration time based on yum content: 47 hours, 23 minutes
   Note: ensure there is sufficient storage space for /var/lib/pulp/published to
   double in size before starting the migration process.
   Check the size of /var/lib/pulp/published with 'du -sh /var/lib/pulp/published/'
   Note: ensure there is sufficient storage space for postgresql.
   You will need additional space for your postgresql database.
   The partition holding '/var/opt/rh/rh-postgresql12/lib/pgsql/data/' will need
   additional free space equivalent to the size of your Mongo db database (/var/lib/mongodb/).
   [OK]

3. 以下のコマンドを使用して、Pulp 移行用にコンテンツを準備します。

   # satellite-maintain content prepare

   最終ステップの一環として、satellite-maintain content prepare は、コンテンツユニットの移行がまだかどうか確認します。破損したコンテンツや欠落しているコンテンツを特定すると、以下のような内容が表示される場合があります。

   ============Missing/Corrupted Content Summary================
     WARNING: MISSING OR CORRUPTED CONTENT DETECTED
     Corrupted or Missing Rpm: 1000/104583
     Corrupted or missing content has been detected, you can examine the list of content in /tmp/unmigratable_content-20211025-74422-16cxfae and take action by either:
     1. Performing a 'Verify Checksum' sync under Advanced Sync Options, let it complete, and re-running the migration
     2. Deleting/disabling the affected repositories and running orphan cleanup (foreman-rake katello:delete_orphaned_content) and re-running the migration.
     3. Manually correcting files on the filesystem in /var/lib/pulp/content/ and re-running the migration
     4. Mark currently corrupted or missing content as skipped (foreman-rake katello:approve_corrupted_migration_content). This will skip migration of missing or corrupted content.

   コンテンツが破損または欠落している原因はいくつかあります。

   • 移行中にリポジトリーの同期または Content View の公開またはプロモーションが発生しました。
   • /var/lib/pulp/content/ 内のディスク上のファイルは、ディスクの腐敗により破損しました。
   • /var/lib/pulp/content/ 内のファイルは、部分的な復元によるディスクの損失などの過去のイベントのために欠落しています。

   • Katello や Pulp などの Satellite のサブシステム間にはいくつかの不一致があります。これは、一時停止した Red Hat Satellite タスクの手順をスキップしてリポジトリーまたはコンテンツビューが不適切に削除された場合に発生する可能性があります。foreman-rake katello:correct_repositories COMMIT=true を実行すると、これを修正できます。

     上記の /tmp/unmigratable_content-20211025-74422-16cxfae20211120-2149-1j4pmfae サンプルでは、satellite-maintain content migration-stats コマンド の一部として、ディスクに書き込まれた破損または欠落している RPM のリストを確認できます。

     修復不能コンテンツが所属するリポジトリーを判断する方法は、How to determine the repository to run Verify Checksum on for reported corrupted RPMs を参照してください。

     移行できないコンテンツが含まれるリポジトリーが On-demand ダウンロードポリシーを使用して設定されており、欠落や破損のある RPM の数が少ない場合にはほぼ、以下のコマンドを使用してスキップするようにマークできます。

     # foreman-rake katello:approve_corrupted_migration_content

     破損または欠落しているコンテンツを承認してアップグレードを続行すると、アップグレード後にそのコンテンツはリポジトリーまたはコンテンツビューのバージョンに表示されなくなります。

     これらのパッケージがアップストリームリポジトリーに存在する場合は、アップグレード後にリポジトリーを再同期すると、これらのパッケージが再度追加されます。これらのコンテンツビューを再公開しない限り、Content View に復元されません。これらのパッケージは使用できない可能性が高いため、アップグレードプロセスはその事実のみを検出します。

     移行中にリポジトリーの同期または Content View の公開またはプロモーションが発生したと思われる場合は、satellite-maintain content prepare を再実行すると、残りのコンテンツが移行されます。初めて satellite-maintain content prepare を実行する場合、Red Hat は、破損または欠落している RPM の数を減らすために、必要な頻度で実行することが推奨されます。残りのコンテンツの移行にかかる時間は短くなります。

     注記

     Ctrl + C を使用して、satellite-maintain content prepare プロセスを終了することはできません。Ctrl + C を使用して、あるいは SSH セッションを切断してプロセスを停止しようとすると、プロセスは終了せずにバックグラウンドで続行されます。必要に応じて、いつでも以下のコマンドを使用してプロセスを正常に終了し、後で続行できます。

     # satellite-maintain content prepare-abort

     satellite-maintain content prepare-abort は、プロセスを終了するまでに数分の時間がかかる場合があります。可能な状況になったら、いつでも satellite-maintain content prepare を使用して移行プロセスを続行できます。

4. このプロセスでは、移行が完了していることを確認しません。次のコマンドを使用して、プロセスがどの程度完了に近いかを判断できます。

   # satellite-maintain content migration-stats

   指定した移行時間がゼロまたはほぼゼロになるまでの間隔。

5. Pulp コンテンツの移行の最終手順は、Satellite Server を 6.9 から 6.10 にアップグレードする際に完了します。

   注記

   問題が発生した場合には、以下のコマンドを使用して、事前移行のプロセスを最初から再起動することができます。

   # satellite-maintain content migration-reset

6. Pulp コンテンツの移行の最終手順は、Satellite Server を 6.9 から 6.10 にアップグレードする際に完了します。

Satellite Server のアップグレード

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

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

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

     バックアップに関する詳細は、Red Hat Satellite 6.9 の管理ガイドの 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 で、Hosts > Discovered hosts に移動します。検出されたホストページで、検出されたホストの電源を切って削除します。Select an Organization メニューで、組織を順番に選択し、検出されたホストの電源を切って削除するプロセスを繰り返します。アップグレードが完了したら、これらのホストを再起動することをメモしておきます。
5. 6.10 にアップグレードする Satellite 6.9/Capsule 6.9 Server の /etc/foreman-installer/custom-hiera.yaml ファイルで apache::purge_configs: false エントリーがないか、コメントアウトされているようにしてください。

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

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

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

   # satellite-maintain upgrade list-versions

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

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

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

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

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

    # rpm -qa --last | grep kernel

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

    # reboot

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

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

14. Pulp 2 から Pulp 3 にコンテンツを移行した場合は、Pulp 2 コンテンツをすべて削除します。

    # satellite-maintain content remove-pulp2

    これにより、Pulp 2 RPM、/var/lib/pulp/content/ のコンテンツ、mongo データベース、および Pulp 3 データベースの移行コンテンツが削除されます。

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

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

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

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

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

   # foreman-rake katello:upgrade_check

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. オプション: PostgreSQL を外部データベースとして使用する場合には、PostgreSQL サーバーで rh-postgresql12-postgresql-evr パッケージをインストールします。このパッケージは rhel-7-server-satellite-6.10-rpms リポジトリーから取得できます。

   # yum install rh-postgresql12-postgresql-evr

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

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

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

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

    # satellite-maintain service stop

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

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

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

      # satellite-maintain service stop

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

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

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

   # satellite-maintain upgrade list-versions

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

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

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

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

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

   警告

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

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

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

   パッケージが古いか、足りないためにスクリプトに失敗した場合には、これらのパッケージを個別にダウンロードしてインストールする必要があります。詳細は、Installing Satellite Server from a Disconnected Networkガイドの Resolving Package Dependency Errors のセクションを参照してください。

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

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

7. Pulp 2 から Pulp 3 にコンテンツを移行した場合は、Pulp 2 コンテンツをすべて削除します。

   # satellite-maintain content remove-pulp2

   これにより、アップロードおよび同期された Pulp 2 パッケージ、/var/lib/pulp/content/ のコンテンツ、MongoDB、および Pulp3 データベースの移行コンテンツが削除されます。

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

   # rpm -qa --last | grep kernel

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

   # satellite-maintain service stop
   # reboot

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

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

    # satellite-maintain service restart

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

    # foreman-rake foreman_openscap:bulk_upload:default

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