3.2. バックアップと移行

手順

1. セルフホスト型エンジンノードの 1 つにログインし、環境をグローバルメンテナンスモードに移行します。

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

2. 元の Manager にログインし、ovirt-engine サービスを停止します。

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

   注記

   元の Manager の実行を停止することは必須ではありませんが、バックアップの作成後に環境を変更しないように推奨しています。さらに、元の Manager と新しい Manager が既存リソースを同時に管理しないようにします。

3. 作成するバックアップファイルの名前と、バックアップログを保存するログファイルの名前を指定して、engine-backup コマンドを実行します。

   # engine-backup --mode=backup --file=file_name --log=log_file_name

4. ファイルを外部サーバーにコピーします。以下の例の storage.example.com は、必要になるまでバックアップを保存するネットワークストレージサーバーの完全修飾ドメイン名です。/backup/ は指定のフォルダーまたはパスです。

   # scp -p file_name log_file_name storage.example.com:/backup/

5. Manager マシンを他の目的で必要としない場合は、Red Hat Subscription Manager から登録を解除します。

   # subscription-manager unregister

6. セルフホスト型エンジンノードの 1 つにログインし、元の Manager 仮想マシンをシャットダウンします。

   # hosted-engine --vm-shutdown

手順

1. バックアップファイルを新規ホストにコピーします。以下の例では、host.example.com はホストの FQDN、/backup/ は指定されたフォルダーまたはパスです。

   # scp -p file_name host.example.com:/backup/

2. 新しいホストにログインします。

3. Red Hat Virtualization Host にデプロイする場合、ovirt-hosted-engine-setup はすでにインストールされているため、この手順を省略します。Red Hat Enterprise Linux にデプロイする場合は、ovirt-hosted-engine-setup パッケージをインストールします。

   # dnf install ovirt-hosted-engine-setup

4. ネットワークやターミナルが切断された場合などにセッションが失われないように、tmux ウィンドウマネージャーを使用してスクリプトを実行します。

   tmux をインストールし、実行します。

   # dnf -y install tmux
   # tmux

5. バックアップファイルへのパスを指定して hosted-engine スクリプトを実行します。

   # hosted-engine --deploy --restore-from-file=backup/file_name

   任意のタイミングでスクリプトをエスケープするには、CTRL+D を使用してデプロイメントを中止します。

6. Yes を選択してデプロイメントを開始します。
7. ネットワークを設定します。スクリプトにより、環境の管理ブリッジとして使用する NIC 候補が検出されます。
8. 仮想マシンのインストールにカスタムアプライアンスを使用する場合は、OVA アーカイブへのパスを入力します。使用しない場合は、このフィールドを空欄のままにして RHV-M Appliance を使用します。
9. Manager の root パスワードを入力します。
10. root ユーザーとして Manager にログインできる SSH 公開鍵を入力し、root ユーザーの SSH アクセスを有効にするかどうかを指定します。
11. 仮想マシンの CPU およびメモリー設定を入力します。
12. Manager 用仮想マシンの MAC アドレスを入力するか、無作為に生成される MAC アドレスを適用します。Manager 用仮想マシンへの IP アドレス割り当てに DHCP を使用する場合は、この MAC アドレスに有効な DHCP 予約があることを確認してください。デプロイメントスクリプトは、DHCP サーバーの設定は行いません。

13. 仮想マシンのネットワーク情報を入力します。Static を指定する場合は、Manager の IP アドレスを入力します。

    重要

    静的 IP アドレスは、ホストと同じサブネットに属している必要があります。たとえばホストが 10.1.1.0/24 内にある場合、Manager 用仮想マシンの IP は同じサブネット範囲 (10.1.1.1-254/24) になければなりません。

14. Manager 用仮想マシンおよびベースホストのエントリーを、仮想マシンの /etc/hosts ファイルに追加するかどうかを指定します。ホスト名は解決可能でなければなりません。
15. SMTP サーバーの名前と TCP ポート番号、メール通知を送信するメールアドレス、メール通知を受信するメールアドレス (複数ある場合はコンマ区切りリスト) を指定します。

16. 管理ポータルにアクセスする際に使用する admin@internal ユーザーのパスワードを入力します。

    スクリプトにより仮想マシンが作成されます。RHV-M Appliance をインストールする必要がある場合は、時間がかかることがあります。

    注記

    必要なネットワークがないなどの理由でホストが動作しなくなると、デプロイが一時停止し、次のようなメッセージが表示されます。

    [ INFO  ] You can now connect to https://<host name>:6900/ovirt-engine/ and check the status of this host and eventually remediate it, please continue only when the host is listed as 'up'
    [ INFO  ] TASK [ovirt.ovirt.hosted_engine_setup : include_tasks]
    [ INFO  ] ok: [localhost]
    [ INFO  ] TASK [ovirt.ovirt.hosted_engine_setup : Create temporary lock file]
    [ INFO  ] changed: [localhost]
    [ INFO  ] TASK [ovirt.ovirt.hosted_engine_setup : Pause execution until /tmp/ansible.<random>_he_setup_lock is removed, delete it once ready to proceed]

    プロセスを一時停止すると、以下が可能になります。

    • 提供された URL を使用して管理ポータルに接続します。
    • 状況を評価し、ホストが動作していない理由を調べ、必要に応じて修正します。たとえば、このデプロイメントがバックアップから復元され、ホストクラスターに 必要なネットワーク がバックアップに含まれている場合は、ネットワークを設定し、関連するホスト NIC をこれらのネットワークに接続します。
    • すべてが正常に見え、ホストのステータスが Up になったら、上記のメッセージに表示されているロックファイルを削除します。デプロイメントは続行されます。

