第4章 マイナーリリース間の更新

手順

1. Manager マシンに Log Collection Analysis ツールをインストールします。

   # yum install rhv-log-collector-analyzer

2. ツールを実行します。

   # rhv-log-collector-analyzer --live

   詳細なレポートが表示されます。

   デフォルトでは、レポートは analyzer_report.html という名前のフィアルに保存されます。

   ファイルを特定の場所に保存するには --html フラグを使用して場所を指定します。

   # rhv-log-collector-analyzer --live --html=/directory/filename.html

3. ELinks テキストモードの Web ブラウザーを使用して、ターミナル内のアナライザーレポートを読み取ることができます。ELinks ブラウザーをインストールするには、以下を実行します。

   # yum install -y elinks

4. ELink を起動し、analyzer_report.html を開きます。

   # elinks /home/user1/analyzer_report.html

   レポート内を移動するには、ELinks で以下のコマンドを使用します。

   • Insert でスクロールアップ
   • Delete でスクロールダウン
   • PageUp でページアップ
   • PageDown でページダウン
   • left Bracket で左にスクロール
   • right Bracket で右にスクロール

手順

1. Manager マシンで、更新されたパッケージが利用可能かどうかを確認します。

   # engine-upgrade-check

2. setup のパッケージを更新します。

   # yum update ovirt\*setup\* rh\*vm-setup-plugins

3. engine-setup スクリプトで Red Hat Virtualization Manager を更新します。engine-setup スクリプトにより、設定に関する質問への回答が求められます。その後、ovirt-engine サービスの停止、更新パッケージのダウンロード/インストール、データベースのバックアップ/更新、インストール後設定の実施を経てから、ovirt-engine サービスが起動します。

   # engine-setup

   スクリプトが正常に完了すると、以下のメッセージが表示されます。

   Execution of setup completed successfully

   注記

   engine-setup スクリプトは、Red Hat Virtualization Manager のインストールプロセス中にも使用され、指定した設定値が保存されます。更新時に、設定のプレビュー時に保存された値が表示され、engine-config がインストール後に設定の更新に使用される場合は最新ではない可能性があります。たとえば、インストール後に engine-config を使用して SANWipeAfterDelete を true へと更新した場合、engine-setup は設定プレビューに Default SAN wipe after delete: False と出力します。ただし、更新された値は engine-setup によって上書きされることはありません。

   重要

   更新プロセスに時間がかかる場合があります。完了する前にプロセスを停止しないでください。

4. Manager にインストールされているベースオペレーティングシステムと、オプションパッケージを更新します。

   # yum update --nobest

   重要

   更新中に必要な Ansible パッケージの競合が発生した場合は、Cannot perform yum update on my RHV manager (ansible conflict) を参照してください。

   重要

   いずれかのカーネルパッケージが更新された場合には、マシンを再起動して更新を完了してください。

手順

1. セルフホスト型エンジンノードのいずれかにログインして、グローバルメンテナンスモードを有効にします。

   # hosted-engine --set-maintenance --mode=global

2. 作業を進める前に、環境がグローバルメンテナンスモードにあることを確認します。

   # hosted-engine --vm-status

   クラスターがグローバルメンテナンスモードにあることを示すメッセージが表示されるはずです。

手順

1. Manager マシンで、更新されたパッケージが利用可能かどうかを確認します。

   # engine-upgrade-check

2. setup のパッケージを更新します。

   # yum update ovirt\*setup\* rh\*vm-setup-plugins

