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

手順

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. Manager 用仮想マシンにログインし、エンジンサービスをシャットダウンします。

   # systemctl stop ovirt-engine

2. Red Hat Virtualization Manager 4.3 環境のバックアップを作成します。

   # engine-backup --scope=all --mode=backup --file=backup.bck --log=backuplog.log

3. バックアップファイルを RHV 環境外のストレージデバイスにコピーします。

4. セルフホストエンジンをシャットダウンします。

   # shutdown

   注記

   セルフホストエンジンの仮想マシンを再利用して Red Hat Virtualization Manager 4.4 をデプロイする場合は、シャットダウンする前にセルフホストエンジンネットワークインターフェイスの MAC アドレスをメモします。

5. セルフホストエンジンがシャットダウンしていることを確認します。

   # hosted-engine --vm-status | grep -E 'Engine status|Hostname'

   注記

   ホストのいずれかが detail フィールドに Up と報告している場合は、その特定のホストにログインして hosted-engine --vm-shutdown コマンドでシャットダウンします。

6. Manager 用仮想マシンを実行している既存のノードに RHVH 4.4 または Red Hat Enterprise Linux 8.6 をインストールして、セルフホストエンジンのデプロイメントホストとして使用します。詳細は、セルフホストエンジン用デプロイメントホストのインストール を参照してください。

   注記

   既存ホストのいずれかを使用することが推奨されます。新規ホストの使用を選択する場合は、アップグレード手順を開始する前に、新規ホストに一意の名前を割り当ててから、既存のクラスターに追加する必要があります。

7. セルフホストエンジンのデプロイメントツールをインストールします。

   # yum install ovirt-hosted-engine-setup

8. バックアップファイルをホストにコピーします。

9. Manager ホストにログインし、バックアップファイルを使用してセルフホストエンジンをデプロイします。

   # hosted-engine --deploy --restore-from-file=/path/backup.bck

   注記

   tmux を使用すると、サーバーへの接続が中断された場合にデプロイメントスクリプトが続行できるようになります。これにより、再接続してデプロイメントにアタッチし、続行することができます。これ以外の場合は、デプロイメント中に接続が中断されると、デプロイメントに失敗します。

   tmux を使用してデプロイメントスクリプトを実行するには、デプロイメントスクリプトを実行する前に tmux コマンドを入力します。

   # tmux
   # hosted-engine --deploy --restore-from-file=backup.bck

   デプロイメントスクリプトは自動的にグローバルメンテナンスモードを無効にし、HA エージェントを呼び出してセルフホストエンジンの仮想マシンを起動します。4.4 セルフホストエンジンのアップグレードされたホストは、HA モードがアクティブであると報告しますが、他のホストは、以前のセルフホストエンジンのストレージに接続されたままであるため、グローバルメンテナンスモードが依然として有効化されていると報告します。

10. Manager 4.3 マシンをホストするストレージドメインをデタッチします。詳細は、管理ガイドの データセンターからストレージドメインをデタッチ を参照してください。

11. Manager 用仮想マシンにログインし、エンジンサービスをシャットダウンします。

    # systemctl stop ovirt-engine

12. Manager マシンで正しいリポジトリーが有効になっていることを確認します。Red Hat Virtualization 4.4 に必要なリポジトリーのリストは、Red Hat Virtualization Manager リポジトリーの有効化 を参照してください。

    Red Hat Virtualization Manager の更新は、コンテンツ配信ネットワーク (CDN) 経由でリリースされます。

13. オプションの拡張機能パッケージが Red Hat Virtualization Manager 4.3 マシンにインストールされていた場合はインストールします。

    # yum install ovirt-engine-extension-aaa-ldap ovirt-engine-extension-aaa-misc

    注記

    ovirt-engine-extension-aaa-ldap は非推奨になりました。新規インストールの場合は、Red Hat Single Sign On を使用します。詳細は、管理ガイド の Red Hat Single Sign-On のインストールおよび設定 を参照してください。

    注記

    これらの拡張機能パッケージの設定は、バックアップおよび復元プロセスの一部として移行されないため、手動で再適用する必要があります。

14. engine-setup コマンドを実行して Manager を設定します。

    # engine-setup

手順

