アップグレードガイド

Red Hat Virtualization 4.0

Red Hat Virtualization の更新およびアップグレード作業

Red Hat Virtualization Documentation Team

Red Hat Customer Content Services

概要

Red Hat Virtualization 環境でコンポーネントをアップグレードおよび更新するための総合ガイド

第1章 Red Hat Virtualization 環境の更新

1.1. 更新についての概要

本ガイドでは、Red Hat Virtualization 環境を次のマイナーリリースに更新する方法および次のメジャーバージョンにアップグレードする方法について説明します。次のメジャーバージョンへのアップグレードは、Red Hat Enterprise Virtualization Manager の現在のバージョンを最新のマイナーバージョンに必ず更新してから行ってください。
対話式のアップグレードの説明については、https://access.redhat.com/labs/rhevupgradehelper/ の RHEV Upgrade Helper を利用することもできます。このアプリケーションに、アップグレードパスおよび現在の環境についての情報を入力すると、適切なアップグレード手順と、アップグレードシナリオ固有の既知の問題を回避する手順が表示されます。
Red Hat Virtualization Manager のアップグレードの主要な手順

  • 適切なエンタイトルメントのサブスクライブ
  • システムの更新
  • engine-setup の再実行
  • 不要となったリポジトリーの削除
RHVH および RHEL ホストの更新

ホストは、ホストの更新が利用できるかを確認して通知する Red Hat Virtualization Manager から直接アップグレードできます。

クラスターおよびデータセンターの互換レベル

アップグレード自体の実行に使用するコマンドは、対話型インターフェースを提供する engine-setup です。アップグレード中は、仮想化ホストと、その仮想化ホストで実行中の仮想マシンはアップグレードとは無関係に稼働を継続します。アップグレードが完了したら、ホストを最新版の Red Hat Enterprise Linux または Red Hat Virtualization Host にアップグレードすることができます。

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

2.1. Red Hat Virtualization Manager の更新

Red Hat Virtualization Manager の更新はコンテンツ配信ネットワーク (CDN) 経由でリリースされます。コンテンツ配信ネットワークから更新をインストールする前に、その更新に関連するアドバイザリーと、カスタマーポータル に掲載の最新版の『Red Hat Virtualization Manager リリースノート』および『Red Hat Virtualization Technical Notes』を必ずお読みください。

手順2.1 Red Hat Virtualization Manager の更新

  1. Red Hat Virtualization Manager マシンで、更新パッケージが利用可能かどうかを確認します。 
    # engine-upgrade-check
    • 更新がない場合には、コマンドは No upgrade というテキストを出力します。 
      # engine-upgrade-check
VERB: queue package ovirt-engine-setup for update
VERB: package ovirt-engine-setup queued
VERB: Building transaction
VERB: Empty transaction
VERB: Transaction Summary:
No upgrade

      注記

      更新があるにも拘らず、入手できない場合には、必要なリポジトリーが有効化されていることを確認してください。『インストールガイド』の「必要なエンタイトルメントのサブスクライブ」を参照してください。
    • 更新が利用可能な場合には、コマンドが更新すべきパッケージを一覧表示します。 
      # engine-upgrade-check
VERB: queue package ovirt-engine-setup for update
VERB: package ovirt-engine-setup queued
VERB: Building transaction
VERB: Transaction built
VERB: Transaction Summary:
VERB:     updated    - ovirt-engine-lib-3.3.2-0.50.el6ev.noarch
VERB:     update     - ovirt-engine-lib-3.4.0-0.13.el6ev.noarch
VERB:     updated    - ovirt-engine-setup-3.3.2-0.50.el6ev.noarch
VERB:     update     - ovirt-engine-setup-3.4.0-0.13.el6ev.noarch
VERB:     install    - ovirt-engine-setup-base-3.4.0-0.13.el6ev.noarch
VERB:     install    - ovirt-engine-setup-plugin-ovirt-engine-3.4.0-0.13.el6ev.noarch
VERB:     updated    - ovirt-engine-setup-plugins-3.3.1-1.el6ev.noarch
VERB:     update     - ovirt-engine-setup-plugins-3.4.0-0.5.el6ev.noarch
Upgrade available