3. engine-setup スクリプトで Red Hat Virtualization Manager を更新します。engine-setup スクリプトにより、設定に関する質問への回答が求められます。その後、ovirt-engine サービスの停止、更新パッケージのダウンロード/インストール、データベースのバックアップ/更新、インストール後設定の実施を経てから、ovirt-engine サービスが起動します。

   # engine-setup

   スクリプトが正常に完了すると、以下のメッセージが表示されます。

   Execution of setup completed successfully

   注記

   engine-setup スクリプトは、Red Hat Virtualization Manager のインストールプロセス中にも使用され、指定した設定値が保存されます。更新時に、設定のプレビュー時に保存された値が表示され、engine-config がインストール後に設定の更新に使用される場合は最新ではない可能性があります。たとえば、インストール後に engine-config を使用して SANWipeAfterDelete を true へと更新した場合、engine-setup は設定プレビューに Default SAN wipe after delete: False と出力します。ただし、更新された値は engine-setup によって上書きされることはありません。

   重要

   更新プロセスに時間がかかる場合があります。完了する前にプロセスを停止しないでください。

4. Manager にインストールされているベースオペレーティングシステムと、オプションパッケージを更新します。

   # yum update --nobest

   重要

   更新中に必要な Ansible パッケージの競合が発生した場合は、Cannot perform yum update on my RHV manager (ansible conflict) を参照してください。

   重要

   カーネルパッケージが更新された場合は、以下を実行します。

   1. グローバルメンテナンスモードを無効にする
   2. マシンを再起動して更新を完了する

手順

1. Manager 用仮想マシンにログインし、シャットダウンします。

2. セルフホスト型エンジンノードのいずれかにログインして、グローバルメンテナンスモードを無効にします。

   # hosted-engine --set-maintenance --mode=none

   グローバルメンテナンスモードを終了すると、ovirt-ha-agent が Manager 用仮想マシンを起動し、続いて Manager が自動的に起動します。Manager が起動するまでに最大で 10 分程度かかる場合があります。

3. 環境が動作していることを確認します。

   # hosted-engine --vm-status

   情報の一覧に、Engine status が含まれます。Engine status の値は、以下のようになるはずです。

   {"health": "good", "vm": "up", "detail": "Up"}

   注記

   仮想マシンが起動中で Manager がまだ動作していない場合、Engine status は以下のようになります。

   {"reason": "bad vm status", "health": "bad", "vm": "up", "detail": "Powering up"}

   このような場合には、数分間待ってからやり直してください。

手順

1. 管理ポータルで コンピュート → クラスター をクリックし、クラスターを選択します。ステータスのアップグレード 列には、クラスターの任意のホストでアップグレードが利用可能かどうかが表示されます。
2. アップグレード をクリックします。
3. 更新するホストを選択し、次に Next をクリックします。

4. オプションを設定します。

   • 固定された仮想マシンの停止: クラスター内のホストに固定された仮想マシンをシャットダウンします。このオプションは、デフォルトで選択されています。このチェックボックスの選択を解除すると、固定された仮想マシンが動作を続けられるように、それらのホストの更新をスキップすることができます (固定された仮想マシンが重要なサービスまたはプロセスを実行中で、更新中の予期せぬ時にシャットダウンされるのを避けたい場合など)。
   • Upgrade Timeout (Minutes): このオプションで設定した時間内に個々のホストの更新が完了しない場合には、クラスターのアップグレードはタイムアウトで失敗します。デフォルトは 60 です。60 分では不十分と思われる大規模なクラスターの場合には、時間を延長することができます。また、ホストの更新が短時間で完了する小規模なクラスターでは、短縮することができます。
   • Check Upgrade: アップグレードプロセスを実行する前に、それぞれのホストで更新が利用可能かどうかを確認します。このオプションは、デフォルトでは選択されていません。ただし、Manager がホストの更新を確認する頻度をデフォルトより低く設定している状況などで、最新の更新を確実に含める必要がある場合には、このオプションを選択することができます。
   • Reboot After Upgrade: ホストの更新後に、それぞれのホストを再起動します。このオプションは、デフォルトで選択されています。ホストの再起動を必要とする保留中の更新がないことが明らかであれば、このチェックボックスの選択を解除してプロセスを迅速化することができます。
   • Use Maintenance Policy: 更新時のクラスターのスケジューリングポリシーを cluster_maintenance に設定します。このオプションはデフォルトで選択されています。したがって、許可される動作は限定的で、仮想マシンは高可用性でない限り起動することができません。更新中も使用を続けたいカスタムのスケジューリングポリシーがある場合には、このチェックボックスの選択を解除することができます。ただし、これにより想定外の結果を招く可能性があります。このオプションを無効にする前に、カスタムのポリシーがクラスターのアップグレード操作に対応していることを確認してください。