17. 使用するストレージのタイプを選択します。

    • NFS の場合は、バージョン、完全なアドレス、ストレージへのパスおよびマウントオプションを入力します。

      警告

      仮想マシンのデータが失われるリスクがあるため、古いセルフホスト型エンジンストレージドメインのマウントポイントを新しいストレージドメインに使用しないでください。

    • iSCSI の場合は、ポータルの詳細を入力し、自動検出された一覧からターゲットおよび LUN を選択します。デプロイメント時に選択できる iSCSI ターゲットは 1 つだけですが、マルチパスがサポートされているので、同じポータルグループのポータルをすべて接続できます。

      注記

      複数の iSCSI ターゲットを指定するには、セルフホストエンジンをデプロイする前にマルチパスを有効にする必要があります。詳細は、Red Hat Enterprise Linux DM マルチパス を参照してください。Multipath Helper ツールを使用して、さまざまなオプションでマルチパスをインストールおよび設定するスクリプトを生成することもできます。

    • Gluster ストレージの場合は、完全なアドレスおよびストレージへのパスならびにマウントオプションを入力します。

      警告

      仮想マシンのデータが失われるリスクがあるため、古いセルフホスト型エンジンストレージドメインのマウントポイントを新しいストレージドメインに使用しないでください。

      重要

      レプリカ 1 およびレプリカ 3 Gluster ストレージのみがサポートされます。必ず以下のようにボリュームを設定します。

      gluster volume set VOLUME_NAME group virt
      gluster volume set VOLUME_NAME performance.strict-o-direct on
      gluster volume set VOLUME_NAME network.remote-dio off
      gluster volume set VOLUME_NAME storage.owner-uid 36
      gluster volume set VOLUME_NAME storage.owner-gid 36
      gluster volume set VOLUME_NAME network.ping-timeout 30

    • ファイバーチャネルの場合は、自動検出された一覧から LUN を選択します。ホストのバスアダプターが設定および接続されている必要があります。また、LUN には既存のデータが含まれないようにする必要があります。既存の LUN を再利用するには、管理ガイド の LUN の再利用 を参照してください。

18. Manager のディスクサイズを入力します。

    スクリプトはデプロイメントが完了するまで続行されます。

19. デプロイメントプロセスでは Manager の SSH キーが変更されます。クライアントマシンが SSH エラーなしで新規の Manager にアクセスできるようにするには、元の Manager にアクセスするクライアントマシンの .ssh/known_hosts ファイルから元の Manager のエントリーを削除します。

手順

1. コンテンツ配信ネットワークにシステムを登録します。プロンプトが表示されたら、カスタマーポータルのユーザー名とパスワードを入力します。

   # subscription-manager register

   注記

   IPv6 ネットワークを使用している場合は、IPv6 移行メカニズムを使用して、コンテンツ配信ネットワークおよびサブスクリプションマネージャーにアクセスします。

2. Red Hat Virtualization Manager のサブスクリプションプールを見つけ、プール ID を記録します。

   # subscription-manager list --available

3. 上記のプール ID を使用して、サブスクリプションをシステムにアタッチします。

   # subscription-manager attach --pool=pool_id

   注記

   現在アタッチされているサブスクリプションを表示するには、以下のコマンドを実行します。

   # subscription-manager list --consumed

   有効なリポジトリーをすべて一覧表示するには、以下のコマンドを実行します。

   # dnf repolist

4. リポジトリーを設定します。

   # subscription-manager repos \
       --disable='*' \
       --enable=rhel-8-for-x86_64-baseos-eus-rpms \
       --enable=rhel-8-for-x86_64-appstream-eus-rpms \
       --enable=rhv-4.4-manager-for-rhel-8-x86_64-rpms \
       --enable=fast-datapath-for-rhel-8-x86_64-rpms \
       --enable=jb-eap-7.4-for-rhel-8-x86_64-rpms \
       --enable=openstack-16.2-cinderlib-for-rhel-8-x86_64-rpms \
       --enable=rhceph-4-tools-for-rhel-8-x86_64-rpms

5. RHEL のバージョンを 8.6 に設定します。

   # subscription-manager release --set=8.6

6. pki-deps モジュールを有効にします。

   # dnf module -y enable pki-deps