Upgrade available
  3. ovirt-engine-setup パッケージを更新します。 
    # yum update ovirt-engine-setup
  4. Red Hat Virtualization Manager を更新します。engine-setup を実行すると、スクリプトは、ファイアウォールルールや PKI 証明書の更新、Data Warehouse データベースのバックアップなどの設定に関する質問を尋ねます。次にスクリプトは、ovirt-engine サービスの停止、更新パッケージのダウンロード/インストール、データベースのバックアップ/更新、インストール後の設定の段階を経てから、ovirt-engine サービスを起動します。

    注記

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

重要

更新プロセスには時間がかかる場合があるため、更新プロセスが完了するまでの時間を計算に入れて、一旦更新を開始したらプロセスを停止しないようにしてください。

2.2. ホストの更新

ホストのアップグレードマネージャーを使用して、Red Hat Virtualization Manager から直接個別のホストを更新します。更新マネージャーは、ホストの更新で利用できるものかあるかを確認して通知し、ホストをメンテナンスモードに切り替えて、パッケージを更新し、ホストを稼動状態に戻すプロセスを自動化することにより、ホストの更新の所要時間を短縮します。ホストが多くある大規模なデプロイメントでは、このようにプロセスを自動化すると大幅に時間を節約することができます。
Red Hat Enterprise Linux ホストでは、デフォルトでアップグレードマネージャーが Red Hat Virtualization パッケージに更新があるかどうかを確認します。システム設定の値「UserPackageNamesForCheckUpdate」で追加のパッケージを指定してアップグレードマネージャーにより更新の有無が監視されるようにすることができます。この値に、ワイルドカードを指定することができます。以下のように、Manager マシンで engine-config コマンドを実行します。 
# engine-config -m UserPackageNamesForCheckUpdate=vdsm-hook-ethtool-options

警告

オペレーティングシステムのセキュリティー修正などのその他の更新については、「ホストの手動更新」で記載されているように yum update を使用して Red Hat Enterprise Linux ホストを手動で更新する必要があります。
Red Hat Virtualization Host (RHVH) の場合は、アップグレードマネージャーは RHVH イメージの更新があるかを確認します。個別のパッケージではなく RHVH イメージ自体が更新されるため、他のパッケージを更新するための yum update を手動で実行する必要はありません。更新時には /etc および /var のディレクトリーで変更された内容のみが保存されます。他のパスに含まれる変更データは更新時にすべて置き換えられます。
アップグレードマネージャーは、デフォルトでは 24 時間間隔で更新をチェックします。HostPackagesUpdateTimeInHours の設定値でこの設定を変更することが可能です。Manager マシンで engine-config コマンドを実行します。以下に例を示します。 
# engine-config -s HostPackagesUpdateTimeInHours=48
クラスターレベルで移行が有効化されている場合には、仮想マシンはそのクラスター内の別のホストに自動的に移行されるので、ホストの更新は、ホストの使用率が比較的に低い時間帯に実行することを推奨します。
ホストが属するクラスターには、ホストがメンテナンスを実行するのに十分なメモリーが確保されていることを確認してください。クラスターに十分なメモリーがない場合には、仮想マシンの移行操作がハングして失敗してしまいます。ホストを更新する前に一部またはすべての仮想マシンをシャットダウンしておくと、この操作のメモリー使用量を低減することができます。

重要

更新の前に、クラスターに複数のホストが含まれていることを確認します。全ホストを同時に更新しないようにしてください。Storage Pool Manager (SPM) のタスクを実行するために、ホストが 1 台使用可能である必要があります。

手順2.2 Red Hat Enterprise Linux ホストおよび Red Hat Virtualization Host の更新

  1. 管理ポータルで ホスト タブをクリックして、更新するホストを選択します。
    • ホストに更新が必要な場合には、アクション項目 の欄に警告のメッセージとホスト名の横にアイコンが表示され、新しいバージョンが入手できることが通知されます。
    • ホストの更新が必要でない場合には、警告メッセージやアイコンは表示されず、これ以外の操作は必要ありません。
  2. アップグレード をクリックすると、ホストのアップグレード の確認のウィンドウが開きます。
  3. OK をクリックしてホストを更新します。ホスト タブにホストの情報が更新され、ステータスが以下の順序で変わります。
    • Maintenance
    • Installing
    • Up
