アップグレードガイド

手順

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

手順

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

手順

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. 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 マシンにログインします。

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

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

3. バックアップファイルを RHV 環境外のストレージデバイスにコピーします。
4. Red Hat Enterprise Linux 8.6 をインストールします。詳細は、標準の RHEL 8 インストールの実行 を参照してください。
5. コマンド yum install rhvm の実行など、Red Hat Virtualization Manager 4.4 のインストール手順を完了します (engine-setup は実行しないでください)。詳細は、Red Hat Virtualization のインストール ガイドのいずれかを参照してください。

6. バックアップファイルを Red Hat Virtualization Manager 4.4 マシンにコピーし、復元します。

   # engine-backup --mode=restore --file=backup.bck --provision-all-databases

   注記

   バックアップに追加のデータベースユーザーへの権限付与が含まれていた場合、このコマンドにより、無作為にパスワードが設定された追加のユーザーが作成されます。追加のユーザーが復元したシステムにアクセスする必要がある場合は、これらのパスワードを手動で変更する必要があります。https://access.redhat.com/articles/2686731 を参照してください。

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

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

8. オプションの拡張機能パッケージが 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 のインストールおよび設定 を参照してください。

   注記

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

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

   # engine-setup

10. Red Hat Virtualization Manager 4.4 に別のマシンを使用している場合は、Red Hat Virtualization Manager 4.3 マシンを廃止します。2 つの異なる Manager が同じホストまたはストレージを管理することはできません。

11. 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. RHVH 4.4 Manager デプロイメント向けに新しい Gluster ボリュームを作成します。

   1. 新しい RHVH 4.4 セルフホストエンジンの仮想マシン (VM) 用に各ホストに新しいエンティティーを作成します。
   2. 設定にスペアディスクがある場合は、Web コンソールからのボリュームの作成を参照してください。

   3. 既存のボリュームグループ (VG) に新しい Manager 100 GB の対応のために十分な領域がある場合は、新しい Manager 論理ボリューム (LV) として使用できます。

      特に明示的に指定しない限り、すべてのホストで以下のコマンドを実行します。

   4. ボリュームグループ (VG) の空き容量を確認します。

      # vgdisplay <VG_NAME> | grep -i free

   5. この VG に論理ボリュームを 1 つ以上作成します。

      # lvcreate -n gluster_lv_newengine -L 100G <EXISTING_VG>

   6. 新しい論理ボリューム (LV) を XFS としてフォーマットします。

      # mkfs.xfs  <LV_NAME>

   7. 新しいブリックのマウントポイントを作成します。

      # mkdir /gluster_bricks/newengine

   8. /etc/fstab で新たに作成されたファイルシステムに対応するエントリーを作成し、ファイルシステムをマウントします。

   9. ラボマウントポイントに SELinux ラベルを設定します。

      # semanage fcontext -a -t glusterd_brick_t /gluster_bricks/newengine
       restorecon -Rv /gluster_bricks/newengine

   10. クラスター内のいずれかのホストで gluster コマンドを実行して、新しい Gluster ボリュームを作成します。

       # gluster volume create newengine replica 3 host1:/gluster_bricks/newengine/newengine host2:/gluster_bricks/newengine/newengine host3:/gluster_bricks/newengine/newengine

   11. 新規作成されたボリュームに必要なボリュームオプションを設定します。クラスター内のいずれかのホストで以下のコマンドを実行します。

       # gluster volume set newengine group virt
        gluster volume set newengine network.ping-timeout 30
        gluster volume set newengine cluster.granular-entry-heal enable
        gluster volume set newengine network.remote-dio off
        gluster volume set newengine performance.strict-o-direct on
        gluster volume set newengine storage.owner-uid 36
        gluster volume set newengine storage.owner-gid 36

   12. 新規作成した Gluster ボリュームを起動します。クラスター内のいずれかのホストで以下のコマンドを実行します。

       # gluster volume start newengine

