アップグレードガイド
Red Hat Virtualization の更新およびアップグレード作業
概要
第1章 Red Hat Virtualization 環境の更新
1.1. 更新の概要
Red Hat Virtualization Manager をアップグレードするには、以下の主要な手順が必要です。
- 適切なエンタイトルメントにサブスクライブします。
- システムの更新
- engine-setup の実行
- リポジトリーの削除は不要になりました。
RHVH および RHEL ホストを更新します。
ホストは、利用可能なホストの更新を確認し、通知する Red Hat Virtualization Manager から直接アップグレードできます。
クラスターとデータセンターの互換性レベルを更新します。
第2章 マイナーリリース間の更新
2.1. Red Hat Virtualization Manager の更新
手順2.1 Red Hat Virtualization Manager の更新
- Red Hat Virtualization Manager マシンで、更新されたパッケージが利用可能かどうかを確認します。
engine-upgrade-check
# engine-upgrade-check
Copy to Clipboard Copied! - 利用可能な更新がない場合は、このコマンドにより
No upgrade
:engine-upgrade-check
# 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
Copy to Clipboard Copied! 注記更新が予想されるものの、利用できない場合は、必要なリポジトリーが有効になっていることを確認します。『インストールガイド』 の 必要なエンタイトルメントへのサブスクライブ を参照してください。 - 更新が利用可能な場合は、このコマンドにより、更新するパッケージが一覧表示されます。
engine-upgrade-check
# 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
Copy to Clipboard Copied!
- ovirt-engine-setup パッケージを更新します。
yum update ovirt-engine-setup
# yum update ovirt-engine-setup
Copy to Clipboard Copied! - 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
# engine-setup
Copy to Clipboard Copied! 重要更新プロセスには時間がかかる場合があります。更新プロセスが完了するまで時間がかかる可能性があり、開始後にプロセスを停止しないでください。 - Manager にインストールされているベースオペレーティングシステムと、オプションパッケージを更新します。
yum update
# yum update
Copy to Clipboard Copied! 重要カーネルパッケージが更新された場合は、システムを再起動して更新を完了してください。
2.2. ホストの更新
UserPackageNamesForCheckUpdate
を使用して更新を監視するアップグレードマネージャーの追加パッケージを指定できます。Manager マシンで engine-config コマンドを実行します。以下に例を示します。
engine-config -m UserPackageNamesForCheckUpdate=vdsm-hook-ethtool-options
# engine-config -m UserPackageNamesForCheckUpdate=vdsm-hook-ethtool-options
Red Hat Virtualization Host 7
リポジトリーを有効にした場合、アップグレードマネージャーは yum check-update
を使用して RHVH イメージへの更新を自動的に確認します。このリポジトリーには redhat-virtualization-host-image-update
パッケージが含まれており、このパッケージはイメージを更新します。詳細は、『インストールガイドの Red Hat Virtualization Host のインストール』 を参照してください。
/etc
ディレクトリーおよび /var
ディレクトリーのみが変更された内容が保持されます。更新時に、他のパスで変更されたデータは完全に置き換えられます。
HostPackagesUpdateTimeInHours
設定値を使用して変更できます。Manager マシンで engine-config コマンドを実行します。以下に例を示します。
engine-config -s HostPackagesUpdateTimeInHours=48
# engine-config -s HostPackagesUpdateTimeInHours=48
HostPackagesUpdateTimeInHours
設定値を使用して、定期的なホストアップグレードチェックを無効にできます。Satellite でホストを管理する場合など、自動アップグレードチェックが常に必要になるとは限りません。Manager マシンで engine-config コマンドを実行します。
engine-config -s HostPackagesUpdateTimeInHours=0
# engine-config -s HostPackagesUpdateTimeInHours=0
subscription-manager repos --disable=rhel-7-server-rhevh-rpms subscription-manager repos --enable=rhel-7-server-rhvh-4-rpms
# subscription-manager repos --disable=rhel-7-server-rhevh-rpms
# subscription-manager repos --enable=rhel-7-server-rhvh-4-rpms
手順2.2 Red Hat Enterprise Linux ホストと Red Hat Virtualization ホストの更新
- ホスト タブを クリック して、更新するホストを選択します。
- ホストに更新が必要な場合は、Action Items の下のアラートメッセージと、ホスト名の横にあるアイコンは新規バージョンが利用可能であることを示します。
- ホストに更新が必要ない場合は、アラートメッセージやアイコンは表示されません。それ以上のアクションは必要ありません。
- Upgrade の確認ウィンドウを開きます。→ +
- OK をクリックしてアップグレードチェックを開始します。
- ホストをアップグレードする場合は、Upgrade の確認ウィンドウを開きます。→ +
- メンテナーンス
- インストール
- Up
2.3. ホストの手動更新
subscription-manager repos --disable=rhel-7-server-rhevh-rpms subscription-manager repos --enable=rhel-7-server-rhvh-4-rpms
# subscription-manager repos --disable=rhel-7-server-rhevh-rpms
# subscription-manager repos --enable=rhel-7-server-rhvh-4-rpms
手順2.3 ホストの手動更新
- 管理ポータルから ホスト タブをクリックして、更新するホストを選択します。
- Red Hat Enterprise Linux ホストで、ホストマシンにログインし、以下のコマンドを実行します。
yum update
# yum update
Copy to Clipboard Copied! - Red Hat Virtualization Host で、Cockpit ユーザーインターフェイスにログインし、Tools > Terminal をクリックして以下のコマンドを実行します。
yum update
# yum update
Copy to Clipboard Copied!
- ホストを再起動して、すべての更新が正しく適用されていることを確認します。
第3章 Red Hat Virtualization 4.0 へのアップグレード
3.1. Red Hat Virtualization 4.0 のアップグレードに関する考慮事項
- バージョン 4.0 へのアップグレードは、バージョン 3.6 からのみ実行できます。
- 3.6 より前のバージョンの Red Hat Enterprise Virtualization を Red Hat Virtualization 4.0 にアップグレードするには、最新バージョンにアップグレードする前に、新しいバージョンの Red Hat Enterprise Virtualization に順次アップグレードする必要があります。たとえば、Red Hat Enterprise Virtualization 3.5 を使用している場合は、Red Hat Virtualization 4.0 にアップグレードする前に、最新のマイナーバージョンの Red Hat Enterprise Virtualization 3.6 にアップグレードする必要があります。最新の 3. 『6 マイナーバージョンへのアップグレード手順については、Red Hat Enterprise Virtualization 3.6 のアップグレードガイド』 を参照してください。アップグレードを実行する前に、データセンターとクラスターの互換バージョンがバージョン 3.6 にあり、ホストを 4.0 以降にアップグレードする必要があります。
- Red Hat Virtualization Manager 4.0 は、Red Hat Enterprise Linux 7.2 以降での実行がサポートされています。
- バージョン 4.0 にアップグレードするには、Manager をホストするマシンのベースオペレーティングシステムもアップグレードする必要があります。
3.2. Red Hat Virtualization Manager 4.0 へのアップグレード
手順3.1 Red Hat Virtualization Manager 4.0 へのアップグレード
- Red Hat Enterprise Virtualization Manager 3.6 で、環境をバックアップします。
engine-backup --scope=all --mode=backup --file=backup.bck --log=backuplog.log
# engine-backup --scope=all --mode=backup --file=backup.bck --log=backuplog.log
Copy to Clipboard Copied! - バックアップファイルを適切なデバイスにコピーします。
- ISO ストレージドメインがエンジンと同じホスト上にある場合は、
/var/lib/exports/iso
の内容をバックアップします。cd /var/lib/exports/iso tar zcf iso_domain.tar.gz UUID
# cd /var/lib/exports/iso # tar zcf iso_domain.tar.gz UUID
Copy to Clipboard Copied! ISO ストレージのバックアップファイルは、アップグレード後に 「ISO ドメインの移行」 で復元されます。 - Install Red Hat Enterprise Linux 7.詳細は、『Red Hat Enterprise Linux インストールガイド』 を参照してください。
- Red Hat Virtualization Manager 4.0 をインストールします。『Red Hat Virtualization インストールガイド』 を参照してください。
- バックアップファイルを Red Hat Virtualization Manager 4.0 マシンにコピーし、復元します。
engine-backup --mode=restore --file=backup.bck --log=restore.log --provision-db --provision-dwh-db --restore-permissions
# engine-backup --mode=restore --file=backup.bck --log=restore.log --provision-db --provision-dwh-db --restore-permissions
Copy to Clipboard Copied! 注記バックアップに追加のデータベースユーザーへの許可が含まれる場合は、このコマンドにより、無作為にパスワードが設定された追加のユーザーが作成されます。追加のユーザーが復元したシステムにアクセスする必要がある場合は、これらのパスワードを手動で変更する必要があります。を参照してください https://access.redhat.com/articles/2686731。注記バックアップに Data Warehouse データが含まれている場合は、--provision-dwh-db オプションを使用します。レポートは Red Hat Virtualization 4.0 で非推奨となり、復元されません。詳細は、BZ#1340810 を参照してください。 - オプションの拡張機能パッケージが Red Hat Enterprise Virtualization Manager 3.6 マシンにインストールされている場合はインストールします。
yum install ovirt-engine-extension-aaa-ldap ovirt-engine-extension-aaa-misc ovirt-engine-extension-logger-log4j
# yum install ovirt-engine-extension-aaa-ldap ovirt-engine-extension-aaa-misc ovirt-engine-extension-logger-log4j
Copy to Clipboard Copied! 注記バックアップおよび復元プロセスの一部として移行されないため、これらの拡張機能パッケージの設定は手動で再適用する必要があります。 - Red Hat Virtualization Manager 4.0 に別のマシンを使用する場合は、Red Hat Enterprise Virtualization Manager 3.6 マシンの使用を停止します。
- engine-setup を実行して Manager を設定します。
engine-setup
# engine-setup
Copy to Clipboard Copied! - ovirt-engine-rename を実行して、FQDN が Red Hat Enterprise Virtualization Manager 3.6 マシンとは異なる場合にのみ Manager の名前を変更し、プロンプトに従って新しい詳細を設定します。
/usr/share/ovirt-engine/setup/bin/ovirt-engine-rename
# /usr/share/ovirt-engine/setup/bin/ovirt-engine-rename
Copy to Clipboard Copied!
subscription-manager repos --disable=rhel-7-server-rhev-mgmt-agent-rpms
# subscription-manager repos --disable=rhel-7-server-rhev-mgmt-agent-rpms
subscription-manager repos --enable=rhel-7-server-rhv-4-mgmt-agent-rpms
# subscription-manager repos --enable=rhel-7-server-rhv-4-mgmt-agent-rpms
3.3. ISO ドメインの移行
iso_domain.tar.gz
バックアップファイルを使用して、ISO ドメインを RHEV-M 3.6 から 4.0 に移行する方法を説明します。
- エクスポートディレクトリーを作成し、そのパーミッションを設定します。
mkdir -p /var/lib/exports/iso chown -R 36:36 /var/lib/exports/
# mkdir -p /var/lib/exports/iso # chown -R 36:36 /var/lib/exports/
Copy to Clipboard Copied! - ISO ドメインのバックアップをこのディレクトリーに展開します。
cd /var/lib/exports/iso tar zxf iso_domain.tar.gz
# cd /var/lib/exports/iso # tar zxf iso_domain.tar.gz
Copy to Clipboard Copied! - エクスポートディレクトリー内のファイルの SELinux コンテキストを設定します。
chcon -R system_u:object_r:public_content_rw_t:s0 /var/lib/exports/iso/
# chcon -R system_u:object_r:public_content_rw_t:s0 /var/lib/exports/iso/
Copy to Clipboard Copied! - 以下の行で
/etc/exports.d/ovirt-engine-iso-domain.exports
を作成します。/var/lib/exports/iso *(rw)
/var/lib/exports/iso *(rw)
Copy to Clipboard Copied! /etc/sysconfig/nfs
で以下の行を編集します。RPCMOUNTDOPTS="-p 892" (..snip..) STATDARGS="-p 662 -o 2020" (..snip..) LOCKD_UDPPORT=32769 LOCKD_UDPPORT=32803 RPCRQUOTAOPTS="-p 875"
RPCMOUNTDOPTS="-p 892" (..snip..) STATDARGS="-p 662 -o 2020" (..snip..) LOCKD_UDPPORT=32769 LOCKD_UDPPORT=32803 RPCRQUOTAOPTS="-p 875"
Copy to Clipboard Copied! nfs
サービスを有効にします。systemctl enable nfs systemctl start nfs
# systemctl enable nfs # systemctl start nfs
Copy to Clipboard Copied! - firewalld でサービスとポートを許可します。
firewall-cmd --add-service={nfs,rpc-bind} firewall-cmd --add-service={nfs,rpc-bind} --permanent firewall-cmd --add-port={32769/udp,32803/tcp,662/tcp,662/udp,875/tcp,875/udp,892/tcp,892/udp} firewall-cmd --add-port={32769/udp,32803/tcp,662/tcp,662/udp,875/tcp,875/udp,892/tcp,892/udp} --permanent
# firewall-cmd --add-service={nfs,rpc-bind} # firewall-cmd --add-service={nfs,rpc-bind} --permanent # firewall-cmd --add-port={32769/udp,32803/tcp,662/tcp,662/udp,875/tcp,875/udp,892/tcp,892/udp} # firewall-cmd --add-port={32769/udp,32803/tcp,662/tcp,662/udp,875/tcp,875/udp,892/tcp,892/udp} --permanent
Copy to Clipboard Copied!
3.4. ローカルストレージを保持している間に RHVH へのアップグレード
手順3.2 ローカルストレージを保持している間に RHVH へのアップグレード
- このプロセスを開始する前に、RHEV-H ホストのローカルストレージがメンテナーンスモードにあることを確認します。
- Data Centers タブを開きます。
- 詳細ペインの Storage タブをクリックし、結果一覧でストレージドメインを選択します。
- Maintenance をクリックします。
- 『インストールガイドの Red Hat Virtualization Host の インストール で説明されているように、Red Hat Virtualization Host を再インストール』 します。重要インストール 先 画面で RHVH をインストールするデバイスを選択する場合は、仮想マシンを保存するデバイスを選択しないでください。オペレーティングシステムをインストールするデバイスのみを選択します。キックスタートを使用してホストをインストールする場合は、以下をキックスタートファイルに追加し、device を関連するデバイスに置き換えて、仮想マシンを含む デバイス を保持するようにしてください。
clearpart --all --drives=device
# clearpart --all --drives=device
Copy to Clipboard Copied! キックスタートの使用方法は、『Red Hat Enterprise Linux 7 インストールガイド』 の キックスタート構文の参考 資料 を参照してください。 - 再インストールしたホストで、以前の環境を復元する
/data
などのディレクトリーを作成します。mkdir /data
# mkdir /data
Copy to Clipboard Copied! - 新しいディレクトリーに以前のローカルストレージをマウントします。この例では、
/dev/sdX1
がローカルストレージになります。mount /dev/sdX1 /data
# mount /dev/sdX1 /data
Copy to Clipboard Copied! - 新しいディレクトリーに以下のパーミッションを設定します。
chown -R 36:36 /data chmod -R 0755 /data
# chown -R 36:36 /data # chmod -R 0755 /data
Copy to Clipboard Copied! - Red Hat では、サーバーの再起動が必要となる場合に備えて、/
etc/fstab
を介してローカルストレージを自動的にマウントすることも推奨しています。blkid | grep -i sdX1 vi /etc/fstab
# blkid | grep -i sdX1 /dev/sdX1: UUID="a81a6879-3764-48d0-8b21-2898c318ef7c" TYPE="ext4" # vi /etc/fstab UUID="a81a6879-3764-48d0-8b21-2898c318ef7c" /data ext4 defaults 0 0
Copy to Clipboard Copied! - 管理ポータルでデータセンターを作成し、Storage Type ドロップダウンメニューで
Local
を選択します。 - 新しいデータセンターでクラスターを設定します。詳細は、『Administration Guide』 の Creating a New Cluster を参照してください。
- Manager にホストを追加します。詳細は、『インストールガイド』 の Red Hat Virtualization Manager へのホストの追加 を参照してください。
- ホスト上で、最初のローカルストレージドメインの作成に使用する新しいディレクトリーを作成します。たとえば、以下のような設定です。
mkdir -p /localfs chown 36:36 /localfs chmod -R 0755 /localfs
# mkdir -p /localfs # chown 36:36 /localfs # chmod -R 0755 /localfs
Copy to Clipboard Copied! - 管理ポータルで Storage タブを開き、New Domain をクリックして新しいローカルストレージドメインを作成します。
localfs
を Name に、/localfs
を Path として定義します。 - ローカルストレージが
Active
になったら、ドメインの インポート を選択し、ドメインの詳細を定義します。たとえば、Data
を Name として、Local on Host
を Storage Type に、/data
を Path として定義します。 - OK をクリックして、ストレージドメインがすでにデータセンターにアタッチされていることを知らせるメッセージが表示されることを確認します。
- 新しいストレージドメインをアクティブ化します。
- Data Centers タブを開きます。
- 詳細ペインの Storage タブをクリックし、結果一覧で新しい
Data
ストレージドメインを選択します。 - Activate をクリックします。
- 新しいストレージドメインが
Active
になったら、仮想マシンとそのディスクをインポートします。- Storage タブで、
data
を選択します。 - 詳細ペインで VM Import タブを選択し、仮想マシンを選択し、Import をクリックします。詳細は、『Administration Guide』 の Importing Virtual Machines from Imported Data Storage Domains を参照してください。
- すべての仮想マシンが正常にインポートされ、適切に機能していることを確認したら、
localfs
をメンテナンスモードに移行できます。- Storage タブをクリックし、結果リストから
localfs
を選択します。 - 詳細ペインの Data Center タブをクリックします。
- Maintenance をクリックした後、OK をクリックしてストレージドメインをメンテナンスモードに移動します。
- Detach をクリックして、 Detach Storage の確認ウィンドウを開きます。
- OK をクリックします。
3.5. 仮想マシンの移行
手順3.3 アップグレードされたホストのクラスターへの追加
- 現在のクラスターのホストを新しいバージョンにアップグレードします。詳細は、「ホストの更新」 を参照してください。
- 現在のクラスターに新しいバージョンホストを追加します。
- Maintenance をクリックして、新しいバージョンのホストをメンテナンスモードにします。
- Edit をクリックします。
- General タブで、ドロップダウンリストで現在のクラスターを選択します。
- Activate をクリックして、新しいバージョンのホストをメンテナンスモードから解除します。
手順3.4 新規ホストのクラスターへの追加
- 新しいバージョンの Red Hat Virtualization を実行する新規ホストを作成します。詳細は、『インストールガイド』 の Red Hat Enterprise Linux ホスト (4.0)または Red Hat Enterprise Linux ホスト (4.1)を参照してください。
- 現在のクラスターに新しいバージョンホストを追加します。
- ホスト タブで、新規 をクリックし 。
- ドロップダウンリストから、Red Hat Virtualization の新しいバージョンと互換性のある データセンター および クラスター を選択します。
- 新規ホストの Name、Address、および Password を入力します。
手順3.5 仮想マシンの移行
- すべての仮想マシンが自動的に移行できることを確認します。
- Virtual Machines タブで、仮想マシンを選択します。
- Edit をクリックします。
- Hosts タブをクリックして、Any Host in Cluster が選択されていることを確認します。
- Migration Mode が
Allow manual and automatic migration
に設定されていることを確認します。
- 以前のバージョンのホストをメンテナンスモードにして、仮想マシンの自動移行をトリガーします。
- ホスト タブで 、 以前のバージョンのホストを選択します。
- Maintenance をクリックして、ホストをメンテナンスモードにします。
- すべての仮想マシンがそれ以降のバージョンホストで実行されているまで、これらの手順を繰り返します。
- クラスターの互換性レベルを新しいバージョンに変更します。詳細は、「クラスターの互換バージョンの変更」 を参照してください。
- 移行した各仮想マシンを停止して起動します。
- Virtual Machines タブで、仮想マシンを選択します。
- Shutdown をクリックします。
- Run をクリックします。
3.6. セルフホストエンジンのアップグレード
第4章 アップグレード後のタスク
4.1. クラスターの互換バージョンの変更
手順4.1 クラスターの互換バージョンの変更
- 管理ポータルで、Clusters タブをクリックします。
- 表示される一覧から変更するクラスターを選択します。
- 互換バージョン を必要な値に変更します。
- Change Cluster Compatibility Version の確認ウィンドウを開きます。をクリックして、
4.2. データセンターの互換バージョンの変更
手順4.2 データセンターの互換バージョンの変更
- 管理ポータルから、Data Centers タブをクリックします。
- 表示される一覧から変更するデータセンターを選択します。
- 互換バージョン を必要な値に変更します。
- Change Data Center Compatibility Version の確認ウィンドウを開きます。をクリックして
付録A Red Hat Virtualization Manager のオフライン更新
A.1. Red Hat Virtualization Manager をオフラインでインストールするためのローカルリポジトリーの更新
- リポジトリーをホストするシステムで、リポジトリーを同期して利用可能な各パッケージの最新バージョンをダウンロードします。
reposync -l --newest-only /var/ftp/pub/rhevrepo
# reposync -l --newest-only /var/ftp/pub/rhevrepo
Copy to Clipboard Copied! このコマンドは、多数のパッケージをダウンロードする可能性があり、完了するまでに時間がかかる場合があります。 - Manager システムでリポジトリーが利用可能であることを確認してから、Manager システムを更新またはアップグレードします。マイナーバージョン間で Manager を更新する方法は、「Red Hat Virtualization Manager の更新」 を参照してください。メジャーバージョン間のアップグレードに関する詳細は、「更新の概要」 を参照してください。