第6章 セルフホストエンジンのアップグレード

手順

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

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

2. 次の手順に進む前に、環境がメンテナンスモードにあることを確認します。

   # hosted-engine --vm-status

手順

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

   # engine-upgrade-check

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

   # yum update rhevm-setup

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

   # engine-setup

   注記

   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

   重要

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

手順

1. 現在 SPM に設定されており、Manager 用仮想マシンを含むホストで、Red Hat Virtualization 4.0 に必要なリポジトリーを有効にします。

   # subscription-manager repos --enable=rhel-7-server-rhv-4-mgmt-agent-rpms

2. Manager 用仮想マシン以外の仮想マシンをすべてを別のホストに移行します。

3. ホストで Manager 用仮想マシンのパッケージを更新します。

   # yum update ovirt-hosted-engine-setup rhevm-appliance

   rhevm-appliance パッケージがない場合には、ovirt-hosted-engine-setup を更新する前に手動でパッケージをインストールします。

   # yum install rhevm-appliance
   # yum update ovirt-hosted-engine-setup

4. アップグレードユーティリティーを実行して、Manager 用仮想マシンをアップグレードします。標準の Red Hat Enterprise Linux リポジトリーで入手可能な screen パッケージがインストールされていない場合は、パッケージをインストールします。

   # yum install screen
   # screen
   # hosted-engine --upgrade-appliance

   アプライアンスが複数検出された場合にはアプライアンスを選択し、Manager データベースのバックアップを作成してその完全パスを指定するように求められます。

手順

1. Red Hat Virtualization Manager 4.1 と Red Hat Virtualization Tools のリポジトリーを有効にします。

   # subscription-manager repos --enable=rhel-7-server-rhv-4.1-rpms
   # subscription-manager repos --enable=rhel-7-server-rhv-4-tools-rpms

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

   # yum update ovirt\*setup\*

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

   # engine-setup

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

   # subscription-manager repos --disable=rhel-7-server-rhv-4.0-rpms

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

   # yum update

   重要

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

手順

1. Red Hat Virtualization Manager 4.2、Red Hat Virtualization Tools、および Ansible Engine のリポジトリーを有効にします。

   # subscription-manager repos --enable=rhel-7-server-rhv-4.2-manager-rpms
   # subscription-manager repos --enable=rhel-7-server-rhv-4-manager-tools-rpms
   # subscription-manager repos --enable=rhel-7-server-ansible-2-rpms

   重要

   Red Hat Virtualization Manager 4.2 では、Red Hat JBoss Enterprise Application Platform (JBoss EAP) 7.1 を Manager マシンにインストールする必要があります。jb-eap-7-for-rhel-7-server-rpms リポジトリーが有効であること、および jb-eap-7.0-for-rhel-7-server-rpms リポジトリーを無効であることを確認してください。どちらのリポジトリーが有効であるかを確認するには、subscription-manager repos --list を実行します。

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

   # yum update ovirt\*setup\*

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

   # engine-setup

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

   # subscription-manager repos --disable=rhel-7-server-rhv-4.1-rpms
   # subscription-manager repos --disable=rhel-7-server-rhv-4.1-manager-rpms
   # subscription-manager repos --disable=rhel-7-server-rhv-4-tools-rpms

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

   # yum update

   重要

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

手順

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

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

2. 環境が稼働していることを確認します。

   # hosted-engine --vm-status

手順

1. 「What channels should be used for RHEV 3.6 ELS?」の説明に従って Red Hat Enterprise Linux ホストをバージョン 7.3 に設定している場合は、更新する前に通常の RHEL 7 バージョンに再設定する必要があります。subscription-manager release --show を実行して、バージョン 7.3 に設定されているかどうかを確認することができます。

   # subscription-manager release --set=7Server

2. 現在のリポジトリーを無効にします。

   # subscription-manager repos --disable=*

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

   • Red Hat Virtualization Host の場合:

     # subscription-manager repos --enable=rhel-7-server-rhvh-4-rpms

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

     # subscription-manager repos --enable=rhel-7-server-rpms
     # subscription-manager repos --enable=rhel-7-server-rhv-4-mgmt-agent-rpms
     # subscription-manager repos --enable=rhel-7-server-ansible-2-rpms

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

5. インストール アップグレードを確認 をクリックし、OK をクリックします。

   イベントおよびアラートの通知 アイコン ( ) をクリックし、イベント セクションを展開して結果を確認します。

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

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

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

   • Maintenance
   • Installing
   • Reboot

   • Up

     このホストから別のホストに移行していた仮想マシンがあれば、この時点で元に戻すことができます。

     注記

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

手順

1. コンピュート クラスター をクリックし、変更するクラスターを選択します。
2. 編集 をクリックします。
3. 互換バージョン を必要な値に変更します。
4. OK をクリックして、クラスターの互換バージョンを変更 の確認ウィンドウを開きます。
5. OK をクリックして確定します。

手順

1. コンピュート データセンター をクリックし、変更するデータセンターを選択します。
2. 編集 をクリックします。
3. 互換バージョン を必要な値に変更します。
4. OK をクリックして、データセンターの互換バージョンを変更 の確認ウィンドウを開きます。
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 で Apache 証明書を署名し直します。

   for name in $names; do
       subject="$(
           openssl \
               x509 \
               -in /etc/pki/ovirt-engine/certs/"${name}".cer \
               -noout \
               -subject \
           | sed \
               's;subject= \(.*\);\1;' \
       )"
      /usr/share/ovirt-engine/bin/pki-enroll-pkcs12.sh \
           --name="${name}" \
           --password=mypass \
           --subject="${subject}" \
           --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 の SSL/TLS 証明書の変更」を参照してください。

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

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

7. Manager で証明書を署名し直します。

   for name in $names; do
      subject="$(
           openssl \
               x509 \
               -in /etc/pki/ovirt-engine/certs/"${name}".cer \
               -noout \
               -subject \
           | sed \
               's;subject= \(.*\);\1;' \
           )"
        /usr/share/ovirt-engine/bin/pki-enroll-pkcs12.sh \
               --name="${name}" \
               --password=mypass \
               --subject="${subject}" \
               --keep-key
   done

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

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

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. 管理ポータルで コンピュート ホスト をクリックします。
    2. ホストを選択し、管理 メンテナンス をクリックします。
    3. ホストがメンテナンスモードに変わったら、インストール 証明書を登録 をクリックします。
    4. 管理 アクティブ化 をクリックします。