5. Next をクリックします。
6. 影響を受けるホストおよび仮想マシンの概要を確認します。
7. アップグレード をクリックします。

手順

1. 管理ポータルで、コンピュート → クラスター をクリックします。
2. 変更を行うクラスターを選択し、編集 をクリックします。
3. 全般 タブで 互換バージョン を必要な値に変更します。
4. OK をクリックします。クラスターの互換バージョンを変更 の確認ダイアログが開きます。
5. OK をクリックして確定します。

手順

1. 管理ポータルで コンピュート → 仮想マシン をクリックします。

2. 再起動が必要な仮想マシンを確認します。Vms: 検索バーに以下のクエリーを入力します。

   next_run_config_exists=True

   検索結果に、変更が保留中の仮想マシンがすべて表示されます。

3. それぞれの仮想マシンを選択し、再起動 をクリックします。あるいは、必要な場合は、仮想マシン自体から仮想マシンを再起動することができます。

手順

1. 管理ポータルで コンピュート → データセンター をクリックします。
2. 変更を行うデータセンターを選択し、編集 をクリックします。
3. 互換バージョン を必要な値に変更します。
4. OK をクリックします。データセンターの互換バージョンを変更 の確認ダイアログが開きます。
5. OK をクリックして確定します。

手順

1. 適切なリポジトリーが有効であることを確認します。現在有効なリポジトリーの一覧を表示するには、dnf repolist を実行します。

   • Red Hat Virtualization Host の場合:

     # subscription-manager repos --enable=rhvh-4-for-rhel-8-x86_64-rpms

   • Red Hat Enterprise Linux ホストの場合:

     # subscription-manager repos \
         --enable=rhel-8-for-x86_64-baseos-rpms \
         --enable=rhel-8-for-x86_64-appstream-rpms \
         --enable=rhv-4-mgmt-agent-for-rhel-8-x86_64-rpms \
         --enable=advanced-virt-for-rhel-8-x86_64-rpms \
         --enable=fast-datapath-for-rhel-8-x86_64-rpms
     
     # subscription-manager repos \
             --enable=rhel-8-for-x86_64-baseos-eus-rpms \
             --enable=rhel-8-for-x86_64-appstream-eus-rpms
     
     # subscription-manager release --set=8.6

     注記

     RHEL 8.6 EUS チャンネルは、RHEL 8.7 がリリースされるまで利用できない場合があります。

2. 管理ポータルで コンピュート → ホスト をクリックし、更新するホストを選択します。

3. インストール → アップグレードを確認 をクリックしてから OK をクリックします。

   通知ドロワー ( ) を開き、イベント セクションを展開して結果を表示します。

4. 更新が利用可能であれば、インストール → アップグレード をクリックします。

5. OK をクリックしてホストを更新します。実行中の仮想マシンは、その移行ポリシーに従って移行されます。いずれかの仮想マシンの移行が無効になっている場合は、シャットダウンするよう求められます。

   コンピュート → ホスト にホストの情報が更新され、ステータスが以下の順序で変わります。

   Maintenance > Installing > Reboot > Up

   注記

   更新が失敗すると、ホストのステータスは Install Failed に変わります。Install Failed のステータスから インストール → アップグレード を再度クリックすることができます。

手順