7. postgresql モジュールのバージョン 12 を有効にします。

   # dnf module -y enable postgresql:12

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

   # dnf module -y enable nodejs:14

9. インストール済みパッケージを同期して、利用可能な最新バージョンに更新します。

   # dnf distro-sync --nobest

手順

1. Compute → Hosts をクリックし、ホストを選択します。
2. Management → Maintenance をクリックしてから OK をクリックします。
3. Installation → Reinstall をクリックします。Install Host ウィンドウが表示されます。
4. Hosted Engine タブをクリックし、ドロップダウンリストから DEPLOY を選択します。
5. OK をクリックして、ホストを再インストールします。

手順

1. Storage → Domains をクリックします。

2. ストレージドメインをメンテナンスモードに移動し、デタッチします。

   1. ストレージドメインの名前をクリックします。詳細ビューが開きます。
   2. Data Center タブをクリックします。
   3. Maintenance をクリックしてから OK をクリックします。
   4. Detach をクリックしてから OK をクリックします。
3. Remove をクリックします。
4. オプションで Format Domain, i.e. Storage Content will be lost! チェックボックスを選択して、ドメインのコンテンツを消去します。
5. OK をクリックします。

手順

1. バックアップファイルを新規ホストにコピーします。以下の例では、host.example.com はホストの FQDN、/backup/ は指定されたフォルダーまたはパスです。

   # scp -p file_name host.example.com:/backup/

2. 新しいホストにログインします。

3. Red Hat Virtualization Host にデプロイする場合、ovirt-hosted-engine-setup はすでにインストールされているため、この手順を省略します。Red Hat Enterprise Linux にデプロイする場合は、ovirt-hosted-engine-setup パッケージをインストールします。

   # dnf install ovirt-hosted-engine-setup

4. ネットワークやターミナルが切断された場合などにセッションが失われないように、tmux ウィンドウマネージャーを使用してスクリプトを実行します。

   tmux をインストールし、実行します。

   # dnf -y install tmux
   # tmux

5. バックアップファイルへのパスを指定して hosted-engine スクリプトを実行します。

   # hosted-engine --deploy --restore-from-file=backup/file_name

   任意のタイミングでスクリプトをエスケープするには、CTRL+D を使用してデプロイメントを中止します。

6. Yes を選択してデプロイメントを開始します。
7. ネットワークを設定します。スクリプトにより、環境の管理ブリッジとして使用する NIC 候補が検出されます。
8. 仮想マシンのインストールにカスタムアプライアンスを使用する場合は、OVA アーカイブへのパスを入力します。使用しない場合は、このフィールドを空欄のままにして RHV-M Appliance を使用します。
9. Manager の root パスワードを入力します。
10. root ユーザーとして Manager にログインできる SSH 公開鍵を入力し、root ユーザーの SSH アクセスを有効にするかどうかを指定します。
11. 仮想マシンの CPU およびメモリー設定を入力します。
12. Manager 用仮想マシンの MAC アドレスを入力するか、無作為に生成される MAC アドレスを適用します。Manager 用仮想マシンへの IP アドレス割り当てに DHCP を使用する場合は、この MAC アドレスに有効な DHCP 予約があることを確認してください。デプロイメントスクリプトは、DHCP サーバーの設定は行いません。

13. 仮想マシンのネットワーク情報を入力します。Static を指定する場合は、Manager の IP アドレスを入力します。

    重要

    静的 IP アドレスは、ホストと同じサブネットに属している必要があります。たとえばホストが 10.1.1.0/24 内にある場合、Manager 用仮想マシンの IP は同じサブネット範囲 (10.1.1.1-254/24) になければなりません。

14. Manager 用仮想マシンおよびベースホストのエントリーを、仮想マシンの /etc/hosts ファイルに追加するかどうかを指定します。ホスト名は解決可能でなければなりません。
15. SMTP サーバーの名前と TCP ポート番号、メール通知を送信するメールアドレス、メール通知を受信するメールアドレス (複数ある場合はコンマ区切りリスト) を指定します。

16. 管理ポータルにアクセスする際に使用する admin@internal ユーザーのパスワードを入力します。

    スクリプトにより仮想マシンが作成されます。RHV-M Appliance をインストールする必要がある場合は、時間がかかることがあります。

    注記

    必要なネットワークがないなどの理由でホストが動作しなくなると、デプロイが一時停止し、次のようなメッセージが表示されます。

    [ INFO  ] You can now connect to https://<host name>:6900/ovirt-engine/ and check the status of this host and eventually remediate it, please continue only when the host is listed as 'up'
    [ INFO  ] TASK [ovirt.ovirt.hosted_engine_setup : include_tasks]
    [ INFO  ] ok: [localhost]
    [ INFO  ] TASK [ovirt.ovirt.hosted_engine_setup : Create temporary lock file]
    [ INFO  ] changed: [localhost]
    [ INFO  ] TASK [ovirt.ovirt.hosted_engine_setup : Pause execution until /tmp/ansible.<random>_he_setup_lock is removed, delete it once ready to proceed]

    プロセスを一時停止すると、以下が可能になります。

    • 提供された URL を使用して管理ポータルに接続します。
    • 状況を評価し、ホストが動作していない理由を調べ、必要に応じて修正します。たとえば、このデプロイメントがバックアップから復元され、ホストクラスターに 必要なネットワーク がバックアップに含まれている場合は、ネットワークを設定し、関連するホスト NIC をこれらのネットワークに接続します。
    • すべてが正常に見え、ホストのステータスが Up になったら、上記のメッセージに表示されているロックファイルを削除します。デプロイメントは続行されます。

