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
# subscription-manager repos --enable \ satellite-maintenance-6.14-for-rhel-8-x86_64-rpmsCopy to Clipboard Copied! Toggle word wrap Toggle overflow 利用可能なバージョンを確認して、次のマイナーバージョンがリストされていることを確認します。
satellite-maintain upgrade list-versions
# satellite-maintain upgrade list-versionsCopy to Clipboard Copied! Toggle word wrap Toggle overflow ヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。このコマンドを最初に使用したときに、
satellite-maintainにより hammer 管理者ユーザー認証情報を入力して、/etc/foreman-maintain/foreman-maintain-hammer.ymlファイルに保存します。satellite-maintain upgrade check --target-version 6.14.z
# satellite-maintain upgrade check --target-version 6.14.zCopy to Clipboard Copied! Toggle word wrap Toggle overflow 結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。
アップグレードに時間がかかるため、
tmuxなどのユーティリティーを使用して、通信セッションを一時停止し、再接続してください。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、
/var/log/foreman-installer/satellite.logファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。アップグレードを実行します。
satellite-maintain upgrade run --target-version 6.14.z
# satellite-maintain upgrade run --target-version 6.14.zCopy to Clipboard Copied! Toggle word wrap Toggle overflow システムを再起動する必要があるかどうかを確認します。
dnf needs-restarting --reboothint
# dnf needs-restarting --reboothintCopy to Clipboard Copied! Toggle word wrap Toggle overflow 前のコマンドで再起動するように指示された場合は、システムを再起動します。
reboot
# rebootCopy to Clipboard Copied! Toggle word wrap Toggle overflow
関連情報
- 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)'
# dnf install 'dnf-command(reposync)'Copy to Clipboard Copied! Toggle word wrap Toggle overflow
接続されている 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など) を作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 設定ファイルで、次の手順を実行します。
-
sslclientcertおよびsslclientkeyオプションの場合は、/etc/pki/katello/certs/org-debug-cert.pemを、ダウンロードした組織のデバッグ証明書の場所に置き換えます。 -
baseurlオプションの場合は、satellite.example.comを、接続されている Satellite Server の正しい FQDN に置き換えます。 -
baseurlオプションの場合は、My_Organizationを組織ラベルに置き換えます。
-
組織ラベルを取得します。
hammer organization list
# hammer organization listCopy to Clipboard Copied! Toggle word wrap Toggle overflow reposyncコマンドを入力します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow これにより、接続されている Satellite Server からリポジトリーのコンテンツがダウンロードされ、ディレクトリー
~/Satellite-reposに保存されます。-
RPM がダウンロードされ、リポジトリーデータディレクトリーが
~/Satellite-reposの各サブディレクトリーに生成されていることを確認します。 ディレクトリーの内容をアーカイブします。
tar czf Satellite-repos.tgz -C ~ Satellite-repos
# tar czf Satellite-repos.tgz -C ~ Satellite-reposCopy to Clipboard Copied! Toggle word wrap Toggle overflow -
生成された
Satellite-repos.tgzファイルを使用して、接続されていない Satellite Server でアップグレードします。
接続されていない Satellite サーバーでの手順
-
生成された
Satellite-repos.tgzファイルを、接続されていない Satellite Server にコピーします。 rootユーザーがアクセスできる場所にアーカイブを展開します。次の例では、/rootが展開場所です。tar zxf Satellite-repos.tgz -C /root
# tar zxf Satellite-repos.tgz -C /rootCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のリポジトリー情報を使用して、
/etc/yum.repos.dの下に Yum 設定ファイルを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
設定ファイルの
/root/Satellite-reposは、展開先の場所に置き換えます。 利用可能なバージョンを確認して、次のマイナーバージョンがリストされていることを確認します。
satellite-maintain upgrade list-versions
# satellite-maintain upgrade list-versionsCopy to Clipboard Copied! Toggle word wrap Toggle overflow ヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。このコマンドを最初に使用したときに、
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"
# satellite-maintain upgrade check \ --target-version 6.14.z \ --whitelist="check-upstream-repository,repositories-validate"Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。
更新に時間がかかるため、
tmuxなどのユーティリティーを使用して、通信セッションを一時停止し、再接続します。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、
/var/log/foreman-installer/satellite.logファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。アップグレードを実行します。
satellite-maintain upgrade run \ --target-version 6.14.z \ --whitelist="check-upstream-repository,repositories-setup,repositories-validate"
# satellite-maintain upgrade run \ --target-version 6.14.z \ --whitelist="check-upstream-repository,repositories-setup,repositories-validate"Copy to Clipboard Copied! Toggle word wrap Toggle overflow システムを再起動する必要があるかどうかを確認します。
dnf needs-restarting --reboothint
# dnf needs-restarting --reboothintCopy to Clipboard Copied! Toggle word wrap Toggle overflow 前のコマンドで再起動するように指示された場合は、システムを再起動します。
reboot
# rebootCopy to Clipboard Copied! Toggle word wrap Toggle overflow
関連情報
- Satellite Server または Capsule Server のバックアップを復元するには、バックアップからの Satellite Server または Capsule Server の復元 を参照してください。
第4章 Capsule Server の更新 リンクのコピーリンクがクリップボードにコピーされました!
Capsule Server を次のマイナーバージョンに更新します。
手順
-
Satellite Server の
satellite-capsule-6.17-for-rhel-9-x86_64-rpmsリポジトリーを同期します。 - Capsule が登録されているコンテンツビューの新しいバージョンを公開およびプロモートします。
Satellite Maintenance リポジトリーが有効になっていることを確認します。
subscription-manager repos --enable \ satellite-maintenance-6.14-for-rhel-8-x86_64-rpms
# subscription-manager repos --enable \ satellite-maintenance-6.14-for-rhel-8-x86_64-rpmsCopy to Clipboard Copied! Toggle word wrap Toggle overflow 利用可能なバージョンを確認して、次のマイナーバージョンがリストされていることを確認します。
satellite-maintain upgrade list-versions
# satellite-maintain upgrade list-versionsCopy to Clipboard Copied! Toggle word wrap Toggle overflow ヘルスチェックオプションを使用して、システムがアップグレードの準備ができているかどうかを確認します。
satellite-maintain upgrade check --target-version 6.14.z
# satellite-maintain upgrade check --target-version 6.14.zCopy to Clipboard Copied! Toggle word wrap Toggle overflow 結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。
アップグレードに時間がかかるため、
tmuxなどのユーティリティーを使用して、通信セッションを一時停止し、再接続してください。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、
/var/log/foreman-installer/capsule.logファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。更新を実行します。
satellite-maintain upgrade run --target-version 6.14.z
# satellite-maintain upgrade run --target-version 6.14.zCopy to Clipboard Copied! Toggle word wrap Toggle overflow システムを再起動する必要があるかどうかを確認します。
dnf needs-restarting --reboothint
# dnf needs-restarting --reboothintCopy to Clipboard Copied! Toggle word wrap Toggle overflow 前のコマンドで再起動するように指示された場合は、システムを再起動します。
reboot
# rebootCopy to Clipboard Copied! Toggle word wrap Toggle overflow