更新が正常に完了すると、ホストは Up のステータスで表示されます。この時点で、このホストから別のホストに移行されていた仮想マシンは、元に戻すことができます。Red Hat Virtualization 環境内の各ホストで更新の手順を繰り返してください。

注記

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

2.3. ホストの手動更新

Red Hat Enterprise Linux ホストは、通常の Red Hat Enterprise Linux システムと同様に yum コマンドを使用します。Red Hat Virtualization Host (RHVH) は yum コマンドを使用して更新を行いますが、追加パッケージのインストールは現在サポートされていません。yum で定期的にシステムを更新して、セキュリティーやバグ修正がタイムリーに適用されるようにすることを強く推奨します。ホストの更新の手順には、ホストの停止と再起動が含まれます。クラスターレベルで移行が有効に設定されている場合は、仮想マシンは自動的にクラスター内の別のホストに移行されるので、ホストの更新は、ホストの使用率が比較的低い時間帯に実行することを推奨します。
ホストが属するクラスターには、ホストがメンテナンスを実行するのに十分なメモリーが確保されている必要があります。メモリーが十分に確保されていないクラスターで稼働中の仮想マシンがあるホストをメンテナンスに切り替えると、仮想マシンの移行の操作はいずれもハングして、失敗してしまいます。ホストをメンテナンスに切り替える前に、一部またはすべての仮想マシンをシャットダウンしておくと、この操作のメモリー使用量を削減することができます。

重要

更新の前に、クラスターに複数のホストが含まれていることを確認します。全ホストを同時に更新しないようにしてください。Storage Pool Manager (SPM) のタスクを実行するために、ホストが 1 台使用可能である必要があります。

手順2.3 ホストの手動更新

  1. 管理ポータルで ホスト タブをクリックして、更新するホストを選択します。
  2. メンテナンス をクリックして、ホストをメンテナンスモードに切り替えします。
    • Red Hat Enterprise Linux ホストの場合は、ホストマシンにログインして以下のコマンドを実行します。 
      # yum update
    • Red Hat Virtualization Host の場合は Cockpit ユーザーインターフェースにログインして、Tools > Terminal をクリックして以下のコマンドを実行します。 
      # yum update
  4. すべての更新が正常に適用されるように、ホストを再起動します。
Red Hat Virtualization 環境内のホストごとに同じ手順を繰り返してください。

第3章 Red Hat Virtualization 4.0 へのアップグレード

3.1. Red Hat Virtualization 4.0 へのアップグレードに関する考慮事項

アップグレードを計画するにあたっての主要な考慮事項を以下に記載します。

重要

バージョン 4.0 へのアップグレードを実行できるのは、バージョン 3.6 からのみです。
Red Hat Enterprise Virtualization 3.6 よりも前のバージョンから 4.0 にアップグレードするには、1 バージョンずつ順番にアップグレードを進めてから最新版にアップグレードする必要があります。たとえば、Red Hat Enterprise Virtualization 3.5 を使用している場合は、まず 3.6 の最新のマイナーバージョンにアップグレードしてから Red Hat Virtualization 4.0 にアップグレードする必要があります。最新の 3.6 マイナーバージョンへのアップグレードに関する説明は、Red Hat Enterprise Virtualization 3.6 の『アップグレードガイド』を参照してください。
データセンターおよびクラスターの互換バージョンが 3.6 でなければ、アップグレードを実行できません。
Red Hat Virtualization Manager 4.0 は、Red Hat Enterprise Linux 7.2 での実行がサポートされています。
バージョン 4.0 へのアップグレードには、Manager をホストするマシンのベースオペレーティングシステムのアップグレードも含まれます。

3.2. Red Hat Virtualization Manager 4.0 へのアップグレード