17. 使用するストレージのタイプを選択します。

    • NFS の場合は、バージョン、完全なアドレス、ストレージへのパスおよびマウントオプションを入力します。

      警告

      仮想マシンのデータが失われるリスクがあるため、古いセルフホスト型エンジンストレージドメインのマウントポイントを新しいストレージドメインに使用しないでください。

    • iSCSI の場合は、ポータルの詳細を入力し、自動検出された一覧からターゲットおよび LUN を選択します。デプロイメント時に選択できる iSCSI ターゲットは 1 つだけですが、マルチパスがサポートされているので、同じポータルグループのポータルをすべて接続できます。

      注記

      複数の iSCSI ターゲットを指定するには、セルフホストエンジンをデプロイする前にマルチパスを有効にする必要があります。詳細は、Red Hat Enterprise Linux DM マルチパス を参照してください。Multipath Helper ツールを使用して、さまざまなオプションでマルチパスをインストールおよび設定するスクリプトを生成することもできます。

    • Gluster ストレージの場合は、完全なアドレスおよびストレージへのパスならびにマウントオプションを入力します。

      警告

      仮想マシンのデータが失われるリスクがあるため、古いセルフホスト型エンジンストレージドメインのマウントポイントを新しいストレージドメインに使用しないでください。

      重要

      レプリカ 1 およびレプリカ 3 Gluster ストレージのみがサポートされます。必ず以下のようにボリュームを設定します。

      gluster volume set VOLUME_NAME group virt
      gluster volume set VOLUME_NAME performance.strict-o-direct on
      gluster volume set VOLUME_NAME network.remote-dio off
      gluster volume set VOLUME_NAME storage.owner-uid 36
      gluster volume set VOLUME_NAME storage.owner-gid 36
      gluster volume set VOLUME_NAME network.ping-timeout 30

    • ファイバーチャネルの場合は、自動検出された一覧から LUN を選択します。ホストのバスアダプターが設定および接続されている必要があります。また、LUN には既存のデータが含まれないようにする必要があります。既存の LUN を再利用するには、管理ガイド の LUN の再利用 を参照してください。

18. Manager のディスクサイズを入力します。

    スクリプトはデプロイメントが完了するまで続行されます。

19. デプロイメントプロセスでは Manager の SSH キーが変更されます。クライアントマシンが SSH エラーなしで新規の Manager にアクセスできるようにするには、元の Manager にアクセスするクライアントマシンの .ssh/known_hosts ファイルから元の Manager のエントリーを削除します。

手順

1. コンテンツ配信ネットワークにシステムを登録します。プロンプトが表示されたら、カスタマーポータルのユーザー名とパスワードを入力します。

   # subscription-manager register

   注記

   IPv6 ネットワークを使用している場合は、IPv6 移行メカニズムを使用して、コンテンツ配信ネットワークおよびサブスクリプションマネージャーにアクセスします。

2. Red Hat Virtualization Manager のサブスクリプションプールを見つけ、プール ID を記録します。

   # subscription-manager list --available

3. 上記のプール ID を使用して、サブスクリプションをシステムにアタッチします。

   # subscription-manager attach --pool=pool_id

   注記

   現在アタッチされているサブスクリプションを表示するには、以下のコマンドを実行します。

   # subscription-manager list --consumed

   有効なリポジトリーをすべて一覧表示するには、以下のコマンドを実行します。

   # dnf repolist

4. リポジトリーを設定します。

   # subscription-manager repos \
       --disable='*' \
       --enable=rhel-8-for-x86_64-baseos-eus-rpms \
       --enable=rhel-8-for-x86_64-appstream-eus-rpms \
       --enable=rhv-4.4-manager-for-rhel-8-x86_64-rpms \
       --enable=fast-datapath-for-rhel-8-x86_64-rpms \
       --enable=jb-eap-7.4-for-rhel-8-x86_64-rpms \
       --enable=openstack-16.2-cinderlib-for-rhel-8-x86_64-rpms \
       --enable=rhceph-4-tools-for-rhel-8-x86_64-rpms

5. RHEL のバージョンを 8.6 に設定します。

   # subscription-manager release --set=8.6

6. pki-deps モジュールを有効にします。

   # dnf module -y enable pki-deps

