オンラインの Red Hat Satellite の 6.16 へのアップグレード
Satellite Server と Capsule のアップグレード
概要
Red Hat ドキュメントへのフィードバック (英語のみ) リンクのコピーリンクがクリップボードにコピーされました!
Red Hat ドキュメントに関するご意見やご感想をお寄せください。また、改善点があればお知らせください。
フィードバックを提供するには、Red Hat Jira の Create Issue フォームを使用します。Jira の問題が Red Hat Satellite Jira プロジェクトに作成され、その進捗状況を追跡できます。
前提条件
- Red Hat アカウント が登録されている。
手順
- Create Issue にアクセスします。Jira でログインエラーが表示された場合は、フォームにリダイレクトされた後、ログインして続行します。
- Summary フィールドと Description フィールドに入力します。Description フィールドに、ドキュメントの URL、章またはセクション番号、および問題の詳しい説明を入力します。フォーム内の他のフィールドは変更しないでください。
- Create をクリックします。
第1章 アップグレードの概要 リンクのコピーリンクがクリップボードにコピーされました!
現在の Red Hat Satellite インストールを Red Hat Satellite 6.16 にアップグレードする前に、以下の前提条件と利用可能なアップグレードパスを確認してください。
アップグレードのインタラクティブな手順については、Red Hat カスタマーポータルの Red Hat Satellite Upgrade Helper を使用できます。このアプリケーションは、Satellite の現在のバージョン番号に合わせてカスタマイズされたアップグレード手順を提供します。その結果、アップグレードパスに固有の手順と、既知の問題を防ぐための手順が提供されます。詳細は、Red Hat カスタマーポータルの Satellite Upgrade Helper を参照してください。
1.1. アップグレードパス リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Satellite 6.15 から Red Hat Satellite 6.16 にアップグレードできます。アップグレード方法の詳細は、2章Red Hat Satellite のアップグレード を参照してください。
Satellite を 6.16 にアップグレードする手順の概要は次のとおりです。
- Satellite Server と Capsule Server が Satellite 6.15 にアップグレードされていることを確認します。詳細は、オンラインの Red Hat Satellite の 6.15 へのアップグレード または オフラインの Red Hat Satellite の 6.15 へのアップグレード を参照してください。
- 外部データベースを使用する場合は、外部データベースを PostgreSQL 13 にアップグレードします。必要に応じて、基礎となるオペレーティングシステムを Red Hat Enterprise Linux 8 から Red Hat Enterprise Linux 9 にアップグレードします。
Satellite Server をアップグレードします。
- Satellite Server を 6.16 にアップグレードします。
オプション: Satellite Server のオペレーティングシステムを Red Hat Enterprise Linux 9 にアップグレードします。
注記Satellite Server のオペレーティングシステムを Red Hat Enterprise Linux 9 にアップグレードすることはオプションですが、6.16 より後の次の Satellite バージョンにアップグレードする前にアップグレードする必要があります。
- 新しい 6.16 リポジトリーを同期します。
Capsule Server をアップグレードします。
- すべての Capsule Server を 6.16 にアップグレードします。
オプション: Capsule Server のオペレーティングシステムを Red Hat Enterprise Linux 9 にアップグレードします。
注記Capsule Server のオペレーティングシステムを Red Hat Enterprise Linux 9 にアップグレードすることはオプションですが、6.16 より後の次の Satellite バージョンにアップグレードする前にアップグレードする必要があります。
バージョン 6.15 の Capsule は、アップグレードされた Satellite Server 6.16 でも引き続き動作します。Satellite Server を 6.16 にアップグレードした後、複数のメンテナンスウィンドウにわたって Capsule を個別にアップグレードできます。詳細は、「Satellite とは別の Capsule のアップグレード」 を参照してください。
Satellite サービスはアップグレード時は停止します。必要なダウンタイムを必ず計画してください。アップグレードプロセスの期間は、ハードウェアの設定、ネットワークの速度、サーバーに保存されているデータ量により異なる可能性があります。
- Satellite Server のアップグレードには約 1 - 2 時間かかります。
- Capsule Server のアップグレードには約 10 - 30 分かかります。
Hammer と API に関する考慮事項
Hammer CLI ツールを使用するスクリプトがある場合は、Hammer の変更に応じてこれらのスクリプトを変更してください。Satellite REST API を使用する統合がある場合は、API の変更に応じてこれらの統合を変更するようにしてください。Hammer および API の変更の詳細は、リリースノート を参照してください。
1.2. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
Satellite 6.16 にアップグレードすると、Satellite インフラストラクチャー全体に影響します。アップグレード前に以下を完了してください。
- Red Hat Satellite 6.16 リリースノート を参照してください。
- サーバーに十分なストレージ容量があることを確認します。詳細は、オンラインネットワーク環境での Satellite Server のインストール の インストールのための環境準備 と Capsule Server のインストール の インストールのための環境準備 を参照してください。
-
/var/lib/pgsqlに、/var/lib/pgsql/dataで消費される量と少なくとも同じ量の空き領域があることを確認します。Satellite 6.16 へのアップグレードには、PostgreSQL 12 から PostgreSQL 13 へのアップグレードが必要です。/var/lib/pgsql/dataの内容は、PostgreSQL のアップグレード中にバックアップされます。 - Satellite Server およびすべての Capsule Server をバックアップします。詳細は、Red Hat Satellite の管理 の Satellite Server および Capsule Server のバックアップ を参照してください。
- Satellite のバージョンごとに API コマンドが異なる場合があるため、使用しているスクリプトに Satellite API コマンドが含まれる場合は、更新の計画を立てます。
- すべての組織を Simple Content Access (SCA) に移行します。詳細は、Red Hat ナレッジベースのソリューション Simple Content Access を参照してください。
-
sha1チェックサムを使用する証明書を新しいハッシュアルゴリズムに更新します。
すべての Satellite Server が同じバージョンであることを確認してください。
設定ファイルを手動で、または Hiera などのツールを使用してカスタマイズすると、その変更内容は、アップグレード時または更新時にメンテナンススクリプトを実行すると上書きされます。satellite-installer で --noop オプションを使用すると、変更をテストできます。詳細は、Red Hat ナレッジベースソリューションの How to use the noop option to check for changes in Satellite config files during an upgrade を参照してください。
1.3. Satellite とは別の Capsule のアップグレード リンクのコピーリンクがクリップボードにコピーされました!
Satellite をバージョン 6.16 にアップグレードしても、Capsule はアップグレードが可能になるまでバージョン 6.15 に保つことができます。
これまで動作していた機能はすべて 6.15 Capsule で動作します。しかし、6.16 リリースで追加された機能は Capsule を 6.16 にアップグレードするまで動作しません。
Satellite アップグレード後の Capsule のアップグレードは、以下のようなシナリオ例で役に立ちます。
- 長期にわたる停止期間の発生を避け、停止期間を複数回に分けて短くする場合。
- 組織内の Capsule が複数のチームで管理されており、別の場所に配置されている場合。
- 負荷分散設定を使用している場合は、1 つの負荷分散 Capsule だけをアップグレードして、残りの負荷分散 Capsule を 1 つ前のバージョンに保つことができます。こうすることで、サービスを停止せずに全 Capsule を順番にアップグレードできます。
1.4. アップグレードの進捗の追跡 リンクのコピーリンクがクリップボードにコピーされました!
アップグレードには時間がかかるため、tmux などのユーティリティーを使用して、通信セッションを一時停止し、再接続してください。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。詳細は、tmux の man ページを参照してください。
アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、/var/log/foreman-installer/satellite.log のログで、プロセスが完全に終了したかどうかを確認できます。
第2章 Red Hat Satellite のアップグレード リンクのコピーリンクがクリップボードにコピーされました!
以下の手順に従って、既存の Red Hat Satellite を Red Hat Satellite 6.16 にアップグレードします。
2.1. Satellite サーバーのアップグレードに関する考慮事項 リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、Satellite Server を 6.15 から 6.16 にアップグレードする方法を説明します。Satellite Server 6.15 のすべてのマイナーバージョンからアップグレードできます。
作業を始める前に
- 「前提条件」 を確認してください。
- Capsule は、Satellite とは別にアップグレードできます。詳細は、「Satellite とは別の Capsule のアップグレード」 を参照してください。
- ファイアウォールの設定を確認して更新します。詳細は、オンラインネットワーク環境での Satellite Server のインストール の インストールのための環境準備 を参照してください。
- カスタマーポータルまたは Satellite Web UI からマニフェストを削除しないでください。削除すると、コンテンツホストからエンタイトルメントがすべて削除されます。
- デフォルトのテンプレートを編集した場合は、ファイルのクローンを作成するか、ファイルをエクスポートしてバックアップしてください。推奨される方法はクローン作成です。今後の更新やアップグレードでファイルが上書きされることがなくなるためです。テンプレートの変更の有無を確認するには、アップグレード前に 履歴 を確認するか、アップグレード後に監査ログで変更を表示できます。Satellite Web UI で Monitor > Audits に移動し、テンプレートを検索すると、変更履歴を確認できます。エクスポートを使用する場合は、エクスポートしたテンプレートと、デフォルトテンプレートを比較し、手動で変更を適用して変更を復元します。
- オプション: アップグレードをテストするには、Satellite Server のクローンを作成します。クローン上でアップグレードのテストが正常に行われた後、プライマリー Satellite Server 上でアップグレードを繰り返してクローンを破棄するか、クローンをプライマリー Satellite Server にプロモートさせて以前のプライマリー Satellite Server を破棄することができます。詳細は、Red Hat Satellite の管理 の Satellite Server のクローン作成 を参照してください。
Capsule に関する考慮事項
- コンテンツビューを使用して Capsule Server のベースオペレーティングシステムまたは Capsule Server リポジトリーへの更新を制御する場合は、そのコンテンツビューの更新済みバージョンを公開する必要があります。
- 6.15 から 6.16 にアップグレードされた Satellite Server は、引き続き 6.15 の Capsule Server を使用できることに注意してください。
カスタムの証明書を実装している場合は、/root/ssl-build ディレクトリーと、カスタム証明書に関連するソースファイルを作成したディレクトリーのコンテンツを保持する必要があります。
アップグレード時にこのファイルを保持できないと、アップグレードは失敗します。ファイルを削除してしまった場合は、アップグレードを進めるためにバックアップから復元する必要があります。
アップグレードシナリオ
自己登録の Satellite をアップグレードすることはできません。自己登録の Satellite は、Red Hat コンテンツ配信ネットワーク (CDN) に移行すればアップグレードを実行できます。
FIPS モード
FIPS モードを使用していない RHEL ベースのシステムから、FIPS モードを使用する RHEL ベースのシステムに Satellite Server をアップグレードすることはできません。
FIPS モードの Red Hat Enterprise Linux ベースシステムで Satellite Server を実行するには、FIPS モードで稼働する RHEL ベースのオペレーティングシステムを新規にプロビジョニングして、Satellite をインストールする必要があります。詳細は、オンラインネットワーク環境での Satellite Server のインストール の インストールのための環境準備 を参照してください。
2.2. 外部データベースのアップグレード リンクのコピーリンクがクリップボードにコピーされました!
外部データベースを使用する場合は、外部データベースを PostgreSQL 13 にアップグレードします。必要に応じて、基礎となるオペレーティングシステムを Red Hat Enterprise Linux 8 から Red Hat Enterprise Linux 9 にアップグレードできます。
2.2.1. 外部データベースシステムでの PostgreSQL のアップグレード リンクのコピーリンクがクリップボードにコピーされました!
外部データベースを PostgreSQL 13 にアップグレードし、パーミッションを修正します。
手順
- Red Hat Enterprise Linux 8 さまざまな種類 のサーバーのデプロイ の pg_upgrade ユーティリティーを使用した Fast upgrade の 手順に従って、外部データベースをアップグレードします。
外部データベースの
evr拡張のパーミッションを修正します。# runuser -l postgres -c \ "psql -d foreman -c \"UPDATE pg_extension SET extowner = (SELECT oid FROM pg_authid WHERE rolname='foreman') WHERE extname='evr';\""
2.2.2. 外部データベースのオペレーティングシステムのアップグレード リンクのコピーリンクがクリップボードにコピーされました!
必要に応じて、バックアップと復元を使用して、外部データベースを Red Hat Enterprise Linux 8 から Red Hat Enterprise Linux 9 にアップグレードできます。
前提条件
- Red Hat Enterprise Linux 9 のドキュメントの外部データベースに従って、PostgreSQL サーバー用に Red Hat Enterprise Linux 9 を実行しているホスト。詳細は、Satellite での外部データベースの使用 を参照し てください。
手順
- 既存の外部データベースのバックアップを作成します。
- 新しい Red Hat Enterprise Linux 9 サーバーでバックアップを復元します。
Satellite が新しいデータベースにアクセスできることを確認します。
# PGPASSWORD='My_Foreman_Database_Password' psql -h postgres.example.com -p 5432 -U foreman -d foreman -c "SELECT 1 as ping"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
2.3. オンラインの Satellite Server のアップグレード リンクのコピーリンクがクリップボードにコピーされました!
パブリックインターネットにアクセスできる Satellite Server には、この手順を使用します。
設定ファイルを手動で、または Hiera などのツールを使用してカスタマイズすると、その変更内容は、アップグレード時または更新時にメンテナンススクリプトを実行すると上書きされます。satellite-installer で --noop オプションを使用すると、変更をテストできます。詳細は、Red Hat ナレッジベースソリューションの How to use the noop option to check for changes in Satellite config files during an upgrade を参照してください。
Satellite Server のアップグレード
すべての Satellite サービスを停止します。
# satellite-maintain service stopスナップショットを作成するか、バックアップを作成します。
- 仮想マシンで、スナップショットを作成します。
- 物理マシンで、バックアップを作成します。
すべての Satellite サービスを起動します。
# satellite-maintain service start-
オプション:
/etc/zones.confまたは/etc/dhcp/dhcpd.confファイルで DNS または DHCP の設定を手動で編集した場合は、設定ファイルをバックアップしてください。インストーラーはドメインまたはサブネットを 1 つしかサポートしないため、これらのバックアップから変更を復元しなければならない場合があります。 オプション: DNS または DHCP の設定ファイルを手動で編集した場合に、変更の上書きを避けるには、以下のコマンドを実行します。
# satellite-installer \ --foreman-proxy-dhcp-managed=false \ --foreman-proxy-dns-managed=false- Satellite Web UI で、Hosts > Discovered hosts に移動します。検出されたホストページで、検出されたホストの電源を切って削除します。Select an Organization メニューで、組織を順番に選択し、検出されたホストの電源を切って削除するプロセスを繰り返します。アップグレードが完了したら、これらのホストを再起動することをメモしておきます。
Satellite Maintenance リポジトリーが有効になっていることを確認します。
# subscription-manager repos --enable \ satellite-maintenance-6.16-for-rhel-8-x86_64-rpmssatellite-maintain を次のバージョンにアップグレードします。
# satellite-maintain self-upgradeヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。プロンプトが表示されたら、hammer の管理者ユーザー認証情報を入力して
satellite-maintainを設定します。この変更は、/etc/foreman-maintain/foreman-maintain-hammer.ymlファイルに適用されます。# satellite-maintain upgrade check結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。
オプション: アップグレードには時間がかかるため、
tmuxなどのユーティリティーを使用して、通信セッションを一時停止し、再接続してください。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、
/var/log/foreman-installer/satellite.logファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。アップグレードを実行します。
# satellite-maintain upgrade runsatellite-maintain コマンドで再起動するように指示された場合は、システムを再起動します。
# reboot
次のステップ
- オプション: アップグレードされた Satellite Server で、オペレーティングシステムを Red Hat Enterprise Linux 9 にアップグレードします。詳細は、3章Satellite または Capsule 上の Red Hat Enterprise Linux のアップグレード を参照してください。
2.4. 新しいリポジトリーの同期 リンクのコピーリンクがクリップボードにコピーされました!
Capsule Server と Satellite Client をアップグレードする前に、新しい 6.16 リポジトリーを有効にして同期する必要があります。
手順
- Satellite Web UI で、Content > Red Hat Repositories に移動します。
- Recommended Repositories を、On の位置に切り替えます。
結果の一覧から、以下のリポジトリーを展開して、Enable アイコンをクリックして、リポジトリーを有効にします。
- Satellite クライアントをアップグレードするには、クライアントが使用するすべての Red Hat Enterprise Linux バージョンで Red Hat Satellite Client 6 リポジトリーを有効にします。
Capsule Server を使用している場合に、Capsule Server をアップグレードするには、以下のリポジトリーも有効にします。
Red Hat Satellite Capsule 6.16 (for RHEL 8 x86_64) (RPMs)
Red Hat Satellite Maintenance 6.16 (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.16 リポジトリーが利用できない場合は、Red Hat サブスクリプションマニフェストを更新します。Satellite Web UI で、Content > Subscriptions に移動し、Manage Manifest をクリックして、Refresh をクリックします。
- Satellite Web UI で、Content > Sync Status に移動します。
- 製品の横にある矢印をクリックして、利用可能なリポジトリーを表示します。
- 6.16 のリポジトリーを選択します。Red Hat Satellite Client 6 には、6.16 バージョンがないことに注意してください。代わりに Red Hat Satellite Client 6 を選択してください。
Synchronize Now をクリックします。
重要リポジトリーを同期しようとしたときにエラーが発生した場合は、マニフェストをリフレッシュしてください。問題が解決しない場合は、サポートリクエストを作成してください。カスタマーポータルまたは Satellite Web UI からマニフェストを削除しないでください。削除すると、コンテンツホストのエンタイトルメントがすべて削除されます。
- コンテンツビューを使用して Capsule Server のベースオペレーティングシステムへの更新を制御する場合は、そのコンテンツビューを新しいリポジトリーで更新し、更新済みのバージョンを公開してプロモートします。詳細は、コンテンツの管理 の コンテンツビューの管理 を参照してください。
2.5. アップグレード後のタスクの実行 リンクのコピーリンクがクリップボードにコピーされました!
- オプション: アップグレード中にデフォルトのプロビジョニングテンプレートが変更された場合は、デフォルトのテンプレートから複製したテンプレートを再作成します。プロビジョニングプロセスの前または後にカスタムコードが実行される場合は、カスタムプロビジョニングスニペットを使用して、複製されたテンプレートの再作成を回避してください。カスタムプロビジョニングスニペットの設定の詳細は、ホストのプロビジョニング の カスタムプロビジョニングスニペットの作成 を参照してください。
/var/lib/pgsql/data-old/ディレクトリーを削除します。# rm -r /var/lib/pgsql/data-old/PostgreSQL はアップグレード中にバックアップの目的でこのディレクトリーを作成します。アップグレードが正常に終了すると、このディレクトリー内のデータは使用できなくなります。
Pulp は、コンテナーマニフェストに関するより多くのデータを API に導入しています。この情報により、Katello はマニフェストラベル、アノテーション、およびマニフェストタイプに関する情報 (起動可能かどうか、flatpak コンテンツを表しているかどうかなど) を表示できます。そのため、このコンテンツをマニフェストからデータベースに取り込むには、移行を行う必要があります。
この移行には時間がかかるため、今後のアップグレードのダウンタイムを短縮するために、6.16 へのアップグレード後に事前移行が自動的に実行されます。事前移行の実行中、Satellite Server は完全に機能しますが、より多くのハードウェアリソースを使用します。
2.6. Capsule Server のアップグレード リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、Capsule Server を 6.15 から 6.16 にアップグレードする方法を説明します。
作業を始める前に
- 「前提条件」 を確認してください。
- Capsule Server をアップグレードする前に、Satellite Server をアップグレードする必要があります。Capsule は、Satellite とは別にアップグレードできます。詳細は、「Satellite とは別の Capsule のアップグレード」 を参照してください。
- Red Hat Satellite Capsule 6.16 リポジトリーが Satellite Server で有効になっており、同期されていることを確認します。
- Satellite Server 上の必要なリポジトリーを必ず同期してください。詳細は、「新しいリポジトリーの同期」 を参照してください。
- コンテンツビューを使用して Capsule Server のベースオペレーティングシステムへの更新を制御する場合は、そのコンテンツビューを新しいリポジトリーで更新し、更新済みのバージョンを公開してプロモートします。詳細は、コンテンツの管理 の コンテンツビューの管理 を参照してください。
- 新たにアップグレードした Satellite Server に、Capsule のベースシステムが登録されていることを確認します。
- 新たにアップグレードした Satellite Server で、Capsule の組織と場所が正しく設定されていることを確認します。
- Capsule Server をアップグレードする前に、ファイアウォールの設定を確認して更新してください。詳細は、Capsule Server のインストール の Capsule インストールのための環境準備 を参照してください。
カスタムの証明書を実装している場合は、/root/ssl-build ディレクトリーと、カスタム証明書に関連するソースファイルを作成したディレクトリーのコンテンツを保持する必要があります。
アップグレード時にこのファイルを保持できないと、アップグレードは失敗します。ファイルを削除してしまった場合は、アップグレードを進めるためにバックアップから復元する必要があります。
Capsule Server のアップグレード
バックアップを作成します。
- 仮想マシンで、スナップショットを作成します。
物理マシンで、バックアップを作成します。
バックアップに関する詳細は、Red Hat Satellite の管理 の Satellite Server および Capsule Server のバックアップ を参照してください。
yum のキャッシュを消去します。
# yum clean metadata-
Satellite Server の
satellite-capsule-6.16-for-rhel-8-x86_64-rpmsリポジトリーを同期します。 - Capsule が登録されているコンテンツビューの新しいバージョンを公開およびプロモートします。
オプション: アップグレードには時間がかかるため、
tmuxなどのユーティリティーを使用して、通信セッションを一時停止し、再接続してください。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、
/var/log/foreman-installer/capsule.logファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。rubygem-foreman_maintainは、Satellite Maintenance リポジトリーからインストールされるか、現在インストールされている場合は Satellite Maintenance リポジトリーからアップグレードされます。Capsule が
satellite-maintenance-6.16-for-rhel-8-x86_64-rpmsにアクセスできることを確認し、以下を実行します。# satellite-maintain self-upgradeCapsule Server で
foreman_url設定が Satellite FQDN を参照していることを確認します。# grep foreman_url /etc/foreman-proxy/settings.ymlヘルスチェックオプションを使用して、システムがアップグレードの準備ができているかどうかを確認します。
# satellite-maintain upgrade check結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。
アップグレードを実行します。
# satellite-maintain upgrade runsatellite-maintain コマンドで再起動するように指示された場合は、システムを再起動します。
# reboot- オプション: DNS または DHCP 設定ファイルを手動で編集した場合は、以前に作成したバックアップを使用して、DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。
- オプション: カスタムリポジトリーを使用する場合は、アップグレードの完了後にそのカスタムリポジトリーを必ず有効にしてください。
リモート実行を使用した Capsule Server のアップグレード
バックアップを作成するか、スナップショットを作成します。
バックアップに関する詳細は、Red Hat Satellite の管理 の Satellite Server および Capsule Server のバックアップ を参照してください。
- Satellite Web UI で、Monitor > Jobs に移動します。
- Run Job をクリックします。
- Job category リストから Maintenance Operations を選択します。
- Job template リストから Capsule Upgrade Playbook を選択します。
- Search Query フィールドに Capsule のホスト名を入力します。
- Resolves to に Apply to 1 host が表示されていることを確認します。
- target_version フィールドに、Capsule のターゲットバージョンを入力します。
- whitelist_options フィールドにオプションを入力します。
- Schedule でジョブ実行のスケジュールを選択します。
- Type of query セクションで、Static Query をクリックします。
次のステップ
- オプション: アップグレードされた Satellite Server で、オペレーティングシステムを Red Hat Enterprise Linux 9 にアップグレードします。詳細は、3章Satellite または Capsule 上の Red Hat Enterprise Linux のアップグレード を参照してください。
第3章 Satellite または Capsule 上の Red Hat Enterprise Linux のアップグレード リンクのコピーリンクがクリップボードにコピーされました!
Satellite と Capsule は、Red Hat Enterprise Linux 8 と Red Hat Enterprise Linux 9 の両方でサポートされています。以下の方法を使用して、Satellite または Capsule のオペレーティングシステムを Red Hat Enterprise Linux 8 から Red Hat Enterprise Linux 9 にアップグレードできます。
- Leapp のインプレースアップグレード
- Leapp を使用すると、Satellite または Capsule をその場でアップグレードできるため、時間は短縮できますが、サービスのダウンタイムが発生します。
- クローン作成を使用した移行
- Red Hat Enterprise Linux 8 システムは、クローン作成を使用した移行中も稼働し続けるため、ダウンタイムが短縮されます。Capsule Server の移行にクローン作成を使用することはできません。
- バックアップおよび復元を使用した移行
- Red Hat Enterprise Linux 8 システムは、クローン作成を使用した移行中も稼働し続けるため、ダウンタイムが短縮されます。バックアップと復元を使用して、Satellite と Capsule の両方のオペレーティングシステムを Red Hat Enterprise Linux 8 から Red Hat Enterprise Linux 9 に移行できます。
3.1. Leapp を使用した Satellite または Capsule の RHEL 9 へのインプレースアップグレード リンクのコピーリンクがクリップボードにコピーされました!
Leapp ツールを使用してアップグレードできるほか、正常にアップグレードを失敗させる可能性のある問題を検出して解決することもできます。
前提条件
- アップグレードを開始する前に、既知の問題を確認してください。詳細は、Red Hat Satellite 6.16 の既知の問題 を参照してください。
- 環境で HTTP プロキシーを使用する場合は、接続に HTTP プロキシーを使用するように Subscription Manager を設定します。詳細は、RHEL 8 から RHEL 9 へのアップグレード の トラブルシューティング を参照してください。
- Red Hat Enterprise Linux 8 で実行している Satellite 6.16 または Capsule 6.16
Capsule Server をアップグレードする場合は、以下のリポジトリーを有効にして Satellite Server と同期し、そのリポジトリーを Capsule Server に接続されているライフサイクル環境とコンテンツビューに追加します。
Red Hat Enterprise Linux 9 for x86_64 - BaseOS (RPMs):
-
メジャーバージョン:
x86_64 9のrhel-9-for-x86_64-baseos-rpms。 -
サポートされている最新のマイナーバージョン:
x86_64 9.Yのrhel-9-for-x86_64-baseos-rpms。ここで、Y はマイナーバージョンを表します。インプレースアップグレードでサポートされている最新のマイナーバージョンについては、RHEL 8 から RHEL 9 へのアップグレード の サポートされているアップグレードパス を参照してください。
-
メジャーバージョン:
Red Hat Enterprise Linux 9 for x86_64 - AppStream (RPMs):
-
メジャーバージョン:
x86_64 9のrhel-9-for-x86_64-appstream-rpms。 -
サポートされている最新のマイナーバージョン:
x86_64 9.Yのrhel-9-for-x86_64-appstream-rpms。ここで、Y はマイナーバージョンを表します。インプレースアップグレードでサポートされている最新のマイナーバージョンについては、RHEL 8 から RHEL 9 へのアップグレード の サポートされているアップグレードパス を参照してください。
-
メジャーバージョン:
-
Red Hat Satellite Capsule 6.16 for RHEL 9 x86_64 RPMs:
satellite-capsule-6.16-for-rhel-9-x86_64-rpms -
Red Hat Satellite Maintenance 6.16 for RHEL 9 x86_64 RPMs:
satellite-maintenance-6.16-for-rhel-9-x86_64-rpms
手順
必要なパッケージをインストールします。
# satellite-maintain packages install leapp leapp-upgrade-el8toel9Leapp にシステムを分析させましょう:
# leapp preupgrade最初の実行では、最も問題が報告され、アップグレードが妨げられます。
/var/log/leapp/leapp-report.txtファイルのレポートを調べ、すべての質問に回答し (leapp answerを使用)、報告された他の問題を手動で解決します。-
leapp preupgradeを再度実行し、これ以上問題は報告されないことを確認します。 Leapp にアップグレード環境を作成します。
# leapp upgradeシステムを再起動して、アップグレードを開始します。
システムが再起動した後、ライブシステムがアップグレードを実行し、再起動して SELinux ラベルを修正してから、最終的な Red Hat Enterprise Linux 9 システムで再起動します。
Leapp がアップグレードを完了するまで待ちます。
journalctlを使用してプロセスを監視できます。# journalctl -u leapp_resume -fパッケージのロックを解除します。
# satellite-maintain packages unlock- アップグレード後の状態を確認します。詳細は、RHEL 8 から RHEL 9 へのアップグレード の アップグレード後の状態の確認 を参照してください。
- RHEL 9 システムでアップグレード後のタスクを実行します。詳細は、RHEL 8 から RHEL 9 へのアップグレード の RHEL 9 システムでのアップグレード後のタスクの実行 を参照してください。
パッケージをロックします。
# satellite-maintain packages lock- SELinux を Enforcing モードに変更します。詳細は、RHEL 8 から RHEL 9 へのアップグレード の SELinux モードの Enforcing への変更 を参照してください。
subscription-managerリリースの設定を解除します。# subscription-manager release --unset
関連情報
- 環境に合わせて Leapp アップグレードをカスタマイズする方法の詳細は Red Hat Enterprise Linux インプレースアップグレードのカスタマイズ を参照してください。
3.2. クローン作成を使用して Satellite を RHEL 9 に移行する リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Enterprise Linux 8 の既存の Satellite Server を、新しくインストールした Red Hat Enterprise Linux 9 システムにクローンできます。既存の Satellite Server のバックアップを作成し、そのクローンを新しい Red Hat Enterprise Linux 9 システムに作成します。
Capsule Server のバックアップにクローン作成を使用することはできません。
手順
- Satellite Server の完全バックアップを実行します。これは、移行するソース Red Hat Enterprise Linux 8 サーバーです。詳細は、Red Hat Satellite の管理 の Satellite Server の完全バックアップの実行 を参照してください。
- ソースサーバーと同じ設定を持つ Red Hat Enterprise Linux 9 のシステムをデプロイします。これはターゲットサーバーです。
- サーバーのクローンを作成します。クローンにより、ターゲットサーバーのホスト名が設定されます。詳細は、Red Hat Satellite の管理 の Satellite Server のクローン作成 を参照してください。
3.3. バックアップと復元を使用して Satellite または Capsule を RHEL 9 に移行する リンクのコピーリンクがクリップボードにコピーされました!
既存の Satellite Server と Capsule Server を Red Hat Enterprise Linux 8 から新しくインストールされた Red Hat Enterprise Linux 9 システムに移行できます。この移行では、既存の Satellite Server と Capsule Server のバックアップを作成し、それを新しい Red Hat Enterprise Linux 9 システムに復元します。
手順
- Satellite Server または Capsule の完全バックアップを実行します。これは、移行するソース Red Hat Enterprise Linux 8 サーバーです。詳細は、Red Hat Satellite の管理 の Satellite Server または Capsule Server の完全バックアップの実行 を参照してください。
- ソースサーバーと同じホスト名と設定を持つ Red Hat Enterprise Linux 9 のシステムをデプロイします。これはターゲットサーバーです。
- バックアップを復元します。復元ではターゲットシステムに大きな変更は行われず、追加の設定が必要になります。詳細は、Red Hat Satellite の管理 の バックアップからの Satellite Server または Capsule Server の復元 を参照してください。
- Capsule Server のバックアップを復元します。詳細は、Red Hat Satellite の管理 の バックアップからの Satellite Server または Capsule Server の復元 を参照してください。
- 古い Red Hat Enterprise Linux 8 Capsule Server をシャットダウンして、その IP アドレスを新しい Red Hat Enterprise Linux 9 システムに再割り当てします。
付録A 権限に関する問題のトラブルシューティング リンクのコピーリンクがクリップボードにコピーされました!
Satellite のアップグレードでは、アップグレード前のチェックが実行されます。アップグレード前のチェックで権限の問題が見つかった場合、次のようなエラーが発生して失敗します。
2024-01-29T20:50:09 [W|app|] Could not create role 'Ansible Roles Manager': ERF73-0602 [Foreman::PermissionMissingException]: some permissions were not found:
Satellite Server でこのようなエラーが表示された場合は、権限の問題を特定して修正してください。
手順
Satellite Server で、パーミッションの問題を特定します。
# satellite-maintain health check --label duplicate_permissionsパーミッションの問題を修正します。
# foreman-rake db:seed
検証
チェックを再度実行して、権限の問題が残っていないことを確認します。
# satellite-maintain health check --label duplicate_permissions