Red Hat Virtualization Manager 4.0 は、Red Hat Enterprise Linux 7 でのみサポートされます。Red Hat Enterprise Virtualization Manager 3.6 を実行していたのと同じ物理マシンを使用する場合でも、Red Hat Enterprise Linux 7 と Red Hat Virtualization Manager 4.0 をクリーンインストールする必要があります。アップグレードのプロセスでは、Red Hat Enterprise Virtualization Manager 3.6 のバックアップファイルを Red Hat Virtualization Manager 4.0 マシンに復元します。
Manager をアップグレードした後にはホストをアップグレードします。「2章マイナーリリース間の更新」を参照してください。次に、クラスターの互換レベルを 4.0 に更新してください。方法は「4章アップグレード後のタスク」を参照してください。

注記

Manager のアップグレード中も、接続されているホストおよび仮想マシンは稼働し続けることが可能です。
アップグレード後の Manager の IP アドレスまたは FQDN が以前とは異なる場合には、ovirt-engine-rename を使用して Manager の名前を変更してください。
ovirt-engine-extension-aaa-ldap、ovirt-engine-extension-aaa-misc または ovirt-engine-extension-logger-log4j などのオプションの拡張パッケージが Red Hat Enterprise Virtualization Manager 3.6 にインストールされている場合には、engine-setup を実行する前に、アップグレードした Manager マシンにこれらのパッケージをインストールする必要があります。これらのパッケージの拡張機能の設定は、アップグレードの際には移行されません。

手順3.1 Red Hat Virtualization Manager 4.0 へのアップグレード

  1. Red Hat Enterprise Virtualization Manager 3.6 で、環境をバックアップします。 
    # engine-backup --scope=all --mode=backup --file=backup.bck --log=backuplog.log
  2. バックアップファイルを適切なデバイスにコピーします。
  3. Red Hat Enterprise Linux 7 をインストールします。詳しい情報は『Red Hat Enterprise Linux インストールガイド』を参照してください。
  4. Red Hat Virtualization Manager 4.0 をインストールします。『Red Hat Virtualization インストールガイド』を参照してください。
  5. バックアップしたファイルを Red Hat Virtualization Manager 4.0 マシンにコピーして、バックアップを復元します。 
    # engine-backup --mode=restore --file=backup.bck --log=restore.log --provision-db --provision-dwh-db --no-restore-permissions

    注記

    バックアップに Data Warehouse データが含まれる場合には、--provision-dwh-db オプションを使用します。
    Reports は Red Hat Virtualization 4.0 で非推奨になり、engine-backup で復元されなくなりました。詳しい情報は BZ#1340810 を参照してください。
  6. オプションの拡張パッケージが Red Hat Enterprise Virtualization Manager 3.6 マシンにインストールされていた場合にはインストールしてください。 
    # yum install ovirt-engine-extension-aaa-ldap ovirt-engine-extension-aaa-misc ovirt-engine-extension-logger-log4j

    注記

    これらのパッケージの拡張機能の設定は、バックアップと復元のプロセス中に移行されないため、手動で再度適用する必要があります。
  7. Red Hat Virtualization Manager 4.0 で別のマシンを使用する場合には、Red Hat Enterprise Virtualization Manager 3.6 マシンの使用を停止してください。
  8. engine-setup を実行して Manager を設定します。 
    # engine-setup
  9. IP アドレスまたは FQDN が Red Hat Enterprise Virtualization 3.6 と異なる場合は ovirt-engine-rename を実行して Manager の名前を変更し、プロンプトに従って新しい情報を設定します。 
    # /usr/share/ovirt-engine/setup/bin/ovirt-engine-rename

注記

HTTPS 証明書の署名に外部の CA を使用する場合には、BZ#1336838 の手順に従い、アップグレード後に管理ポータルにログインしてください。virt-viewer の外部メニューが機能するように、全クライアントで CA 証明書がシステム全体のトラストストアに追加されるようにしてください。詳しい情報は BZ#1313379 を参照してください。
環境内の Red Hat Enterprise Linux ホストを更新する前に、更新するホスト上で以下のコマンドを実行し、バージョン 3.6 のリポジトリーを無効にして必要な 4.0 リポジトリーを有効にします。 
# subscription-manager repos --disable=*
# subscription-manager repos --enable=rhel-7-server-rhv-4-mgmt-agent-rpms
RHEV-H ホストは RHVH 4.0 にインストールしなおす必要があります。『インストールガイド』の「Red Hat Virtualization Host」を参照します。
次に、ホストを更新して、クラスターとデータセンターの互換バージョンを 4.0 に変更してください。