7. postgresql モジュールのバージョン 12 を有効にします。

   # dnf module -y enable postgresql:12

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

   # dnf module -y enable nodejs:14

9. インストール済みパッケージを同期して、利用可能な最新バージョンに更新します。

   # dnf distro-sync --nobest

手順

1. Compute → Hosts をクリックし、ホストを選択します。
2. Management → Maintenance をクリックしてから OK をクリックします。
3. Installation → Reinstall をクリックします。Install Host ウィンドウが表示されます。
4. Hosted Engine タブをクリックし、ドロップダウンリストから DEPLOY を選択します。
5. OK をクリックして、ホストを再インストールします。

手順

1. Storage → Domains をクリックします。

2. ストレージドメインをメンテナンスモードに移動し、デタッチします。

   1. ストレージドメインの名前をクリックします。詳細ビューが開きます。
   2. Data Center タブをクリックします。
   3. Maintenance をクリックしてから OK をクリックします。
   4. Detach をクリックしてから OK をクリックします。
3. Remove をクリックします。
4. オプションで Format Domain, i.e. Storage Content will be lost! チェックボックスを選択して、ドメインのコンテンツを消去します。
5. OK をクリックします。

手順

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

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

2. 作業を進める前に、環境がグローバルメンテナンスモードにあることを確認します。

   # hosted-engine --vm-status

   クラスターがグローバルメンテナンスモードにあることを示すメッセージが表示されるはずです。

手順

1. Manager マシンにログインします。

2. 設定ファイルを削除し、Manager に関連付けられているデータベースをクリーンアップします。

   # engine-cleanup

   engine-cleanup コマンドは、Manager データベースのみを削除します。データベースを削除したり、そのデータベースを所有しているユーザーを削除したりすることはありません。

3. 完全バックアップまたはデータベースのみのバックアップを復元します。ユーザーとデータベースがすでに存在しているので、新規のデータベースを作成したり、データベースの認証情報を指定する必要はありません。

   • 完全バックアップを復元します。

     # engine-backup --mode=restore --file=file_name --log=log_file_name --restore-permissions

   • 設定ファイルおよびデータベースバックアップを復元して、データベースのみのバックアップを復元します。

     # engine-backup --mode=restore --scope=files --scope=db --scope=dwhdb --file=file_name --log=log_file_name --restore-permissions

     注記

     Manager データベースのみを復元するには (たとえば、Data Warehouse データベースが別のマシンにある場合)、-scope=dwhdb パラメーターを省略できます。

     成功すると、次の出力が表示されます。

     You should now run engine-setup.
     Done.

4. Manager を再設定します。

   # engine-setup

手順

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. コンテンツ配信ネットワークにシステムを登録します。プロンプトが表示されたら、カスタマーポータルのユーザー名とパスワードを入力します。

   # subscription-manager register

   注記

   IPv6 ネットワークを使用している場合は、IPv6 移行メカニズムを使用して、コンテンツ配信ネットワークおよびサブスクリプションマネージャーにアクセスします。

2. Red Hat Virtualization Manager のサブスクリプションプールを見つけ、プール ID を記録します。

   # subscription-manager list --available

3. 上記のプール ID を使用して、サブスクリプションをシステムにアタッチします。

   # subscription-manager attach --pool=pool_id

   注記

   現在アタッチされているサブスクリプションを表示するには、以下のコマンドを実行します。

   # subscription-manager list --consumed

   有効なリポジトリーをすべて一覧表示するには、以下のコマンドを実行します。

   # dnf repolist

4. リポジトリーを設定します。

   # subscription-manager repos \
       --disable='*' \
       --enable=rhel-8-for-x86_64-baseos-eus-rpms \
       --enable=rhel-8-for-x86_64-appstream-eus-rpms \
       --enable=rhv-4.4-manager-for-rhel-8-x86_64-rpms \
       --enable=fast-datapath-for-rhel-8-x86_64-rpms \
       --enable=jb-eap-7.4-for-rhel-8-x86_64-rpms \
       --enable=openstack-16.2-cinderlib-for-rhel-8-x86_64-rpms \
       --enable=rhceph-4-tools-for-rhel-8-x86_64-rpms

5. RHEL のバージョンを 8.6 に設定します。

   # subscription-manager release --set=8.6

6. postgresql モジュールのバージョン 12 を有効にします。

   # dnf module -y enable postgresql:12

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

   # dnf module -y enable nodejs:14

8. インストール済みパッケージを同期して、利用可能な最新バージョンに更新します。

   # dnf distro-sync --nobest

手順

1. Manager で Data Warehouse データベースおよび設定ファイルのバックアップを作成します。

   # engine-backup --mode=backup --scope=grafanadb --scope=dwhdb --scope=files --file=file_name --log=log_file_name

2. そのバックアップファイルを Manager マシンから新たなマシンにコピーします。

   # scp /tmp/file_name root@new.dwh.server.com:/tmp

