Red Hat Satellite の更新
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章 Satellite の次のマイナーバージョンへの更新
Satellite 保守ツールを使用して、Satellite Server と Capsule Server を新しいマイナーリリースバージョンに更新できます (6.14.0 から 6.14.1 など)。マイナーリリースへの更新は、オペレーティング環境を停止することなく実行でき、多くの場合、短時間で終わります。
マイナーリリースではコードのリリース後に発見されたセキュリティーの脆弱性や軽微な問題にパッチを適用するため、Red Hat では定期的に更新を実行することを推奨しています。
第2章 Satellite Server の更新
接続されている Satellite Server を次のマイナーバージョンに更新します。接続されていない Satellite セットアップを更新する方法については、3章接続されていない Satellite Server の更新 を参照してください。
前提条件
- Satellite Server をバックアップします。詳細は、Red Hat Satellite の管理 の Satellite Server および Capsule 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 Maintenance リポジトリーが有効になっていることを確認します。
# subscription-manager repos --enable \ satellite-maintenance-6.14-for-rhel-8-x86_64-rpms
利用可能なバージョンを確認して、次のマイナーバージョンがリストされていることを確認します。
# satellite-maintain upgrade list-versions
ヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。このコマンドを最初に使用したときに、
satellite-maintain
により hammer 管理者ユーザー認証情報を入力して、/etc/foreman-maintain/foreman-maintain-hammer.yml
ファイルに保存します。# satellite-maintain upgrade check --target-version 6.14.z
結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。
アップグレードに時間がかかるため、
tmux
などのユーティリティーを使用して、通信セッションを一時停止し、再接続してください。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、
/var/log/foreman-installer/satellite.log
ファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。アップグレードを実行します。
# satellite-maintain upgrade run --target-version 6.14.z
システムを再起動する必要があるかどうかを確認します。
# dnf needs-restarting --reboothint
前のコマンドで再起動するように指示された場合は、システムを再起動します。
# reboot
関連情報
- Satellite Server または Capsule Server のバックアップを復元するには、バックアップからの Satellite Server または Capsule Server の復元 を参照してください。
第3章 接続されていない Satellite Server の更新
接続されている Satellite Server (CDN からコンテンツを同期するサーバー) が接続されていない Satellite Server からエアギャップで隔離されているエアギャップ Satellite セットアップを、次のマイナーバージョンに更新します。
前提条件
- Satellite Server をバックアップします。詳細は、Red Hat Satellite の管理 の Satellite Server および Capsule Server のバックアップ を参照してください。
更新手順に必要な
reposync
をインストールします。# dnf install 'dnf-command(reposync)'
接続されている Satellite サーバーでの手順
接続されている Satellite Server で次のリポジトリーが同期されていることを確認します。
- rhel-8-for-x86_64-baseos-rpms
- rhel-8-for-x86_64-appstream-rpms
- satellite-6.14-for-rhel-8-x86_64-rpms
- satellite-maintenance-6.14-for-rhel-8-x86_64-rpms
-
組織のデバッグ証明書をダウンロードして、
/etc/pki/katello/certs/org-debug-cert.pem
または選択した場所にローカルに保存します。詳細は、Red Hat Satellite の管理 の 組織のデバッグ証明書の作成 を参照してください。 /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.14-for-rhel-8-x86_64-rpms] name=Red Hat Satellite 6.14 for RHEL 8 RPMs x86_64 baseurl=_https://satellite.example.com_/pulp/content/_My_Organization_/Library/content/dist/layered/rhel8/x86_64/satellite/6.14/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-maintenance-6.14-for-rhel-8-x86_64-rpms] name=Red Hat Satellite Maintenance 6.14 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.14/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
設定ファイルで、次の手順を実行します。
-
sslclientcert
およびsslclientkey
オプションの場合は、/etc/pki/katello/certs/org-debug-cert.pem
を、ダウンロードした組織のデバッグ証明書の場所に置き換えます。 -
baseurl
オプションの場合は、satellite.example.com
を、接続されている Satellite Server の正しい FQDN に置き換えます。 -
baseurl
オプションの場合は、My_Organization
を組織ラベルに置き換えます。
-
組織ラベルを取得します。
# hammer organization list
reposync
コマンドを入力します。# dnf reposync \ --delete \ --disableplugin=foreman-protector \ --download-metadata \ --repoid rhel-8-for-x86_64-appstream-rpms \ --repoid rhel-8-for-x86_64-baseos-rpms \ --repoid satellite-maintenance-6.14-for-rhel-8-x86_64-rpms \ --repoid satellite-6.14-for-rhel-8-x86_64-rpms \ -n \ -p ~/Satellite-repos
これにより、接続されている Satellite Server からリポジトリーのコンテンツがダウンロードされ、ディレクトリー
~/Satellite-repos
に保存されます。-
RPM がダウンロードされ、リポジトリーデータディレクトリーが
~/Satellite-repos
の各サブディレクトリーに生成されていることを確認します。 ディレクトリーの内容をアーカイブします。
# tar czf Satellite-repos.tgz -C ~ Satellite-repos
-
生成された
Satellite-repos.tgz
ファイルを使用して、接続されていない Satellite Server でアップグレードします。
接続されていない Satellite サーバーでの手順
-
生成された
Satellite-repos.tgz
ファイルを、接続されていない Satellite Server にコピーします。 root
ユーザーがアクセスできる場所にアーカイブを展開します。次の例では、/root
が展開場所です。# tar zxf Satellite-repos.tgz -C /root
次のリポジトリー情報を使用して、
/etc/yum.repos.d
の下に Yum 設定ファイルを作成します。[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.14-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.14-for-rhel-8-x86_64-rpms enabled=1 [satellite-maintenance-6.14-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.14-for-rhel-8-x86_64-rpms enabled=1
-
設定ファイルの
/root/Satellite-repos
は、展開先の場所に置き換えます。 利用可能なバージョンを確認して、次のマイナーバージョンがリストされていることを確認します。
# satellite-maintain upgrade list-versions
ヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。このコマンドを最初に使用したときに、
satellite-maintain
により hammer 管理者ユーザー認証情報を入力して、/etc/foreman-maintain/foreman-maintain-hammer.yml
ファイルに保存します。# satellite-maintain upgrade check \ --target-version 6.14.z \ --whitelist="check-upstream-repository,repositories-validate"
- 結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。
更新に時間がかかるため、
tmux
などのユーティリティーを使用して、通信セッションを一時停止し、再接続します。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、
/var/log/foreman-installer/satellite.log
ファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。アップグレードを実行します。
# satellite-maintain upgrade run \ --target-version 6.14.z \ --whitelist="check-upstream-repository,repositories-setup,repositories-validate"
システムを再起動する必要があるかどうかを確認します。
# dnf needs-restarting --reboothint
前のコマンドで再起動するように指示された場合は、システムを再起動します。
# reboot
関連情報
- Satellite Server または Capsule Server のバックアップを復元するには、バックアップからの Satellite Server または Capsule Server の復元 を参照してください。
第4章 Capsule Server の更新
Capsule Server を次のマイナーバージョンに更新します。
手順
-
Satellite Server の
satellite-capsule-6.15-for-rhel-8-x86_64-rpms
リポジトリーを同期します。 - Capsule が登録されているコンテンツビューの新しいバージョンを公開およびプロモートします。
Satellite Maintenance リポジトリーが有効になっていることを確認します。
# subscription-manager repos --enable \ satellite-maintenance-6.14-for-rhel-8-x86_64-rpms
利用可能なバージョンを確認して、次のマイナーバージョンがリストされていることを確認します。
# satellite-maintain upgrade list-versions
ヘルスチェックオプションを使用して、システムがアップグレードの準備ができているかどうかを確認します。
# satellite-maintain upgrade check --target-version 6.14.z
結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。
アップグレードに時間がかかるため、
tmux
などのユーティリティーを使用して、通信セッションを一時停止し、再接続してください。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、
/var/log/foreman-installer/capsule.log
ファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。更新を実行します。
# satellite-maintain upgrade run --target-version 6.14.z
システムを再起動する必要があるかどうかを確認します。
# dnf needs-restarting --reboothint
前のコマンドで再起動するように指示された場合は、システムを再起動します。
# reboot