3.3. Capsule Server のアップグレード

このセクションは、Capsule Server を 6.8 から 6.9 にアップグレードする方法を説明します。

作業開始前の準備

  • Capsule Server をアプリケーションする前に Satellite Server をアップロードする必要があります。Capsule は、Satellite とは別にアップグレードできます。詳細は、「Satellite とは別の Capsule のアップグレード」 を参照してください。
  • Red Hat Satellite Capsule 6.9 リポジトリーが Satellite Server で有効になっており、同期されていることを確認します。
  • Satellite Server 上の必要なリポジトリーを必ず同期してください。詳細は、「新しいリポジトリーの同期」 を参照してください。
  • コンテンツビューを使用して Capsule Server のベースオペレーティングシステムへの更新を制御する場合、それらのコンテンツビューを新しいリポジトリーで更新し、更新済みのバージョンを公開します。詳しい情報は、コンテンツ管理ガイドコンテンツビューの管理 を参照してください。
  • 新たにアップグレードした Satellite Server に、Capsule のベースシステムが'登録されていることを確認します。
  • 新たにアップグレードした Satellite Server で、Capsule の組織と場所が正しく設定されていることを確認します。
  • Capsule Server をアップグレードする前に、ファイアウォールの設定を確認して更新してください。詳細は、Capsule Server のインストールポートとファイアウォールの要件 を参照してください。
警告

カスタムの証明書を実装している場合は、/root/ssl-build ディレクトリーと、カスタム証明書に関連するソースファイルを作成したディレクトリーのコンテンツを保持する必要があります。

アップグレード時にこのファイルを保持できないと、アップグレードは失敗します。ファイルを削除してしまった場合は、アップグレードを進めるためにバックアップから復元する必要があります。

Capsule Server のアップグレード

  1. バックアップを作成します。

  2. オプション: /etc/zones.conf または /etc/dhcp/dhcpd.conf ファイルで DNS または DHCP の設定を手動で編集した場合には、設定ファイルをバックアップしてください。インストーラーはドメインまたはサブネット 1 つしかサポートしないので、このバックアップから変更を復元する必要がある場合があります。
  3. オプション: DNS または DHCP の設定ファイルを手動で編集し、変更を上書きしない場合は、以下のコマンドを実行します。

    # satellite-installer --foreman-proxy-dns-managed=false \
    --foreman-proxy-dhcp-managed=false
  4. Satellite Web UI で、ホスト > 検出されたホスト に移動します。検出されたホストがある場合は、そのホストの電源を切り、検出されたホスト ページに表示されているすべてのエントリーを削除します。必要に応じて、組織設定メニューから、その他の組織を順番に選択し、すべてのエントリーを削除します。アップグレードが完了したら、検出されたホストを再起動します。
  5. yum のキャッシュを消去します。

    # yum clean all
  6. satellite-maintain が含まれる rubygem-foreman_maintain パッケージがインストールされており、最新の状態になっていることを確認します。

    # yum install rubygem-foreman_maintain
  7. gofer パッケージを更新します。

    # satellite-maintain packages update gofer
  8. goferd サービスを再起動します。

    # systemctl restart goferd
  9. Capsule Server で foreman_url 設定が Satellite FQDN を参照していることを確認します。

    # grep foreman_url /etc/foreman-proxy/settings.yml
  10. 利用可能なバージョンを確認して、希望のバージョンが表示されていることを確認します。

    # satellite-maintain upgrade list-versions
  11. アップグレード時間は長くなるため、通信セッションの中断と再接続を可能にする screen などのユーティリティーを使用します。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。screen コマンドの使用方法は、Red Hat ナレッジベースHow do I use the screen command? を参照してください。

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

  12. ヘルスチェックオプションを使用して、システムがアップグレードの準備ができているかどうかを確認します。

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

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

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

    # satellite-maintain upgrade run --target-version 6.9
    警告

    config サブディレクトリーを含むディレクトリーからコマンドを実行すると、以下のエラーが発生します。

    ERROR: Scenario (config/capsule.yaml) was not found, can not continue.

    このような場合は、root ユーザーのホームディレクトリーに移動し、コマンドを再実行します。

  14. カーネルパッケージが最後に更新された日時を確認します。

    # rpm -qa --last | grep kernel
  15. オプション: 最後の再起動以降にカーネルが更新された場合には、satellite-maintain サービスを停止して、システムを再起動します。

    # satellite-maintain service stop
    # reboot
  16. 作成しておいたバックアップを使用して、DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。
  17. オプション: カスタムリポジトリーを使用する場合は、アップグレードの完了後に、これらのカスタムリポジトリーを有効化することを確認してください。
  18. オプション: Capsule Server を検出ホストのプロキシーとして使用する予定の場合には、Discovery プラグインをインストールして、アップロード前にシャットダウンしたホストの電源をオンにします。

    # satellite-maintain packages install tfm-rubygem-smart_proxy_discovery.noarch

Satellite Web UI のリモート実行を使用した Capsule Server のアップグレード

  1. バックアップを作成します。

  2. オプション: /etc/zones.conf または /etc/dhcp/dhcpd.conf ファイルで DNS または DHCP の設定を手動で編集した場合には、設定ファイルをバックアップしてください。インストーラーはドメインまたはサブネット 1 つしかサポートしないので、このバックアップから変更を復元する必要がある場合があります。
  3. オプション: DNS または DHCP の設定ファイルを手動で編集し、変更を上書きしない場合は、以下のコマンドを実行します。

    # satellite-installer --foreman-proxy-dns-managed=false \
    --foreman-proxy-dhcp-managed=false
  4. Satellite Web UI で、Monitor > Jobs に移動します。
  5. Run Job をクリックします。
  6. Job category リストから Maintenance Operations を選択します。
  7. Job template リストから Capsule Upgrade Playbook を選択します。
  8. Search Query フィールドに Capsule のホスト名を入力します。
  9. Resolves to1 host が表示されていることを確認します。
  10. target_version フィールドに、Capsule のターゲットバージョンを入力します。
  11. whitelist_options フィールドに、許可リストオプションを入力します。
  12. Type of query には、クエリーの種類に合わせて Static Query または Dynamic Query をクリックします。
  13. Schedule でジョブ実行のスケジュールを選択します。