3. engine-backup を新しいマシンにインストールします。

   # dnf install ovirt-engine-tools-backup

4. PostgreSQL サーバーパッケージをインストールします。

   # dnf install postgresql-server postgresql-contrib

5. PostgreSQL データベースを初期化し、postgresql サービスを開始して、このサービスが起動時に開始されることを確認します。

   # su - postgres -c 'initdb'
   # systemctl enable postgresql
   # systemctl start postgresql

6. 新しいマシンで Data Warehouse データベースを復元します。file_name は、Manager からコピーされたバックアップファイルです。

   # engine-backup --mode=restore --scope=files --scope=grafanadb --scope=dwhdb --file=file_name --log=log_file_name --provision-dwh-db

   復元モードで --provision-* オプションを使用すると、デフォルトで --restore-permissions が適用されます。

1. 必要なリポジトリーを有効にします。

   1. コンテンツ配信ネットワークにシステムを登録します。プロンプトが表示されたら、カスタマーポータルのユーザー名とパスワードを入力します。

      # subscription-manager register

   2. Red Hat Virtualization Manager のサブスクリプションプールを見つけ、プール ID を記録します。

      # subscription-manager list --available

   3. 上記のプール ID を使用して、サブスクリプションをシステムにアタッチします。

      # subscription-manager attach --pool=pool_id

   4. リポジトリーを設定します。

      # subscription-manager repos \
          --disable='*' \
          --enable=rhel-8-for-x86_64-baseos-eus-rpms \
          --enable=rhel-8-for-x86_64-appstream-eus-rpms \
          --enable=rhv-4.4-manager-for-rhel-8-x86_64-rpms \
          --enable=fast-datapath-for-rhel-8-x86_64-rpms \
          --enable=jb-eap-7.4-for-rhel-8-x86_64-rpms
      
      # subscription-manager release --set=8.6

2. pki-deps モジュールを有効にします。

   # dnf module -y enable pki-deps

3. 現在インストールされている全パッケージを最新の状態にします。

   # dnf upgrade --nobest

4. ovirt-engine-dwh-setup パッケージをインストールします。

   # dnf install ovirt-engine-dwh-setup

手順

1. Data Warehouse サービスを停止します。

   # systemctl stop ovirt-engine-dwhd.service

2. データベースがリモートマシンでホストされる場合は、postgres.conf ファイルを編集して手動でアクセス権限を付与する必要があります。/var/lib/pgsql/data/postgresql.conf ファイルを編集し、listen_addresses 行を変更して以下と一致するようにします。

   listen_addresses = '*'

   その行が存在しない、またはコメントアウトされている場合は、手動で追加します。

   Manager マシンでデータベースがホストされていて、そのデータベースが Red Hat Virtualization Manager のクリーンセットアップ中に設定された場合は、デフォルトでアクセス権限が付与されます。

3. postgresql サービスを再起動します。

   # systemctl restart postgresql

1. ovirt_engine_history データベースと Data Warehouse サービスの両方を 同じ マシンに移行する場合は、以下のコマンドを実行します。移行しない場合は、次のステップに進みます。

   # sed -i '/^ENGINE_DB_/d' \
           /etc/ovirt-engine-dwh/ovirt-engine-dwhd.conf.d/10-setup-database.conf
   
   # sed -i \
        -e 's;^\(OVESETUP_ENGINE_CORE/enable=bool\):True;\1:False;' \
        -e '/^OVESETUP_CONFIG\/fqdn/d' \
        /etc/ovirt-engine-setup.conf.d/20-setup-ovirt-post.conf

2. apache/grafana PKI ファイルを削除して、engine-setup によって正しい値で再生成されるようにします。

   # rm -f \
     /etc/pki/ovirt-engine/certs/apache.cer \
     /etc/pki/ovirt-engine/certs/apache-grafana.cer \
     /etc/pki/ovirt-engine/keys/apache.key.nopass \
     /etc/pki/ovirt-engine/keys/apache-grafana.key.nopass \
     /etc/pki/ovirt-engine/apache-ca.pem \
     /etc/pki/ovirt-engine/apache-grafana-ca.pem

3. engine-setup コマンドを実行し、マシンでの Data Warehouse の設定を開始します。

   # engine-setup

4. Enter キーを押して自動検出されたホスト名をそのまま使用するか、別のホスト名を入力して Enter キーを押します。

   Host fully qualified DNS name of this server [autodetected host name]:

5. Enter キーを押して､ファイアウォールを自動設定するか、No と入力し､Enter キーを押して、既存の設定を維持します。

   Setup can automatically configure the firewall on this system.
   Note: automatic configuration of the firewall may overwrite current settings.
   Do you want Setup to configure the firewall? (Yes, No) [Yes]:

   ファイアウォールの自動設定を選択した場合に、ファイアウォール管理機能がアクティブ化されていなければ、サポートされているオプション一覧から、選択したファイアウォール管理機能を指定するように要求されます。ファイアウォール管理機能の名前を入力して、Enter キーを押してください。この操作は、オプションが 1 つしかリストされていない場合でも必要です。