2. バックアップ Playbook を使用して、すべての RHVH 4.3 ノードで Gluster 設定をバックアップします。

   1. バックアップ Playbook は RHVH 4.3 の最新バージョンで利用できます。この Playbook が利用できない場合は、Playbook とインベントリーファイルを作成します。

      /etc/ansible/roles/gluster.ansible/playbooks/hc-ansible-deployment/archive_config.yml

      例:

       all:
        hosts:
          host1:
          host2:
          host3:
        vars:
          backup_dir: /archive
          nbde_setup: false
          upgrade: true

   2. 正しい詳細でバックアップインベントリーファイルを編集します。

        Common variables
        backup_dir ->  Absolute path to directory that contains the extracted contents of the backup archive
        nbde_setup -> Set to false as the {virt-product-fullname} 4.3 setup doesn’t support NBDE
        upgrade -> Default value true . This value will make no effect with backup

   3. ディレクトリーに切り替え、Playbook を実行します。

      ansible-playbook -i archive_config_inventory.yml archive_config.yml --tags backupfiles

   4. 生成されたバックアップ設定 tar ファイルは、RHVH-<HOSTNAME>-backup.tar.gz という名前の /root の下に生成されます。すべてのホストで、バックアップ設定 tar ファイルをバックアップホストにコピーします。
3. Manager Administration Portal を使用して、最初のホストで実行されている仮想マシンをクラスター内の他のホストに移行します。

4. バックアップマネージャーを設定します。

   # engine-backup --mode=backup --scope=all --file=<backup-file.tar.gz> --log=<logfile>

   注記

   バックアップを作成する前に、以下の手順を実施します。

   • セルフホストエンジン (SHE) の グローバルメンテナンス を有効にします。
   • SSH を使用して Manager 仮想マシンにログインし、ovirt-engine サービスを停止します。
   • バックアップファイルをセルフホストエンジンの仮想マシンからリモートホストにコピーします。
   • Manager をシャットダウンします。
5. すべてのレプリカ 3 ボリュームで、保留中の自己修復タスクを確認します。修復が完了するまで待ちます。

6. ホストのいずれかで以下のコマンドを実行します。

   # gluster volume heal <volume> info summary

7. glusterfs ブリックプロセスを停止し、最初のホストですべてのラボをアンマウントして、ファイルシステムの整合性を維持します。最初のホストで以下を実行します。

   # pkill glusterfsd; pkill glusterfs
   # systemctl stop glusterd
   # umount /gluster_bricks/*

8. RHVH 4.4 ISO でホストを再インストールし、OS ディスクのフォーマットのみを行います。

   重要

   ラボがそれらのディスク上に作成されるため、インストールが他のディスクをフォーマットしないことを確認してください。

9. RHVH 4.4 のインストール再起動後にノードが稼働したら、インストールガイドで説明されているように RHVH 4.4 リポジトリーにサブスクライブするか、ダウンロードした RHVH 4.4 アプライアンスをインストールします。

   # yum install <appliance>

10. Gluster ブリックに使用されるデバイスを無効にします。

    1. 新しい SSH 秘密鍵と公開鍵のペアを作成します。
    2. フロントエンドネットワーク FQDN とバックエンドネットワーク FQDN を使用して、同じホストに SSH 公開鍵認証 (パスワードなし SSH) を確立します。

    3. インベントリーファイルを作成します。

       /etc/ansible/roles/gluster.ansible/playbooks/hc-ansible-deployment/blacklist_inventory.yml

       例:

        hc_nodes:
         hosts:
           host1-backend-FQDN.example.com:
             blacklist_mpath_devices:
                - sda
                - sdb

    4. Playbook の実行

       ansible-playbook -i blacklist_inventory.yml /etc/ansible/roles/gluster.ansible/playbooks/hc-ansible-deployment/tasks/gluster_deployment.yml --tags blacklistdevices*

11. Manager のバックアップおよびホスト設定の tar ファイルをバックアップホストから新たにインストールしたホストにコピーし、scp を使用してコンテンツのデプロイメントを解除します。

12. Gluster 設定ファイルを復元します。

    1. Gluster 設定ファイルの内容を抽出します。

        # mkdir /archive
        # tar -xvf /root/ovirt-host-host1.example.com.tar.gz -C /archive/

    2. インベントリーファイルを編集して、設定ファイルの復元を行います。インベントリーファイルは /etc/ansible/roles/gluster.ansible/playbooks/hc-ansible-deployment/archive_config_inventory.yml にあります。

       Playbook コンテンツの例:

        all:
          hosts:
        	host1.example.com:
          vars:
        	backup_dir: /archive
        	nbde_setup: false
        	upgrade: true

       重要

       Use only one host under ‘hosts’ section of restoration playbook.

    3. Playbook を実行して設定ファイルを復元します。

       ansible-playbook -i archive_config_inventory.yml archive_config.yml --tags restorefiles

