Red Hat Satellite 6.14 へのアップグレード

1. Satellite Server を 6.14 にアップグレードします。詳細は、「Satellite Server のアップグレード」 を参照してください。
2. すべての Capsule Server を 6.14 にアップグレードします。詳細は、「Capsule Server のアップグレード」 を参照してください。

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

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. オプション: PostgreSQL を外部データベースとして使用する場合は、以下を実行します。

   1. postgresql-contrib パッケージを PostgreSQL サーバーにインストールします。

      # dnf install postgresql-contrib

   2. Pulp データベースに接続します。

      # su - postgres -c "psql pulpcore"

   3. hstore エクステンションを作成します。

      pulpcore=# CREATE EXTENSION IF NOT EXISTS "hstore";
      CREATE EXTENSION

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

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

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

9. メンテナンスモジュールを有効にします。

   # dnf module enable satellite-maintenance:el8

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

    # satellite-maintain upgrade list-versions

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

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

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

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

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

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

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

14. システムを再起動する必要があるかどうかを確認します。

    # dnf needs-restarting --reboothint

15. オプション: 前のコマンドで再起動するように指示された場合は、システムを再起動します。

    # reboot

接続されていない 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. オプション: PostgreSQL を外部データベースとして使用する場合は、以下を実行します。

   1. postgresql-contrib パッケージを PostgreSQL サーバーにインストールします。

      # dnf install postgresql-contrib

   2. Pulp データベースに接続します。

      # su - postgres -c "psql pulpcore"

   3. hstore エクステンションを作成します。

      pulpcore=# CREATE EXTENSION IF NOT EXISTS "hstore";
      CREATE EXTENSION

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

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

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

9. オフラインネットワーク環境での Satellite Server のインストール ガイドの バイナリー DVD イメージのダウンロード の手順に従って、最新の ISO ファイルを取得します。

10. オフラインネットワーク環境での Satellite Server のインストール の RHEL 8 でのオフラインリポジトリーを使用したベースオペレーティングシステムの設定 の手順に従って、マウントポイントとして機能するディレクトリーを作成し、ISO イメージをマウントして、rhel8 リポジトリーを設定します。

    この段階では、パッケージのインストールや更新はしないでください。

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

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

          [Satellite-6.14]

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

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

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

13. メンテナンスモジュールを有効にします。

    # dnf module enable satellite-maintenance:el8

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

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

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

    # satellite-maintain upgrade list-versions

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

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

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

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

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

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

18. システムを再起動する必要があるかどうかを確認します。

    # dnf needs-restarting --reboothint

19. オプション: 前のコマンドで再起動するように指示された場合は、システムを再起動します。

    # reboot

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

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

    # satellite-maintain service restart

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

    # foreman-rake foreman_openscap:bulk_upload:default

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

手順

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

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

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

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

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

     Red Hat Satellite Maintenance 6.14 (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.14 リポジトリーが利用できない場合は、Red Hat Subscription Manifest を更新します。Satellite Web UI で、Content > Subscriptions に移動し、Manage Manifest をクリックして、Refresh をクリックします。

4. Satellite Web UI で、Content > Sync Status に移動します。
5. 製品の横にある矢印をクリックして、利用可能なリポジトリーを表示します。
6. 6.14 のリポジトリーを選択します。Red Hat Satellite Client 6 には 6.14 バージョンがないことに注意してください。代わりに 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 リポジトリーからアップグレードされます。

   Capsule が satellite-maintenance-6.14-for-rhel-8-x86_64-rpms にアクセスできることを確認し、以下を実行します。

   # satellite-maintain self-upgrade

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

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

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

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

11. システムを再起動する必要があるかどうかを確認します。

    # dnf needs-restarting --reboothint

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