1. アップグレードするホストを選択し、そのホストの仮想マシンを同じクラスター内の別のホストに移行します。ライブマイグレーションを使用して、仮想マシンのダウンタイムを最小限に抑えることができます。詳細は、仮想マシン管理ガイド の ホスト間での仮想マシンの移行 を参照してください。
2. ホストをメンテナンスモードにし、Manager からホストを削除します。詳細は、管理ガイド の ホストの削除 を参照してください。
3. Red Hat Enterprise Linux 8.6 または RHVH 4.4 をインストールします。詳細は、いずれかの Red Hat Virtualization のインストール ガイドの Red Hat Virtualization 用ホストのインストール を参照してください。
4. 適切なパッケージをインストールして、RHV 4.4 のホストを有効にします。詳細は、いずれかの Red Hat Virtualization のインストール ガイドの Red Hat Virtualization 用ホストのインストール を参照してください。
5. このホストを Manager に追加し、これを同じクラスターに割り当てます。次に、仮想マシンをこのホストに移行してください。詳細は、いずれかの Red Hat Virtualization のインストール ガイドの Red Hat Virtualization Manager への通常ホストの追加 を参照してください。

手順

1. このプロセスを開始する前に、RHVH 4.3 ホストのローカルストレージ上のローカルストレージがメンテナンスモードにあることを確認します。以下の手順を実行します。

   1. Data Centers タブを開きます。
   2. Details ペインの Storage タブをクリックし、結果一覧でストレージドメインを選択します。
   3. Maintenance をクリックします。

2. インストールガイド の Red Hat Virtualization Host のインストール に記載されているとおりに、Red Hat Virtualization Host を再インストールします。

   重要

   インストール先 画面で RHVH をインストールするデバイスを選択する場合は、仮想マシンを保存するデバイスを選択しないでください。オペレーティングシステムをインストールするデバイスのみを選択します。

   キックスタートを使用してホストをインストールする場合は、キックスタートファイルに以下を追加して、仮想マシンを含むデバイスを保存するようにしてください。ここでの `device` は、適切なデバイスに置き換えてください。

   # clearpart --all --drives=device

   キックスタートの使用方法は、Red Hat Enterprise Linux 8 高度な RHEL インストールの実行 の キックスタートの参照 を参照してください。

3. 再インストールしたホストで、以前の環境を復元するディレクトリー (/data など) を作成します。

   # mkdir /data

4. 新しいディレクトリーに以前のローカルストレージをマウントします。この例では、/dev/sdX1 がローカルストレージになります。

   # mount /dev/sdX1 /data

5. 新しいディレクトリーに以下のパーミッションを設定します。

   # chown -R 36:36 /data
   # chmod -R 0755 /data

6. Red Hat では、サーバーの再起動が必要となる場合に備えて、/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

7. 管理ポータルでデータセンターを作成し、Storage Type ドロップダウンメニューで Local を選択します。
8. 新しいデータセンターでクラスターを設定します。詳細は、管理ガイド の 新規クラスターの作成 を参照してください。
9. Manager にホストを追加します。詳細は、いずれかの Red Hat Virtualization のインストール ガイドの Red Hat Virtualization Manager への通常のホストの追加 を参照してください。

10. ホスト上で、最初のローカルストレージドメインの作成に使用する新しいディレクトリーを作成します。以下に例を示します。

    # mkdir -p /localfs
    # chown 36:36 /localfs
    # chmod -R 0755 /localfs

11. 管理ポータルで Storage タブを開き、New Domain をクリックして新しいローカルストレージドメインを作成します。
12. 名前を localfs に設定し、パスを /localfs に設定します。
13. ローカルストレージがアクティブになったら、Import Domain をクリックして、ドメインの詳細を設定します。たとえば、Data を名前として、Local on Host をストレージタイプとして、/data をパスとして定義します。
14. ストレージドメインがデータセンターにすでにアタッチされていることを知らせるメッセージが表示されるので、OK をクリックして確定します。

15. 新しいストレージドメインをアクティブ化します。

    1. Data Centers タブを開きます。
    2. 詳細ペインの Storage タブをクリックし、結果一覧で新しいデータストレージドメインを選択します。
    3. Activate をクリックします。

16. 新規ストレージドメインがアクティブになったら、仮想マシンとそのディスクをインポートします。

    1. Storage タブで、data を選択します。
    2. 詳細ペインで VM Import タブを選択し、仮想マシンを選択して Import をクリックします。詳細は、仮想マシン管理ガイド の データドメインからの仮想マシンのインポート を参照してください。
17. すべての仮想マシンが正常にインポートされ、適切に機能していることを確認したら、localfs をメンテナンスモードに移行できます。

18. Storage タブをクリックし、結果一覧で localfs を選択します。

    1. 詳細ペインの Data Center タブをクリックします。
    2. Maintenance をクリックしてから OK をクリックし、ストレージドメインをメンテナンスモードに移動します。
    3. Detach をクリックします。Detach Storage の確認ウィンドウが開きます。
    4. OK をクリックします。

手順

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 をクリックして確定します。