1. 適切なリポジトリーが有効であることを確認します。dnf repolist を実行して、現在有効なリポジトリーを確認することができます。

   • Red Hat Virtualization Host の場合:

     # subscription-manager repos --enable=rhvh-4-for-rhel-8-x86_64-rpms

   • Red Hat Enterprise Linux ホストの場合:

     # subscription-manager repos \
         --enable=rhel-8-for-x86_64-baseos-rpms \
         --enable=rhel-8-for-x86_64-appstream-rpms \
         --enable=rhv-4-mgmt-agent-for-rhel-8-x86_64-rpms \
         --enable=advanced-virt-for-rhel-8-x86_64-rpms \
         --enable=fast-datapath-for-rhel-8-x86_64-rpms
     
     # subscription-manager repos \
             --enable=rhel-8-for-x86_64-baseos-eus-rpms \
             --enable=rhel-8-for-x86_64-appstream-eus-rpms
     
     # subscription-manager release --set=8.6

     注記

     RHEL 8.6 EUS チャンネルは、RHEL 8.7 がリリースされるまで利用できない場合があります。

2. 管理ポータルで コンピュート → ホスト をクリックし、更新するホストを選択します。
3. 管理 → メンテナンス をクリックしてから OK をクリックします。

4. Red Hat Enterprise Linux ホストの場合:

   1. Red Hat Enterprise Linux の現行バージョンを特定します。

      # cat /etc/redhat-release

   2. redhat-release パッケージの利用可能なバージョンを確認します。

      # dnf --refresh info --available redhat-release

      このコマンドは、利用可能な更新をすべて表示します。たとえば、Red Hat Enterprise Linux 8.2.z から 8.3 にアップグレードする場合は、パッケージのバージョンを、現在インストールされているバージョンと比較します。

      Available Packages
      Name         : redhat-release
      Version      : 8.3
      Release      : 1.0.el8
      …​

      注意

      通常、Red Hat Enterprise Linux Advanced Virtualization モジュールは、Red Hat Enterprise Linux y-stream よりも遅れてリリースされます。新しい Advanced Virtualization モジュールがまだ利用できない場合や、有効化した際にエラーが発生した場合は、ここで停止してアップグレードを取り消します。取り消さない場合は、ホストが破損するリスクがあります。

   3. Red Hat Enterprise Linux 8.3 以降の Advanced Virtualization ストリームが利用できる場合は、virt モジュールをリセットします。

      # dnf module reset virt

      注記

      Advanced Virtualization ストリームでこのモジュールがすでに有効になっている場合は、このステップは必要なく、マイナス要因となることもありません。

      以下を入力してストリームの値を確認できます。

      # dnf module list virt

   4. 以下のコマンドを使用して、Advanced Virtualization ストリームで virt モジュールを有効にします。

      • RHV 4.4.2 の場合

        # dnf module enable virt:8.2

      • RHV 4.4.3～4.4.5 に対応しています。

        # dnf module enable virt:8.3

      • RHV 4.4.6 から 4.4.10 の場合:

        # dnf module enable virt:av

      • RHV 4.4 以降の場合:

        # dnf module enable virt:rhel

        注記

        RHEL 8.6 以降、Advanced Virtualization パッケージは標準の virt:rhel モジュールを使用します。RHEL 8.4 および 8.5 では、1 つの Advanced Virtualization ストリーム rhel:av のみが使用されます。

5. nodejs モジュールのバージョン 14 を有効にします。

   # dnf module -y enable nodejs:14

6. ホストを更新します。

   # dnf upgrade --nobest

7. すべての更新が正常に適用されるように、ホストを再起動します。

   注記

   imgbased ログを確認して、Red Hat Virtualization Host 向けの追加パッケージの更新に失敗したものがないかを確認します。更新後に一部のパッケージの再インストールに失敗した場合には、そのパッケージが /var/imgbased/persisted-rpms に記載されていることを確認します。足りないパッケージを追加してから rpm -Uvh /var/imgbased/persisted-rpms/* を実行します。