3.3. セルフホストエンジンのアップグレード

Red Hat Enterprise Linux ベースのセルフホストエンジン環境をアップグレードするには、『セルフホストエンジンガイド』の「リソースのメンテナンスおよびアップグレード」を参照してください。
『セルフホストエンジンガイド』の「リソースのメンテナンスおよびアップグレード」を参照してください。

第4章 アップグレード後のタスク

4.1. クラスターの互換バージョンの変更

Red Hat Virtualization のクラスターには互換バージョンがあります。クラスターの互換バージョンは、そのクラスター内の全ホストがサポートする Red Hat Virtualization の機能を示します。クラスターの互換バージョンは、そのクラスター内で最も機能性の低いホストのバージョンに応じて設定されます。

注記

クラスターの互換バージョンを変更するには、まず、クラスター内の全ホストを更新して、必要な互換性レベルをサポートするレベルにする必要があります。

手順4.1 クラスターの互換バージョンの変更

  1. 管理ポータルで クラスター タブをクリックします。
  2. 表示された一覧の中から、変更するクラスターを選択します。
  3. 編集 をクリックします。
  4. 互換バージョン を必要な値に変更します。
  5. OK をクリックして、クラスターの互換バージョンを変更 の確認ウィンドウを開きます。
  6. OK をクリックして確定します。
クラスターの互換バージョンが更新されました。データセンター内の全クラスターの互換バージョンの更新が完了したら、次にデータセンター自体の互換バージョンも変更することができます。

4.2. データセンターの互換バージョンの変更

Red Hat Virtualization データセンターには、互換バージョンがあります。互換バージョンとは、データセンターと互換性のある Red Hat Virtualization のバージョンを指します。データセンター内のクラスターはすべて、指定の互換性レベルをサポートします。

注記

データセンターの互換バージョンを変更するには、まず最初に、データセンター内の全クラスターを更新して、必要な互換性レベルをサポートするレベルにしておく必要があります。

手順4.2 データセンターの互換バージョンの変更

  1. 管理ポータルで データセンター タブをクリックします。
  2. 表示された一覧の中から、変更するデータセンターを選択します。
  3. 編集 をクリックします。
  4. 互換バージョン を必要な値に変更します。
  5. OK をクリックして、データセンターの互換バージョンを変更 の確認ウィンドウを開きます。
  6. OK をクリックして確定します。
データセンターの互換バージョンが更新されました。

付録A オフラインの Red Hat Virtualization Manager の更新

A.1. Red Hat Virtualization Manager をオフラインでインストールするためのローカルリポジトリーの更新

ローカルリポジトリーから FTP 経由でパッケージを受信するシステム上に Red Hat Virtualization Manager がホストされている場合には、そのリポジトリーを定期的に同期してコンテンツ配信ネットワークからパッケージをダウンロードしてから、Manager システムの更新またはアップグレードを行う必要があります。更新パッケージは、セキュリティー問題、バグ修正、拡張機能の追加に対応します。
  1. リポジトリーをホストするシステムで、リポジトリーを同期して利用可能な各パッケージの最新バージョンをダウンロードします。 
    # reposync -l --newest-only /var/ftp/pub/rhevrepo
    このコマンドを実行すると、多数のパッケージがダウンロードされて完了に長時間を要する場合があります。
  2. Manager システムでリポジトリーが利用可能であることを確認してから、Manager システムを更新/アップグレードします。マイナーバージョン間での Manager 更新についての情報は「Red Hat Virtualization Manager の更新」を、メジャーバージョン間のアップグレードについての情報は「更新についての概要」を参照してください。

法律上の通知

Copyright © 2016 Red Hat.
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.