1.2. Red Hat Virtualization 4.2 から 4.3 へのセルフホストエンジンのアップグレード

手順

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. ELinks を起動し、analyzer_report.html を開きます。

   # elinks /home/user1/analyzer_report.html

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

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

手順

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 パッケージの競合が発生した場合は、RHV Manager で yum update を実行できない (ansible の競合) を参照してください。

   重要

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

手順

1. Red Hat Virtualization 4.3 のリポジトリーを有効にします。

   # subscription-manager repos \
       --enable=rhel-7-server-rhv-4.3-manager-rpms \
       --enable=jb-eap-7.2-for-rhel-7-server-rpms

   その他のリポジトリーはすべて、Red Hat Virtualization リリース全体を通して同じになります。

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

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

3. engine-setup を実行し、プロンプトに従って Red Hat Virtualization Manager をアップグレードします。

   # engine-setup

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

   Execution of setup completed successfully

4. Red Hat Virtualization 4.2 のリポジトリーを無効にして、このシステムで 4.2 のパッケージが使用されないようにします。

   # subscription-manager repos \
       --disable=rhel-7-server-rhv-4.2-manager-rpms \
       --disable=jb-eap-7-for-rhel-7-server-rpms

5. ベースオペレーティングシステムを更新します。

   # yum update

   重要

   更新中に必要な Ansible パッケージの競合が発生した場合は、RHV Manager で yum update を実行できない (ansible の競合) を参照してください。

   重要

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

手順

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. 管理ポータルで Compute Clusters をクリックし、クラスターを選択します。Upgrade status 列には、クラスターの任意のホストでアップグレードが利用可能かどうかが表示されます。
2. Upgrade をクリックします。
3. 更新するホストを選択し、次に Next をクリックします。

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

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

手順

1. 管理ポータルで、Compute Clusters をクリックします。
2. 変更を行うクラスターを選択し、Edit をクリックします。
3. General タブで Compatibility Version を必要な値に変更します。
4. OK をクリックします。Change Cluster Compatibility Version の確認ダイアログが開きます。
5. OK をクリックして確定します。

手順

1. 管理ポータルで Compute Virtual Machines をクリックします。

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

   next_run_config_exists=True

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

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

手順

1. 管理ポータルで Compute Data Centers をクリックします。
2. 変更を行うデータセンターを選択し、Edit をクリックします。
3. Compatibility Version を必要な値に変更します。
4. OK をクリックします。Change Data Center Compatibility Version の確認ダイアログが開きます。
5. OK をクリックして確定します。

1. Manager マシンに root ユーザーとしてログインします。

2. /etc/pki/ovirt-engine/openssl.conf に default_md = sha256 の行が含まれているかどうかを確認します。

   # cat /etc/pki/ovirt-engine/openssl.conf

   default_md = sha1 が依然として含まれている場合は、既存の設定をバックアップし、デフォルトを sha256 に変更します。

   # cp -p /etc/pki/ovirt-engine/openssl.conf /etc/pki/ovirt-engine/openssl.conf."$(date +"%Y%m%d%H%M%S")"
   # sed -i 's/^default_md = sha1/default_md = sha256/' /etc/pki/ovirt-engine/openssl.conf

3. 署名し直す必要のある証明書を定義します。

   # names="apache"

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

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

5. Manager で、/etc/ovirt-engine/engine.conf.d ディレクトリーと /etc/pki/ovirt-engine ディレクトリーのバックアップを保存し、証明書を再署名します。

   # . /etc/ovirt-engine/engine.conf.d/10-setup-protocols.conf
   # for name in $names; do
       subject="$(
           openssl \
               x509 \
               -in /etc/pki/ovirt-engine/certs/"${name}".cer \
               -noout \
               -subject \
               -nameopt compat \
           | sed \
               's;subject=\(.*\);\1;' \
       )"
      /usr/share/ovirt-engine/bin/pki-enroll-pkcs12.sh \
           --name="${name}" \
           --password=mypass \ <1>
           --subject="${subject}" \
           --san=DNS:"${ENGINE_FQDN}" \
           --keep-key
   done

   このパスワード値を変更しないでください。

6. httpd サービスを再起動します。

   # systemctl restart httpd

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

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