13. Manager からバックアップアーカイブをポイントする --restore-from-file オプションを使用して Manager デプロイメントを実行します。この Manager デプロイメントは、hosted-engine --deploy コマンドを使用して対話的に実行でき、新たに作成された Manager ボリュームに対応するストレージを提供します。また、自動化された手順で ovirt-ansible-hosted-engine-setup を使用して同じ操作を行うこともできます。以下の手順は、バックアップを使用して HostedEngine 仮想マシンをデプロイする自動化された方法です。

    1. 新たにインストールしたホストに HostedEngine デプロイメントの Playbook を作成します。

       /etc/ansible/roles/gluster.ansible/playbooks/hc-ansible-deployment/he.yml

       - name: Deploy oVirt hosted engine
         hosts: localhost
         roles:
           - role: ovirt.hosted_engine_setup

    2. テンプレートファイルを使用して HostedEngine 関連の情報を更新します。

       /etc/ansible/roles/gluster.ansible/playbooks/hc-ansible-deployment/he_gluster_vars.json

       例:

       # cat /etc/ansible/roles/gluster.ansible/playbooks/hc-ansible-deployment/he_gluster_vars.json
       
       {
         "he_appliance_password": "<password>",
         "he_admin_password": "<password>",
         "he_domain_type": "glusterfs",
         "he_fqdn": "<hostedengine.example.com>",
         "he_vm_mac_addr": "<00:18:15:20:59:01>",
         "he_default_gateway": "<19.70.12.254>",
         "he_mgmt_network": "ovirtmgmt",
         "he_storage_domain_name": "HostedEngine",
         "he_storage_domain_path": "</newengine>",
         "he_storage_domain_addr": "<host1.example.com>",
         "he_mount_options": "backup-volfile-servers=<host2.example.com>:<host3.example.com>",
         "he_bridge_if": "<eth0>",
         "he_enable_hc_gluster_service": true,
         "he_mem_size_MB": "16384",
         "he_cluster": "Default",
         "he_restore_from_file": "/root/engine-backup.tar.gz",
         "he_vcpus": 4
       }

       重要
       • 上記の he_gluster_vars.json には、“he_restore_from_file” および “he_storage_domain_path” という 2 つの重要な値があります。最初のオプション “he_restore_from_file” は、ローカルマシンにコピーされた Manager バックアップアーカイブの絶対ファイル名をポイントする必要があります。2 番目のオプション “he_storage_domain_path” は、新しく作成された Gluster ボリュームを参照しているはずです。
       • また、Manager 仮想マシン内で実行されている以前のバージョンの RHVH Version はダウンし、破棄されることに注意してください。古い Manager 仮想マシンに対応する MAC アドレスと FQDN は、新しい Manager 用でも再利用できます。

    3. 静的 Manager ネットワーク設定の場合は、以下のようにオプションをさらに追加します。

         “he_vm_ip_addr”:  “<engine VM ip address>”
         “he_vm_ip_prefix”:  “<engine VM ip prefix>”
         “he_dns_addr”:  “<engine VM DNS server>”
         “he_default_gateway”:  “<engine VM default gateway>”

       重要

       利用可能な特定の DNS がない場合は、“he_vm_etc_hosts”: true と “he_network_test”: “ping” の 2 つのオプションを追加します。

    4. Playbook を実行して HostedEngine デプロイメントをデプロイします。

       # cd /etc/ansible/roles/gluster.ansible/playbooks/hc-ansible-deployment
       # ansible-playbook he.yml --extra-vars "@he_gluster_vars.json"

    5. セルフホストエンジンのデプロイメントが完了するまで待ちます。

       重要

       セルフホストエンジンのデプロイメント中に問題が発生した場合は、/var/log/ovirt-hosted-engine-setup でログメッセージを確認し、問題を修正します。ovirt-hosted-engine-cleanup コマンドを使用して失敗したセルフホストエンジンのデプロイメントをクリーンアップし、デプロイメントを再実行します。