6. Manager の完全修飾ドメイン名およびパスワードを入力します。その他のフィールドについては、Enter キーを押してそれぞれのデフォルト値をそのまま使用します。

   Host fully qualified DNS name of the engine server []: engine-fqdn
   Setup needs to do some actions on the remote engine server. Either automatically, using ssh as root to access it, or you will be prompted to manually perform each such action.
   Please choose one of the following:
   1 - Access remote engine server using ssh as root
   2 - Perform each action manually, use files to copy content around
   (1, 2) [1]:
   ssh port on remote engine server [22]:
   root password on remote engine server engine-fqdn: password

7. Manager データベースマシンの完全修飾ドメイン名 (FQDN) およびパスワードを入力します。その他のフィールドについては、Enter キーを押してそれぞれのデフォルト値をそのまま使用します。

   Engine database host []: manager-db-fqdn
   Engine database port [5432]:
   Engine database secured connection (Yes, No) [No]:
   Engine database name [engine]:
   Engine database user [engine]:
   Engine database password: password

8. インストールの設定を確認します。

   Please confirm installation settings (OK, Cancel) [OK]:

手順

1. Manager マシンで Manager を再起動します。

   # service ovirt-engine restart

2. 以下のコマンドを実行して /etc/ovirt-engine-setup.conf.d/20-setup-ovirt-post.conf ファイルを変更し、オプションを False に設定します。

   # sed -i \
        -e 's;^\(OVESETUP_DWH_CORE/enable=bool\):True;\1:False;' \
        -e 's;^\(OVESETUP_DWH_CONFIG/remoteEngineConfigured=bool\):True;\1:False;' \
        /etc/ovirt-engine-setup.conf.d/20-setup-ovirt-post.conf
   
   # sed -i \
        -e 's;^\(OVESETUP_GRAFANA_CORE/enable=bool\):True;\1:False;' \
        /etc/ovirt-engine-setup.conf.d/20-setup-ovirt-post.conf

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

   # systemctl disable ovirt-engine-dwhd.service

4. Data Warehouse に関するファイルを削除します。

   # rm -f /etc/ovirt-engine-dwh/ovirt-engine-dwhd.conf.d/*.conf /var/lib/ovirt-engine-dwh/backups/*

1. バックアップアプリケーションは、REST API を使用して、バックアップに含める必要のある 仮想マシンディスクを検索 します。QCOW2 形式のディスクのみが含まれています。
2. バックアップアプリケーションは、完全バックアップ または 増分バックアップ を開始します。API 呼び出しは、仮想マシン ID、オプションの以前のチェックポイント ID、およびバックアップするディスクのリストを指定します。API 呼び出しで以前のチェックポイント ID が指定されていない場合は、各ディスクの現在の状態に基づいて、指定されたディスク内のすべてのデータを含む完全バックアップが開始されます。
3. エンジンは、バックアップ用に仮想マシンを準備します。仮想マシンは、バックアップ中も実行を継続できます。
4. バックアップアプリケーションは、バックアップを開始する準備ができたことをエンジンが報告するまで、バックアップステータスについてエンジンをポーリングします。
5. バックアップを開始する準備ができると、バックアップアプリケーションは、バックアップに含まれるすべてのディスクに対して イメージ転送オブジェクトを作成 します。
6. バックアップアプリケーションは、イメージ転送ごとに ovirt-imageio から変更されたブロックのリストを取得 します。変更リストが利用できない場合、バックアップアプリケーションはエラーになります。
7. バックアップアプリケーションは、変更されたブロックを RAW 形式で ovirt-imageio からダウンロードし、バックアップメディアに保存 します。変更されたブロックのリストが利用できない場合、バックアップアプリケーションはディスク全体のコピーにフォールバックできます。
8. バックアップアプリケーションは、すべてのイメージ転送を完了します。
9. バックアップアプリケーションは、REST API を使用してバックアップを完了 します。

1. ユーザーは、バックアップアプリケーションを使用して、使用可能なバックアップに基づき復元ポイントを選択します。
2. バックアップアプリケーションは、復元されたデータを保持するために、新しいディスク、または既存のディスクを持つスナップショットを作成します。
3. バックアップアプリケーションは、format が raw であることを指定して、ディスクごとにアップロードイメージの転送を開始 します。これにより、RAW データを QCOW2 ディスクにアップロードするときにフォーマット変換が可能になります。
4. バックアップアプリケーションは、API を使用してこの復元ポイントに含まれるデータを imageio に転送 します。
5. バックアップアプリケーションは、イメージ転送を完了します。

手順

1. 新しい仮想ディスクを追加します。詳細は、仮想ディスクの作成 を参照してください。
2. ディスクを設定するときは、Enable Incremental Backup チェックボックスをオンにします。

手順