8. 管理ポータルに接続して、警告が表示されなくなったことを確認します。
9. 以前に CA または https 証明書をブラウザーにインポートしている場合は、その証明書を探してブラウザーから削除し、新しい CA 証明書をインポートし直します。ブラウザーから提供される手順に従って、認証局の証明書をインストールしてください。認証局の証明書を取得するには、http://your-manager-fqdn/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA に移動し、your-manager-fqdn を完全修飾ドメイン名 (FQDN) に置き換えます。

1. Manager マシンに root ユーザーとしてログインします。

2. /etc/pki/ovirt-engine/openssl.conf に default_md = sha256 の行が含まれているかどうかを確認します。

   # cat /etc/pki/ovirt-engine/openssl.conf

   default_md = sha1 が依然として含まれている場合は、既存の設定をバックアップし、デフォルトを sha256 に変更します。

   # cp -p /etc/pki/ovirt-engine/openssl.conf /etc/pki/ovirt-engine/openssl.conf."$(date +"%Y%m%d%H%M%S")"
   # sed -i 's/^default_md = sha1/default_md = sha256/' /etc/pki/ovirt-engine/openssl.conf

3. CA 証明書のバックアップを作成して ca.pem.new に新しい証明書を作成し、CA 証明書を署名し直します。

   # cp -p /etc/pki/ovirt-engine/private/ca.pem /etc/pki/ovirt-engine/private/ca.pem."$(date +"%Y%m%d%H%M%S")"
   # openssl x509 -signkey /etc/pki/ovirt-engine/private/ca.pem -in /etc/pki/ovirt-engine/ca.pem -out /etc/pki/ovirt-engine/ca.pem.new -days 3650 -sha256

4. 既存の証明書を新しい証明書に置き換えます。

   # mv /etc/pki/ovirt-engine/ca.pem.new /etc/pki/ovirt-engine/ca.pem

5. 署名し直す必要のある証明書を定義します。

   # names="engine apache websocket-proxy jboss imageio-proxy"

   アップグレード後に Red Hat Virtualization Manager SSL 証明書を置き換えている場合は、上記のコマンドの代わりに以下のコマンドを実行します。

   # names="engine websocket-proxy jboss imageio-proxy"

   詳細は、管理ガイド の Red Hat Virtualization Manager CA 証明書の置き換え を参照してください。

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

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

7. Manager で、/etc/ovirt-engine/engine.conf.d ディレクトリーと /etc/pki/ovirt-engine ディレクトリーのバックアップを保存し、証明書を再署名します。

   # . /etc/ovirt-engine/engine.conf.d/10-setup-protocols.conf
   # for name in $names; do
       subject="$(
           openssl \
               x509 \
               -in /etc/pki/ovirt-engine/certs/"${name}".cer \
               -noout \
               -subject \
               -nameopt compat \
           | sed \
               's;subject=\(.*\);\1;' \
       )"
      /usr/share/ovirt-engine/bin/pki-enroll-pkcs12.sh \
           --name="${name}" \
           --password=mypass \ <1>
           --subject="${subject}" \
           --san=DNS:"${ENGINE_FQDN}" \
           --keep-key
   done

   このパスワード値を変更しないでください。

8. 以下のサービスを再起動します。

   # systemctl restart httpd
   # systemctl restart ovirt-engine
   # systemctl restart ovirt-websocket-proxy
   # systemctl restart ovirt-imageio

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

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

10. 管理ポータルに接続して、警告が表示されなくなったことを確認します。
11. 以前に CA または https 証明書をブラウザーにインポートしている場合は、その証明書を探してブラウザーから削除し、新しい CA 証明書をインポートし直します。ブラウザーから提供される手順に従って、認証局の証明書をインストールしてください。認証局の証明書を取得するには、http://your-manager-fqdn/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA に移動し、your-manager-fqdn を完全修飾ドメイン名 (FQDN) に置き換えます。

12. ホストで証明書を登録します。それぞれのホストについて以下の手順を繰り返します。

    1. 管理ポータルで Compute Hosts をクリックします。
    2. ホストを選択し、Management Maintenance をクリックしてから OK をクリックします。
    3. ホストがメンテナンスモードに変わったら、Installation Enroll Certificate をクリックします。
    4. Management Activate をクリックします。