14. 新たにインストールした Red Hat Virtualization Manager で RHVH 4.4 管理ポータルにログインします。すべてのホストが up 状態にあることを確認し、Gluster ボリュームでの自己修復が完了するまで待ちます。

15. 次のホストをアップグレードします。

    1. 管理ポータルから、次のホスト (通常は順番が次のホスト) を Maintenance モードに移動します。このホストを Maintenance モードに移行している間に Gluster サービスを停止します。

    2. ホストのコマンドラインから Gluster ブリックをアンマウントします。

       # umount /gluster_bricks/*

    3. このホストを RHVH4.4 で再インストールします。

       重要

       ラボがそれらのディスク上に作成されるため、インストールが他のディスクをフォーマットしないことを確認してください。

    4. 新たにインストールしたホストでマルチパス設定が利用できない場合は、Gluster デバイスを無効にします。インベントリーファイルは、Gluster ブリックに使用されるデバイスを無効 にする手順の一部として最初のホストにすでに作成されています。

       1. 最初のホストから新たにインストールしたホストに SSH 公開鍵認証を設定します。
       2. 新しいホスト名でインベントリーを更新します。
       3. Playbook を実行します。
    5. Gluster 設定の tar ファイルをバックアップホストから新規インストールしたホストにコピーし、コンテンツを展開します。

    6. このホストの Gluster 設定ファイルを復元する手順で説明されているように、Playbook を実行し、新たにインストールされたホストで Gluster 設定を復元します。

       重要

       新たにインストールしたホストで Playbook を編集し、--restore-from-file…​ オプションを使用して手順 Perform manager deployment で説明されているように実行します。ホスト名を変更し、同じホストで実行しないようにしてください。

    7. RHVH 管理ポータルでホストを再インストールします。RHVH 4.4 で最初にデプロイされたホストから認証キーをコピーします。

       # scp root@host1.example.com:/root/.ssh/authorized_keys /root/.ssh/

       1. 管理ポータル では、ホストは ‘Maintenance’ に置かれます。Compute → Hosts → Installation → Reinstall に移動します。
       2. New Host ダイアログボックスの HostedEngine タブで、deploy self-hosted engine deployment アクションを選択します。
       3. ホストが Up 状態になるまで待機します。

    8. GFID の不一致に関連するエラーがないことを確認します。エラーがある場合は、解決します。

       grep -i "gfid mismatch" /var/log/glusterfs/*

16. クラスター内のすべての RHVH について、次のホストをアップグレード の手順を繰り返します。
17. (オプション) クラスター内に別の Gluster 論理ネットワークが存在する場合は、Gluster 論理ネットワークを各ホストの必要なインターフェイスにアタッチします。

18. 古い Manager ストレージドメインを削除します。Storage → Domain の下に一覧表示され、横にゴールドの星がない hosted_storage という名前で、古い Manager ストレージドメインを特定します。

    1. Storage → Domains → hosted_storage → Data center タブに移動し、Maintenance を選択します。
    2. ストレージドメインが Maintenance モードに移行するまで待ちます。
    3. ストレージドメインが Maintenance モードに移動したら、Detach をクリックすると、ストレージドメインは 未接続 に移行します。
    4. 未接続ストレージドメインを選択し、Remove をクリックして OK を確定します。

19. 古い Manager ボリュームを停止して削除します。

    1. Storage → Volumes に移動して、古い Manager ボリュームを選択します。Stop をクリックし、OK を確定します。
    2. 同じボリュームを選択し、Remove をクリックして OK を確定します。

20. クラスターの互換バージョンを更新します。

    1. Compute → Clusters に移動し、クラスターの Default を選択し、Edit をクリックして Compatibility Version を 4.4 に更新し、OK をクリックします。

       重要

       互換バージョンを変更するための警告が表示されます。これには、クラスターの仮想マシンを再起動する必要があります。OKをクリックして確定します。

21. RHVH 4.4 で新しい Gluster ボリュームオプションを使用でき、それらのボリュームオプションをすべてのボリュームに適用します。クラスター内のノードの 1 つで以下のコマンドを実行します。

    # for vol in gluster volume list; do gluster volume set $vol group virt; done

22. アーカイブを削除し、すべてのノードでバックアップ設定ファイルの内容をデプロイメントします。

Web コンソールを使用した追加の Gluster ボリュームの作成

1. Manager Web コンソールにログインします。
2. Virtualization → Hosted Engine に移動し、Manage Gluster をクリックします。

3. ボリュームの作成 をクリックします。ボリュームの作成ウィンドウで、以下の手順を実施します。

   1. Hosts タブで、未使用のディスクを持つ 3 つの異なる ovirt-ng-nodes を選択し、Next をクリックします。
   2. Volumes タブで、作成するボリュームの詳細を指定し、Next をクリックします。
   3. Bricks タブで、ボリュームの作成に使用するディスクの詳細を指定し、Next をクリックします。
   4. Review タブで、生成された設定ファイルで誤った情報の有無を確認します。問題がなければ、Deploy をクリックします。

手順

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 マシンに 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. 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. 管理ポータルで 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. 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

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

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

   # systemctl restart httpd

6. 管理ポータルに接続して、警告が表示されなくなったことを確認します。
7. 以前に 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. 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

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

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

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

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) に置き換えます。

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

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

手順

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. 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 マシンにログインします。

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

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

3. バックアップファイルを RHV 環境外のストレージデバイスにコピーします。
4. Red Hat Enterprise Linux 8.6 をインストールします。詳細は、標準の RHEL 8 インストールの実行 を参照してください。
5. コマンド yum install rhvm の実行など、Red Hat Virtualization Manager 4.4 のインストール手順を完了します (engine-setup は実行しないでください)。詳細は、Red Hat Virtualization のインストール ガイドのいずれかを参照してください。

6. バックアップファイルを Red Hat Virtualization Manager 4.4 マシンにコピーし、復元します。

   # engine-backup --mode=restore --file=backup.bck --provision-all-databases

   注記

   バックアップに追加のデータベースユーザーへの権限付与が含まれていた場合、このコマンドにより、無作為にパスワードが設定された追加のユーザーが作成されます。追加のユーザーが復元したシステムにアクセスする必要がある場合は、これらのパスワードを手動で変更する必要があります。https://access.redhat.com/articles/2686731 を参照してください。

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

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

8. オプションの拡張機能パッケージが 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 のインストールおよび設定 を参照してください。

   注記

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

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

   # engine-setup

10. Red Hat Virtualization Manager 4.4 に別のマシンを使用している場合は、Red Hat Virtualization Manager 4.3 マシンを廃止します。2 つの異なる Manager が同じホストまたはストレージを管理することはできません。

手順

1. Data Warehouse マシンをバックアップします。

   注記

   Grafana は RHV 4.3 ではサポートされていませんが、RHV 4.4 では、このコマンドに Grafana サービスおよび Grafana データベースも含まれます。

   # engine-backup --file=<backupfile>

2. バックアップファイルをストレージデバイスにコピーします。

3. Data Warehouse サービスを停止して無効にします。

   # systemctl stop ovirt-engine-dwhd
   # systemctl disable ovirt-engine-dwhd

4. Red Hat Enterprise Linux 8.6 または Red Hat Virtualization Host 4.4 で Data Warehouse マシンを再インストールします。
5. PostgreSQL データベースを準備します。詳細は、リモートデータベースが設定されたスタンドアロン Manager の Red Hat Virtualization のインストール の リモート PostgreSQL データベースの準備 を参照してください。
6. サーバーで正しいリポジトリーを有効にし、Data Warehouse サービスをインストールします。詳細な手順は、Red Hat Virtualization 4.4 の別のマシンへの Data Warehouse のインストールおよび設定 を参照してください。dnf install ovirt-engine-dwh-setup コマンドを実行する手順を含む、そこまでのすべての手順を実行します。次に、この手順の次のステップに進みます。
7. バックアップファイルをストレージデバイスから Data Warehouse マシンにコピーします。

8. バックアップファイルを復元します。

   # engine-backup --mode=restore --file=backup.bck --provision-all-databases

9. Data Warehouse マシンで engine-setup コマンドを実行します。

   # engine-setup

10. Manager マシンで Manager を再起動して、Data Warehouse データベースに接続します。

    # systemctl restart ovirt-engine

手順

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

手順

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. 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 データベースをアップグレードする場合は、Manager マシンで ovirt-engine サービスを停止します。

     # systemctl stop ovirt-engine

   • Data Warehouse データベースをアップグレードする場合は、Data Warehouse マシンで ovirt-engine-dwhd サービスを停止します。

     # systemctl stop ovirt-engine-dwhd

2. PostgreSQL 10 パッケージを取得するために必要なリポジトリーを有効にします。

   Red Hat Virtualization Manager リポジトリーを有効にするか、

   # subscription-manager repos --enable=rhel-7-server-rhv-4.3-manager-rpms

   あるいは、SCL リポジトリーを有効にします。

   # subscription-manager repos --enable rhel-server-rhscl-7-rpms

3. PostgreSQL 10 パッケージをインストールします。

   # yum install rh-postgresql10 rh-postgresql10-postgresql-contrib

4. PostgreSQL 9.5 サービスを停止し、無効にします。

   # systemctl stop rh-postgresql95-postgresql
   # systemctl disable rh-postgresql95-postgresql

5. PostgreSQL 9.5 データベースを PostgreSQL 10 にアップグレードします。

   # scl enable rh-postgresql10 -- postgresql-setup --upgrade-from=rh-postgresql95-postgresql --upgrade

6. rh-postgresql10-postgresql.service を起動して有効にし、実行していることを確認します。

   # systemctl start rh-postgresql10-postgresql.service
   # systemctl enable rh-postgresql10-postgresql.service
   # systemctl status rh-postgresql10-postgresql.service

   以下のような出力が表示されることを確認します。

   rh-postgresql10-postgresql.service - PostgreSQL database server
      Loaded: loaded (/usr/lib/systemd/system/rh-postgresql10-postgresql.service;
   enabled; vendor preset: disabled)
      Active: active (running) since ...

7. pg_hba.conf クライアント設定ファイルを PostgreSQL 9.5 環境から PostgreSQL 10 環境にコピーします。

   # cp -p /var/opt/rh/rh-postgresql95/lib/pgsql/data/pg_hba.conf  /var/opt/rh/rh-postgresql10/lib/pgsql/data/pg_hba.conf

8. /var/opt/rh/rh-postgresql10/lib/pgsql/data/postgresql.conf で以下のパラメーターを更新します。

   listen_addresses='*'
   autovacuum_vacuum_scale_factor=0.01
   autovacuum_analyze_scale_factor=0.075
   autovacuum_max_workers=6
   maintenance_work_mem=65536
   max_connections=150
   work_mem = 8192

9. PostgreSQL 10 サービスを再起動して設定の変更を適用します。

   # systemctl restart rh-postgresql10-postgresql.service

手順

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

   注記

   Manager のアップグレードプロセス中に、engine-setup スクリプトにより、リモート Data Warehouse データベースへの接続が解除される場合があります。接続を切断して設定を続行する必要があります。

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

   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. 管理ポータルで 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. 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

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

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

   # systemctl restart httpd

6. 管理ポータルに接続して、警告が表示されなくなったことを確認します。
7. 以前に 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. 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

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

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

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

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) に置き換えます。

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

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

手順

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. 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. セルフホスト型エンジンノードのいずれかにログインして、グローバルメンテナンスモードを有効にします。

   # 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. グローバルメンテナンスモードを無効にします。
   2. マシンを再起動して更新を完了します。

手順

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. 適切なリポジトリーが有効であることを確認します。現在有効なリポジトリーのリストを表示するには、dnf repolist を実行します。

   • Red Hat Virtualization Host の場合:

     # subscription-manager repos --enable=rhvh-4-for-rhel-8-x86_64-rpms

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

     # subscription-manager repos \
         --enable=rhel-8-for-x86_64-baseos-eus-rpms \
         --enable=rhel-8-for-x86_64-appstream-eus-rpms \
         --enable=rhv-4-mgmt-agent-for-rhel-8-x86_64-rpms \
         --enable=advanced-virt-for-rhel-8-x86_64-rpms \
         --enable=fast-datapath-for-rhel-8-x86_64-rpms
     
     # subscription-manager release --set=8.6

2. 管理ポータルで Compute → Hosts をクリックし、更新するホストを選択します。

3. Installation → Check for Upgrade をクリックしてから OK をクリックします。

   通知ドロワー ( ) を開き、イベント セクションをデプロイメントして結果を表示します。

4. 更新が利用可能であれば、Installation → Upgrade をクリックします。

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

   Compute → Hosts にホストの情報が更新され、ステータスが以下の順序で変わります。

   Maintenance > Installing > Reboot > Up

   注記

   更新が失敗すると、ホストのステータスは Install Failed に変わります。Install Failed のステータスから Installation → Upgrade を再度クリックすることができます。

手順

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

   • Red Hat Virtualization Host の場合:

     # subscription-manager repos --enable=rhvh-4-for-rhel-8-x86_64-rpms

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

     # subscription-manager repos \
         --enable=rhel-8-for-x86_64-baseos-eus-rpms \
         --enable=rhel-8-for-x86_64-appstream-eus-rpms \
         --enable=rhv-4-mgmt-agent-for-rhel-8-x86_64-rpms \
         --enable=advanced-virt-for-rhel-8-x86_64-rpms \
         --enable=fast-datapath-for-rhel-8-x86_64-rpms
     
     # subscription-manager release --set=8.6

2. 管理ポータルで Compute → Hosts をクリックし、更新するホストを選択します。
3. Management → Maintenance をクリックしてから OK をクリックします。

4. Red Hat Enterprise Linux ホストの場合:

   1. Red Hat Enterprise Linux の現行バージョンを特定します。

      # cat /etc/redhat-release

   2. redhat-release パッケージの利用可能なバージョンを確認します。

      # dnf --refresh info --available redhat-release

      このコマンドは、利用可能な更新をすべて表示します。たとえば、Red Hat Enterprise Linux 8.2.z から 8.3 にアップグレードする場合は、パッケージのバージョンを、現在インストールされているバージョンと比較します。

      Available Packages
      Name         : redhat-release
      Version      : 8.3
      Release      : 1.0.el8
      …​

      注意

      通常、Red Hat Enterprise Linux Advanced Virtualization モジュールは、Red Hat Enterprise Linux y-stream よりも遅れてリリースされます。新しい Advanced Virtualization モジュールがまだ利用できない場合や、有効化した際にエラーが発生した場合は、ここで停止してアップグレードを取り消します。取り消さない場合は、ホストが破損するリスクがあります。

   3. Red Hat Enterprise Linux 8.3 以降の Advanced Virtualization ストリームが利用できる場合は、virt モジュールをリセットします。

      # dnf module reset virt

      注記

      Advanced Virtualization ストリームでこのモジュールがすでに有効になっている場合は、このステップは必要なく、マイナス要因となることもありません。

      以下を入力してストリームの値を確認できます。

      # dnf module list virt

   4. 以下のコマンドを使用して、Advanced Virtualization ストリームで virt モジュールを有効にします。

      • RHV 4.4.2 の場合:

        # dnf module enable virt:8.2

      • RHV 4.4.3 から 4.4.5 に対応しています。

        # dnf module enable virt:8.3

      • RHV 4.4.6 - 4.4.10 の場合:

        # dnf module enable virt:av

      • RHV 4.4 以降の場合:

        # dnf module enable virt:rhel

        注記

        RHEL 8.6 以降、Advanced Virtualization パッケージは標準の virt:rhel モジュールを使用します。RHEL 8.4 および 8.5 では、1 つの Advanced Virtualization ストリーム rhel:av のみが使用されます。

5. nodejs モジュールのバージョン 14 を有効にします。

   # dnf module -y enable nodejs:14

6. ホストを更新します。

   # dnf upgrade --nobest

7. すべての更新が正常に適用されるように、ホストを再起動します。

   注記

   imgbased ログを確認して、Red Hat Virtualization Host 向けの追加パッケージの更新に失敗したものがないかを確認します。更新後に一部のパッケージの再インストールに失敗した場合は、そのパッケージが /var/imgbased/persisted-rpms に記載されていることを確認します。足りないパッケージを追加してから rpm -Uvh /var/imgbased/persisted-rpms/* を実行します。