1. 管理ポータルで Compute → Virtual Machines をクリックします。
2. 仮想マシンを選択し、Disks タブをクリックします。
3. Edit ボタンをクリックします。Edit Disk ダイアログボックスが開きます。
4. Enable Incremental Backup チェックボックスを選択します。

手順

1. 仮想マシンに接続されているディスクを一覧表示します。たとえば、ID 123 の仮想マシンの場合は、以下の要求を送信します。

   GET /ovirt-engine/api/vms/123/diskattachments

   応答にはすべての disk_attachment オブジェクトが含まれ、各オブジェクトには 1 つ以上の disk オブジェクトが含まれます。以下に例を示します。

   <disk_attachments>
       <disk_attachment>
          …​
          <disk href="/ovirt-engine/api/disks/456" id="456"/>
          …​
       </disk_attachment>
       …​
   </disk_attachments>

2. disk サービスを使用して、前の手順のディスクプロパティーを表示します。たとえば、ID 456 のディスクの場合は、以下の要求を送信します。

   GET /ovirt-engine/api/disks/456

   応答には、ディスクのすべてのプロパティーが含まれます。backup は none または incremental に設定されています。以下に例を示します。

   <disk href="/ovirt-engine/api/disks/456" id="456">
       …​
       <backup>incremental</backup>
       …​
   </disk>

手順

1. バックアップを作成する仮想マシンを指定する要求を送信します。たとえば、以下のように ID 123 の仮想マシンを指定します。

   POST /ovirt-engine/api/vms/123/backups

2. 要求の本文で、バックアップを作成するディスクを指定します。たとえば、ID 456 のディスクのフルバックアップを開始するには、以下の要求本文を送信します。

   <backup>
       <disks>
          <disk id="456" />
          …​
       </disks>
   </backup>

   応答本文は以下のようになります。

   <backup id="789">
       <disks>
          <disk id="456" />
          …​
          …​
       </disks>
       <status>initializing</status>
       <creation_date>
   </backup>

   応答には以下が含まれます。

   • バックアップ ID
   • バックアップのステータス。バックアップが初期化中であることを示します。
3. ステータスが ready になるまでバックアップをポーリングします。応答には、to_checkpoint_id が含まれます。この ID をメモし、次の増分バックアップで from_checkpoint_id に使用します。

手順

1. バックアップを作成する仮想マシンを指定する要求を送信します。たとえば、以下のように ID 123 の仮想マシンを指定します。

   POST /ovirt-engine/api/vms/123/backups

2. 要求の本文で、バックアップを作成するディスクを指定します。たとえば、ID 456 のディスクの増分バックアップを開始するには、以下の要求本文を送信します。

   <backup>
       <from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
       <disks>
          <disk id="456" />
          …​
       </disks>
   </backup>

   注記

   要求本文に、前のチェックポイントに含まれていないディスクを含めると、要求はこのディスクの完全バックアップも実行します。たとえば、ID 789 のディスクはまだバックアップされていません。上記の要求本文に 789 のフルバックアップを追加するには、次のような要求本文を送信します。

   <backup>
       <from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
       <disks>
          <disk id="456" />
          <disk id="789" />
          …​
       </disks>
   </backup>

   応答本文は以下のようになります。

   <backup id="101112">
   <from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
   <to_checkpoint_id>new-checkpoint-uuid</to_checkpoint_id>
       <disks>
          <disk id="456" />
          <disk id="789" />
          …​
          …​
       </disks>
       <status>initializing</status>
       <creation_date>
   </backup>

   応答には以下が含まれます。

   • バックアップ ID
   • バックアップに含まれていたディスクの ID。
   • バックアップが初期化中であることを示すステータス。
3. ステータスが ready になるまでバックアップをポーリングします。応答には、to_checkpoint_id が含まれます。この ID をメモし、次の増分バックアップで from_checkpoint_id に使用します。

手順

1. 次のような要求を送信します。

   POST /ovirt-engine/api/imagetransfers

2. 要求本文で、次のパラメーターを指定します。

   • ディスク ID
   • バックアップ ID
   • download するディスクセットの方向
   • raw に設定されたディスクのフォーマット

   たとえば、ディスクの ID が 123 で、バックアップの ID が 456 であるディスクのバックアップを転送するには、次の要求本文を送信します。

   <image_transfer>
       <disk id="123"/>
       <backup id="456"/>
       <direction>download</direction>
       <format>raw</format>
   </image_transfer>

手順

1. 次のような要求を送信します。

   POST /ovirt-engine/api/imagetransfers

2. 要求本文で、次のパラメーターを指定します。

   • ディスク ID またはスナップショット ID
   • upload を行うディスクセットの方向
   • raw に設定されたディスクのフォーマット

   たとえば、ディスクの ID が 123 であるディスクのバックアップを転送するには、次の要求本文を送信します。

   <image_transfer>
       <disk id="123"/>
       <direction>upload</direction>
       <format>raw</format>
   </image_transfer>