第3章 Red Hat Satellite のアップグレード
高可用性設定に Satellite 6 をインストールしている場合は、Satellite 6.4 にアップグレードする前に Red Hat サポートにご連絡ください。
本章を参照して、既存の Red Hat Satellite 環境を Red Hat Satellite 6.4 にアップグレードします。
本章には以下が含まれます。
アップグレードを行う前に「前提条件」を参照してください。
3.1. Satellite Server のアップグレード
このセクションでは、Satellite Server を 6.3 から 6.4 にアップグレードする方法を説明します。Red Hat Satellite Server 6.3 であれば、どのマイナーバージョンからでもアップグレードできます。
作業を開始する前に
- Satellite Server をアップグレードする前に、ファイアウォールの設定を確認して更新してください。詳細は『オンラインネットワークからの Satellite Server のインストール』の「ポートおよびファイアウォールの要件」を参照してください。
- カスタマーポータルまたは Satellite Web UI からマニフェストを削除しないでください。削除すると、コンテンツホストからエンタイトルメントがすべて削除されます。
- アップグレードする前に、全 Foreman フックのバックアップを作成して、その後フックを削除します。アップグレードが完了し、Satellite が動作しているのを確認したら、フックを復元します。
- デフォルトテンプレートを変更する場合は、そのテンプレートのクローンを作成するか、エクスポートを行って、ファイルをバックアップします。クローンを作成することで、今後の更新またはアップグレードが上書きされなくなるため、推奨されるのはクローン作成です。テンプレートの変更の有無を確認するには、アップグレード前に 履歴 を確認するか、アップグレード後に監査ログで変更を表示できます。Web UI で モニター > 監査 に移動し、テンプレートを検索すると、変更履歴を確認できます。エクスポートを使用する場合は、エクスポートしたテンプレートと、デフォルトテンプレートを比較し、手動で変更を適用して変更を復元します。
-
/root/.hammer/defaults.yml
ファイルが Satellite Server にある場合には、アップグレード前にこのファイルのバックアップを作成してから、/root/.hammer/defaults.yml
を削除してください。このファイルは、アップグレードの完了後に Satellite が機能していることが分かるまで復元しないでください。Red Hat の バグ 1632768 が解決されるまで、この回避策を適用する必要があります。
Capsule に関する留意事項
- Red Hat Satellite Capsule 6.4 リポジトリーが Satellite Server で有効になっており、同期されているのを確認します。Red Hat のバグ 1305040 が解決され、Capsules にこれらの変更が同期されるまでしばらくお待ちください。
- Capsule Server のベースオペレーティングシステム、または Capsule Server リポジトリーへの更新をコンテンツビューで管理する場合は、更新したコンテンツビューを公開する必要があります。
カスタムの証明書を実装している場合は、/root/ssl-build
ディレクトリーと、カスタム証明書に関連するソースファイルを作成したディレクトリーのコンテンツを保持する必要があります。
アップグレード時にこのファイルを保持できないと、アップグレードは失敗します。ファイルを削除してしまった場合は、アップグレードを進めるためにバックアップから復元する必要があります。
BASH シェルの設定
BASH シェルには、ハッシュテーブルのバイナリーの場所が保存されます。アップグレード時に katello-service
スクリプトの場所が変更になりますが、BASH にはこの変更が登録されないため、変更後にこのスクリプトを呼び出すと、foreman-maintain
が失敗します。
オプション: インストーラーの完了後に
katello-service
が有効になるように、アップグレードする前に、BASH シェルでcheckhash
オプションを一時的に設定できます。BASH シェルで以下のようなコマンドを実行します。shopt -s checkhash
# shopt -s checkhash
Copy to Clipboard Copied! アップグレードに成功または失敗した後に、現在実行しているすべての BASH シェルで、以下のコマンドを実行します。
hash -d katello-service 2> /dev/null
# hash -d katello-service 2> /dev/null
Copy to Clipboard Copied!
アップグレードシナリオ
- Red Hat コンテンツ配信ネットワークに接続している Satellite Server をアップグレードする場合は「接続している Satellite Server のアップグレード」に進みます。
- Red Hat コンテンツ配信ネットワークに接続していない Satellite Server をアップグレードする場合は「切断されている Satellite Server のアップグレード」に進みます。
自己登録の Satellite をアップグレードすることはできません。自己登録の Satellite は、Red Hat コンテンツ配信ネットワーク (CDN) に移行すればアップグレードを実行できます。自己登録の Satellite を CDN に移行する方法は、『Satellite 6.3 の Red Hat Satellite のアップグレードおよびアップデート』ガイドの 「自己登録 Satellite の移行」を参照してください。
3.1.1. 接続している Satellite Server のアップグレード
Satellite Server を Red Hat 配信ネットワークに接続している場合は、以下の手順を行います。
設定ファイルをカスタマイズする場合は、手動または Hiera などのツールを使用します。このような変更を行うと、アップグレード時または更新時にインストールスクリプトを実行する際に上書きされます。satellite-installer スクリプトで --noop
オプションを使用すると、変更をテストできます。詳細は、ナレッジベースソリューションの「How to use the noop option to check for changes in Satellite config files during an upgrade」を参照してください。
Satellite Server のアップグレード
バックアップを作成します。
- 仮想マシンで、スナップショットを作成します。
物理マシンで、バックアップを作成します。
バックアップに関する詳細は、『Red Hat Satellite 6.3 管理』ガイドの「Satellite Server および Capsule Server のバックアップと復元」を参照してください。
-
DNS と DHCP の設定ファイルである
/etc/zones.conf
と/etc/dhcp/dhcpd.conf
のバックアップをそれぞれ作成します。インストーラーでは、ドメインまたはサブネットが 1 つしかサポートされないため、バックアップからの変更の復元が必要になる場合があります。 DNS または DHCP の設定ファイルを手動で編集し、変更を上書きしない場合は、以下のコマンドを実行します。
satellite-installer --foreman-proxy-dns-managed=false \ --foreman-proxy-dhcp-managed=false
# satellite-installer --foreman-proxy-dns-managed=false \ --foreman-proxy-dhcp-managed=false
Copy to Clipboard Copied! - Satellite Web UI で、ホスト > 検出された ホストに移動します。検出されたホストページで、検出したホストの電源を切って削除します。組織の選択 メニューで、組織を順番に選択し、検出したホストの電源を切って削除するプロセスを繰り返します。アップグレードが完了したら、検出されたホストを再起動します。
- Satellite Web UI で、コンテンツ > Red Hat サブスクリプション に移動して、マニフェストの管理 をクリックします。サブスクリプションマニフェストペインで、アクション タブをクリックし、マニフェストの更新 をクリックして、サブスクリプションマニフェストの最新コピーをダウンロードします。
リポジトリーを設定します。
- Satellite Web UI で、コンテンツ > Red Hat リポジトリー に移動して、RPM タブを選択します。
- 製品 一覧から Red Hat Enterprise Linux Server を探して、展開します。
- リポジトリーセット 一覧から Red Hat Satellite Tools 6.4 (for RHEL7 Server) (RPMs) を探して、展開します。
- Red Hat Satellite Tools 6.4 for RHEL 7 Server RPMs x86_64 を選択します。
新たに有効にしたリポジトリーを同期します。
- Satellite Web UI で、コンテンツ > 同期の状態 に移動します。
- 製品の横にある矢印をクリックして、利用可能なリポジトリーを表示します。
- 6.4 のリポジトリーを選択します。
今すぐ同期 をクリックします。
リポジトリーのアップデート時にエラーが発生した場合は、カスタマーポータルまたは Satellite Web UI からマニフェストを削除していないことを確認してください。マニフェストを削除すると、コンテンツホストからエンタイトルメントがすべて削除されます。マニフェストを更新しても問題が解決しない場合は、サポートケースを作成してください。
- 6.3 バージョンのリポジトリーを使用する既存のコンテンツビューを、6.4 用の新しいバージョンで更新します。更新したコンテンツビューのバージョンを公開してプロモートすると、リポジトリーのバージョンが 6.4 になります。
サブスクリプションを更新します。
subscription-manager refresh
# subscription-manager refresh
Copy to Clipboard Copied! Satellite Maintenance と Red Hat Enterprise Linux Ansible のリポジトリーを有効にします。
subscription-manager repos \ --enable rhel-7-server-satellite-maintenance-6-rpms \ --enable rhel-7-server-ansible-2.6-rpms
# subscription-manager repos \ --enable rhel-7-server-satellite-maintenance-6-rpms \ --enable rhel-7-server-ansible-2.6-rpms
Copy to Clipboard Copied! 以下のコマンドを入力して、
foreman-maintain
をインストールするか、最新バージョンに更新します。yum install rubygem-foreman_maintain
# yum install rubygem-foreman_maintain
Copy to Clipboard Copied! 利用可能なバージョンを確認して、希望のバージョンが表示されていることを確認します。
foreman-maintain upgrade list-versions
# foreman-maintain upgrade list-versions
Copy to Clipboard Copied! ヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。プロンプトが表示されたら、hammer の管理者ユーザー認証情報を入力して
foreman-maintain
を設定します。この変更は、/etc/foreman-maintain/foreman-maintain-hammer.yml
ファイルに適用されます。foreman-maintain upgrade check --target-version 6.4
# foreman-maintain upgrade check --target-version 6.4
Copy to Clipboard Copied! 結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。
アップグレード時間は長くなるため、通信セッションの中断と再接続を可能にする
screen
などのユーティリティーを使用します。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。screen コマンドの使用方法は、Red Hat ナレッジベース の「How do I use the screen command?」を参照してください。アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、
/var/log/foreman-installer/satellite.log
のログで、プロセスが完全に終了したかどうかを確認できます。アップグレードを実行します。
foreman-maintain upgrade run --target-version 6.4
# foreman-maintain upgrade run --target-version 6.4
Copy to Clipboard Copied! BASH シェルを使用している場合は、アップグレードに成功または失敗した後に、以下を入力します。
hash -d foreman-maintain service 2> /dev/null
# hash -d foreman-maintain service 2> /dev/null
Copy to Clipboard Copied! - 作成したバックアップを使用して、DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。
以前の手順で変更を加えた場合には、Satellite サービスを再起動します。
foreman-maintain service restart
# foreman-maintain service restart
Copy to Clipboard Copied! OpenSCAP プラグインがインストールされているにもかかわらず、デフォルトの OpenSCAP コンテンツが利用できない場合は、以下のコマンドを実行します。
foreman-rake foreman_openscap:bulk_upload:default
# foreman-rake foreman_openscap:bulk_upload:default
Copy to Clipboard Copied!
3.1.2. 切断されている Satellite Server のアップグレード
Red Hat Content Delivery Network に接続していない Satellite Server には、この手順を使用します。
設定ファイルをカスタマイズする場合は、手動または Hiera などのツールを使用します。このようなカスタマイズを行うと、アップグレード時または更新時にインストールスクリプトを実行する際に上書きされます。satellite-installer スクリプトで --noop
オプションを使用すると、変更をテストできます。詳細は、ナレッジベースソリューションの「How to use the noop option to check for changes in Satellite config files during an upgrade」を参照してください。
作業を開始する前に
- Satellite Server をアップグレードする前に、ファイアウォールの設定を確認して更新してください。詳細は『オンラインネットワークからの Satellite Server のインストール』の「ポートおよびファイアウォールの要件」を参照してください。
- カスタマーポータルまたは Satellite Web UI からマニフェストを削除しないでください。削除すると、コンテンツホストからエンタイトルメントがすべて削除されます。
- アップグレードする前に、全 Foreman フックのバックアップを作成して、その後フックを削除します。アップグレードが完了し、Satellite が動作しているのを確認できるまで、フックを元に戻さないでください。
カスタムの証明書を実装している場合は、/root/ssl-build
ディレクトリーと、カスタム証明書に関連するソースファイルを作成したディレクトリーのコンテンツを保持する必要があります。
アップグレード時にこのファイルを保持できないと、アップグレードは失敗します。ファイルを削除してしまった場合は、アップグレードを進めるためにバックアップから復元する必要があります。
切断されている Satellite Server のアップグレード
バックアップを作成します。
- 仮想マシンで、スナップショットを作成します。
- 物理マシンで、バックアップを作成します。
アップグレード前スクリプトは競合を検出し、アップグレード後に登録解除および削除できる Satellite Server の重複エントリーがあるホストをリストできます。また、組織に割り当てられていないホストを検出します。ホスト > すべてのホスト で、組織の関連付けがないホストがリストされ、同じ名前のコンテンツホストに組織がすでに関連付けられている場合、コンテンツホストは自動的に登録解除されます。これは、アップグレード前にこのようなホストを組織に関連付けることによって回避できます。
アップグレードの前に、アップグレード前チェックスクリプトを実行して、削除できるホストのリストを取得します。関連付けられていないホストが検出された場合は、アップグレードの前に組織にそれらのホストを関連付けることが推奨されます。
foreman-rake katello:upgrade_check
# foreman-rake katello:upgrade_check
Copy to Clipboard Copied! アップグレードチェックで、タスクが実行中であることが原因の障害が報告された場合は、タスクが完了するまで待機することが推奨されます。一部のタスクはキャンセルすることができますが、Red Hat ナレッジベースソリューション「Red Hat Satellite 6 で一時停止したタスクを管理する 」に目を通して、安全にキャンセルできるタスクとできないタスクについて理解する必要があります。
-
DNS と DHCP の設定ファイルである
/etc/zones.conf
と/etc/dhcp/dhcpd.conf
のバックアップをそれぞれ作成します。インストーラーでは、ドメインまたはサブネットが 1 つしかサポートされないため、バックアップからの変更の復元が必要になる場合があります。 DNS または DHCP の設定ファイルを手動で編集し、変更を上書きしない場合は、以下のようにインストーラースクリプトを実行します。
satellite-installer --foreman-proxy-dns-managed=false \ --foreman-proxy-dhcp-managed=false
# satellite-installer --foreman-proxy-dns-managed=false \ --foreman-proxy-dhcp-managed=false
Copy to Clipboard Copied! -
Satellite Web UI で、ホスト > 検出されたホスト に移動します。検出されたホストが利用可能な場合は無効にし、
検出されたホスト
ページにあるエントリーをすべて削除します。必要に応じて、組織設定メニューから、その他の組織を順番に選択し、すべてのエントリーを削除します。アップグレードが完了したら、検出されたホストを再起動します。 - すべての外部 Capsule Server が組織に割り当てられていることを確認します。割り当てられていない場合、これらのサーバーは、ホスト統合の変更により登録解除された可能性があります。
Puppet 4 リポジトリーを無効にします。
subscription-manager repos \ --disable=rhel-7-server-satellite-6.3-puppet4-rpms
# subscription-manager repos \ --disable=rhel-7-server-satellite-6.3-puppet4-rpms
Copy to Clipboard Copied! Satellite サービスを停止します。
katello-service stop
# katello-service stop
Copy to Clipboard Copied! - 『オフラインネットワークからの Satellite SERVER のインストール』の「切断されたネットワークからのダウンロードおよびインストール」の手順に従って、最新の ISO ファイルを取得し、マウントしてから、パッケージをインストールします。
カスタム Apache サーバー設定がある場合は、次の手順でインストールデフォルト値に戻ります。アップグレードの実行時に変更する内容を確認する場合は、
--noop
(no operation) オプションとともにアップグレードコマンドを入力し、次の手順でアップグレードコマンドを入力するときに適用される変更内容を確認できます。このテストを行わない場合は、次の手順に進みます。テストを行う場合は、以下の手順を行います。次の行を
/etc/httpd/conf/httpd.conf
設定ファイルに追加します。Include /etc/httpd/conf.modules.d/*.conf
Include /etc/httpd/conf.modules.d/*.conf
Copy to Clipboard Copied! httpd
サービスを再起動します。systemctl restart httpd
# systemctl restart httpd
Copy to Clipboard Copied! postgresql
データベースサービスおよびmongod
データベースサービスを起動します。systemctl start postgresql systemctl start mongod
# systemctl start postgresql # systemctl start mongod
Copy to Clipboard Copied! 以下のように、
--noop
オプションを付けて、インストーラースクリプトを実行します。satellite-installer --scenario satellite --upgrade --verbose --noop
# satellite-installer --scenario satellite --upgrade --verbose --noop
Copy to Clipboard Copied! /var/log/foreman-installer/satellite.log
を参照して、--noop
オプションを付けずに実行した場合に 適用される変更 を確認します。設定ファイルへの変更を示す+++
と---
の記号を探します。この "no operation" オプションにより、実際にはファイルは作成されませんが、モジュール内の一部の Puppet リソースではファイルが作成されていることが期待されるため、エラーメッセージが表示されるはずです。Satellite サービスを停止します。
katello-service stop
# katello-service stop
Copy to Clipboard Copied!
アップグレード時間は長くなるため、通信セッションの中断と再接続を可能にする
screen
などのユーティリティーを使用します。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。screen コマンドの使用方法は、Red Hat ナレッジベース の「How do I use the screen command?」を参照してください。アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、
/var/log/foreman-installer/satellite.log
のログで、プロセスが完全に終了したかどうかを確認できます。以下のコマンドを入力して、
foreman-maintain
をインストールするか、最新バージョンに更新します。yum install rubygem-foreman_maintain
# yum install rubygem-foreman_maintain
Copy to Clipboard Copied! 利用可能なバージョンを確認して、希望のバージョンが表示されていることを確認します。
foreman-maintain upgrade list-versions
# foreman-maintain upgrade list-versions
Copy to Clipboard Copied! ヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。プロンプトが表示されたら、hammer の管理者ユーザー認証情報を入力して
foreman-maintain
を設定します。この変更は、/etc/foreman-maintain/foreman-maintain-hammer.yml
ファイルに適用されます。foreman-maintain upgrade check --target-version 6.4
# foreman-maintain upgrade check --target-version 6.4
Copy to Clipboard Copied! 結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。
アップグレードを実行します。
foreman-maintain upgrade run --target-version 6.4
# foreman-maintain upgrade run --target-version 6.4
Copy to Clipboard Copied! BASH シェルを使用している場合は、アップグレードに成功または失敗した後に、以下を入力します。
hash -d foreman-maintain service 2> /dev/null
# hash -d foreman-maintain service 2> /dev/null
Copy to Clipboard Copied! 警告config サブディレクトリーを含むディレクトリーからコマンドを実行すると、以下のエラーが発生します。
ERROR: Scenario (config/satellite.yaml) was not found, can not continue.
ERROR: Scenario (config/satellite.yaml) was not found, can not continue.
Copy to Clipboard Copied! このような場合は、root ユーザーのホームディレクトリーに移動し、コマンドを再実行します。
- 作成したバックアップを使用して、DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。
以前の手順で変更を加えた場合には、Satellite サービスを再起動します。
foreman-maintain service restart
# foreman-maintain service restart
Copy to Clipboard Copied! OpenSCAP プラグインがインストールされているにもかかわらず、デフォルトの OpenSCAP コンテンツが利用できない場合は、以下のコマンドを実行します。
foreman-rake foreman_openscap:bulk_upload:default
# foreman-rake foreman_openscap:bulk_upload:default
Copy to Clipboard Copied! - Satellite Web UI で 設定 > 検出ルール に移動し、選択した組織および場所を検出ルールに関連付けます。
3.2. Capsule Server のアップグレード
このセクションは、Capsule Server を 6.3 から 6.4 にアップグレードする方法を説明します。
作業を開始する前に
- Capsule Server をアップグレードする前に、Satellite Server がアップグレードされている必要があります。
- Capsule Server は Puppet 4 にアップグレードする必要があります。詳細は、『Red Hat Satellite 6.3 アップグレードおよびアップデートガイド』の「Puppet のアップグレード」の章を参照してください。
- Red Hat Satellite Capsule 6.4 リポジトリーが Satellite Server で有効になっており、同期されているのを確認します。
- Capsule Server のベースオペレーティングシステム、または Capsule Server リポジトリーへの更新をコンテンツビューで管理する場合は、更新したコンテンツビューを公開する必要があります。
- 新たにアップグレードした Satellite Server に、Capsule のベースシステムが’登録されていることを確認します。
- 新たにアップグレードした Satellite Server で、Capsule の組織と場所が正しく設定されていることを確認します。
- Capsule Server をアップグレードする前に、ファイアウォールの設定を確認して更新してください。詳細は『Capsule Server のインストール』の「ポートおよびファイアウォールの要件」を参照してください。
カスタムの証明書を実装している場合は、/root/ssl-build
ディレクトリーと、カスタム証明書に関連するソースファイルを作成したディレクトリーのコンテンツを保持する必要があります。
アップグレード時にこのファイルを保持できないと、アップグレードは失敗します。ファイルを削除してしまった場合は、アップグレードを進めるためにバックアップから復元する必要があります。
Capsule Server のアップグレード
バックアップを作成します。
- 仮想マシンで、スナップショットを作成します。
物理マシンで、バックアップを作成します。
バックアップに関する詳細は、『Red Hat Satellite 6.3 管理』ガイドの「Satellite Server および Capsule Server のバックアップと復元」を参照してください。
-
DNS と DHCP の設定ファイルである
/etc/zones.conf
と/etc/dhcp/dhcpd.conf
のバックアップをそれぞれ作成します。インストーラーでは、ドメインまたはサブネットが 1 つしかサポートされないため、バックアップからの変更の復元が必要になる場合があります。 DNS または DHCP の設定ファイルを手動で編集し、変更を上書きしない場合は、以下のコマンドを実行します。
satellite-installer --foreman-proxy-dns-managed=false \ --foreman-proxy-dhcp-managed=false
# satellite-installer --foreman-proxy-dns-managed=false \ --foreman-proxy-dhcp-managed=false
Copy to Clipboard Copied! Red Hat Satellite 6.3 のリポジトリーを無効にします。
subscription-manager repos \ --disable rhel-7-server-satellite-capsule-6.3-rpms
# subscription-manager repos \ --disable rhel-7-server-satellite-capsule-6.3-rpms
Copy to Clipboard Copied! Puppet 4 リポジトリーを無効にします。
subscription-manager repos \ --disable=rhel-7-server-satellite-capsule-6.3-puppet4-rpms
# subscription-manager repos \ --disable=rhel-7-server-satellite-capsule-6.3-puppet4-rpms
Copy to Clipboard Copied! 新しいリポジトリーを有効にします。
Red Hat Software Collections リポジトリーは、リモート実行機能を含む一部の Red Hat Satellite 機能で必要な、新しいバージョンの Ruby を提供します。Satellite ツールリポジトリーでは、エラータを管理するための通信サービスを提供する
gofer
およびkatello-agent
が提供されます。以下のコマンドを実行します。
subscription-manager repos \ --enable rhel-7-server-satellite-capsule-6.4-rpms \ --enable rhel-server-rhscl-7-rpms \ --enable rhel-7-server-satellite-tools-6.4-rpms \ --enable rhel-7-server-satellite-maintenance-6-rpms \ --enable rhel-7-server-ansible-2.6-rpms
# subscription-manager repos \ --enable rhel-7-server-satellite-capsule-6.4-rpms \ --enable rhel-server-rhscl-7-rpms \ --enable rhel-7-server-satellite-tools-6.4-rpms \ --enable rhel-7-server-satellite-maintenance-6-rpms \ --enable rhel-7-server-ansible-2.6-rpms
Copy to Clipboard Copied!
-
Satellite web UI で、ホスト > 検出されたホスト に移動します。検出されたホストが利用できる場合は、そのホストの電源を切り、
検出されたホスト
ページに表示されているすべてのエントリーを削除します。必要に応じて、組織設定メニューから、その他のすべての組織を順番に選択して、すべてのエントリーを削除します。アップグレードが完了したら、検出されたホストを再起動します。 リポジトリーキャッシュを削除します。
yum clean all
# yum clean all
Copy to Clipboard Copied! Satellite サービスを停止します。
katello-service stop
# katello-service stop
Copy to Clipboard Copied! すべてのパッケージを更新します。
yum update
# yum update
Copy to Clipboard Copied! 検出されたホストのプロキシーとして Capsule Server を使用する場合は、検出プラグインをインストールします。
yum install rubygem-smart_proxy_discovery.noarch
# yum install rubygem-smart_proxy_discovery.noarch
Copy to Clipboard Copied! Capsule Server で
foreman_url
設定が正しいことを確認します。grep foreman_url /etc/foreman-proxy/settings.yml
# grep foreman_url /etc/foreman-proxy/settings.yml
Copy to Clipboard Copied! Satellite Server の完全修飾ドメイン名が表示されます。
--upgrade
オプションを使用してインストーラースクリプトを実行することによりアップグレードを実行します。satellite-installer --scenario capsule --upgrade
# satellite-installer --scenario capsule --upgrade
Copy to Clipboard Copied! 警告config サブディレクトリーを含むディレクトリーからコマンドを実行すると、以下のエラーが発生します。
ERROR: Scenario (config/capsule.yaml) was not found, can not continue.
ERROR: Scenario (config/capsule.yaml) was not found, can not continue.
Copy to Clipboard Copied! このような場合は、root ユーザーのホームディレクトリーに移動し、コマンドを再実行します。
- 作成しておいたバックアップを使用して、DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。
- Satellite Server で foreman-discovery パッケージをアップグレードし、アップグレード前にシャットダウンしたホストを有効にします。
3.3. Satellite クライアントのアップグレード
現時点では、Satellite Tools リポジトリーに含まれる、Satellite 6.3 バージョンの katello-agent
などのクライアントライブラリーは、Satellite 6.4 で正式にテストされていないため、サポート対象外となります。
Satellite Server との完全互換性を持たせるために、すべてのクライアントを、速やかに新しいバージョンの katello-agent
にアップグレードします。このため、Satellite Tools リポジトリーを 6.3 から 6.4 に変更する必要があります。これは手動で行うか、satellite-6.4-tools-upgrade
パッケージをインストールすることで行えます。このパッケージには、Satellite Tools リポジトリーのバージョンを変更するポストインストールスクリプトだけが含まれます。
前提条件
- Satellite Server がアップグレードされている必要があります。
- Satellite で、新しい Satellite Tools リポジトリーを有効にしておく必要があります。
- Satellite で、新しいリポジトリーを同期しておく必要があります。
-
クライアントに
katello-agent
がインストールされていない場合は、手動で作業を行います。
カスタムの証明書を実装している場合は、/root/ssl-build
ディレクトリーと、カスタム証明書に関連するソースファイルを作成したディレクトリーのコンテンツを保持する必要があります。
アップグレード時にこのファイルを保持できないと、アップグレードは失敗します。ファイルを削除してしまった場合は、アップグレードを進めるためにバックアップから復元する必要があります。
一括リポジトリー設定 UI を使用した Satellite クライアントのアップグレード
- Satellite Web UI で、ホスト > コンテンツホスト に移動し、アップグレードするコンテンツホストを選択します。
- アクションの選択 一覧から リポジトリーセットの管理 を選択します。
- リポジトリーセットの管理 の一覧から、Red Hat Satellite Tools 6.3 のチェックボックスを選択します。
- アクションの選択 一覧から Override to Disabled (「無効」に上書き) を選択し、Done (完了) をクリックします。
- プロセスが完了したら、以前の手順で使用した同じホストセットで、リポジトリーセットの管理 を選択します。
- リポジトリーセットの管理 の一覧から、Red Hat Satellite Tools 6.4 のチェックボックスを選択します。
- アクションの選択 一覧から Override to Enabled (「有効」に上書き) を選択し、Done (完了) をクリックします。
- プロセスが完了したら、以前の手順で使用した同じホストセットで、リポジトリーセットの管理 を選択します。
- アクションの選択 一覧から パッケージの管理 を選択します。
-
パッケージ 検索フィールドで、
katello-agent
と入力します。 - 更新 一覧から、希望の更新方法を選択します。
- 更新が完了したことを確認してから、Done (完了) をクリックします。
Satellite クライアントの手動アップグレード
- クライアントシステムにログインします。
以前のバージョンの Satellite のリポジトリーを無効にします。
subscription-manager repos \ --disable rhel-7-server-satellite-tools-6.3-rpms
# subscription-manager repos \ --disable rhel-7-server-satellite-tools-6.3-rpms
Copy to Clipboard Copied! 現行バージョンの Satellite の Satellite Tools リポジトリーを有効にします。
subscription-manager repos \ --enable=rhel-7-server-satellite-tools-6.4-rpms
# subscription-manager repos \ --enable=rhel-7-server-satellite-tools-6.4-rpms
Copy to Clipboard Copied! 以下の Katello、Pulp、および qpid パッケージをアップグレードします。
yum upgrade katello-agent katello-host-tools katello-host-tools-fact-plugin pulp-rpm-handlers qpid-proton-c
# yum upgrade katello-agent katello-host-tools katello-host-tools-fact-plugin pulp-rpm-handlers qpid-proton-c
Copy to Clipboard Copied! goferd を再起動します。
systemctl restart goferd
# systemctl restart goferd
Copy to Clipboard Copied!
3.4. アップグレード後のタスク
本セクションで紹介する手順の一部はオプションです。お使いのインストールに関連する手順のみを選択できます。
PXE ベースの検出プロセスを使用する場合には、Satellite の ホスト > 検出されたホスト ページに表示させるホストで、Satellite または Capsule Server 上で Discovery アップグレードの手順を実行する必要があります。
Satellite または Capsule のバックアップおよび復元のスクリプトがある場合には、katello-backup
と katello-restore
を foreman-maintain backup
と foreman-maintain restore
に置き換えるように、このスクリプトを更新するようにしてください。
3.4.1. Discovery のアップグレード
このセクションでは、PXE ブートを使用して Satellite Server に登録するホストに渡した PXELinux テンプレートとブートイメージをアップデートする方法を説明します。
Satellite 6.4 以降、プロビジョニングテンプレートには別途サブネットが関連付けられるので、対象のサブネットに対して TFTP Capsule を使用するように初期設定しないようにしてください。アップグレード後にサブネットを作成する場合には、特に Satellite また Capsule が Discovery テンプレートにプロキシーサービスを提供できるようにしてから、テンプレート Capsule を使用するように、検出されたホストで全ホストを設定する必要があります。
アップグレード中は、TFTP プロキシーが設定された各サブネットが有効化されている場合には、テンプレート Capsule を TFTP Capsule と同じに設定してください。アップグレード後には、すべてのサブネットでこれが正しく設定されていることを確認してください。
ホストで PXE ブートを使用しない場合には、Satellite に新規ホストを検出させるために、これらの手順は、必要ありません。
3.4.1.1. Satellite Server での Discovery のアップグレード
Satellite web UI で Discovery テンプレートをアップデートします。
- ホスト > プロビジョニングテンプレート に移動します。
-
PXELinux global default
行で クローン をクリックします。 -
名前 フィールドに、テンプレートの新しい名前を入力します (例:
ACME PXE global default
)。 -
テンプレートエディターフィールドで、
ONTIMEOUT local
行をONTIMEOUT discovery
に変更し、送信 をクリックします。 - 管理 > 設定 に移動します。
-
Global default PXELinux template
の 値 をクリックします。 - 新しく作成したテンプレートの名前を選択し、チェックボタンをクリックします。
- ホスト > プロビジョニングテンプレート に移動します。
- PXE デフォルトのビルド をクリックして、OK をクリックします。
- Satellite Web UI で 設定 > 検出ルール に移動し、選択した組織および場所を検出ルールに関連付けます。
3.4.1.2. Capsule Server での Discovery のアップグレード
Satellite Server で、Foreman Discovery パッケージが最新であることを確認します。
yum upgrade tfm-rubygem-foreman_discovery
# yum upgrade tfm-rubygem-foreman_discovery
Copy to Clipboard Copied! 以前の手順で更新があれば、Satellite サービスを再起動します。
katello-service restart
# katello-service restart
Copy to Clipboard Copied! 検出されたホストでプロビジョニングネットワークに接続した Satellite Capsule の Discovery イメージ、または検出されたホストに TFTP サービスを提供する Satellite Capsule の Discovery イメージをアップグレードします。
yum upgrade foreman-discovery-image
# yum upgrade foreman-discovery-image
Copy to Clipboard Copied! 同じインスタンスに、Proxy サービスを提供するパッケージをインストールして、
foreman-proxy
サービスを再起動します。yum install rubygem-smart_proxy_discovery service foreman-proxy restart
# yum install rubygem-smart_proxy_discovery # service foreman-proxy restart
Copy to Clipboard Copied! - Satellite web UI で、インフラストラクチャー > Capsule に移動して、関連する Capsule の機能列に Discovery が表示されていることを確認します。必要に応じて、アクション ドロップダウンメニューから 更新 を選択します。
インフラストラクチャー > サブネット に移動し、検出を使用する各サブネットで以下を行います。
- サブネット名をクリックします。
- Capsule タブで、上で設定した Capsule に Discovery Capsule が設定されているのを確認します。
3.4.1.3. サブネットにテンプレート Capsule があることの確認
検出されたホストが含まれる全サブネットに、テンプレート Capsule が設定されていることを確認します。
- Satellite Web UI で、インフラストラクチャー > Capsule に移動します。
- 確認するサブネットを選択します。
- Capsule タブで、テンプレート Capsule が、このサブネットに設定されていることを確認します。
テンプレート Capsule を使用したサブネットの設定に関する詳細は、『Red Hat Satellite ホスト管理』ガイドの「Discovery サブネットの設定」を参照してください。
3.4.2. virt-who のアップグレード
Satellite または Capsule Server に virt-who がインストールされている場合は、Satellite または Capsule Server のアップグレード時に一緒にアップグレードされるため、追加の作業は必要ありません。virt-who を他の場所にインストールしている場合は、手動でアップグレードする必要があります。
作業を開始する前に
Satellite または Capsule Server に登録しているホストに virt-who がインストールされている場合は、最初にホストを、Satellite Tools リポジトリーで利用可能な最新パッケージにアップグレードします。ホストのアップグレードに関する詳細は「Satellite クライアントのアップグレード」を参照してください。
virt-who の手動アップグレード
virt-who をアップグレードします。
yum upgrade virt-who
# yum upgrade virt-who
Copy to Clipboard Copied! virt-who サービスを再起動して、新しいバージョンを有効にします。
systemctl restart virt-who.service
# systemctl restart virt-who.service
Copy to Clipboard Copied!
3.4.3. 以前のバージョンの Satellite Tools リポジトリーの削除
Satellite 6.4 へのアップグレードが完了したら、コンテンツホストから Red Hat Satellite Tools 6.3 リポジトリーを削除して、無効にすることができます。
バージョン 6.3 の Satellite Tools リポジトリーを無効にします。
- Satellite Web UI で、コンテンツ > Red Hat サブスクリプション に移動します。
- 有効されたリポジトリー エリアで、Red Hat Satellite Tools 6.3 for RHEL 7 Server RPMs x86_64 を探し出します。
- 右側の 無効化 アイコンをクリックします。
リポジトリーがまだコンテンツビューに含まれている場合には、無効にできません。スケジュールされているタスクにより、無効にされたリポジトリーからパッケージが自動的に削除されます。