Migration Toolkit for Virtualization のインストールおよび使用
VMware vSphere または Red Hat Virtualization から Red Hat OpenShift Virtualization への移行
概要
多様性を受け入れるオープンソースの強化 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、用語の置き換えは、今後の複数のリリースにわたって段階的に実施されます。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。
第1章 Migration Toolkit for Virtualization について リンクのコピーリンクがクリップボードにコピーされました!
Migration Toolkit for Virtualization (MTV) を使用して、次の移行元プロバイダーから OpenShift Virtualization 移行先プロバイダーに仮想マシンを移行できます。
- VMware vSphere
- Red Hat Virtualization (RHV)
- OpenStack
- VMware vSphere によって作成された Open Virtual Appliances (OVA)
- リモートの OpenShift Virtualization クラスター
第2章 MTV コールド移行とウォーム移行の概要 リンクのコピーリンクがクリップボードにコピーされました!
コールド移行とは、電源が オフ になっている仮想マシン (VM) を別のホストに移行することです。仮想マシンの電源がオフになっているため、共通の共有ストレージは必要ありません。
ウォーム移行とは、電源が オン になっている仮想マシンを別のホストに移行することです。移行元ホストの状態が移行先ホストに複製されます。
ウォーム移行のプレコピー段階
- 実行中の仮想マシンディスクの初期スナップショットを作成します。
- 最初のスナップショットをターゲットにコピーします。フルディスク転送、コピーされるデータの量が最大になります。完了までにさらに時間がかかります。
差分のコピー: 変更されたデータ。最後のスナップショットが取得されてから変更されたデータのみをコピーします。完了までにかかる時間が短くなります。
- 新しいスナップショットを作成します。
- 以前のスナップショットと新しいスナップショット間の差分をコピーします。
- デフォルトで設定可能な次のスナップショットを、最後のスナップショットが終了してから 1 時間後にスケジュールします。
- 任意の数の差分をコピーできます。
ウォーム移行のカットオーバー段階
- ウォーム移行を完了するためのスケジュール時間
- ソースの仮想マシンをシャットダウンします。
- 最後のスナップショットの差分をターゲットにコピーします。
コールド移行と同じように続行します。
- ゲストの変換
- ターゲット仮想マシンの起動 (オプション)
2.1. 移行速度の比較 リンクのコピーリンクがクリップボードにコピーされました!
- ウォーム移行の単一ディスク転送およびディスク変換で得られる速度は、コールド移行の場合とほぼ同じです。
- ウォーム移行の利点は、仮想マシンの電源が オン の状態でスナップショットの転送がバックグラウンドで実行されることです。
- デフォルトでは、60 分ごとにスナップショットが作成されます。仮想マシンが大幅に変更された場合、仮想マシンの電源が オフ になっているときのコールド移行よりも多くのデータを転送する必要があります。
- カットオーバー時間、つまり仮想マシンのシャットダウンから最後のスナップショットの転送までの時間は、最後のスナップショット以降に仮想マシンがどの程度変更されたかによって異なります。
2.2. コールド移行とウォーム移行 リンクのコピーリンクがクリップボードにコピーされました!
MTV は、以下からのコールド移行をサポートしています。
- VMware vSphere
- Red Hat Virtualization (RHV)
- OpenStack
- リモートの OpenShift Virtualization クラスター
MTV は、VMware vSphere および RHV からのウォーム移行をサポートします。
2.2.1. コールド移行 リンクのコピーリンクがクリップボードにコピーされました!
コールド移行は、デフォルトの移行タイプです。ソース仮想マシンは、データのコピー中にシャットダウンします。
VMware のみ: コールド移行の場合、移行中にパッケージマネージャーを使用できない状況では、MTV は移行された仮想マシンに qemu-guest-agent デーモンをインストールしません。これにより、移行された仮想マシンの機能に多少の影響が出ますが、全体的には引き続き機能すると予想されます。
MTV が移行された VM に qemu-guest-agent を自動的にインストールできるようにするには、移行後に仮想マシンの初回起動時にパッケージマネージャーがデーモンをインストールできることを確認してください。
それが不可能な場合は、自動または手動の任意の手順を使用して、qemu-guest-agent をインストールしてください。
2.2.2. ウォーム移行 リンクのコピーリンクがクリップボードにコピーされました!
ほとんどのデータは、ソース仮想マシン (VM) の実行中に、プレコピー 段階でコピーされます。
その後、仮想マシンがシャットダウンされ、残りのデータが カットオーバー 段階でコピーされます。
プレコピー段階
仮想マシンはプレコピー段階ではシャットダウンされません。
仮想マシンディスクは、変更ブロックのトラッキング (CBT) スナップショットを使用して増分がコピーされます。スナップショットは、デフォルトでは 1 時間間隔で作成されます。forklift-controller デプロイメントを更新して、スナップショットの間隔を変更できます。
各ソース仮想マシンおよび各仮想マシンディスクに対して CBT を有効にする必要があります。
仮想マシンは、最大 28 CBT スナップショットをサポートします。ソース仮想マシンの CBT スナップショットが多すぎて、Migration Controller サービスが新規スナップショットを作成できない場合は、ウォーム移行に失敗する可能性があります。スナップショットが不要になると、Migration Controller サービスは各スナップショットを削除します。
プレコピー段階は、カットオーバー段階を手動で開始するか、開始がスケジュールされるまで実行されます。
カットオーバー段階
カットオーバーの段階で仮想マシンはシャットダウンされ、残りのデータは移行されます。RAM に格納されたデータは移行されません。
MTV コンソールを使用してカットオーバー段階を手動で開始するか、Migration マニフェストでカットオーバー時間をスケジュールできます。
2.2.3. コールド移行とウォーム移行の長所と短所 リンクのコピーリンクがクリップボードにコピーされました!
次の表では、コールド移行とウォーム移行の利点と欠点をさらに詳しく説明します。MTV をインストールした Red Hat OpenShift プラットフォームに Red Hat Enterprise Linux (RHEL) 9 がインストールされていることを前提としています。
| コールド移行 | ウォーム移行 | |
|---|---|---|
| Duration | ディスク上のデータ量に相関します。各ブロックは 1 回コピーされます。 | ディスク上のデータ量と仮想マシンの使用率に相関します。ブロックは複数回コピーされる場合があります。 |
| フェイルファースト | 変換してから転送します。各仮想マシンは OpenShift と互換性が確保されるように変換され、変換が成功すると仮想マシンが転送されます。仮想マシンを変換できない場合、移行は即座に失敗します。 | 転送してから変換します。MTV は各仮想マシンのスナップショットを作成し、それを Red Hat OpenShift に転送します。カットオーバーを開始すると、MTV は最後のスナップショットを作成し、それを転送してから、仮想マシンを変換します。 |
| ツール |
|
コンテナー化データインポーター (CDI)、永続ストレージ管理アドオン、および |
| 転送されるデータ | すべてのディスクの概算合計 | すべてのディスクおよび仮想マシン使用率の概算値 |
| VM のダウンタイム | 高: 仮想マシンがシャットダウンされ、ディスクが転送されます。 | 低: ディスクはバックグラウンドで転送されます。カットオーバーの段階で仮想マシンはシャットダウンされ、残りのデータは移行されます。RAM に格納されたデータは移行されません。 |
| 並列処理 | ディスクは仮想マシンごとに順番に転送されます。リモート移行の場合、ディスクは並行して転送されます。 [a] | ディスクは異なる Pod によって並行して転送されます。 |
| 接続の使用 | ディスク転送中のみソースへの接続を維持します。 | ディスク転送中はソースへの接続が維持されますが、スナップショット間では接続が解放されます。 |
| ツール | MTV のみ。 | OpenShift Virtualization からの MTV および CDI。 |
[a]
リモート移行: MTV がインストールされていないターゲット環境。CDI を使用したリモート環境への移行を指します。
| ||
上の表は実行中の仮想マシンの状況を示しています。ウォーム移行の主な利点はダウンタイムの短縮です。また、ダウンしている仮想マシンに対してウォーム移行を開始する理由はありません。ただし、MTV が virt-v2v と RHEL 9 を使用している場合でも、ダウンしている仮想マシンのウォーム移行を実行することは、コールド移行と同じではありません。ダウンしている仮想マシンの場合、MTV はコールド移行とは異なり、CDI を使用してディスクを転送します。
VMware からインポートする場合、ESXi、vSphere、または VDDK に関連する制限など、移行速度に影響する追加の要因があります。
2.2.3.1. まとめ リンクのコピーリンクがクリップボードにコピーされました!
前述の情報に基づいて、コールド移行とウォーム移行について次のような結論を導き出すことができます。
- ウォーム移行を使用すると、仮想マシンのダウンタイムを最小限に抑えることができます。
- 1 つのディスクに大量のデータがある仮想マシンでは、コールド移行を使用すると時間を最小限に抑えることができます。
- 大量のデータが複数のディスクに均等に分散された仮想マシンでは、ウォーム移行を使用すると期間を最小限に抑えることができます。
第3章 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
以下の前提条件を確認し、環境が移行用に準備されていることを確認します。
3.1. ソフトウェア要件 リンクのコピーリンクがクリップボードにコピーされました!
Migration Toolkit for Virtualization (MTV) には、すべてのプロバイダーに対するソフトウェア要件と、プロバイダーごとの特定のソフトウェア要件があります。
3.1.1. すべてのプロバイダーのソフトウェア要件 リンクのコピーリンクがクリップボードにコピーされました!
互換性のあるバージョン の Red Hat OpenShift および OpenShift Virtualization をインストールする必要があります。
3.2. ストレージのサポートとデフォルトモード リンクのコピーリンクがクリップボードにコピーされました!
Migration Toolkit for Virtualization (MTV) は、サポート対象のストレージに対して次のデフォルトのボリュームおよびアクセスモードを使用します。
| プロビジョナー | ボリュームモード | アクセスモード |
|---|---|---|
| kubernetes.io/aws-ebs | Block | ReadWriteOnce |
| kubernetes.io/azure-disk | Block | ReadWriteOnce |
| kubernetes.io/azure-file | ファイルシステム | ReadWriteMany |
| kubernetes.io/cinder | Block | ReadWriteOnce |
| kubernetes.io/gce-pd | Block | ReadWriteOnce |
| kubernetes.io/hostpath-provisioner | ファイルシステム | ReadWriteOnce |
| manila.csi.openstack.org | ファイルシステム | ReadWriteMany |
| openshift-storage.cephfs.csi.ceph.com | ファイルシステム | ReadWriteMany |
| openshift-storage.rbd.csi.ceph.com | Block | ReadWriteOnce |
| kubernetes.io/rbd | Block | ReadWriteOnce |
| kubernetes.io/vsphere-volume | Block | ReadWriteOnce |
OpenShift Virtualization ストレージが 動的プロビジョニング をサポートしていない場合は、次の設定を適用する必要があります。
FilesystemのボリュームモードFilesystemボリュームモードは、Blockボリュームモードよりも遅くなります。ReadWriteOnceアクセスモードReadWriteOnceアクセスモードは、仮想マシンのライブマイグレーションをサポートしません。
ストレージプロファイルの編集に関する詳細は、静的にプロビジョニングされたストレージクラスの有効化 を参照してください。
移行で、EXT4 ファイルシステムで作成されたブロックストレージおよび永続ボリュームを使用する場合は、CDI のファイルシステムのオーバーヘッドを 10% 以上に増やします。CDI が想定するデフォルトのオーバーヘッドには、root パーティション用に予約された場所が完全に含まれていません。CDI のファイルシステムオーバーヘッドをこの量だけ増やさないと、移行が失敗する可能性があります。
OpenStack から移行する場合、または Red Hat Virtualization から MTV がデプロイされている Red Hat OpenShift クラスターにコールド移行を実行する場合、その移行時には CDI なしで永続ボリュームが割り当てられます。このような場合は、ファイルシステムのオーバーヘッドの調整が必要になる場合があります。
設定されたファイルシステムのオーバーヘッド (デフォルト値は 10%) が低すぎる場合、スペース不足によりディスク転送は失敗します。このような場合は、ファイルシステムのオーバーヘッドを増やす必要があります。
ただし、場合によっては、ファイルシステムのオーバーヘッドを減らしてストレージの消費量を削減したい場合があります。
MTV Operator の設定 で説明されているように、forklift-controller CR の spec 部分にある controller_filesystem_overhead の値を変更することで、ファイルシステムのオーバーヘッドを変更できます。
3.3. ネットワークの前提条件 リンクのコピーリンクがクリップボードにコピーされました!
すべての移行に、以下の前提条件が適用されます。
- IP アドレス、VLAN、およびその他のネットワーク設定が、移行前または移行中に変更されていない。仮想マシンの MAC アドレスは移行時に保持されます。
- 移行元環境、OpenShift Virtualization クラスター、およびレプリケーションリポジトリー間のネットワーク接続が、信頼でき中断されない。
- 複数の移行元および移行先ネットワークをマッピングする場合は、追加の移行先ネットワークごとに ネットワークアタッチメント定義 が作成されている。
3.3.1. ポート リンクのコピーリンクがクリップボードにコピーされました!
ファイアウォールは、以下のポートでトラフィックを有効にする必要があります。
| ポート | プロトコル | 送信元 | 送信先 | 目的 |
|---|---|---|---|---|
| 443 | TCP | OpenShift ノード | VMware vCenter | VMware プロバイダーインベントリー ディスク転送の認証 |
| 443 | TCP | OpenShift ノード | VMware ESXi ホスト | ディスク転送の認証 |
| 902 | TCP | OpenShift ノード | VMware ESXi ホスト | ディスク転送データのコピー |
| ポート | プロトコル | 送信元 | 送信先 | 目的 |
|---|---|---|---|---|
| 443 | TCP | OpenShift ノード | RHV エンジン | RHV プロバイダーインベントリー ディスク転送の認証 |
| 443 | TCP | OpenShift ノード | RHV ホスト | ディスク転送の認証 |
| 54322 | TCP | OpenShift ノード | RHV ホスト | ディスク転送データのコピー |
3.4. ソース仮想マシンの前提条件 リンクのコピーリンクがクリップボードにコピーされました!
すべての移行に、以下の前提条件が適用されます。
- ISO イメージと CD-ROM のマウントが解除されている。
- 各 NIC には IPv4 アドレスまたは IPv6 アドレスのいずれかが含まれており、NIC では両方を使用できる。
- 各仮想マシンのオペレーティングシステムは、変換用のゲストオペレーティングシステムとして認定およびサポートされている。
Converting virtual machines from other hypervisors to KVM with virt-v2v の表を参照して、オペレーティングシステムがサポートされているかどうかを確認できます。RHEL 8 ホストと RHEL 9 ホストに関する表の列を参照してください。
- RHEL 8 で実行する MTV 2.6.z を使用して移行する仮想マシン。
- RHEL 9 で実行する MTV 2.7.z を使用して移行する仮想マシン。
-
仮想マシンの名前にはピリオド (
.) を含めることはできない。Migration Toolkit for Virtualization (MTV) は、仮想マシン名内のピリオドをダッシュ (-) に変更します。 仮想マシンの名前は、OpenShift Virtualization 環境の他の仮想マシンと同じにしない。
警告MTV は、デュアルブートオペレーティングシステム仮想マシンの移行を限定的にサポートしています。
デュアルブートオペレーティングシステム仮想マシンの場合、MTV は最初に見つかったブートディスクを変換しようとします。または、MTV UI でルートデバイスを指定することもできます。
注記Migration Toolkit for Virtualization は、ルールに準拠していない仮想マシンに新しい名前を自動的に割り当てます。
Migration Toolkit for Virtualization は、新しい仮想マシン名を自動的に生成するときに、次の変更を行います。
- 除外された文字を削除する。
- 大文字を小文字に切り替える。
-
アンダースコア (
_) をダッシュ (-) に変更する。
この機能により、ルールに準拠していない仮想マシン名を入力した場合でも、移行をスムーズに進めることができます。
セキュアブートが有効になっている仮想マシンは自動的に移行されない可能性がある
現在、セキュアブートが有効になっている仮想マシン (VM) は自動的に移行されない可能性があります。セキュアブートは、デバイスが Original Equipment Manufacturer (OEM) が信頼するソフトウェアのみを使用して起動するように、PC 業界のメンバーにより開発されたセキュリティ標準で、このセキュアブートが原因で、宛先プロバイダーで仮想マシンが起動できなくなるためです。
回避策: 現在の回避策は、宛先でセキュアブートを無効にすることです。詳細は、セキュアブートの無効化 を参照してください。(MTV-1548)
Measured Boot を使用している Windows 仮想マシンは移行できない
Measured Boot 機能を使用している Microsoft Windows 仮想マシン (VM) は移行できません。Measured Boot は、ファームウェアを含む各起動コンポーネントからブートドライバーまでをチェックして、あらゆる種類のデバイスの変更を防止するメカニズムであるためです。
移行の代替手段としては、OpenShift Virtualization 上で直接 Windows 仮想マシンを再作成する方法があります。
3.5. Red Hat Virtualization の前提条件 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Virtualization の移行には、以下の前提条件が適用されます。
-
移行元プロバイダーを作成するには、少なくとも
UserRoleおよびReadOnlyAdminロールを持っている必要があります。これらは最低限必要な権限ですが、その他の管理者権限またはスーパーユーザー権限でも作成できます。
移行元プロバイダーの仮想マシンが移行されるまで、UserRole ロールおよび ReadOnlyAdmin ロールを保持する必要があります。そうでない場合、移行に失敗します。
仮想マシンを移行するには:
以下のいずれかが必要である。
- RHV の管理者権限。これらのパーミッションにより、システム内の仮想マシンを移行できます。
-
移行するすべての仮想マシンの
DiskCreatorおよびUserVmManager権限。
- 互換性のあるバージョン の Red Hat Virtualization を使用する。
サードパーティーの証明書に置き換えられていない限り、Manager CA 証明書を用意する。Manager CA 証明書を用意した場合は、Manager Apache CA 証明書を指定する。
ブラウザーで https://<engine_host>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA に移動して、Manager CA 証明書を取得できます。
- ダイレクト LUN ディスクを使用して仮想マシンを移行する場合は、仮想マシン実行先の OpenShift Virtualization クラスター内のノードがバックエンドストレージにアクセスできることを確認してください。
- 移行元プロバイダーから移行先プロバイダーに コピーされる ディスクイメージとは異なり、LUN は移行元プロバイダーの仮想マシンから 切り離され ますが、削除 されず、ターゲットプロバイダーで作成された仮想マシン (VM) にアタッチされます。
- 移行元プロバイダーへのフォールバックが必要な場合に備えて、移行中に LUN は移行元プロバイダーから削除されません。ただし、LUN を移行元プロバイダーの仮想マシンに再接続する前に、LUN がターゲット環境上の仮想マシンによって同時に使用されていないことを確認してください。同時に使用されていると、データの破損が発生する可能性があります。
3.6. OpenStack の前提条件 リンクのコピーリンクがクリップボードにコピーされました!
OpenStack の移行には、次の前提条件が適用されます。
- 互換性のあるバージョン の OpenStack を使用している。
3.6.1. OpenStack 移行元プロバイダーを使用した移行のための追加の認証方法 リンクのコピーリンクがクリップボードにコピーされました!
MTV バージョン 2.6 以降では、標準のユーザー名とパスワードの認証情報セットに加えて、OpenStack 移行元プロバイダーを使用した移行のための次の認証方法がサポートされています。
- トークン認証
- アプリケーション認証情報の認証
これらの方法を使用すると、Secret マニフェストを準備する方法を除き、他の仮想マシンを移行するのと同じ方法で、コマンドラインインターフェイス (CLI) を使用して OpenStack ソースプロバイダーで仮想マシンを移行できます。
3.6.1.1. OpenStack 移行元プロバイダーでのトークン認証の使用 リンクのコピーリンクがクリップボードにコピーされました!
OpenStack 移行元プロバイダーの作成時に、ユーザー名とパスワード認証の代わりにトークン認証を使用できます。
MTV は、次の両方のタイプのトークン認証をサポートしています。
- ユーザー ID のトークン
- ユーザー名が含まれるトークン
トークン認証のタイプごとに、OpenStack からのデータを使用して Secret マニフェストを作成する必要があります。
前提条件
OpenStack アカウントがある。
手順
- OpenStack Web コンソールの Dashboard で、Project > API Access をクリックします。
Download OpenStack RC file を展開し、OpenStack RC file をクリックします。
ダウンロードされるファイル (ここでは
<openstack_rc_file>と呼びます) には、トークン認証に使用される次のフィールドが含まれています。OS_AUTH_URL OS_PROJECT_ID OS_PROJECT_NAME OS_DOMAIN_NAME OS_USERNAME
OS_AUTH_URL OS_PROJECT_ID OS_PROJECT_NAME OS_DOMAIN_NAME OS_USERNAMECopy to Clipboard Copied! Toggle word wrap Toggle overflow トークン認証に必要なデータを取得するには、次のコマンドを実行します。
openstack token issue
$ openstack token issueCopy to Clipboard Copied! Toggle word wrap Toggle overflow ここでは
<openstack_token_output>と呼ばれる出力には、ユーザー ID のトークンを使用した認証に必要なtoken、userID、およびprojectIDが含まれています。以下のような
Secretマニフェストを作成します。ユーザー ID のトークンを使用した認証の場合:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow ユーザー名でトークンを使用した認証の場合:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.6.1.2. OpenStack 移行元プロバイダーでのアプリケーション認証情報の認証の使用 リンクのコピーリンクがクリップボードにコピーされました!
OpenStack 移行元プロバイダーの作成時に、ユーザー名とパスワード認証の代わりにアプリケーション認証情報の認証を使用できます。
MTV は、次のアプリケーション認証情報の認証をサポートします。
- アプリケーション認証情報 ID
- アプリケーション認証情報名
アプリケーション認証情報の認証のタイプごとに、OpenStack からのデータを使用して Secret マニフェストを作成する必要があります。
前提条件
OpenStack アカウントがある。
手順
- OpenStack Web コンソールの Dashboard で、Project > API Access をクリックします。
Download OpenStack RC file を展開し、OpenStack RC file をクリックします。
ダウンロードするファイル (ここでは
<openstack_rc_file>と呼びます) には、アプリケーション認証情報の認証に使用される次のフィールドが含まれています。OS_AUTH_URL OS_PROJECT_ID OS_PROJECT_NAME OS_DOMAIN_NAME OS_USERNAME
OS_AUTH_URL OS_PROJECT_ID OS_PROJECT_NAME OS_DOMAIN_NAME OS_USERNAMECopy to Clipboard Copied! Toggle word wrap Toggle overflow アプリケーション認証情報の認証に必要なデータを取得するには、以下のコマンドを実行します。
openstack application credential create --role member --role reader --secret redhat forklift
$ openstack application credential create --role member --role reader --secret redhat forkliftCopy to Clipboard Copied! Toggle word wrap Toggle overflow ここでは
<openstack_credential_output>と呼ばれる出力には、次のものが含まれます。-
アプリケーション認証情報 ID を使用した認証に必要な
IDとsecret -
アプリケーション認証情報名を使用した認証に必要な
nameとsecret
-
アプリケーション認証情報 ID を使用した認証に必要な
以下のような
Secretマニフェストを作成します。アプリケーション認証情報 ID を使用した認証の場合:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow アプリケーション認証情報名を使用した認証の場合:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.7. VMware の前提条件 リンクのコピーリンクがクリップボードにコピーされました!
移行を加速するために、VDDK イメージの作成が強く推奨されます。詳細は、VDDK イメージの作成 を参照してください。
仮想マシンが VMware vSAN によってバックアップされている場合、仮想マシンの移行は VDDK なしでは機能しません。
VMware の移行には、以下の前提条件が適用されます。
- 互換性のあるバージョン の VMware vSphere を使用している。
- 少なくとも最小限の VMware 権限 を持つユーザーとしてログインしている。
- 移行前のフックを使用して仮想マシンにアクセスするには、VMware Tools をソース仮想マシンにインストールする必要があります。
-
仮想マシンオペレーティングシステムが、OpenShift Virtualization のゲストオペレーティングシステム としての使用 および
virt-v2vでの KVM への変換 に対して認定およびサポートされている。 - ウォーム移行を実行している場合は、仮想マシンおよび仮想マシンディスクで 変更ブロックのトラッキング (CBT) を有効にしている。
- 同じ移行計画の ESXi ホストから 10 台を超える仮想マシンを移行する場合は、ホストの NFC サービスメモリーを増やしている。
- Migration Toolkit for Virtualization (MTV) は休止状態の仮想マシンの移行をサポートしていないため、休止状態を無効にすることを強く推奨する。
停電が発生した場合、休止状態が無効になっている仮想マシンのデータが失われる可能性があります。ただし、ハイバネーションが無効になっていない場合は移行に失敗します。
MTV も OpenShift Virtualization も、VMWare から仮想マシンを移行するための Btrfs の変換をサポートしていません。
VMware 権限
Migration Toolkit for Virtualization (MTV) を使用して仮想マシンを OpenShift Virtualization に移行するには、次の最小限の VMware 権限のセットが必要です。
| 特権 | 説明 |
|---|---|
|
| |
|
| 電源がオンになっている仮想マシンの電源をオフにできます。この操作により、ゲストオペレーティングシステムの電源がオフになります。 |
|
| 電源がオフになっている仮想マシンの電源をオンにし、中断している仮想マシンを再開できます。 |
|
| VMware VIX API による仮想マシンの管理を可能にします。 |
|
注記
すべての | |
|
| ランダムな読み取りおよび書き込みアクセスのために仮想マシンでディスクを開くことができます。主にリモートディスクマウントに使用されます。 |
|
| VMX、ディスク、ログ、NVRAM など、仮想マシンに関連付けられたファイルの操作を許可します。 |
|
| ランダムな読み取りアクセスのために仮想マシンでディスクを開くことができます。主にリモートディスクマウントに使用されます。 |
|
| VMX、ディスク、ログ、NVRAM など、仮想マシンに関連付けられたファイルの読み取り操作を許可します。 |
|
| VMX、ディスク、ログ、NVRAM など、仮想マシンに関連付けられたファイルの書き込み操作を許可します。 |
|
| テンプレートのクローンを作成できます。 |
|
| 既存の仮想マシンのクローン作成とリソースの割り当てを許可します。 |
|
| 仮想マシンから新しいテンプレートを作成できます。 |
|
| 仮想マシンを移行せずに、仮想マシンのゲストオペレーティングシステムをカスタマイズできます。 |
|
| テンプレートからの仮想マシンのデプロイメントを許可します。 |
|
| 既存の電源がオフになっている仮想マシンをテンプレートとしてマークできます。 |
|
| 既存のテンプレートを仮想マシンとしてマークできます。 |
|
| カスタマイズ仕様の作成、変更、または削除を許可します。 |
|
| 仮想マシンのディスクでのプロモート操作を許可します。 |
|
| カスタマイズ仕様の読み取りを許可します。 |
|
| |
|
| 仮想マシンの現在の状態からスナップショットを作成できます。 |
|
| スナップショット履歴からスナップショットを削除できます。 |
|
| |
|
| データストアの内容を探索できます。 |
|
| データストア内で低レベルのファイル操作 (読み取り、書き込み、削除、および名前変更) を実行できます。 |
|
| |
|
| セッションの有効性の検証を可能にします。 |
|
| |
|
| 暗号化された仮想マシンの復号化を許可します。 |
|
| 暗号化されたリソースへのアクセスを許可します。 |
3.7.1. VDDK イメージの作成 リンクのコピーリンクがクリップボードにコピーされました!
VMware vSphere から仮想ディスクを移動する場合は、Migration Toolkit for Virtualization (MTV) を VMware Virtual Disk Development Kit (VDDK) SDK と併用することを強く推奨します。
オプションではありますが、VDDK イメージを作成することを強く推奨します。VDDK なしで MTV を使用することは推奨されず、移行速度が大幅に低下する可能性があります。
この機能を利用するには、VMware Virtual Disk Development Kit (VDDK) をダウンロードし、VDDK イメージをビルドして、VDDK イメージをイメージレジストリーにプッシュします。
VDDK パッケージにはシンボリックリンクが含まれているため、VDDK イメージの作成手順は、シンボリックリンク (symlink) を保持するファイルシステム上で実行する必要があります。
VDDK イメージをパブリックレジストリーに保存すると、VMware ライセンスの条項に違反する可能性があります。
前提条件
- Red Hat OpenShift イメージレジストリー
-
podmanがインストールされている。 - シンボリックリンク (symlink) を保存するファイルシステム上で作業している。
- 外部レジストリーを使用している場合、OpenShift Virtualization がこれにアクセスできる。
手順
一時ディレクトリーを作成し、これに移動します。
mkdir /tmp/<dir_name> && cd /tmp/<dir_name>
$ mkdir /tmp/<dir_name> && cd /tmp/<dir_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - ブラウザーで、VMware VDDK バージョン 8 ダウンロードページ に移動します。
- バージョン 8.0.1 を選択し、Download をクリックします。
OpenShift Virtualization 4.12 に移行するには、VMware VDDK バージョン 7 ダウンロードページ から VDDK バージョン 7.0.3.2 をダウンロードします。
- VDDK アーカイブファイルを一時ディレクトリーに保存します。
VDDK アーカイブをデプロイメントします。
tar -xzf VMware-vix-disklib-<version>.x86_64.tar.gz
$ tar -xzf VMware-vix-disklib-<version>.x86_64.tar.gzCopy to Clipboard Copied! Toggle word wrap Toggle overflow Dockerfileを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow VDDK イメージをビルドします。
podman build . -t <registry_route_or_server_path>/vddk:<tag>
$ podman build . -t <registry_route_or_server_path>/vddk:<tag>Copy to Clipboard Copied! Toggle word wrap Toggle overflow VDDK イメージをレジストリーにプッシュします。
podman push <registry_route_or_server_path>/vddk:<tag>
$ podman push <registry_route_or_server_path>/vddk:<tag>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - イメージが OpenShift Virtualization 環境からアクセスできることを確認します。
3.7.2. ESXi ホストの NFC サービスメモリーの拡張 リンクのコピーリンクがクリップボードにコピーされました!
同じ移行計画の ESXi ホストから 10 台を超える仮想マシンを移行する場合は、ホストの NFC サービスメモリーを増やしている。有効にしないと、NFC サービスメモリーの同時接続は 10 台に制限されているため、移行に失敗します。
手順
- root として ESXi ホストにログインします。
/etc/vmware/hostd/config.xmlでmaxMemoryの値を1000000000に変更します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow hostdを再起動します。/etc/init.d/hostd restart
# /etc/init.d/hostd restartCopy to Clipboard Copied! Toggle word wrap Toggle overflow ホストを再起動する必要はありません。
3.7.3. VDDK バリデーターコンテナーにはリクエストと制限が必要 リンクのコピーリンクがクリップボードにコピーされました!
クラスターまたはプロジェクトのリソースクォータが設定されている 場合は、MTV Pod での移行に十分なクォータがあることを確認する必要があります。
次のように、ForkliftController カスタムリソース (CR) でオーバーライドできるデフォルトを確認できます。必要に応じて、これらのデフォルトを調整できます。
これらの設定は環境に大きく依存します。 一度に多数の移行が行われ、移行に対して十分なクォータが設定されていない場合、移行は失敗する可能性があります。これは、一度に移行される仮想マシン/ディスクの数を決定する MAX_VM_INFLIGHT 設定とも相関します。
ForkliftController CR で上書きできるデフォルト:
これは、コールド移行とウォーム移行の両方に影響します。
コールド移行の場合、ディスクコピーを実行するため、より多くのリソースが消費される可能性があります。ウォーム移行の場合、リクエストを減らすことを検討してみてください。
-
virt_v2v_container_limits_cpu:
4000m -
virt_v2v_container_limits_memory:
8Gi -
virt_v2v_container_requests_cpu:
1000m virt_v2v_container_requests_memory:
1Gi注記virt-v2vを使用したコールド移行とウォーム移行では、リソースが大量に消費される可能性があります。詳細は、コンピュートの電源および RAM を参照してください。
-
virt_v2v_container_limits_cpu:
これはフックを使用したすべての移行に影響します。
-
hooks_container_limits_cpu:
1000m -
hooks_container_limits_memory:
1Gi -
hooks_container_requests_cpu:
100m -
hooks_container_requests_memory:
150Mi
-
hooks_container_limits_cpu:
これは、OVA の移行に影響します。
-
ova_container_limits_cpu:
1000m -
ova_container_limits_memory:
1Gi -
ova_container_requests_cpu:
100m -
ova_container_requests_memory:
150Mi
-
ova_container_limits_cpu:
3.8. Open Virtual Appliance (OVA) の前提条件 リンクのコピーリンクがクリップボードにコピーされました!
Open Virtual Appliance (OVA) ファイルの移行には、以下の前提条件が適用されます。
- すべての OVA ファイルは、VMware vSphere によって作成されます。
VMware vSphere によって作成されたものではなくても、vSphere と互換性のある OVA ファイルの移行は成功する可能性があります。ただし、このようなファイルの移行は MTV ではサポートされていません。MTV は、VMware vSphere によって作成された OVA ファイルのみをサポートします。
OVA ファイルは、次のいずれかの構造の NFS 共有ディレクトリーの下にあるフォルダー (1 つまたは複数) に含まれています。
すべての仮想マシン情報を保持する 1 つ以上の圧縮された Open Virtualization Format (OVF) パッケージ。
各圧縮パッケージのファイル名には
.ova拡張子が 必要です。複数の圧縮パッケージを同じフォルダーに保存できます。この構造を使用すると、MTV はルートフォルダーと第 1 レベルのサブフォルダーをスキャンして圧縮パッケージを探します。
たとえば、NFS 共有が
/nfsの場合、/nfsフォルダーがスキャンされます。/nfs/subfolder1フォルダーもスキャンされます。
しかし、/nfs/subfolder1/subfolder2はスキャンされません。展開された OVF パッケージ内。
この構造を使用すると、MTV はルートフォルダー、第 1 レベルのサブフォルダー、第 2 レベルのサブフォルダーをスキャンして展開された OVF パッケージを探します。ただし、フォルダー内に存在できる
.ovfファイルは 1 つだけです。そうでない場合、移行に失敗します。たとえば、NFS 共有が
/nfsの場合、
OVF ファイル/nfs/vm.ovfがスキャンされます。
OVF ファイル/nfs/subfolder1/vm.ovfがスキャンされます。
OVF ファイル/nfs/subfolder1/subfolder2/vm.ovfがスキャンされます。
しかし、OVF ファイル/nfs/subfolder1/subfolder2/subfolder3/vm.ovfはスキャンされません。
3.9. ソフトウェア互換性ガイドライン リンクのコピーリンクがクリップボードにコピーされました!
互換性のあるソフトウェアバージョンをインストールする必要があります。
| Migration Toolkit for Virtualization | Red Hat OpenShift | OpenShift Virtualization | VMware vSphere | Red Hat Virtualization | OpenStack |
|---|---|---|---|---|---|
| 2.7 | 4.17、4.16、4.15 | 4.17、4.16、4.15 | 6.5 以降 | 4.4 SP1 以降 | 16.1 以降 |
MTV は Red Hat Virtualization (RHV) 4.4 SP1 でのみテストされました。Red Hat Virtualization (RHV) 4.3 からの移行は MTV 2.7 ではテストされていません。サポート対象外ですが、RHV 4.3 からの基本的な移行は機能するはずです。
通常、OpenShift Virtualization に移行する前に、Red Hat Virtualization Manager (RHVM) を前述のサポートされているバージョンにアップグレードすることを推奨します。
OpenShift Virtualization に移行する前に、RHV を上記のサポートされているバージョンにアップグレードすることが推奨されます。
ただし、RHV 4.3.11 からの移行は MTV 2.3 でテストされており、実際には MTV 2.7 を使用する多くの環境で機能する可能性があります。この場合、OpenShift Virtualization に移行する前に、Red Hat Virtualization Manager (RHVM) を前述のサポート対象バージョンにアップグレードすることが推奨されます。
3.9.1. OpenShift Operator のライフサイクル リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform で使用するために Red Hat が同梱する Operator のソフトウェアメンテナンスのライフサイクル分類の詳細は、OpenShift Operator のライフサイクル を参照してください。
第4章 MTV Operator のインストールと設定 リンクのコピーリンクがクリップボードにコピーされました!
MTV Operator は、Red Hat OpenShift Web コンソールまたはコマンドラインインターフェイス (CLI) を使用してインストールできます。
Migration Toolkit for Virtualization (MTV) バージョン 2.4 以降では、MTV Operator に Red Hat OpenShift Web コンソール用の MTV プラグインが含まれています。
Red Hat OpenShift Web コンソールまたは CLI を使用して MTV Operator をインストールした後、Operator を設定できます。
4.1. Red Hat OpenShift Web コンソールを使用した MTV Operator のインストール リンクのコピーリンクがクリップボードにコピーされました!
MTV Operator は、Red Hat OpenShift Web コンソールを使用してインストールできます。
前提条件
- Red Hat OpenShift 4.17 以降がインストールされている。
- OpenShift 移行ターゲットクラスターに OpenShift Virtualization Operator インストールされている。
-
cluster-adminパーミッションを持つユーザーとしてログインしている。
手順
- Red Hat OpenShift Web コンソールで、Operators → OperatorHub をクリックします。
- Filter by keyword フィールドを使用して mtv-operator を検索します。
- Migration Toolkit for Virtualization Operator をクリックしてから Install をクリックします。
- ボタンがアクティブになったら、Create ForkliftController をクリックします。
Create をクリックします。
ForkliftController が表示されるリストに表示されます。
- Workloads → Pods をクリックし、MTV Pod が実行されていることを確認します。
Operators → Installed Operators をクリックして、Migration Toolkit for Virtualization Operator が Succeeded のステータスで openshift-mtv プロジェクトに表示されることを確認します。
プラグインの準備が整ったら、ページのリロードが求められます。Migration メニュー項目は、Red Hat OpenShift Web コンソールの左側に表示されるナビゲーションバーに自動的に追加されます。
4.2. コマンドラインインターフェイスを使用した MTV Operator のインストール リンクのコピーリンクがクリップボードにコピーされました!
コマンドラインインターフェイス (CLI) を使用して MTV Operator をインストールできます。
前提条件
- Red Hat OpenShift 4.17 以降がインストールされている。
- OpenShift 移行ターゲットクラスターに OpenShift Virtualization Operator インストールされている。
-
cluster-adminパーミッションを持つユーザーとしてログインしている。
手順
openshift-mtv プロジェクトを作成します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 名前が
migrationのOperatorGroupCR を作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow Operator の
SubscriptionCR を作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow ForkliftControllerCR を作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow MTV Pod が実行していることを確認します。
oc get pods -n openshift-mtv
$ oc get pods -n openshift-mtvCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.3. MTV Operator の設定 リンクのコピーリンクがクリップボードにコピーされました!
MTV Operator の次のすべての設定は、特に指定がない限り、ForkliftController CR を変更するか、Overview ページの Setting セクションで設定できます。
- Migration Toolkit for Virtualization (MTV) が同時に移行できる仮想マシン (VM) またはディスクのプランごとの最大数。
-
must gatherレポートが自動的に削除されるまで保持される期間 - メインのコントローラーコンテナーに割り当てられる CPU 制限
- メインのコントローラーコンテナーに割り当てられるメモリー制限
- ウォーム移行を開始する前に新しいスナップショットが要求される間隔
- ウォーム移行中にスナップショットの作成または削除のステータスをチェックする頻度
-
storageclassがfilesystemの場合に、ファイルシステムのオーバーヘッドとして割り当てられる永続ボリューム内のスペースの割合 (ForkliftControllerCR のみ)。 -
永続ブロックボリュームに割り当てられた固定量の追加スペース。この設定は、ブロックベースのすべての
storageclassに適用されます (ForkliftControllerCR のみ)。 -
vSphere 移行元プロバイダーの設定に対するオペレーティングシステムの configuration map (
ForkliftControllerCR のみ)。 -
Red Hat Virtualization (RHV) 移行元プロバイダーの設定に対するオペレーティングシステムの configuration map (
ForkliftControllerCR のみ)。
ユーザーインターフェイスを使用してこれらを設定する手順は、MTV の設定 で説明しています。ForkliftController CR を変更してこれらの設定を指定する手順を以下に示します。
手順
次のようにラベルと値を追加して、
ForkliftControllerCR のspec部分のパラメーターの値を変更します。spec: label: value
spec: label: value1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- CLI を使用して設定できるラベルを、各ラベルとそのデフォルト値の説明とともに次の表に示します。
| ラベル | 説明 | デフォルト値 |
|---|---|---|
|
| 以下のとおり、プロバイダーにより異なります。
|
|
|
|
自動削除される前に |
|
|
| メインのコントローラーコンテナーに割り当てられる CPU 制限。 |
|
|
| メインのコントローラーコンテナーに割り当てられるメモリー制限。 |
|
|
| ウォームマイグレーションを開始する前に新しいスナップショットが要求される間隔 (分単位)。 |
|
|
| ウォームマイグレーション中にシステムがスナップショットの作成または削除のステータスをチェックする頻度 (秒単位)。 |
|
|
|
|
|
|
|
永続ブロックボリュームに割り当てられた固定量の追加スペース。この設定は、ブロックベースの
|
|
|
| vSphere 移行元プロバイダーの configuration map。この configuration map は、受信仮想マシンのオペレーティングシステムを OpenShift Virtualization の設定名にマッピングします。この configuration map は、MTV Operator がデプロイされている namespace に存在する必要があります。 OpenShift Virtualization 環境の設定リストを表示するには、OpenShift Web コンソールを開き、Virtualization → Preferences をクリックします。
このラベルの値がデフォルト値の
|
|
|
| RHV 移行元プロバイダーの configuration map。この configuration map は、受信仮想マシンのオペレーティングシステムを OpenShift Virtualization の設定名にマッピングします。この configuration map は、MTV Operator がデプロイされている namespace に存在する必要があります。 OpenShift Virtualization 環境の設定リストを表示するには、OpenShift Web コンソールを開き、Virtualization → Preferences をクリックします。
このラベルの値がデフォルト値の
|
|
4.3.1. controller_max_vm_inflight ラベルの設定 リンクのコピーリンクがクリップボードにコピーされました!
controller_max_vm_inflight ラベルは、UI では Max concurrent virtual machine migrations として表示され、その意味は移行のソースプロバイダーにより異なります。
OVA または VMware の移行を除くすべての移行の場合、このラベルは Migration Toolkit for Virtualization (MTV) が同時に転送できる ディスク の最大数を示します。これらの移行では、MTV はディスクを並行して移行します。つまり、移行するディスクの合計数が設定値より大きい場合、仮想マシンの移行が完了したかどうかにかかわらず、追加のディスクはキューが空くまで待機する必要があります。
たとえば、ラベルの値が 15 で、仮想マシン A に 5 つのディスク、仮想マシン B に 5 つのディスク、仮想マシン C に 6 つのディスクがある場合、16 番目のディスクを除くすべてのディスクの移行が同時に開始されます。いずれかのディスクが移行されると、仮想マシン A および仮想マシン B のすべてのディスクの移行が完了していなくても、16 番目のディスクを移行できます。
OVA の移行の場合、このラベルは MTV が同時に移行できる 仮想マシン の最大数を示します。つまり、追加のディスクはすべて、少なくとも 1 つの仮想マシンが完全に移行されるまで待機する必要があります。
たとえば、ラベルの値が 2 で、仮想マシン A に 5 つのディスク、仮想マシン B に 5 つのディスク、仮想マシン C に 6 つのディスクがあるとします。仮想マシン C 上のすべてのディスクは、仮想マシン A または仮想マシン B のすべてのディスクの移行が完了するまで移行を待機する必要があります。
VMware の移行の場合、このラベルは以下を意味します。
コールドマイグレーション:
- ローカル OpenShift Virtualization への移行: 同時に移行できる各 ESXi ホストの仮想マシン。
- リモート OpenShift Virtualization への移行: 同時に移行できる各 ESXi ホストのディスク。
- ウォームマイグレーション: 同時に移行できる各 ESXi ホストのディスク。
第5章 Red Hat OpenShift Web コンソールを使用した仮想マシンの移行 リンクのコピーリンクがクリップボードにコピーされました!
MTV ユーザーインターフェイスを使用して仮想マシン (VM) を移行します。これは、Red Hat OpenShift Web コンソールの Virtualization セクションにあります。
5.1. MTV ユーザーインターフェイス リンクのコピーリンクがクリップボードにコピーされました!
Migration Toolkit for Virtualization (MTV) ユーザーインターフェイスは OpenShift Web コンソールに統合されています。
左側のパネルでは、移行の進行状況のコンポーネントに関連するページ (例: 仮想化のプロバイダー) を選択できます。また、管理者の場合は、Overview を選択することもできます。このページには、移行に関する情報が含まれており、MTV の設定を行うことができます。
図5.1 MTV 拡張インターフェイス
コンポーネントに関連するページでは、ページの左上にある プロジェクト 一覧をクリックし、作業が許可されているプロジェクト (namespace) を確認できます。
- 管理者の場合は、すべてのプロジェクトを表示できます。
- 管理者以外は、作業権限を持つプロジェクトのみが表示されます。
5.1.1. MTV の概要ページ リンクのコピーリンクがクリップボードにコピーされました!
Migration Toolkit for Virtualization (MTV) Overview ページには、移行に関するシステム全体の情報と、変更できる Settings の一覧が表示されます。
管理者権限がある場合は、Red Hat OpenShift Web コンソールで Migration → Overview をクリックして Overview ページにアクセスできます。
Overview ページには 3 つのタブがあります。
- 概要
- YAML
- メトリクス
5.1.1.1. Overview タブ リンクのコピーリンクがクリップボードにコピーされました!
Overview タブでは、以下を確認できます。
- Operator: MTV Operator がデプロイされている namespace と Operator のステータス。
- Pod: MTV Operator によってデプロイされた各 Pod の名前、ステータス、作成時間。
条件: MTV Operator のステータス:
-
Failure: 前回の失敗。
Falseは、デプロイメントしてから障害が発生していないことを示します。 - Running: Operator が現在実行中で、次の調整を待機しているかどうか。
- Successful: 最後に成功した調整。
-
Failure: 前回の失敗。
5.1.1.2. YAML タブ リンクのコピーリンクがクリップボードにコピーされました!
MTV Operator の操作を定義するカスタムリソース ForkliftController。このタブからカスタムリソースを変更できます。
5.1.1.3. Metrics タブ リンクのコピーリンクがクリップボードにコピーされました!
Metrics タブを使用すると、以下を確認できます。
移行: MTV を使用して実行された移行の数:
- Total
- Running
- Failed
- Succeeded
- Canceled
仮想マシンの移行: MTV を使用して移行された仮想マシンの数:
- Total
- Running
- Failed
- Succeeded
- Canceled
1 回の移行に多数の仮想マシンが関係する可能性があるため、MTV を使用して実行される移行の数は、MTV を使用して移行された仮想マシンの数とは大幅に異なる可能性があります。
- 過去 7 日間に MTV を使用して実行された移行の実行中、失敗、成功した移行の数を示すグラフ
- 過去 7 日間に MTV を使用して実行された仮想マシン移行の実行中、失敗、成功した数を示すグラフ
5.1.2. MTV の設定 リンクのコピーリンクがクリップボードにコピーされました!
管理者権限がある場合は、Overview ページにアクセスし、そのページで以下の設定を変更できます。
| 設定 | 説明 | デフォルト値 |
|---|---|---|
| Max concurrent virtual machine migrations | 以下のとおり、プロバイダーにより異なります。
| 20 |
| Must gather cleanup after (hours) |
自動削除される前に | Disabled |
| Controller main container CPU limit | メインのコントローラーコンテナーに割り当てられる CPU 制限。 | 500 m |
| Controller main container Memory limit | メインのコントローラーコンテナーに割り当てられるメモリー制限。 | 800 Mi |
| Precopy internal (minutes) | ウォームマイグレーションを開始するまでに新しいスナップショットを要求する間隔 | 60 |
| Snapshot polling interval (seconds) | ウォームマイグレーション中にスナップショットの作成または削除のステータスをチェックする頻度。 | 10 |
手順
- Red Hat OpenShift Web コンソールで、Migration → Overview をクリックします。Settings リストはページの右側にあります。
- Settings リストで、変更する設定の Edit アイコンをクリックします。
- リストから設定を選択します。
- Save をクリックします。
5.2. MTV ユーザーインターフェイスを使用した仮想マシンの移行 リンクのコピーリンクがクリップボードにコピーされました!
MTV ユーザーインターフェイスを使用して、次のプロバイダーから仮想マシンを移行します。
- VMware vSphere
- Red Hat Virtualization (RHV)
- OpenStack
- VMware vSphere によって作成された Open Virtual Appliances (OVA)
- OpenShift Virtualization クラスター
すべての移行について、移行元のプロバイダー、移行先のプロバイダー、および移行計画を指定します。特定の手順はプロバイダーによって異なります。
すべての 前提条件 を満たしていることを確認する必要があります。
VMware のみ: 最小限の VMware の権限 セットが必要です。
VMware のみ: VMware 仮想ディスク開発キット (VDDK) イメージを作成すると、移行速度が向上します。
第6章 VMware vSphere からの仮想マシンの移行 リンクのコピーリンクがクリップボードにコピーされました!
6.1. VMware vSphere 移行元プロバイダーの追加 リンクのコピーリンクがクリップボードにコピーされました!
VMware vSphere 仮想マシンは、VMware vCenter または VMWare ESX/ESXi サーバーから移行できます。MTV バージョン 2.6 以降では、SDK エンドポイントを ESX/ESXi サーバーのエンドポイントに指定することで、vCenter を経由せずに ESX/ESXi サーバーから直接移行できます。
Migration Toolkit for Virtualization でサポートされているが 2023 FIPS 要件に準拠していない vSphere のバージョンから移行をできるように、VMware vSphere 移行元プロバイダーを使用した移行では EMS 強制が無効になっています。したがって、vSphere 移行元プロバイダーからの移行が FIPS に準拠されなくなるリスクを考慮する必要があります。サポートされているバージョンの vSphere は、ソフトウェア互換性ガイドライン に記載されています。
移行ネットワークのデフォルト値のほかに、最大伝送単位 (MTU) の値を入力する場合は、使用する OpenShift 転送ネットワークに同じ値も入力する必要があります。OpenShift 転送ネットワークの詳細は、移行計画の作成 を参照してください。
前提条件
- すべてのクラスターがアクセスできるセキュアなレジストリーに VMware Virtual Disk Development Kit (VDDK) イメージを作成することを強く推奨します。VDDK イメージは移行を加速し、計画が失敗するリスクを軽減します。VDDK を使用しておらず、プランが失敗した場合は、VDDK をインストールして再試行してください。詳細は、VDDK イメージの作成 を参照してください。
仮想マシンが VMware vSAN によってバックアップされている場合、仮想マシンの移行は VDDK なしでは機能しません。
手順
- Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
- Create Provider をクリックします。
- vSphere をクリックします。
次のフィールドを指定します。
Provider details
- Provider resource name: 移行元プロバイダーの名前。
- Endpoint type: vSphere プロバイダーエンドポイントタイプを選択します。オプション: vCenter または ESXi。仮想マシンは、vCenter、vCenter によって管理されていない ESX/ESXi サーバー、または vCenter によって管理されているが vCenter を経由しない ESX/ESXi サーバーから移行できます。
-
URL: ソース仮想マシンがマウントされている vCenter の SDK エンドポイントの URL。URL に
sdkパス (通常は/sdk) が含まれていることを確認してください。たとえば、https://vCenter-host-example.com/sdkです。FQDN の証明書が指定されている場合、このフィールドの値は証明書内の FQDN と一致する必要があります。 -
VDDK init image:
VDDKInitImageパス。移行を加速するために、VDDK init イメージの作成が強く推奨されます。詳細は、VDDK イメージの作成 を参照してください。
プロバイダー認証情報
-
Username: vCenter ユーザーまたは ESXi ユーザー。たとえば、
user@vsphere.localです。 - Password: vCenter ユーザーパスワードまたは ESXi ユーザーパスワード。
CA 証明書を検証するには、以下のいずれかのオプションを選択します。
- Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
- Use the system CA certificate: システム CA 証明書を検証した後に移行します。
Skip certificate validation: CA 証明書を検証せずに移行します。
- カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
- システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
- 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。
オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。
- Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。
詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。
確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。
プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。
プロバイダーがプロバイダーのリストに表示されます。
注記プロバイダーのステータスが
Readyになるまでには数分かかる場合があります。オプション: プロバイダーの UI へのアクセスを追加します。
Providers ページで、プロバイダーをクリックします。
Provider details ページが開きます。
- External UI web link の下の Edit アイコンをクリックします。
リンクを入力して Save をクリックします。
注記リンクを入力しない場合、MTV によって正しいリンクの計算が試行されます。
- MTV が成功した場合、フィールドのハイパーリンクの参照先が計算されたリンクになります。
- MTV が成功しなかった場合、フィールドは空のままになります。
6.2. VMware 移行元プロバイダーの移行ネットワークの選択 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールで移行元プロバイダーの移行ネットワークを選択して、移行元環境のリスクを軽減し、パフォーマンスを向上できます。
移行に管理ネットワークを使用すると、ネットワークに十分な帯域幅がないためにパフォーマンスが低下する可能性があります。この状況は、ディスク転送操作がネットワークを飽和状態にし、移行元プラットフォームに悪影響を及ぼす可能性があります。
vSphere の Network File Copy (NFC) サービスを使用して、ホストからディスクを転送するネットワークを制御することもできます。
移行ネットワークのデフォルト値のほかに、最大伝送単位 (MTU) の値を入力する場合は、使用する OpenShift 転送ネットワークに同じ値も入力する必要があります。OpenShift 転送ネットワークの詳細は、移行計画の作成 を参照してください。
前提条件
- 移行ネットワークにディスク転送に十分なスループット (最低速度は 10 Gbps) がある。
デフォルトゲートウェイを使用して、OpenShift Virtualization ノードから移行ネットワークにアクセスできる。
注記ソースの仮想ディスクは、ターゲット namespace の Pod ネットワークに接続されている Pod によってコピーされます。
- 移行ネットワークで、ジャンボフレームを有効にしている。
手順
- Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
- プロバイダーの横にある Hosts 列のホスト番号をクリックし、ホストのリストを表示します。
- 1 つまたは複数のホストを選択し、Select migration network をクリックします。
次のフィールドを指定します。
- Network: ネットワーク名
-
ESXi host admin username: 例:
root - ESXi host admin password: パスワード
- Save をクリックします。
各ホストのステータスが Ready であることを確認します。
ホストのステータスが Ready でない場合、移行ネットワーク上でホストに到達できないか、クレデンシャルが正しくない可能性があります。ホスト設定を変更して、変更を保存できます。
6.3. OpenShift Virtualization 移行先プロバイダーの追加 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Virtualization プロバイダーは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
具体的には、OpenShift Virtualization プロバイダーとして自動的に追加されるホストクラスターは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
MTV をインストールしたプロバイダーであるデフォルトの OpenShift Virtualization 移行先プロバイダーだけでなく、別の OpenShift Virtualization 移行先プロバイダーも Red Hat OpenShift Web コンソールに追加できます。
MTV がデプロイされているクラスターから別のクラスターに仮想マシンを移行したり、リモートクラスターから MTV がデプロイされたクラスターに仮想マシンを移行したりできます。
前提条件
-
cluster-admin権限を持つ OpenShift Virtualization サービスアカウントトークン がある。
手順
- Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
- Create Provider をクリックします。
- OpenShift Virtualization をクリックします。
次のフィールドを指定します。
- Provider resource name: 移行元プロバイダーの名前
- URL: API サーバーのエンドポイントの URL
Service account bearer token:
cluster-admin権限を持つサービスアカウントのトークンURL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。
CA 証明書を検証するには、以下のいずれかのオプションを選択します。
- Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
- Use the system CA certificate: システム CA 証明書を検証した後に移行します。
Skip certificate validation: CA 証明書を検証せずに移行します。
- カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
- システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
- 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。
オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。
- Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。
詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。
確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。
プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。
プロバイダーがプロバイダーのリストに表示されます。
6.4. OpenShift Virtualization プロバイダーの移行ネットワークの選択 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールで OpenShift Virtualization プロバイダーのデフォルトの移行ネットワークを選択して、パフォーマンスを向上させることができます。デフォルトの移行ネットワークは、ディスクが設定された namespace にディスクを転送するために使用されます。
移行ネットワークを選択しない場合、デフォルトの移行ネットワークは pod ネットワークで、ディスク転送に最適ではない可能性があります。
移行計画の作成時に別のネットワークを選択して、プロバイダーのデフォルトの移行ネットワークを上書きできます。
手順
- Red Hat OpenShift Web コンソールで、Migration > Providers for virtualization をクリックします。
変更する移行ネットワークがある OpenShift Virtualization プロバイダーをクリックします。
Providers detail ページが表示されたら:
- Networks タブをクリックします。
- Set default transfer network をクリックします。
- リストからデフォルトの転送ネットワークを選択し、Save をクリックします。
6.5. 移行計画の作成 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、移行計画を作成します。移行元プロバイダー、移行する仮想マシン (VM)、およびその他の計画の情報を指定します。
Internet Small Computer Systems Interface (iSCSI) 接続や Network File System (NFS) マウントなど、ゲストが開始するストレージ接続が指定された仮想マシンを含めないでください。これらには、移行前の追加の計画、または移行後の再設定が必要です。
これにより、ゲストが参照するストレージのディスクに同時にアクセスされないようにします。
プランには 500 台を超える仮想マシンまたは 500 台を超えるディスクを含めることはできません。
手順
Red Hat OpenShift Web コンソールで、Plans for virtualization、Create Plan の順にクリックします。
Create migration plan ウィザードが開き、Select source provider インターフェイスが表示されます。
移行する仮想マシンの移行元プロバイダーを選択します。
Select virtual machines インターフェイスが開きます。
移行する仮想マシンを選択し、Next をクリックします。
Create migration plan ペインが開きます。移行元プロバイダーの名前と、移行先プロバイダーと namespace、ネットワークマップ、ストレージマップに関する提案が表示されます。
- Plan name を入力します。
- Target provider、Target namespace、または Network map または Storage map の要素を変更するには、関連するリストから項目を選択します。
- Network map または Storage map を追加するには、+ 記号をクリックしてマッピングを追加します。
Create migration plan をクリックします。
MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。
プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。
このページの Settings セクションで、以下の項目を確認します。
- ウォーム移行: デフォルトでは、すべての移行はコールド移行です。ウォーム移行の場合は、Edit アイコンをクリックし、Warm migration を選択します。
Transfer Network: 仮想マシンを OpenShift Virtualization に転送するために使用されるネットワーク。デフォルトでは、これがプロバイダーのデフォルトの転送ネットワークです。選択したターゲット namespace に、転送ネットワークがあることを確認します。転送ネットワークを編集するには、Edit アイコンをクリックし、開いたウィンドウのリストから別の転送ネットワークを選択して、Save をクリックします。
Networking > NetworkAttachmentDefinitions をクリックして、OpenShift Web コンソールで OpenShift ネットワークを設定できます。
OpenShift がサポートするさまざまなタイプのネットワークの詳細は、OpenShift Container Platform の追加のネットワーク を参照してください。
OpenShift 転送ネットワークの最大伝送単位 (MTU) を調整する場合は、VMware 移行ネットワークの MTU も変更する必要があります。詳細は、VMware 移行元プロバイダーの移行ネットワークの選択 を参照してください。
- Target namespace: 移行されたすべての仮想マシンで使用される移行先の namespace。デフォルトでは、これは現在のまたはアクティブな namespace です。namespace を編集するには、Edit アイコンをクリックし、開いたウィンドウの一覧から別のターゲット namespace を選択し、Save をクリックします。
Preserve static IPs: デフォルトでは、仮想ネットワークインターフェイスコントローラー (vNIC) は移行プロセス中に変更されます。その結果、ゲスト仮想マシンのインターフェイス名にリンクされた静的 IP で設定された vNIC は IP を失います。これを回避するには、Preserve static IP の横にある Edit アイコンをクリックし、開いたウィンドウで Whether to preserve the static IPs を切り替えます。次に、Save をクリックします。
その後、MTV は、vNIC プロパティーが欠落している仮想マシンに関する警告メッセージを発行します。不足している vNIC プロパティーを取得するには、vSphere で該当する仮想マシンを実行して、vNIC プロパティーが MTV に報告されるようにします。
- Disk decryption passphrases: Linux Unified Key Setup (LUKS) を使用して暗号化されたディスクの場合。LUKS で暗号化されたデバイスの復号化パスフレーズのリストを入力するには、Settings セクションで、Disk decryption passphrases の横にある Edit アイコンをクリックし、パスフレーズを入力して、Save をクリックします。パスフレーズは特定の順序で入力する必要はありません。LUKS 暗号化デバイスごとに、MTV はデバイスのロックを解除するまで各パスフレーズを試みます。
Root device: マルチブートの仮想マシン移行のみに適用されます。デフォルトでは、MTV はルートデバイスとして検出された最初の起動可能なデバイスを使用します。
別のルートデバイスを指定するには、Settings セクションで、Root device の横にある Edit icon をクリックし、よく使用されるオプションのリストからデバイスを選択するか、テキストボックスにデバイスを入力します。
MTV はディスクの場所に
/dev/sd<disk_identifier><disk_partition>という形式を使用します。たとえば、2 番目のディスクがルートデバイスであり、オペレーティングシステムがディスクの 2 番目のパーティションにある場合、形式は/dev/sdb2になります。起動デバイスを入力したら、Save をクリックします。指定した起動デバイスが正しくないために変換が失敗した場合は、変換 Pod のログを確認することで正確な情報を取得できます。
VMware 7 仮想マシンを CentOS 7.9 を使用する OpenShift 4.13+ プラットフォームに移行すると、ネットワークインターフェイスの名前が変更され、仮想マシンの静的 IP 設定が機能しなくなります。
6.6. 移行計画の実行 リンクのコピーリンクがクリップボードにコピーされました!
移行計画を実行し、Red Hat OpenShift Web コンソールでその進行状況を表示できます。
前提条件
- 有効な移行計画が作成されている。
手順
Red Hat OpenShift Web コンソールで、Migration → Plans for virtualization をクリックします。
Plans リストには、ソースプロバイダーとターゲットプロバイダー、移行される仮想マシン (VM) の数、ステータス、移行の開始日、および各プランの説明が表示されます。
- 移行計画の横にある Start をクリックして移行を開始します。
開いた確認ウィンドウで Start をクリックします。
プランの Status が Running に変更され、移行の進捗が表示されます。
ウォーム移行のみ:
- プレコピー段階が開始します。
- Cutover クリックして移行を完了します。
オプション: 移行の ステータス のリンクをクリックすると、移行の全体的なステータスと各仮想マシンのステータスが表示されます。
- 左側のリンクは、移行が失敗したか、成功したか、進行中かを示します。また、移行が成功、失敗、またはキャンセルされた仮想マシンの数も報告されます。
右側のリンクで、Plan Details ページの Virtual Machines タブが開きます。各仮想マシンについて、タブには次のデータが表示されます。
- 仮想マシンの名前
- 移行の開始時間と終了時間
- コピーされたデータ量
仮想マシンの移行の進捗パイプライン
警告データの破損を回避するために、インポートされる仮想マシンでは、svMotion を含む vMotion と再配置を無効にする必要があります。
オプション: 移行の実行中または完了後に移行のログを表示するには、次の操作を実行します。
- Virtual Machines タブをクリックします。
移行の進行状況を確認する仮想マシンの左側にある矢印 (>) をクリックします。
仮想マシンの詳細が表示されます。
Pods セクションの Pod links 列で、Logs リンクをクリックします。
Logs タブが開きます。
注記ログは常に利用できるとは限りません。ログが利用できない一般的な理由は次のとおりです。
-
OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、
virt-v2vは関係しないため、Pod は必要ありません。 - Pod が作成されなかった。
- Pod が削除された。
- Pod を実行する前に移行に失敗した。
-
OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、
- Raw ログを表示するには、Raw リンクをクリックします。
- ログをダウンロードするには、Download リンクをクリックします。
6.7. 移行計画のオプション リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールの Plans for virtualization ページで、移行計画の横にある Options メニュー
をクリックすると、次のオプションにアクセスできます。
Edit Plan: 移行計画の詳細を編集します。プランが実行中または正常に完了している場合は、次のオプションを編集できません。
- Plan details ページの Settings セクションにあるすべてのプロパティー。たとえば、ウォーム移行またはコールド移行、ターゲットの namespace、および保持された静的 IP などです。
- Mappings タブでのプランのマッピング。
- Hooks タブにリストされているフック。
- Start migration: Active は、該当する場合のみ。
- Restart migration: 中断された移行を再開します。このオプションを選択する前に、エラーメッセージがないことを確認してください。ある場合は、プランを編集する必要があります。
Cutover: ウォーム移行のみ。該当する場合にのみアクティブになります。Cutover をクリックすると、Cutover ウィンドウが開き、以下のオプションがサポートされます。
- Set cutover: カットオーバーの日時を設定します。
- Remove cutover: スケジュールされたカットオーバーをキャンセルします。該当する場合にのみアクティブになります。
Duplicate Plan: 既存の計画と同じ仮想マシン (VM)、パラメーター、マッピング、およびフックを使用して、新しい移行計画を作成します。この機能は、以下のタスクに使用できます。
- 仮想マシンを別の namespace に移行する。
- アーカイブされた移行計画を編集する。
- ステータスが異なる移行計画を編集する (例: 失敗、キャンセル、実行中、クリティカル、準備完了)。
Archive Plan: 移行プランのログ、履歴、メタデータを削除します。計画を編集または再起動することはできません。表示、複製、削除のみが可能です。
注記Archive Plan は元に戻せません。ただし、アーカイブされた計画を複製することはできます。
Delete Plan: 移行プランを完全に削除します。実行中の移行計画を削除することはできません。
注記Delete Plan は元に戻せません。
移行計画を削除しても、一時リソースは削除されません。一時リソースを削除するには、削除する前にまずプランをアーカイブします。
6.8. 移行のキャンセル リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、移行計画の進行中に一部またはすべての仮想マシン (VM) の移行をキャンセルできます。
手順
- Red Hat OpenShift Web コンソールで、Plans for virtualization をクリックします。
- 実行中の移行計画の名前をクリックし、移行の詳細を表示します。
- 1 つ以上の仮想マシンを選択し、Cancel をクリックします。
Yes, cancel をクリックしてキャンセルを確定します。
Migration details by VM リストでは、キャンセルした仮想マシンのステータスは Canceled になります。移行されていない仮想マシンと移行された仮想マシンは影響を受けません。
Migration plans ページの移行計画の横にある Restart をクリックして、キャンセルした移行を再開できます。
第7章 Red Hat Virtualization からの仮想マシンの移行 リンクのコピーリンクがクリップボードにコピーされました!
7.1. Red Hat Virtualization 移行元プロバイダーの追加 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift の Web コンソールを使用して、Red Hat Virtualization 移行元プロバイダーを追加できます。
前提条件
- マネージャーの CA 証明書 (サードパーティーの証明書に置き換えられた場合を除く)。その場合は、マネージャーの Apache CA 証明書を指定します。
手順
- Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
- Create Provider をクリックします。
- Red Hat Virtualization をクリックします。
次のフィールドを指定します。
- Provider resource name: 移行元プロバイダーの名前。
-
URL: ソース仮想マシンがマウントされている Red Hat Virtualization Manager (RHVM) の API エンドポイントの URL。URL に、RHVM API サーバーへのパス (通常は
/ovirt-engine/api)が含まれていることを確認してください。たとえば、https://rhv-host-example.com/ovirt-engine/apiです。 - Username: ユーザー名。
- Password: パスワード。
CA 証明書を検証するには、以下のいずれかのオプションを選択します。
- Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
- Use the system CA certificate: システム CA 証明書を検証した後に移行します。
Skip certificate validation: CA 証明書を検証せずに移行します。
- カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
- システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
- 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。
オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。
- Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。
詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。
確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。
プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。
プロバイダーがプロバイダーのリストに表示されます。
オプション: プロバイダーの UI へのアクセスを追加します。
Providers ページで、プロバイダーをクリックします。
Provider details ページが開きます。
- External UI web link の下の Edit アイコンをクリックします。
リンクを入力して Save をクリックします。
注記リンクを入力しない場合、MTV によって正しいリンクの計算が試行されます。
- MTV が成功した場合、フィールドのハイパーリンクの参照先が計算されたリンクになります。
- MTV が成功しなかった場合、フィールドは空のままになります。
7.2. OpenShift Virtualization 移行先プロバイダーの追加 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Virtualization プロバイダーは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
具体的には、OpenShift Virtualization プロバイダーとして自動的に追加されるホストクラスターは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
MTV をインストールしたプロバイダーであるデフォルトの OpenShift Virtualization 移行先プロバイダーだけでなく、別の OpenShift Virtualization 移行先プロバイダーも Red Hat OpenShift Web コンソールに追加できます。
MTV がデプロイされているクラスターから別のクラスターに仮想マシンを移行したり、リモートクラスターから MTV がデプロイされたクラスターに仮想マシンを移行したりできます。
前提条件
-
cluster-admin権限を持つ OpenShift Virtualization サービスアカウントトークン がある。
手順
- Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
- Create Provider をクリックします。
- OpenShift Virtualization をクリックします。
次のフィールドを指定します。
- Provider resource name: 移行元プロバイダーの名前
- URL: API サーバーのエンドポイントの URL
Service account bearer token:
cluster-admin権限を持つサービスアカウントのトークンURL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。
CA 証明書を検証するには、以下のいずれかのオプションを選択します。
- Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
- Use the system CA certificate: システム CA 証明書を検証した後に移行します。
Skip certificate validation: CA 証明書を検証せずに移行します。
- カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
- システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
- 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。
オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。
- Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。
詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。
確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。
プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。
プロバイダーがプロバイダーのリストに表示されます。
7.3. OpenShift Virtualization プロバイダーの移行ネットワークの選択 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールで OpenShift Virtualization プロバイダーのデフォルトの移行ネットワークを選択して、パフォーマンスを向上させることができます。デフォルトの移行ネットワークは、ディスクが設定された namespace にディスクを転送するために使用されます。
移行ネットワークを選択しない場合、デフォルトの移行ネットワークは pod ネットワークで、ディスク転送に最適ではない可能性があります。
移行計画の作成時に別のネットワークを選択して、プロバイダーのデフォルトの移行ネットワークを上書きできます。
手順
- Red Hat OpenShift Web コンソールで、Migration > Providers for virtualization をクリックします。
変更する移行ネットワークがある OpenShift Virtualization プロバイダーをクリックします。
Providers detail ページが表示されたら:
- Networks タブをクリックします。
- Set default transfer network をクリックします。
- リストからデフォルトの転送ネットワークを選択し、Save をクリックします。
7.4. 移行計画の作成 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、移行計画を作成します。移行元プロバイダー、移行する仮想マシン (VM)、およびその他の計画の情報を指定します。
Internet Small Computer Systems Interface (iSCSI) 接続や Network File System (NFS) マウントなど、ゲストが開始するストレージ接続が指定された仮想マシンを含めないでください。これらには、移行前の追加の計画、または移行後の再設定が必要です。
これにより、ゲストが参照するストレージのディスクに同時にアクセスされないようにします。
プランには 500 台を超える仮想マシンまたは 500 台を超えるディスクを含めることはできません。
手順
Red Hat OpenShift Web コンソールで、Plans for virtualization、Create Plan の順にクリックします。
Create migration plan ウィザードが開き、Select source provider インターフェイスが表示されます。
移行する仮想マシンの移行元プロバイダーを選択します。
Select virtual machines インターフェイスが開きます。
移行する仮想マシンを選択し、Next をクリックします。
Create migration plan ペインが開きます。移行元プロバイダーの名前と、移行先プロバイダーと namespace、ネットワークマップ、ストレージマップに関する提案が表示されます。
- Plan name を入力します。
- Target provider、Target namespace、または Network map または Storage map の要素を変更するには、関連するリストから項目を選択します。
- Network map または Storage map を追加するには、+ 記号をクリックしてマッピングを追加します。
Create migration plan をクリックします。
MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。
プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。
このページの Settings セクションで、以下の項目を確認します。
- Warm migration: デフォルトでは、すべての移行はコールド移行です。ウォーム移行の場合は、Edit アイコンをクリックし、Warm migration を選択します。
Transfer Network: 仮想マシンを OpenShift Virtualization に転送するために使用されるネットワーク。デフォルトでは、これがプロバイダーのデフォルトの転送ネットワークです。選択したターゲット namespace に、転送ネットワークがあることを確認します。転送ネットワークを編集するには、Edit アイコンをクリックし、開いたウィンドウのリストから別の転送ネットワークを選択して、Save をクリックします。
Networking > NetworkAttachmentDefinitions をクリックして、OpenShift Web コンソールで OpenShift ネットワークを設定できます。
OpenShift がサポートするさまざまなタイプのネットワークの詳細は、OpenShift Container Platform の追加のネットワーク を参照してください。
OpenShift 転送ネットワークの最大伝送単位 (MTU) を調整する場合は、VMware 移行ネットワークの MTU も変更する必要があります。詳細は、VMware 移行元プロバイダーの移行ネットワークの選択 を参照してください。
- Target namespace: 移行されたすべての仮想マシンで使用される移行先の namespace。デフォルトでは、これは現在のまたはアクティブな namespace です。namespace を編集するには、Edit アイコンをクリックし、開いたウィンドウの一覧から別のターゲット namespace を選択し、Save をクリックします。
Preserving the CPU model of VMs that are migrated from RHV: 通常、RHV 仮想マシンの CPU モデル (タイプ) はクラスターレベルで設定されますが、仮想マシンレベルで設定することもできます。これはカスタム CPU モデルと呼ばれます。デフォルトでは、MTV は宛先クラスターの CPU モデルを次のように設定します。
- MTV は、CPU 設定がカスタムの仮想マシンの場合は、カスタム CPU 設定を保持します。
カスタム CPU 設定のない仮想マシン、MTV は CPU モデルを設定しません。代わりに、CPU モデルは OpenShift Virtualization によって後で設定されます。
RHV 仮想マシンのクラスターレベルの CPU モデルを保持するには、Settings セクションで、Preserve CPU model の横にある Edit アイコンをクリックします。Whether to preserve the CPU model スイッチを切り替えて、Save をクリックします。
7.5. 移行計画の実行 リンクのコピーリンクがクリップボードにコピーされました!
移行計画を実行し、Red Hat OpenShift Web コンソールでその進行状況を表示できます。
前提条件
- 有効な移行計画が作成されている。
手順
Red Hat OpenShift Web コンソールで、Migration → Plans for virtualization をクリックします。
Plans リストには、ソースプロバイダーとターゲットプロバイダー、移行される仮想マシン (VM) の数、ステータス、移行の開始日、および各プランの説明が表示されます。
- 移行計画の横にある Start をクリックして移行を開始します。
開いた確認ウィンドウで Start をクリックします。
プランの Status が Running に変更され、移行の進捗が表示されます。
ウォーム移行のみ:
- プレコピー段階が開始します。
- Cutover クリックして移行を完了します。
オプション: 移行の ステータス のリンクをクリックすると、移行の全体的なステータスと各仮想マシンのステータスが表示されます。
- 左側のリンクは、移行が失敗したか、成功したか、進行中かを示します。また、移行が成功、失敗、またはキャンセルされた仮想マシンの数も報告されます。
右側のリンクで、Plan Details ページの Virtual Machines タブが開きます。各仮想マシンについて、タブには次のデータが表示されます。
- 仮想マシンの名前
- 移行の開始時間と終了時間
- コピーされたデータ量
仮想マシンの移行の進捗パイプライン
警告データの破損を回避するために、インポートされる仮想マシンでは、svMotion を含む vMotion と再配置を無効にする必要があります。
オプション: 移行の実行中または完了後に移行のログを表示するには、次の操作を実行します。
- Virtual Machines タブをクリックします。
移行の進行状況を確認する仮想マシンの左側にある矢印 (>) をクリックします。
仮想マシンの詳細が表示されます。
Pods セクションの Pod links 列で、Logs リンクをクリックします。
Logs タブが開きます。
注記ログは常に利用できるとは限りません。ログが利用できない一般的な理由は次のとおりです。
-
OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、
virt-v2vは関係しないため、Pod は必要ありません。 - Pod が作成されなかった。
- Pod が削除された。
- Pod を実行する前に移行に失敗した。
-
OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、
- Raw ログを表示するには、Raw リンクをクリックします。
- ログをダウンロードするには、Download リンクをクリックします。
7.6. 移行計画のオプション リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールの Plans for virtualization ページで、移行計画の横にある Options メニュー
をクリックすると、次のオプションにアクセスできます。
Edit Plan: 移行計画の詳細を編集します。プランが実行中または正常に完了している場合は、次のオプションを編集できません。
- Plan details ページの Settings セクションにあるすべてのプロパティー。たとえば、ウォーム移行またはコールド移行、ターゲットの namespace、および保持された静的 IP などです。
- Mappings タブでのプランのマッピング。
- Hooks タブにリストされているフック。
- Start migration: Active は、該当する場合のみ。
- Restart migration: 中断された移行を再開します。このオプションを選択する前に、エラーメッセージがないことを確認してください。ある場合は、プランを編集する必要があります。
Cutover: ウォーム移行のみ。該当する場合にのみアクティブになります。Cutover をクリックすると、Cutover ウィンドウが開き、以下のオプションがサポートされます。
- Set cutover: カットオーバーの日時を設定します。
- Remove cutover: スケジュールされたカットオーバーをキャンセルします。該当する場合にのみアクティブになります。
Duplicate Plan: 既存の計画と同じ仮想マシン (VM)、パラメーター、マッピング、およびフックを使用して、新しい移行計画を作成します。この機能は、以下のタスクに使用できます。
- 仮想マシンを別の namespace に移行する。
- アーカイブされた移行計画を編集する。
- ステータスが異なる移行計画を編集する (例: 失敗、キャンセル、実行中、クリティカル、準備完了)。
Archive Plan: 移行プランのログ、履歴、メタデータを削除します。計画を編集または再起動することはできません。表示、複製、削除のみが可能です。
注記Archive Plan は元に戻せません。ただし、アーカイブされた計画を複製することはできます。
Delete Plan: 移行プランを完全に削除します。実行中の移行計画を削除することはできません。
注記Delete Plan は元に戻せません。
移行計画を削除しても、一時リソースは削除されません。一時リソースを削除するには、削除する前にまずプランをアーカイブします。
7.7. 移行のキャンセル リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、移行計画の進行中に一部またはすべての仮想マシン (VM) の移行をキャンセルできます。
手順
- Red Hat OpenShift Web コンソールで、Plans for virtualization をクリックします。
- 実行中の移行計画の名前をクリックし、移行の詳細を表示します。
- 1 つ以上の仮想マシンを選択し、Cancel をクリックします。
Yes, cancel をクリックしてキャンセルを確定します。
Migration details by VM リストでは、キャンセルした仮想マシンのステータスは Canceled になります。移行されていない仮想マシンと移行された仮想マシンは影響を受けません。
Migration plans ページの移行計画の横にある Restart をクリックして、キャンセルした移行を再開できます。
第8章 OpenStack からの仮想マシンの移行 リンクのコピーリンクがクリップボードにコピーされました!
8.1. OpenStack 移行元プロバイダーの追加 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift の Web コンソールを使用して、OpenStack 移行元プロバイダーを追加できます。
OpenStack プロバイダーからイメージベースの仮想マシンを移行すると、ソース仮想マシンに接続されているイメージのスナップショットが作成され、スナップショットのデータがターゲット仮想マシンにコピーされます。つまり、ターゲット仮想マシンは、スナップショットが作成された時点でのソース仮想マシンと同じ状態になります。
手順
- Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
- Create Provider をクリックします。
- OpenStack をクリックします。
次のフィールドを指定します。
- Provider resource name: 移行元プロバイダーの名前。
-
URL: OpenStack Identity (Keystone) エンドポイントの URL。たとえば、
http://controller:5000/v3です。 Authentication type: 次の認証方法のいずれかを選択し、選択した内容に関連する情報を入力します。たとえば、認証タイプとして Application credential ID を選択した場合は、Application credential ID と Application credential secret フィールドがアクティブになり、ID とシークレットを指定する必要があります。
Application credential ID
- Application credential ID: OpenStack アプリケーション認証情報 ID
-
Application credential secret: OpenStack アプリケーション認証情報の
Secret
Application credential name
- Application credential name: OpenStack アプリケーションの認証情報名
-
Application credential secret: OpenStack アプリケーション認証情報の
Secret - Username: OpenStack ユーザー名
- Domain: OpenStack ドメイン名
Token with user ID
- Token: OpenStack トークン
- User ID: OpenStack ユーザー ID
- Project ID: OpenStack プロジェクト ID
ユーザー名のトークン
- Token: OpenStack トークン
- Username: OpenStack ユーザー名
- Project: OpenStack プロジェクト
- Domain name: OpenStack ドメイン名
Password
- Username: OpenStack ユーザー名
- Password: OpenStack パスワード
- Project: OpenStack プロジェクト
- Domain: OpenStack ドメイン名
CA 証明書を検証するには、以下のいずれかのオプションを選択します。
- Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
- Use the system CA certificate: システム CA 証明書を検証した後に移行します。
Skip certificate validation: CA 証明書を検証せずに移行します。
- カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
- システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
- 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。
オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。
- Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。
詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。
確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。
プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。
プロバイダーがプロバイダーのリストに表示されます。
オプション: プロバイダーの UI へのアクセスを追加します。
Providers ページで、プロバイダーをクリックします。
Provider details ページが開きます。
- External UI web link の下の Edit アイコンをクリックします。
リンクを入力して Save をクリックします。
注記リンクを入力しない場合、MTV によって正しいリンクの計算が試行されます。
- MTV が成功した場合、フィールドのハイパーリンクの参照先が計算されたリンクになります。
- MTV が成功しなかった場合、フィールドは空のままになります。
8.2. OpenShift Virtualization 移行先プロバイダーの追加 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Virtualization プロバイダーは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
具体的には、OpenShift Virtualization プロバイダーとして自動的に追加されるホストクラスターは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
MTV をインストールしたプロバイダーであるデフォルトの OpenShift Virtualization 移行先プロバイダーだけでなく、別の OpenShift Virtualization 移行先プロバイダーも Red Hat OpenShift Web コンソールに追加できます。
MTV がデプロイされているクラスターから別のクラスターに仮想マシンを移行したり、リモートクラスターから MTV がデプロイされたクラスターに仮想マシンを移行したりできます。
前提条件
-
cluster-admin権限を持つ OpenShift Virtualization サービスアカウントトークン がある。
手順
- Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
- Create Provider をクリックします。
- OpenShift Virtualization をクリックします。
次のフィールドを指定します。
- Provider resource name: 移行元プロバイダーの名前
- URL: API サーバーのエンドポイントの URL
Service account bearer token:
cluster-admin権限を持つサービスアカウントのトークンURL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。
CA 証明書を検証するには、以下のいずれかのオプションを選択します。
- Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
- Use the system CA certificate: システム CA 証明書を検証した後に移行します。
Skip certificate validation: CA 証明書を検証せずに移行します。
- カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
- システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
- 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。
オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。
- Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。
詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。
確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。
プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。
プロバイダーがプロバイダーのリストに表示されます。
8.3. OpenShift Virtualization プロバイダーの移行ネットワークの選択 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールで OpenShift Virtualization プロバイダーのデフォルトの移行ネットワークを選択して、パフォーマンスを向上させることができます。デフォルトの移行ネットワークは、ディスクが設定された namespace にディスクを転送するために使用されます。
移行ネットワークを選択しない場合、デフォルトの移行ネットワークは pod ネットワークで、ディスク転送に最適ではない可能性があります。
移行計画の作成時に別のネットワークを選択して、プロバイダーのデフォルトの移行ネットワークを上書きできます。
手順
- Red Hat OpenShift Web コンソールで、Migration > Providers for virtualization をクリックします。
変更する移行ネットワークがある OpenShift Virtualization プロバイダーをクリックします。
Providers detail ページが表示されたら:
- Networks タブをクリックします。
- Set default transfer network をクリックします。
- リストからデフォルトの転送ネットワークを選択し、Save をクリックします。
8.4. 移行計画の作成 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、移行計画を作成します。移行元プロバイダー、移行する仮想マシン (VM)、およびその他の計画の情報を指定します。
Internet Small Computer Systems Interface (iSCSI) 接続や Network File System (NFS) マウントなど、ゲストが開始するストレージ接続が指定された仮想マシンを含めないでください。これらには、移行前の追加の計画、または移行後の再設定が必要です。
これにより、ゲストが参照するストレージのディスクに同時にアクセスされないようにします。
プランには 500 台を超える仮想マシンまたは 500 台を超えるディスクを含めることはできません。
手順
Red Hat OpenShift Web コンソールで、Plans for virtualization、Create Plan の順にクリックします。
Create migration plan ウィザードが開き、Select source provider インターフェイスが表示されます。
移行する仮想マシンの移行元プロバイダーを選択します。
Select virtual machines インターフェイスが開きます。
移行する仮想マシンを選択し、Next をクリックします。
Create migration plan ペインが開きます。移行元プロバイダーの名前と、移行先プロバイダーと namespace、ネットワークマップ、ストレージマップに関する提案が表示されます。
- Plan name を入力します。
- Target provider、Target namespace、または Network map または Storage map の要素を変更するには、関連するリストから項目を選択します。
- Network map または Storage map を追加するには、+ 記号をクリックしてマッピングを追加します。
Create migration plan をクリックします。
MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。
プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。
このページの Settings セクションで、以下の項目を確認します。
Transfer Network: 仮想マシンを OpenShift Virtualization に転送するために使用されるネットワーク。デフォルトでは、これがプロバイダーのデフォルトの転送ネットワークです。選択したターゲット namespace に、転送ネットワークがあることを確認します。転送ネットワークを編集するには、Edit アイコンをクリックし、開いたウィンドウのリストから別の転送ネットワークを選択して、Save をクリックします。
Networking > NetworkAttachmentDefinitions をクリックして、OpenShift Web コンソールで OpenShift ネットワークを設定できます。
OpenShift がサポートするさまざまなタイプのネットワークの詳細は、OpenShift Container Platform の追加のネットワーク を参照してください。
OpenShift 転送ネットワークの最大伝送単位 (MTU) を調整する場合は、VMware 移行ネットワークの MTU も変更する必要があります。詳細は、VMware 移行元プロバイダーの移行ネットワークの選択 を参照してください。
- Target namespace: 移行されたすべての仮想マシンで使用される移行先の namespace。デフォルトでは、これは現在のまたはアクティブな namespace です。namespace を編集するには、Edit アイコンをクリックし、開いたウィンドウの一覧から別のターゲット namespace を選択し、Save をクリックします。
計画が有効な場合、以下のいずれかを実行できます。
- Start migration をクリックして、すぐに計画を実行します。
- 後で Plans for virtualization ページで計画を選択し、移行計画の実行 の手順に従うことで、計画を実行します。
8.5. 移行計画の実行 リンクのコピーリンクがクリップボードにコピーされました!
移行計画を実行し、Red Hat OpenShift Web コンソールでその進行状況を表示できます。
前提条件
- 有効な移行計画が作成されている。
手順
Red Hat OpenShift Web コンソールで、Migration → Plans for virtualization をクリックします。
Plans リストには、ソースプロバイダーとターゲットプロバイダー、移行される仮想マシン (VM) の数、ステータス、移行の開始日、および各プランの説明が表示されます。
- 移行計画の横にある Start をクリックして移行を開始します。
開いた確認ウィンドウで Start をクリックします。
プランの Status が Running に変更され、移行の進捗が表示されます。
ウォーム移行のみ:
- プレコピー段階が開始します。
- Cutover クリックして移行を完了します。
オプション: 移行の ステータス のリンクをクリックすると、移行の全体的なステータスと各仮想マシンのステータスが表示されます。
- 左側のリンクは、移行が失敗したか、成功したか、進行中かを示します。また、移行が成功、失敗、またはキャンセルされた仮想マシンの数も報告されます。
右側のリンクで、Plan Details ページの Virtual Machines タブが開きます。各仮想マシンについて、タブには次のデータが表示されます。
- 仮想マシンの名前
- 移行の開始時間と終了時間
- コピーされたデータ量
仮想マシンの移行の進捗パイプライン
警告データの破損を回避するために、インポートされる仮想マシンでは、svMotion を含む vMotion と再配置を無効にする必要があります。
オプション: 移行の実行中または完了後に移行のログを表示するには、次の操作を実行します。
- Virtual Machines タブをクリックします。
移行の進行状況を確認する仮想マシンの左側にある矢印 (>) をクリックします。
仮想マシンの詳細が表示されます。
Pods セクションの Pod links 列で、Logs リンクをクリックします。
Logs タブが開きます。
注記ログは常に利用できるとは限りません。ログが利用できない一般的な理由は次のとおりです。
-
OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、
virt-v2vは関係しないため、Pod は必要ありません。 - Pod が作成されなかった。
- Pod が削除された。
- Pod を実行する前に移行に失敗した。
-
OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、
- Raw ログを表示するには、Raw リンクをクリックします。
- ログをダウンロードするには、Download リンクをクリックします。
8.6. 移行計画のオプション リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールの Plans for virtualization ページで、移行計画の横にある Options メニュー
をクリックすると、次のオプションにアクセスできます。
Edit Plan: 移行計画の詳細を編集します。プランが実行中または正常に完了している場合は、次のオプションを編集できません。
- Plan details ページの Settings セクションにあるすべてのプロパティー。たとえば、ウォーム移行またはコールド移行、ターゲットの namespace、および保持された静的 IP などです。
- Mappings タブでのプランのマッピング。
- Hooks タブにリストされているフック。
- Start migration: Active は、該当する場合のみ。
- Restart migration: 中断された移行を再開します。このオプションを選択する前に、エラーメッセージがないことを確認してください。ある場合は、プランを編集する必要があります。
Cutover: ウォーム移行のみ。該当する場合にのみアクティブになります。Cutover をクリックすると、Cutover ウィンドウが開き、以下のオプションがサポートされます。
- Set cutover: カットオーバーの日時を設定します。
- Remove cutover: スケジュールされたカットオーバーをキャンセルします。該当する場合にのみアクティブになります。
Duplicate Plan: 既存の計画と同じ仮想マシン (VM)、パラメーター、マッピング、およびフックを使用して、新しい移行計画を作成します。この機能は、以下のタスクに使用できます。
- 仮想マシンを別の namespace に移行する。
- アーカイブされた移行計画を編集する。
- ステータスが異なる移行計画を編集する (例: 失敗、キャンセル、実行中、クリティカル、準備完了)。
Archive Plan: 移行プランのログ、履歴、メタデータを削除します。計画を編集または再起動することはできません。表示、複製、削除のみが可能です。
注記Archive Plan は元に戻せません。ただし、アーカイブされた計画を複製することはできます。
Delete Plan: 移行プランを完全に削除します。実行中の移行計画を削除することはできません。
注記Delete Plan は元に戻せません。
移行計画を削除しても、一時リソースは削除されません。一時リソースを削除するには、削除する前にまずプランをアーカイブします。
8.7. 移行のキャンセル リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、移行計画の進行中に一部またはすべての仮想マシン (VM) の移行をキャンセルできます。
手順
- Red Hat OpenShift Web コンソールで、Plans for virtualization をクリックします。
- 実行中の移行計画の名前をクリックし、移行の詳細を表示します。
- 1 つ以上の仮想マシンを選択し、Cancel をクリックします。
Yes, cancel をクリックしてキャンセルを確定します。
Migration details by VM リストでは、キャンセルした仮想マシンのステータスは Canceled になります。移行されていない仮想マシンと移行された仮想マシンは影響を受けません。
Migration plans ページの移行計画の横にある Restart をクリックして、キャンセルした移行を再開できます。
第9章 OVA からの仮想マシンの移行 リンクのコピーリンクがクリップボードにコピーされました!
9.1. Open Virtual Appliance (OVA) 移行元プロバイダーの追加 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、VMware vSphere によって作成された Open Virtual Appliance (OVA) ファイルを移行元プロバイダーとして追加できます。
手順
- Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
- Create Provider をクリックします。
- Open Virtual Appliance (OVA) をクリックします。
次のフィールドを指定します。
- Provider resource name: 移行元プロバイダーの名前
- URL: OVA を提供する NFS ファイル共有の URL
プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。
プロバイダーがプロバイダーのリストに表示されます。
注記エラーが発生したことを示すエラーメッセージが表示される場合があります。このメッセージは無視しても問題ありません。
9.2. OpenShift Virtualization 移行先プロバイダーの追加 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Virtualization プロバイダーは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
具体的には、OpenShift Virtualization プロバイダーとして自動的に追加されるホストクラスターは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
MTV をインストールしたプロバイダーであるデフォルトの OpenShift Virtualization 移行先プロバイダーだけでなく、別の OpenShift Virtualization 移行先プロバイダーも Red Hat OpenShift Web コンソールに追加できます。
MTV がデプロイされているクラスターから別のクラスターに仮想マシンを移行したり、リモートクラスターから MTV がデプロイされたクラスターに仮想マシンを移行したりできます。
前提条件
-
cluster-admin権限を持つ OpenShift Virtualization サービスアカウントトークン がある。
手順
- Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
- Create Provider をクリックします。
- OpenShift Virtualization をクリックします。
次のフィールドを指定します。
- Provider resource name: 移行元プロバイダーの名前
- URL: API サーバーのエンドポイントの URL
Service account bearer token:
cluster-admin権限を持つサービスアカウントのトークンURL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。
CA 証明書を検証するには、以下のいずれかのオプションを選択します。
- Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
- Use the system CA certificate: システム CA 証明書を検証した後に移行します。
Skip certificate validation: CA 証明書を検証せずに移行します。
- カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
- システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
- 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。
オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。
- Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。
詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。
確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。
プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。
プロバイダーがプロバイダーのリストに表示されます。
9.3. OpenShift Virtualization プロバイダーの移行ネットワークの選択 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールで OpenShift Virtualization プロバイダーのデフォルトの移行ネットワークを選択して、パフォーマンスを向上させることができます。デフォルトの移行ネットワークは、ディスクが設定された namespace にディスクを転送するために使用されます。
移行ネットワークを選択しない場合、デフォルトの移行ネットワークは pod ネットワークで、ディスク転送に最適ではない可能性があります。
移行計画の作成時に別のネットワークを選択して、プロバイダーのデフォルトの移行ネットワークを上書きできます。
手順
- Red Hat OpenShift Web コンソールで、Migration > Providers for virtualization をクリックします。
変更する移行ネットワークがある OpenShift Virtualization プロバイダーをクリックします。
Providers detail ページが表示されたら:
- Networks タブをクリックします。
- Set default transfer network をクリックします。
- リストからデフォルトの転送ネットワークを選択し、Save をクリックします。
9.4. 移行計画の作成 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、移行計画を作成します。移行元プロバイダー、移行する仮想マシン (VM)、およびその他の計画の情報を指定します。
Internet Small Computer Systems Interface (iSCSI) 接続や Network File System (NFS) マウントなど、ゲストが開始するストレージ接続が指定された仮想マシンを含めないでください。これらには、移行前の追加の計画、または移行後の再設定が必要です。
これにより、ゲストが参照するストレージのディスクに同時にアクセスされないようにします。
プランには 500 台を超える仮想マシンまたは 500 台を超えるディスクを含めることはできません。
手順
Red Hat OpenShift Web コンソールで、Plans for virtualization、Create Plan の順にクリックします。
Create migration plan ウィザードが開き、Select source provider インターフェイスが表示されます。
移行する仮想マシンの移行元プロバイダーを選択します。
Select virtual machines インターフェイスが開きます。
移行する仮想マシンを選択し、Next をクリックします。
Create migration plan ペインが開きます。移行元プロバイダーの名前と、移行先プロバイダーと namespace、ネットワークマップ、ストレージマップに関する提案が表示されます。
- Plan name を入力します。
- Target provider、Target namespace、または Network map または Storage map の要素を変更するには、関連するリストから項目を選択します。
- Network map または Storage map を追加するには、+ 記号をクリックしてマッピングを追加します。
Create migration plan をクリックします。
MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。
プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。
このページの Settings セクションで、以下の項目を確認します。
Transfer Network: 仮想マシンを OpenShift Virtualization に転送するために使用されるネットワーク。デフォルトでは、これがプロバイダーのデフォルトの転送ネットワークです。選択したターゲット namespace に、転送ネットワークがあることを確認します。転送ネットワークを編集するには、Edit アイコンをクリックし、開いたウィンドウのリストから別の転送ネットワークを選択して、Save をクリックします。
Networking > NetworkAttachmentDefinitions をクリックして、OpenShift Web コンソールで OpenShift ネットワークを設定できます。
OpenShift がサポートするさまざまなタイプのネットワークの詳細は、OpenShift Container Platform の追加のネットワーク を参照してください。
OpenShift 転送ネットワークの最大伝送単位 (MTU) を調整する場合は、VMware 移行ネットワークの MTU も変更する必要があります。詳細は、VMware 移行元プロバイダーの移行ネットワークの選択 を参照してください。
- Target namespace: 移行されたすべての仮想マシンで使用される移行先の namespace。デフォルトでは、これは現在のまたはアクティブな namespace です。namespace を編集するには、Edit アイコンをクリックし、開いたウィンドウの一覧から別のターゲット namespace を選択し、Save をクリックします。
計画が有効な場合、以下のいずれかを実行できます。
- Start migration をクリックして、すぐに計画を実行します。
- 後で Plans for virtualization ページで計画を選択し、移行計画の実行 の手順に従うことで、計画を実行します。
9.5. 移行計画の実行 リンクのコピーリンクがクリップボードにコピーされました!
移行計画を実行し、Red Hat OpenShift Web コンソールでその進行状況を表示できます。
前提条件
- 有効な移行計画が作成されている。
手順
Red Hat OpenShift Web コンソールで、Migration → Plans for virtualization をクリックします。
Plans リストには、ソースプロバイダーとターゲットプロバイダー、移行される仮想マシン (VM) の数、ステータス、移行の開始日、および各プランの説明が表示されます。
- 移行計画の横にある Start をクリックして移行を開始します。
開いた確認ウィンドウで Start をクリックします。
プランの Status が Running に変更され、移行の進捗が表示されます。
ウォーム移行のみ:
- プレコピー段階が開始します。
- Cutover クリックして移行を完了します。
オプション: 移行の ステータス のリンクをクリックすると、移行の全体的なステータスと各仮想マシンのステータスが表示されます。
- 左側のリンクは、移行が失敗したか、成功したか、進行中かを示します。また、移行が成功、失敗、またはキャンセルされた仮想マシンの数も報告されます。
右側のリンクで、Plan Details ページの Virtual Machines タブが開きます。各仮想マシンについて、タブには次のデータが表示されます。
- 仮想マシンの名前
- 移行の開始時間と終了時間
- コピーされたデータ量
仮想マシンの移行の進捗パイプライン
警告データの破損を回避するために、インポートされる仮想マシンでは、svMotion を含む vMotion と再配置を無効にする必要があります。
オプション: 移行の実行中または完了後に移行のログを表示するには、次の操作を実行します。
- Virtual Machines タブをクリックします。
移行の進行状況を確認する仮想マシンの左側にある矢印 (>) をクリックします。
仮想マシンの詳細が表示されます。
Pods セクションの Pod links 列で、Logs リンクをクリックします。
Logs タブが開きます。
注記ログは常に利用できるとは限りません。ログが利用できない一般的な理由は次のとおりです。
-
OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、
virt-v2vは関係しないため、Pod は必要ありません。 - Pod が作成されなかった。
- Pod が削除された。
- Pod を実行する前に移行に失敗した。
-
OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、
- Raw ログを表示するには、Raw リンクをクリックします。
- ログをダウンロードするには、Download リンクをクリックします。
9.6. 移行計画のオプション リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールの Plans for virtualization ページで、移行計画の横にある Options メニュー
をクリックすると、次のオプションにアクセスできます。
Edit Plan: 移行計画の詳細を編集します。プランが実行中または正常に完了している場合は、次のオプションを編集できません。
- Plan details ページの Settings セクションにあるすべてのプロパティー。たとえば、ウォーム移行またはコールド移行、ターゲットの namespace、および保持された静的 IP などです。
- Mappings タブでのプランのマッピング。
- Hooks タブにリストされているフック。
- Start migration: Active は、該当する場合のみ。
- Restart migration: 中断された移行を再開します。このオプションを選択する前に、エラーメッセージがないことを確認してください。ある場合は、プランを編集する必要があります。
Cutover: ウォーム移行のみ。該当する場合にのみアクティブになります。Cutover をクリックすると、Cutover ウィンドウが開き、以下のオプションがサポートされます。
- Set cutover: カットオーバーの日時を設定します。
- Remove cutover: スケジュールされたカットオーバーをキャンセルします。該当する場合にのみアクティブになります。
Duplicate Plan: 既存の計画と同じ仮想マシン (VM)、パラメーター、マッピング、およびフックを使用して、新しい移行計画を作成します。この機能は、以下のタスクに使用できます。
- 仮想マシンを別の namespace に移行する。
- アーカイブされた移行計画を編集する。
- ステータスが異なる移行計画を編集する (例: 失敗、キャンセル、実行中、クリティカル、準備完了)。
Archive Plan: 移行プランのログ、履歴、メタデータを削除します。計画を編集または再起動することはできません。表示、複製、削除のみが可能です。
注記Archive Plan は元に戻せません。ただし、アーカイブされた計画を複製することはできます。
Delete Plan: 移行プランを完全に削除します。実行中の移行計画を削除することはできません。
注記Delete Plan は元に戻せません。
移行計画を削除しても、一時リソースは削除されません。一時リソースを削除するには、削除する前にまずプランをアーカイブします。
9.7. 移行のキャンセル リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、移行計画の進行中に一部またはすべての仮想マシン (VM) の移行をキャンセルできます。
手順
- Red Hat OpenShift Web コンソールで、Plans for virtualization をクリックします。
- 実行中の移行計画の名前をクリックし、移行の詳細を表示します。
- 1 つ以上の仮想マシンを選択し、Cancel をクリックします。
Yes, cancel をクリックしてキャンセルを確定します。
Migration details by VM リストでは、キャンセルした仮想マシンのステータスは Canceled になります。移行されていない仮想マシンと移行された仮想マシンは影響を受けません。
Migration plans ページの移行計画の横にある Restart をクリックして、キャンセルした移行を再開できます。
第10章 OpenShift Virtualization からの仮想マシンの移行 リンクのコピーリンクがクリップボードにコピーされました!
10.1. Red Hat OpenShift Virtualization 移行元プロバイダーの追加 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Virtualization プロバイダーは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
具体的には、OpenShift Virtualization プロバイダーとして自動的に追加されるホストクラスターは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
MTV がデプロイされているクラスターから別のクラスターに仮想マシンを移行したり、リモートクラスターから MTV がデプロイされたクラスターに仮想マシンを移行したりできます。
移行元プロバイダーの Red Hat OpenShift クラスターのバージョンは 4.13 以降である必要があります。
手順
- Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
- Create Provider をクリックします。
- OpenShift Virtualization をクリックします。
次のフィールドを指定します。
- Provider resource name: 移行元プロバイダーの名前
- URL: API サーバーのエンドポイントの URL
Service account bearer token:
cluster-admin権限を持つサービスアカウントのトークンURL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。
CA 証明書を検証するには、以下のいずれかのオプションを選択します。
- Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
- Use the system CA certificate: システム CA 証明書を検証した後に移行します。
Skip certificate validation: CA 証明書を検証せずに移行します。
- カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
- システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
- 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。
オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。
- Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。
詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。
確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。
プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。
プロバイダーがプロバイダーのリストに表示されます。
オプション: プロバイダーの UI へのアクセスを追加します。
Providers ページで、プロバイダーをクリックします。
Provider details ページが開きます。
- External UI web link の下の Edit アイコンをクリックします。
リンクを入力して Save をクリックします。
注記リンクを入力しない場合、MTV によって正しいリンクの計算が試行されます。
- MTV が成功した場合、フィールドのハイパーリンクの参照先が計算されたリンクになります。
- MTV が成功しなかった場合、フィールドは空のままになります。
10.2. OpenShift Virtualization 移行先プロバイダーの追加 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Virtualization プロバイダーは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
具体的には、OpenShift Virtualization プロバイダーとして自動的に追加されるホストクラスターは、移行元プロバイダーと移行先プロバイダーの両方として使用できます。
MTV をインストールしたプロバイダーであるデフォルトの OpenShift Virtualization 移行先プロバイダーだけでなく、別の OpenShift Virtualization 移行先プロバイダーも Red Hat OpenShift Web コンソールに追加できます。
MTV がデプロイされているクラスターから別のクラスターに仮想マシンを移行したり、リモートクラスターから MTV がデプロイされたクラスターに仮想マシンを移行したりできます。
前提条件
-
cluster-admin権限を持つ OpenShift Virtualization サービスアカウントトークン がある。
手順
- Red Hat OpenShift Web コンソールで、Migration → Providers for virtualization をクリックします。
- Create Provider をクリックします。
- OpenShift Virtualization をクリックします。
次のフィールドを指定します。
- Provider resource name: 移行元プロバイダーの名前
- URL: API サーバーのエンドポイントの URL
Service account bearer token:
cluster-admin権限を持つサービスアカウントのトークンURL と Service account bearer token の両方を空白のままにすると、ローカルの OpenShift クラスターが使用されます。
CA 証明書を検証するには、以下のいずれかのオプションを選択します。
- Use a custom CA certificate: カスタム CA 証明書を検証した後に移行します。
- Use the system CA certificate: システム CA 証明書を検証した後に移行します。
Skip certificate validation: CA 証明書を検証せずに移行します。
- カスタム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA 証明書をテキストボックスにドラッグするか、または それを参照して Select をクリックするかの いずれか を行います。
- システム CA 証明書を使用するには、Skip certificate validation スイッチを左に切り替えた状態にし、CA certificate のテキストボックスを空のままにします。
- 証明書の検証を省略するには、Skip certificate validation スイッチを右に切り替えます。
オプション: プロバイダーの API エンドポイント URL からカスタム CA 証明書を取得するように MTV に依頼します。
- Fetch certificate from URL をクリックします。Verify certificate ウィンドウが開きます。
詳細が正しい場合は、I trust the authenticity of this certificate チェックボックスを選択し、Confirm をクリックします。そうでない場合は、Cancel をクリックし、正しい証明書情報を手動で入力します。
確認後、CA 証明書は、API エンドポイントとの後続の通信を検証するために使用されます。
プロバイダーを追加して保存するには、プロバイダーの作成 をクリックします。
プロバイダーがプロバイダーのリストに表示されます。
10.3. OpenShift Virtualization プロバイダーの移行ネットワークの選択 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールで OpenShift Virtualization プロバイダーのデフォルトの移行ネットワークを選択して、パフォーマンスを向上させることができます。デフォルトの移行ネットワークは、ディスクが設定された namespace にディスクを転送するために使用されます。
移行ネットワークを選択しない場合、デフォルトの移行ネットワークは pod ネットワークで、ディスク転送に最適ではない可能性があります。
移行計画の作成時に別のネットワークを選択して、プロバイダーのデフォルトの移行ネットワークを上書きできます。
手順
- Red Hat OpenShift Web コンソールで、Migration > Providers for virtualization をクリックします。
変更する移行ネットワークがある OpenShift Virtualization プロバイダーをクリックします。
Providers detail ページが表示されたら:
- Networks タブをクリックします。
- Set default transfer network をクリックします。
- リストからデフォルトの転送ネットワークを選択し、Save をクリックします。
10.4. 移行計画の作成 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、移行計画を作成します。移行元プロバイダー、移行する仮想マシン (VM)、およびその他の計画の情報を指定します。
Internet Small Computer Systems Interface (iSCSI) 接続や Network File System (NFS) マウントなど、ゲストが開始するストレージ接続が指定された仮想マシンを含めないでください。これらには、移行前の追加の計画、または移行後の再設定が必要です。
これにより、ゲストが参照するストレージのディスクに同時にアクセスされないようにします。
プランには 500 台を超える仮想マシンまたは 500 台を超えるディスクを含めることはできません。
手順
Red Hat OpenShift Web コンソールで、Plans for virtualization、Create Plan の順にクリックします。
Create migration plan ウィザードが開き、Select source provider インターフェイスが表示されます。
移行する仮想マシンの移行元プロバイダーを選択します。
Select virtual machines インターフェイスが開きます。
移行する仮想マシンを選択し、Next をクリックします。
Create migration plan ペインが開きます。移行元プロバイダーの名前と、移行先プロバイダーと namespace、ネットワークマップ、ストレージマップに関する提案が表示されます。
- Plan name を入力します。
- Target provider、Target namespace、または Network map または Storage map の要素を変更するには、関連するリストから項目を選択します。
- Network map または Storage map を追加するには、+ 記号をクリックしてマッピングを追加します。
Create migration plan をクリックします。
MTV によって移行計画が検証されます。Plan details ページが開き、計画が使用可能かどうか、またはエラーが含まれているかどうかが示されます。
プランの詳細が表示され、前のページで入力した項目を編集できます。変更を加えると、MTV によってプランが再度検証されます。
このページの Settings セクションで、以下の項目を確認します。
Transfer Network: 仮想マシンを OpenShift Virtualization に転送するために使用されるネットワーク。デフォルトでは、これがプロバイダーのデフォルトの転送ネットワークです。選択したターゲット namespace に、転送ネットワークがあることを確認します。転送ネットワークを編集するには、Edit アイコンをクリックし、開いたウィンドウのリストから別の転送ネットワークを選択して、Save をクリックします。
Networking > NetworkAttachmentDefinitions をクリックして、OpenShift Web コンソールで OpenShift ネットワークを設定できます。
OpenShift がサポートするさまざまなタイプのネットワークの詳細は、OpenShift Container Platform の追加のネットワーク を参照してください。
OpenShift 転送ネットワークの最大伝送単位 (MTU) を調整する場合は、VMware 移行ネットワークの MTU も変更する必要があります。詳細は、VMware 移行元プロバイダーの移行ネットワークの選択 を参照してください。
- Target namespace: 移行されたすべての仮想マシンで使用される移行先の namespace。デフォルトでは、これは現在のまたはアクティブな namespace です。namespace を編集するには、Edit アイコンをクリックし、開いたウィンドウの一覧から別のターゲット namespace を選択し、Save をクリックします。
計画が有効な場合、以下のいずれかを実行できます。
- Start migration をクリックして、すぐに計画を実行します。
- 後で Plans for virtualization ページで計画を選択し、移行計画の実行 の手順に従うことで、計画を実行します。
10.5. 移行計画の実行 リンクのコピーリンクがクリップボードにコピーされました!
移行計画を実行し、Red Hat OpenShift Web コンソールでその進行状況を表示できます。
前提条件
- 有効な移行計画が作成されている。
手順
Red Hat OpenShift Web コンソールで、Migration → Plans for virtualization をクリックします。
Plans リストには、ソースプロバイダーとターゲットプロバイダー、移行される仮想マシン (VM) の数、ステータス、移行の開始日、および各プランの説明が表示されます。
- 移行計画の横にある Start をクリックして移行を開始します。
開いた確認ウィンドウで Start をクリックします。
プランの Status が Running に変更され、移行の進捗が表示されます。
ウォーム移行のみ:
- プレコピー段階が開始します。
- Cutover クリックして移行を完了します。
オプション: 移行の ステータス のリンクをクリックすると、移行の全体的なステータスと各仮想マシンのステータスが表示されます。
- 左側のリンクは、移行が失敗したか、成功したか、進行中かを示します。また、移行が成功、失敗、またはキャンセルされた仮想マシンの数も報告されます。
右側のリンクで、Plan Details ページの Virtual Machines タブが開きます。各仮想マシンについて、タブには次のデータが表示されます。
- 仮想マシンの名前
- 移行の開始時間と終了時間
- コピーされたデータ量
仮想マシンの移行の進捗パイプライン
警告データの破損を回避するために、インポートされる仮想マシンでは、svMotion を含む vMotion と再配置を無効にする必要があります。
オプション: 移行の実行中または完了後に移行のログを表示するには、次の操作を実行します。
- Virtual Machines タブをクリックします。
移行の進行状況を確認する仮想マシンの左側にある矢印 (>) をクリックします。
仮想マシンの詳細が表示されます。
Pods セクションの Pod links 列で、Logs リンクをクリックします。
Logs タブが開きます。
注記ログは常に利用できるとは限りません。ログが利用できない一般的な理由は次のとおりです。
-
OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、
virt-v2vは関係しないため、Pod は必要ありません。 - Pod が作成されなかった。
- Pod が削除された。
- Pod を実行する前に移行に失敗した。
-
OpenShift Virtualization から OpenShift Virtualization への移行である。この場合、
- Raw ログを表示するには、Raw リンクをクリックします。
- ログをダウンロードするには、Download リンクをクリックします。
10.6. 移行計画のオプション リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールの Plans for virtualization ページで、移行計画の横にある Options メニュー
をクリックすると、次のオプションにアクセスできます。
Edit Plan: 移行計画の詳細を編集します。プランが実行中または正常に完了している場合は、次のオプションを編集できません。
- Plan details ページの Settings セクションにあるすべてのプロパティー。たとえば、ウォーム移行またはコールド移行、ターゲットの namespace、および保持された静的 IP などです。
- Mappings タブでのプランのマッピング。
- Hooks タブにリストされているフック。
- Start migration: Active は、該当する場合のみ。
- Restart migration: 中断された移行を再開します。このオプションを選択する前に、エラーメッセージがないことを確認してください。ある場合は、プランを編集する必要があります。
Cutover: ウォーム移行のみ。該当する場合にのみアクティブになります。Cutover をクリックすると、Cutover ウィンドウが開き、以下のオプションがサポートされます。
- Set cutover: カットオーバーの日時を設定します。
- Remove cutover: スケジュールされたカットオーバーをキャンセルします。該当する場合にのみアクティブになります。
Duplicate Plan: 既存の計画と同じ仮想マシン (VM)、パラメーター、マッピング、およびフックを使用して、新しい移行計画を作成します。この機能は、以下のタスクに使用できます。
- 仮想マシンを別の namespace に移行する。
- アーカイブされた移行計画を編集する。
- ステータスが異なる移行計画を編集する (例: 失敗、キャンセル、実行中、クリティカル、準備完了)。
Archive Plan: 移行プランのログ、履歴、メタデータを削除します。計画を編集または再起動することはできません。表示、複製、削除のみが可能です。
注記Archive Plan は元に戻せません。ただし、アーカイブされた計画を複製することはできます。
Delete Plan: 移行プランを完全に削除します。実行中の移行計画を削除することはできません。
注記Delete Plan は元に戻せません。
移行計画を削除しても、一時リソースは削除されません。一時リソースを削除するには、削除する前にまずプランをアーカイブします。
10.7. 移行のキャンセル リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、移行計画の進行中に一部またはすべての仮想マシン (VM) の移行をキャンセルできます。
手順
- Red Hat OpenShift Web コンソールで、Plans for virtualization をクリックします。
- 実行中の移行計画の名前をクリックし、移行の詳細を表示します。
- 1 つ以上の仮想マシンを選択し、Cancel をクリックします。
Yes, cancel をクリックしてキャンセルを確定します。
Migration details by VM リストでは、キャンセルした仮想マシンのステータスは Canceled になります。移行されていない仮想マシンと移行された仮想マシンは影響を受けません。
Migration plans ページの移行計画の横にある Restart をクリックして、キャンセルした移行を再開できます。
第11章 コマンドラインからの仮想マシンの移行 リンクのコピーリンクがクリップボードにコピーされました!
コマンドラインから仮想マシンを OpenShift Virtualization に移行できます。
すべての 前提条件 を満たしていることを確認する必要があります。
11.1. 管理者以外が移行計画コンポーネントを操作するために必要な権限 リンクのコピーリンクがクリップボードにコピーされました!
管理者の場合は、移行計画のすべてのコンポーネント (プロバイダー、ネットワークマッピング、移行計画など) を操作できます。
デフォルトでは、管理者以外のユーザーが移行計画とそのコンポーネントを操作できる機能は限られています。管理者は、ロールを変更してすべてのコンポーネントへの完全なアクセスを許可したり、制限付きのパーミッションを付与したりできます。
たとえば、管理者は、移行計画に管理者以外のクラスターロールを 1 つ以上割り当てることができます。
| Role | 説明 |
|---|---|
|
| 移行計画を表示できますが、作成、削除、または変更はできません。 |
|
|
個々の移行計画を作成、削除、または変更 ( |
|
|
すべての |
事前定義されたクラスターのロールには、リソース (例: plan)、API グループ (例: forklift.konveyor.io-v1beta1)、およびアクション (例: view、edit) が含まれることに注意してください。
全体的な例として、管理者以外のユーザーに namespace 別に次の一連の権限を付与できます。
- アクセス可能な namespace のストレージマップ、ネットワークマップ、および移行計画を作成および変更する
- 管理者が作成したプロバイダーをストレージマップ、ネットワークマップ、移行計画に接続する
- プロバイダーを作成できない、またはシステム設定を変更できないようにする
| アクション | API グループ | リソース |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 空の文字列 |
|
管理者以外が移行計画を作成するには、ネットワークマップまたはストレージマップのテンプレートを使用する場合でも、ネットワークマップおよびストレージマップの edit ロールの一部である create 権限が必要です。
11.2. 仮想マシンの移行 リンクのコピーリンクがクリップボードにコピーされました!
MTV カスタムリソース (CR) を作成し、コマンドラインインターフェイス (CLI) を使用して仮想マシン (VM) を移行します。CR と移行手順は移行元プロバイダーによって異なります。
クラスタースコープの CR の名前を指定する必要があります。
namespace スコープの CR の名前と namespace の両方を指定する必要があります。
移行計画が定義されている OpenShift クラスターとは異なる OpenShift クラスターへの移行や、そこからの移行を行うには、cluster-admin 権限を持つ OpenShift Virtualization サービスアカウントトークンが必要です。
11.3. VMware vSphere 移行元プロバイダーからの移行 リンクのコピーリンクがクリップボードにコピーされました!
コマンドラインインターフェイス (CLI) を使用して、VMware vSphere ソースプロバイダーから移行できます。
手順
移行元プロバイダーの認証情報の
Secretマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
ownerReferencesセクションはオプションです。- 2
- vCenter ユーザーまたは ESX/ESXi ユーザーを指定します。
- 3
- vCenter ユーザーまたは ESX/ESXi ユーザーのパスワードを指定します。
- 4
- 証明書の検証をスキップするには
"true"を指定し、証明書を検証するには"false"を指定します。指定されていない場合はデフォルトで"false"になります。証明書の検証をスキップすると、安全でない移行が続行され、証明書は不要になります。セキュアではない移行とは、転送されたデータがセキュアではない接続を介して送信され、機密性の高いデータが公開される可能性があることを意味します。 - 5
- このフィールドが設定されておらず、skip certificate verification が無効になっている場合、MTV はシステム CA の使用を試みます。
- 6
- vCenter または ESX/ESXi の API エンドポイント URL を指定します (例:
https://<vCenter_host>/sdk)。
移行元プロバイダーの
Providerマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Hostマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- VMware vSphere
ProviderCR の名前を指定します。 - 2
- VMware vSphere ホストの Managed Object Reference (moRef) を指定します。moRef を取得するには、VMware vSphere moRef の取得 を参照してください。
- 3
- VMware vSphere 移行ネットワークの IP アドレスを指定します。
移行元ネットワークと移行先ネットワークをマッピングする
NetworkMapマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 使用できる値は
Podおよびmultusです。 - 2
- ソースネットワークを指定するには、
idまたはnameパラメーターのいずれかを使用できます。idには、VMware vSphere ネットワーク Managed Object Reference (moRef) を指定します。moRef を取得するには、VMware vSphere moRef の取得 を参照してください。 - 3
- 追加の OpenShift Virtualization ネットワークごとにネットワークアタッチメント定義を指定します。
- 4
typeがmultusの場合に限り必要です。OpenShift Virtualization のネットワークアタッチメント定義の namespace を指定します。
StorageMapマニフェストを作成し、移行元ストレージと移行先ストレージをマッピングします。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 使用できる値は
ReadWriteOnceおよびReadWriteManyです。 - 2
- VMware vSphere データストアの moRef を指定します。たとえば、
f2737930-b567-451a-9ceb-2887f6207009です。moRef を取得するには、VMware vSphere moRef の取得 を参照してください。
オプション:
Hookマニフェストを作成し、PlanCR で指定されたフェーズ中に仮想マシンでカスタムコードを実行します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記デフォルトの
hook-runnerイメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。
移行の
Planマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
PlanCR の名前を指定します。- 2
- 移行がウォーム (
true) かコールド (false) かを指定します。Migrationマニフェストでcutoverパラメーターの値を指定せずにウォーム移行を指定すると、プレコピーステージのみが実行します。 - 3
- プランごとにネットワークマップとストレージマップを 1 つだけ指定します。
- 4
- 移行する仮想マシンがネットワークに割り当てられていない場合でも、ネットワークマッピングを指定します。この場合、マッピングは空にできます。
- 5
NetworkMapCR の名前を指定します。- 6
- 移行する仮想マシンにディスクイメージが割り当てられていない場合でも、ストレージマッピングを指定します。この場合、マッピングは空にできます。
- 7
StorageMapCR の名前を指定します。- 8
- デフォルトでは、仮想ネットワークインターフェイスコントローラー (vNIC) は移行プロセス中に変更されます。その結果、ゲスト仮想マシンのインターフェイス名にリンクされた静的 IP で設定された vNIC は IP を失います。これを回避するには、
preserveStaticIPsをtrueに設定します。MTV は、vNIC プロパティーが欠落している仮想マシンに関する警告メッセージを発行します。不足している vNIC プロパティーを取得するには、vSphere で該当する仮想マシンを実行して、vNIC プロパティーが MTV に報告されるようにします。 - 9
idパラメーターまたはnameパラメーターのいずれかを使用して、移行元の仮想マシンを指定できます。- 10
- VMware vSphere 仮想マシンの moRef を指定します。moRef を取得するには、VMware vSphere moRef の取得 を参照してください。
- 11
- オプション: 仮想マシンのフックを最大 2 つ指定できます。各フックは個別の移行ステップで実行する必要があります。
- 12
HookCR の名前を指定します。- 13
- 使用できる値は、移行計画が開始される前の
PreHook、または移行が完了した後のPostHookです。
重要VMware 7 仮想マシンを CentOS 7.9 を使用する OpenShift 4.13+ プラットフォームに移行すると、ネットワークインターフェイスの名前が変更され、仮想マシンの静的 IP 設定が機能しなくなります。
PlanCR を実行するためのMigrationマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記カットオーバー時間を指定する場合は、UTC 時間オフセットを含む ISO 8601 形式を使用します (例:
2024-04-04T01:23:45.678+09:00)。
forklift-controller が移行計画の調整に常に失敗し、その後 HTTP 500 エラーを返すという問題があります。この問題は、仮想マシン (VM) 上でのみユーザー権限を指定した場合に発生します。
MTV では、仮想マシンで使用されるストレージ、ネットワーク、スイッチなどを含むデータセンターレベルで権限を追加する必要があります。次に、権限を子要素に伝播する必要があります。
このレベルの権限を追加しない場合は、必要な仮想マシンホスト上の各オブジェクトに権限を手動で追加する必要があります。
11.3.1. VMware vSphere moRef の取得 リンクのコピーリンクがクリップボードにコピーされました!
コマンドラインインターフェイスから Migration Toolkit for Virtualization (MTV) を使用して VMware vSphere ソースプロバイダーで仮想マシンを移行する場合は、データストア、ネットワーク、仮想マシンなど、vSphere 内の特定のエンティティーのマネージドオブジェクト参照 (moRef) を知っておく必要があります。
インベントリーサービスから 1 つ以上の vSphere エンティティーの moRef を取得できます。その後、各 moRef を別のエンティティーの moRef を取得するための参照として使用できます。
手順
プロジェクトのルートを取得します。
oc get route -n openshift-mtv
oc get route -n openshift-mtvCopy to Clipboard Copied! Toggle word wrap Toggle overflow Inventoryサービスルートを取得します。oc get route <inventory_service> -n openshift-mtv
$ oc get route <inventory_service> -n openshift-mtvCopy to Clipboard Copied! Toggle word wrap Toggle overflow アクセストークンを取得します。
TOKEN=$(oc whoami -t)
$ TOKEN=$(oc whoami -t)Copy to Clipboard Copied! Toggle word wrap Toggle overflow VMware vSphere プロバイダーの moRef を取得します。
curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers/vsphere -k
$ curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers/vsphere -kCopy to Clipboard Copied! Toggle word wrap Toggle overflow VMware vSphere ソースプロバイダーのデータストアを取得します。
curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers/vsphere/<provider id>/datastores/ -k
$ curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers/vsphere/<provider id>/datastores/ -kCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
この例では、データストア v2v_general_porpuse_ISCSI_DC の moRef は datastore-11 であり、データストア f01-h27-640-SSD_2 の moRef は datastore-730 です。
11.3.2. コマンドラインインターフェイスからの移行のキャンセル リンクのコピーリンクがクリップボードにコピーされました!
移行の進行中に、コマンドラインインターフェイス (CLI) を使用して、移行全体または特定の仮想マシン (VM) の移行をキャンセルできます。
移行全体のキャンセル
MigrationCR を削除します。oc delete migration <migration> -n <namespace>
$ oc delete migration <migration> -n <namespace>1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
MigrationCR の名前を指定します。
特定の仮想マシンの移行のキャンセル
Migrationマニフェストのspec.cancelブロックに特定の仮想マシンを追加します。2 つの仮想マシンの移行をキャンセルするための YAML の例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
idキーまたはnameキーを使用して仮想マシンを指定できます。
idキーの値は、VMware 仮想マシンの場合は Managed Object Reference、RHV 仮想マシンの場合は VM UUID です。残りの仮想マシンの進捗をモニタリングするための
MigrationCR を取得します。oc get migration/<migration> -n <namespace> -o yaml
$ oc get migration/<migration> -n <namespace> -o yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
11.4. Red Hat Virtualization 移行元プロバイダーからの移行 リンクのコピーリンクがクリップボードにコピーされました!
コマンドラインインターフェイス (CLI) を使用して、Red Hat Virtualization (RHV) の移行元プロバイダーから移行できます。
前提条件
ダイレクト LUN ディスクを使用して仮想マシンを移行する場合は、仮想マシン実行先の OpenShift Virtualization クラスター内のノードがバックエンドストレージにアクセスできることを確認してください。
- 移行元プロバイダーから移行先プロバイダーに コピーされる ディスクイメージとは異なり、LUN は移行元プロバイダーの仮想マシンから 切り離され ますが、削除 されず、ターゲットプロバイダーで作成された仮想マシン (VM) にアタッチされます。
- 移行元プロバイダーへのフォールバックが必要な場合に備えて、移行中に LUN は移行元プロバイダーから削除されません。ただし、LUN を移行元プロバイダーの仮想マシンに再接続する前に、LUN がターゲット環境上の仮想マシンによって同時に使用されていないことを確認してください。同時に使用されていると、データの破損が発生する可能性があります。
手順
移行元プロバイダーの認証情報の
Secretマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
ownerReferencesセクションはオプションです。- 2
- RHV Manager ユーザーを指定します。
- 3
- ユーザーパスワードを指定します。
- 4
- 証明書の検証をスキップするには
"true"を指定し、証明書を検証するには"false"を指定します。指定されていない場合はデフォルトで"false"になります。証明書の検証をスキップすると、安全でない移行が続行され、証明書は不要になります。セキュアではない移行とは、転送されたデータがセキュアではない接続を介して送信され、機密性の高いデータが公開される可能性があることを意味します。 - 5
- サードパーティーの証明書に置き換えられていない限り、Manager CA 証明書を入力します。その場合は、Manager Apache CA 証明書を入力します。Manager CA 証明書は、https://<engine_host>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA で取得できます。
- 6
- API エンドポイント URL を指定します (例:
https://<engine_host>/ovirt-engine/api)。
移行元プロバイダーの
Providerマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
移行元ネットワークと移行先ネットワークをマッピングする
NetworkMapマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
StorageMapマニフェストを作成し、移行元ストレージと移行先ストレージをマッピングします。Copy to Clipboard Copied! Toggle word wrap Toggle overflow オプション:
Hookマニフェストを作成し、PlanCR で指定されたフェーズ中に仮想マシンでカスタムコードを実行します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記デフォルトの
hook-runnerイメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。
移行の
Planマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
PlanCR の名前を指定します。- 2
- 以下の注を参照してください。
- 3
- 移行がウォームまたはコールドであるかどうかを指定します。
Migrationマニフェストでcutoverパラメーターの値を指定せずにウォーム移行を指定すると、プレコピーステージのみが実行します。 - 4
- プランごとにネットワークマップとストレージマップを 1 つだけ指定します。
- 5
- 移行する仮想マシンがネットワークに割り当てられていない場合でも、ネットワークマッピングを指定します。この場合、マッピングは空にできます。
- 6
NetworkMapCR の名前を指定します。- 7
- 移行する仮想マシンにディスクイメージが割り当てられていない場合でも、ストレージマッピングを指定します。この場合、マッピングは空にできます。
- 8
StorageMapCR の名前を指定します。- 9
idパラメーターまたはnameパラメーターのいずれかを使用して、移行元の仮想マシンを指定できます。- 10
- RHV 仮想マシンの UUID を指定します。
- 11
- オプション: 仮想マシンのフックを最大 2 つ指定できます。各フックは個別の移行ステップで実行する必要があります。
- 12
HookCR の名前を指定します。- 13
- 使用できる値は、移行計画が開始される前の
PreHook、または移行が完了した後のPostHookです。
注記-
移行されたマシンにカスタム CPU モデルが設定されている場合、
preserveClusterCpuModelの設定に関係なく、移行先クラスターでもその CPU モデルが設定されます。 移行されたマシンにカスタム CPU モデルが 設定されていない 場合:
-
preserveClusterCpuModelが 'true` に設定されている場合、MTV はクラスターの設定に基づいて、RHV で実行されている仮想マシンの CPU モデルをチェックし、移行された仮想マシンをその CPU モデルに設定します。 -
preserveClusterCpuModelが 'false` に設定されている場合、MTV は CPU タイプを設定せず、仮想マシンが移行先クラスターのデフォルトの CPU モデルで設定されます。
-
PlanCR を実行するためのMigrationマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記カットオーバー時間を指定する場合は、UTC 時間オフセットを含む ISO 8601 形式を使用します (例:
2024-04-04T01:23:45.678+09:00)。
11.4.1. コマンドラインインターフェイスからの移行のキャンセル リンクのコピーリンクがクリップボードにコピーされました!
移行の進行中に、コマンドラインインターフェイス (CLI) を使用して、移行全体または特定の仮想マシン (VM) の移行をキャンセルできます。
移行全体のキャンセル
MigrationCR を削除します。oc delete migration <migration> -n <namespace>
$ oc delete migration <migration> -n <namespace>1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
MigrationCR の名前を指定します。
特定の仮想マシンの移行のキャンセル
Migrationマニフェストのspec.cancelブロックに特定の仮想マシンを追加します。2 つの仮想マシンの移行をキャンセルするための YAML の例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
idキーまたはnameキーを使用して仮想マシンを指定できます。
idキーの値は、VMware 仮想マシンの場合は Managed Object Reference、RHV 仮想マシンの場合は VM UUID です。残りの仮想マシンの進捗をモニタリングするための
MigrationCR を取得します。oc get migration/<migration> -n <namespace> -o yaml
$ oc get migration/<migration> -n <namespace> -o yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
11.5. OpenStack 移行元プロバイダーからの移行 リンクのコピーリンクがクリップボードにコピーされました!
コマンドラインインターフェイス (CLI) を使用して、OpenStack ソースプロバイダーから移行できます。
手順
移行元プロバイダーの認証情報の
Secretマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
ownerReferencesセクションはオプションです。- 2
- OpenStack ユーザーを指定します。
- 3
- OpenStack ユーザーのパスワードを指定します。
- 4
- 証明書の検証をスキップするには
"true"を指定し、証明書を検証するには"false"を指定します。指定されていない場合はデフォルトで"false"になります。証明書の検証をスキップすると、安全でない移行が続行され、証明書は不要になります。セキュアではない移行とは、転送されたデータがセキュアではない接続を介して送信され、機密性の高いデータが公開される可能性があることを意味します。 - 5
- このフィールドが設定されておらず、skip certificate verification が無効になっている場合、MTV はシステム CA の使用を試みます。
- 6
- API エンドポイント URL を指定します (例:
https://<identity_service>/v3)。
移行元プロバイダーの
Providerマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
移行元ネットワークと移行先ネットワークをマッピングする
NetworkMapマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
StorageMapマニフェストを作成し、移行元ストレージと移行先ストレージをマッピングします。Copy to Clipboard Copied! Toggle word wrap Toggle overflow オプション:
Hookマニフェストを作成し、PlanCR で指定されたフェーズ中に仮想マシンでカスタムコードを実行します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記デフォルトの
hook-runnerイメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。
移行の
Planマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
PlanCR の名前を指定します。- 2
- プランごとにネットワークマップとストレージマップを 1 つだけ指定します。
- 3
- 移行する仮想マシンがネットワークに割り当てられていない場合でも、ネットワークマッピングを指定します。この場合、マッピングは空にできます。
- 4
NetworkMapCR の名前を指定します。- 5
- 移行する仮想マシンにディスクイメージが割り当てられていない場合でも、ストレージマッピングを指定します。この場合、マッピングは空にできます。
- 6
StorageMapCR の名前を指定します。- 7
idパラメーターまたはnameパラメーターのいずれかを使用して、移行元の仮想マシンを指定できます。- 8
- OpenStack 仮想マシン UUID を指定します。
- 9
- オプション: 仮想マシンのフックを最大 2 つ指定できます。各フックは個別の移行ステップで実行する必要があります。
- 10
HookCR の名前を指定します。- 11
- 使用できる値は、移行計画が開始される前の
PreHook、または移行が完了した後のPostHookです。
PlanCR を実行するためのMigrationマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記カットオーバー時間を指定する場合は、UTC 時間オフセットを含む ISO 8601 形式を使用します (例:
2024-04-04T01:23:45.678+09:00)。
11.5.1. コマンドラインインターフェイスからの移行のキャンセル リンクのコピーリンクがクリップボードにコピーされました!
移行の進行中に、コマンドラインインターフェイス (CLI) を使用して、移行全体または特定の仮想マシン (VM) の移行をキャンセルできます。
移行全体のキャンセル
MigrationCR を削除します。oc delete migration <migration> -n <namespace>
$ oc delete migration <migration> -n <namespace>1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
MigrationCR の名前を指定します。
特定の仮想マシンの移行のキャンセル
Migrationマニフェストのspec.cancelブロックに特定の仮想マシンを追加します。2 つの仮想マシンの移行をキャンセルするための YAML の例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
idキーまたはnameキーを使用して仮想マシンを指定できます。
idキーの値は、VMware 仮想マシンの場合は Managed Object Reference、RHV 仮想マシンの場合は VM UUID です。残りの仮想マシンの進捗をモニタリングするための
MigrationCR を取得します。oc get migration/<migration> -n <namespace> -o yaml
$ oc get migration/<migration> -n <namespace> -o yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
11.6. Open Virtual Appliance (OVA) の移行元プロバイダーからの移行 リンクのコピーリンクがクリップボードにコピーされました!
コマンドラインインターフェイス (CLI) を使用して、移行元のプロバイダーとして VMware vSphere によって作成された Open Virtual Appliance (OVA) ファイルから移行できます。
手順
移行元プロバイダーの認証情報の
Secretマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
移行元プロバイダーの
Providerマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
移行元ネットワークと移行先ネットワークをマッピングする
NetworkMapマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
StorageMapマニフェストを作成し、移行元ストレージと移行先ストレージをマッピングします。Copy to Clipboard Copied! Toggle word wrap Toggle overflow オプション:
Hookマニフェストを作成し、PlanCR で指定されたフェーズ中に仮想マシンでカスタムコードを実行します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記デフォルトの
hook-runnerイメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。
移行の
Planマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
PlanCR の名前を指定します。- 2
- プランごとにネットワークマップとストレージマップを 1 つだけ指定します。
- 3
- 移行する仮想マシンがネットワークに割り当てられていない場合でも、ネットワークマッピングを指定します。この場合、マッピングは空にできます。
- 4
NetworkMapCR の名前を指定します。- 5
- 移行する仮想マシンにディスクイメージが割り当てられていない場合でも、ストレージマッピングを指定します。この場合、マッピングは空にできます。
- 6
StorageMapCR の名前を指定します。- 7
idパラメーターまたはnameパラメーターのいずれかを使用して、移行元の仮想マシンを指定できます。- 8
- OVA 仮想マシン UUID を指定します。
- 9
- オプション: 仮想マシンのフックを最大 2 つ指定できます。各フックは個別の移行ステップで実行する必要があります。
- 10
HookCR の名前を指定します。- 11
- 使用できる値は、移行計画が開始される前の
PreHook、または移行が完了した後のPostHookです。
PlanCR を実行するためのMigrationマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記カットオーバー時間を指定する場合は、UTC 時間オフセットを含む ISO 8601 形式を使用します (例:
2024-04-04T01:23:45.678+09:00)。
11.6.1. コマンドラインインターフェイスからの移行のキャンセル リンクのコピーリンクがクリップボードにコピーされました!
移行の進行中に、コマンドラインインターフェイス (CLI) を使用して、移行全体または特定の仮想マシン (VM) の移行をキャンセルできます。
移行全体のキャンセル
MigrationCR を削除します。oc delete migration <migration> -n <namespace>
$ oc delete migration <migration> -n <namespace>1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
MigrationCR の名前を指定します。
特定の仮想マシンの移行のキャンセル
Migrationマニフェストのspec.cancelブロックに特定の仮想マシンを追加します。2 つの仮想マシンの移行をキャンセルするための YAML の例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
idキーまたはnameキーを使用して仮想マシンを指定できます。
idキーの値は、VMware 仮想マシンの場合は Managed Object Reference、RHV 仮想マシンの場合は VM UUID です。残りの仮想マシンの進捗をモニタリングするための
MigrationCR を取得します。oc get migration/<migration> -n <namespace> -o yaml
$ oc get migration/<migration> -n <namespace> -o yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
11.7. Red Hat OpenShift Virtualization 移行元プロバイダーからの移行 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Virtualization プロバイダーは、ソースプロバイダーまたは宛先プロバイダーとして使用できます。コマンドラインインターフェイス (CLI) を使用して、OpenShift Virtualization ソースプロバイダーから移行できます。
手順
移行元プロバイダーの認証情報の
Secretマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
ownerReferencesセクションはオプションです。- 2
cluster-admin権限でサービスアカウントのトークンを指定します。トークンとURLの両方が空白のままの場合、ローカル OpenShift クラスターが使用されます。- 3
- ユーザーパスワードを指定します。
- 4
- 証明書の検証をスキップするには
"true"を指定し、証明書を検証するには"false"を指定します。指定されていない場合はデフォルトで"false"になります。証明書の検証をスキップすると、安全でない移行が続行され、証明書は不要になります。セキュアではない移行とは、転送されたデータがセキュアではない接続を介して送信され、機密性の高いデータが公開される可能性があることを意味します。 - 5
- このフィールドが設定されておらず、skip certificate verification が無効になっている場合、MTV はシステム CA の使用を試みます。
- 6
- API サーバーのエンドポイントの URL を指定します。
移行元プロバイダーの
Providerマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
移行元ネットワークと移行先ネットワークをマッピングする
NetworkMapマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
StorageMapマニフェストを作成し、移行元ストレージと移行先ストレージをマッピングします。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 使用できる値は
ReadWriteOnceおよびReadWriteManyです。
オプション:
Hookマニフェストを作成し、PlanCR で指定されたフェーズ中に仮想マシンでカスタムコードを実行します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記デフォルトの
hook-runnerイメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。
移行の
Planマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
PlanCR の名前を指定します。- 2
- プランごとにネットワークマップとストレージマップを 1 つだけ指定します。
- 3
- 移行する仮想マシンがネットワークに割り当てられていない場合でも、ネットワークマッピングを指定します。この場合、マッピングは空にできます。
- 4
NetworkMapCR の名前を指定します。- 5
- 移行する仮想マシンにディスクイメージが割り当てられていない場合でも、ストレージマッピングを指定します。この場合、マッピングは空にできます。
- 6
StorageMapCR の名前を指定します。- 7
- オプション: 仮想マシンのフックを最大 2 つ指定できます。各フックは個別の移行ステップで実行する必要があります。
- 8
HookCR の名前を指定します。- 9
- 使用できる値は、移行計画が開始される前の
PreHook、または移行が完了した後のPostHookです。
PlanCR を実行するためのMigrationマニフェストを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記カットオーバー時間を指定する場合は、UTC 時間オフセットを含む ISO 8601 形式を使用します (例:
2024-04-04T01:23:45.678+09:00)。
11.7.1. コマンドラインインターフェイスからの移行のキャンセル リンクのコピーリンクがクリップボードにコピーされました!
移行の進行中に、コマンドラインインターフェイス (CLI) を使用して、移行全体または特定の仮想マシン (VM) の移行をキャンセルできます。
移行全体のキャンセル
MigrationCR を削除します。oc delete migration <migration> -n <namespace>
$ oc delete migration <migration> -n <namespace>1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
MigrationCR の名前を指定します。
特定の仮想マシンの移行のキャンセル
Migrationマニフェストのspec.cancelブロックに特定の仮想マシンを追加します。2 つの仮想マシンの移行をキャンセルするための YAML の例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
idキーまたはnameキーを使用して仮想マシンを指定できます。
idキーの値は、VMware 仮想マシンの場合は Managed Object Reference、RHV 仮想マシンの場合は VM UUID です。残りの仮想マシンの進捗をモニタリングするための
MigrationCR を取得します。oc get migration/<migration> -n <namespace> -o yaml
$ oc get migration/<migration> -n <namespace> -o yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
第12章 高度な移行オプション リンクのコピーリンクがクリップボードにコピーされました!
12.1. ウォーム移行のプレコピー間隔の変更 リンクのコピーリンクがクリップボードにコピーされました!
ForkliftController カスタムリソース (CR) にパッチを適用して、スナップショットの間隔を変更できます。
手順
ForkliftControllerCR にパッチを適用します。oc patch forkliftcontroller/<forklift-controller> -n openshift-mtv -p '{"spec": {"controller_precopy_interval": <60>}}' --type=merge$ oc patch forkliftcontroller/<forklift-controller> -n openshift-mtv -p '{"spec": {"controller_precopy_interval": <60>}}' --type=merge1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- プレコピーの間隔を分単位で指定します。デフォルト値は
60です。
forklift-controllerPod を再起動する必要はありません。
12.2. Validation サービスのカスタムルールの作成 リンクのコピーリンクがクリップボードにコピーされました!
Validation サービスは Open Policy Agent (OPA) ポリシールールを使用して、移行に対する各仮想マシン (VM) の適合性を確認します。Validation サービスは、各仮想マシンの concerns リストを生成します。これは、Provider Inventory サービスに仮想マシン属性として保存されます。Web コンソールには、プロバイダーインベントリー内の各仮想マシンの concerns が表示されます。
カスタムルールを作成して、Validation サービスのデフォルトルールセットを拡張できます。たとえば、仮想マシンに複数のディスクがあるかどうかを確認するルールを作成できます。
12.2.1. Rego ファイルについて リンクのコピーリンクがクリップボードにコピーされました!
検証ルールは、Open Policy Agent (OPA) のネイティブクエリー言語である Rego で記述されます。ルールは、Validation Pod の /usr/share/opa/policies/io/konveyor/forklift/<provider> ディレクトリーに .rego ファイルとして保存されます。
各検証ルールは、個別の .rego ファイルに定義され、特定の条件をテストします。条件が true と評価された場合、ルールは {“category", “label", “assessment"} ハッシュを concerns に追加します。concerns のコンテンツは、仮想マシンのインベントリーレコードの concerns キーに追加されます。Web コンソールには、プロバイダーインベントリー内の各仮想マシンの concerns キーのコンテンツが表示されます。
次の .rego ファイルの例では、VMware 仮想マシンのクラスターで有効になっている分散リソーススケジューリングを確認します。
drs_enabled.rego の例
12.2.2. デフォルトの検証ルールの確認 リンクのコピーリンクがクリップボードにコピーされました!
カスタムルールを作成する前に、Validation サービスのデフォルトルールを確認して、既存のデフォルト値を再定義するルールを作成しないようにする必要があります。
例: デフォルトのルールに default valid_input = false の行が含まれていて、default valid_input = true の行が含まれるカスタムルールを作成した場合、Validation サービスは起動しません。
手順
ValidationPod のターミナルに接続します。oc rsh <validation_pod>
$ oc rsh <validation_pod>Copy to Clipboard Copied! Toggle word wrap Toggle overflow プロバイダーの OPA ポリシーディレクトリーに移動します。
cd /usr/share/opa/policies/io/konveyor/forklift/<provider>
$ cd /usr/share/opa/policies/io/konveyor/forklift/<provider>1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
vmwareまたはovirtを指定します。
デフォルトポリシーを検索します。
grep -R "default" *
$ grep -R "default" *Copy to Clipboard Copied! Toggle word wrap Toggle overflow
12.2.3. 検証ルールの作成 リンクのコピーリンクがクリップボードにコピーされました!
ルールを含む設定マップカスタムリソース (CR) を Validation サービスに適用して、検証ルールを作成します。
-
既存のルールと同じ 名前 でルールを作成すると、
Validationサービスは、それらのルールでOR操作を実行します。 -
デフォルトのルールと矛盾するルールを作成すると、
Validationサービスは開始しません。
検証ルールの例
検証ルールは、Provider Inventory サービスが収集する仮想マシン (VM) 属性に基づいています。
たとえば、VMware API はこのパス (MOR:VirtualMachine.config.extraConfig["numa.nodeAffinity"]) を使用して、VMware 仮想マシンに NUMA ノードアフィニティーが設定されているかどうかを確認します。
Provider Inventory サービスは、この設定を簡素化し、テスト可能な属性を、リストの値で返します。
"numaNodeAffinity": [
"0",
"1"
],
"numaNodeAffinity": [
"0",
"1"
],
この属性に基づいて Rego クエリーを作成し、それを forklift-validation-config 設定マップに追加します。
`count(input.numaNodeAffinity) != 0`
`count(input.numaNodeAffinity) != 0`
手順
以下の例に従って設定マップ CR を作成します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow forklift-controllerデプロイメントを0にスケーリングして、ValidationPod を停止します。oc scale -n openshift-mtv --replicas=0 deployment/forklift-controller
$ oc scale -n openshift-mtv --replicas=0 deployment/forklift-controllerCopy to Clipboard Copied! Toggle word wrap Toggle overflow forklift-controllerデプロイメントを1にスケーリングして、ValidationPod を起動します。oc scale -n openshift-mtv --replicas=1 deployment/forklift-controller
$ oc scale -n openshift-mtv --replicas=1 deployment/forklift-controllerCopy to Clipboard Copied! Toggle word wrap Toggle overflow ValidationPod ログをチェックして、Pod が起動したことを確認します。oc logs -f <validation_pod>
$ oc logs -f <validation_pod>Copy to Clipboard Copied! Toggle word wrap Toggle overflow カスタムルールがデフォルトのルールと競合する場合、
ValidationPod は起動しません。移行元プロバイダーを削除します。
oc delete provider <provider> -n openshift-mtv
$ oc delete provider <provider> -n openshift-mtvCopy to Clipboard Copied! Toggle word wrap Toggle overflow 移行元プロバイダーを追加して、新規ルールを適用します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
カスタムルールを作成した後、ルールのバージョンを更新して、Inventory サービスが変更を検出し、仮想マシンを検証できるようにする必要があります。
12.2.4. インベントリールールバージョンの更新 リンクのコピーリンクがクリップボードにコピーされました!
Provider Inventory サービスが変更を検出して Validation サービスをトリガーするように、ルールを更新するたびにインベントリールールのバージョンを更新する必要があります。
ルールバージョンは、各プロバイダーの rules_version.rego ファイルに記録されます。
手順
現在のルールバージョンを取得します。
GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version
$ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
{ "result": { "rules_version": 5 } }{ "result": { "rules_version": 5 } }Copy to Clipboard Copied! Toggle word wrap Toggle overflow ValidationPod のターミナルに接続します。oc rsh <validation_pod>
$ oc rsh <validation_pod>Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
/usr/share/opa/policies/io/konveyor/forklift/<provider>/rules_version.regoファイルでルールバージョンを更新します。 -
ValidationPod ターミナルからログアウトします。 更新されたルールバージョンを検証します。
GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version
$ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
{ "result": { "rules_version": 6 } }{ "result": { "rules_version": 6 } }Copy to Clipboard Copied! Toggle word wrap Toggle overflow
12.3. Inventory サービス JSON の取得 リンクのコピーリンクがクリップボードにコピーされました!
Inventory サービスクエリーを仮想マシン (VM) に送信して Inventory サービス JSON を取得します。出力には "input" キーが含まれます。このキーには、Validation サービスルールによってクエリーされるインベントリー属性が含まれます。
検証ルールは、"input" キーの任意の属性に基づいて作成できます (例: input.snapshot.kind)。
手順
プロジェクトのルートを取得します。
oc get route -n openshift-mtv
oc get route -n openshift-mtvCopy to Clipboard Copied! Toggle word wrap Toggle overflow Inventoryサービスルートを取得します。oc get route <inventory_service> -n openshift-mtv
$ oc get route <inventory_service> -n openshift-mtvCopy to Clipboard Copied! Toggle word wrap Toggle overflow アクセストークンを取得します。
TOKEN=$(oc whoami -t)
$ TOKEN=$(oc whoami -t)Copy to Clipboard Copied! Toggle word wrap Toggle overflow HTTP GET リクエストをトリガーします (たとえば、Curl を使用)。
curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers -k
$ curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers -kCopy to Clipboard Copied! Toggle word wrap Toggle overflow プロバイダーの
UUIDを取得します。curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers/<provider> -k
$ curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers/<provider> -k1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow プロバイダーの仮想マシンを取得します。
curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers/<provider>/<UUID>/vms -k
$ curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers/<provider>/<UUID>/vms -kCopy to Clipboard Copied! Toggle word wrap Toggle overflow 仮想マシンの詳細を取得します。
curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers/<provider>/<UUID>/workloads/<vm> -k
$ curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers/<provider>/<UUID>/workloads/<vm> -kCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
12.4. MTV 移行計画へのフックの追加 リンクのコピーリンクがクリップボードにコピーされました!
Migration Toolkit for Virtualization (MTV) 移行計画にフックを追加して、移行前または移行後に仮想マシン上で自動化の操作を実行できます。
12.4.1. MTV 移行計画のフック リンクのコピーリンクがクリップボードにコピーされました!
MTV CLI または Red Hat OpenShift Web コンソールにある MTV ユーザーインターフェイスを使用して、Migration Toolkit for Virtualization (MTV) 移行計画にフックを追加できます。
- 移行前 フックは、プロバイダー上にある仮想マシンに対して操作を実行するフックです。これにより、仮想マシンの移行の準備が整います。
- 移行後 フックは、OpenShift Virtualization に移行した仮想マシン上で操作を実行するフックです。
12.4.1.1. デフォルトのフックイメージ リンクのコピーリンクがクリップボードにコピーされました!
MTV フックのデフォルトのフックイメージは、quay.io/konveyor/hook-runner です。このイメージは、Ansible Runner イメージをベースにしており、Ansible Kubernetes リソースと最新の oc バイナリーを提供するための python-openshift が追加されています。
12.4.1.2. フックの実行 リンクのコピーリンクがクリップボードにコピーされました!
移行フックの一部として提供される Ansible Playbook は、ConfigMap としてフックコンテナーにマウントされます。フックコンテナーは、選択した ServiceAccount を使用して、openshift-mtv namespace 内の目的のクラスター上でジョブとして実行されます。
フックを追加するときは、Hook CR が配置されている namespace、フックの名前、およびフックが移行前フックか移行後フックかを指定する必要があります。
フックを仮想マシンで実行するには、仮想マシンが起動し、SSH を使用して利用可能な状態である必要があります。
次の図は、移行フックを使用する一般的なプロセスを示しています。具体的な手順は、Red Hat OpenShift Web コンソールを使用した移行計画への移行フックの追加 および CLI を使用した移行計画への移行フックの追加 を参照してください。
図12.1 移行計画へのフックの追加
プロセス:
Ansible フックと認証情報を入力します。
UI または CLI を使用して、Ansible フックイメージを MTV コントローラーに入力します。
-
UI で、
ansible-runnerを指定し、フックを含むplaybook.ymlを入力します。 - CLI で、フックを実行する Playbook を指定するフックイメージを入力します。
-
UI で、
Pod 内で Playbook を実行するために SSH データなどの追加データが必要な場合は、仮想マシンの認証情報を含むシークレットを作成します。このシークレットは Pod にマウントされませんが、Playbook によって呼び出されます。
注記このシークレットは、ソースプロバイダーの認証情報を含む
SecretCR とは異なります。
MTV コントローラーは、次の内容を含む
ConfigMapを作成します。-
workload.yml、仮想マシンに関する情報を含む。 -
playbook.yml、実行する生の文字列 Playbook。 plan.yml、PlanCR。ConfigMapには仮想マシンの名前が含まれており、Playbook に何を実行するかを指示します。
-
MTV コントローラーは、ユーザーが指定したイメージを開始するジョブを作成します。
ConfigMapをコンテナーにマウントします。Ansible フックは、ユーザーが以前に入力したシークレットをインポートします。
ジョブは、次のように移行前フックまたは移行後フックを実行します。
- 移行前フックの場合、ジョブは SSH を使用してソースプロバイダー上の仮想マシンにログインし、フックを実行します。
- 移行後のフックの場合、ジョブは SSH を使用して OpenShift Virtualization 上の仮想マシンにログインし、フックを実行します。
12.4.2. Red Hat OpenShift Web コンソールを使用した移行計画への移行フックの追加 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、既存の移行計画に移行フックを追加できます。Migration Toolkit for Virtualization (MTV) CLI で 1 つのコマンドを実行する必要があることに注意してください。
たとえば、移行前に仮想マシンに cloud-init サービスをインストールし、ファイルを書き込むフックを作成できます。
移行計画ごとに、移行前フックを 1 つ、移行後フックを 1 つ、またはそれぞれを 1 つ実行できます。
前提条件
- 移行計画。
- 移行フックファイル。その内容をコピーして Web コンソールに貼り付けます。
-
ソースプロバイダーの
シークレットを含むファイル。 - フックによって呼び出され、作業している namespace に対して少なくとも書き込みアクセス権がある Red Hat OpenShift サービスアカウント。
- 仮想マシンにインストールされた公開鍵を使用して移行する仮想マシンへの SSH アクセス。
- Microsoft Server 上でのみ実行されている仮想マシン: リモート実行が有効化されている。
関連情報
サービスアカウントを作成する手順については、サービスアカウントの概要および作成 を参照してください。
手順
- Red Hat OpenShift Web コンソールで、Migration > Plans for virtualization をクリックし、フックを追加する移行計画をクリックします。
- Hooks をクリックします。
移行前のフックの場合は、以下の手順を実行します。
- Pre migration hook セクションで、Enable hook スイッチを Enable pre migration hook に切り替えます。
-
Hook ランナーイメージ を入力します。
spec.playbookを指定する場合は、ansible-runnerが含まれるイメージを使用する必要があります。 - Ansible Playbook テキストボックスにフックを YAML ファイルとして貼り付けます。
移行後のフックの場合は、以下の手順を実行します。
- Post migration hook で、Enable hook を Enable post migration hook に切り替えます。
-
Hook ランナーイメージ を入力します。
spec.playbookを指定する場合は、ansible-runnerが含まれるイメージを使用する必要があります。 - Ansible Playbook テキストボックスにフックを YAML ファイルとして貼り付けます。
- タブの上部にある Update hooks をクリックします。
ターミナルで以下のコマンドを実行し、各フックを Red Hat OpenShift サービスアカウントに関連付けます。
oc -n openshift-mtv patch hook <name_of_hook> \ -p '{"spec":{"serviceAccount":"<service_account>"}}' --type merge$ oc -n openshift-mtv patch hook <name_of_hook> \ -p '{"spec":{"serviceAccount":"<service_account>"}}' --type mergeCopy to Clipboard Copied! Toggle word wrap Toggle overflow
次の移行フックの例では、SSH を使用して仮想マシンにアクセスできることを確認し、SSH 鍵を作成し、Maria データベースの停止とテキストファイルの生成の 2 つのタスクを実行します。
移行フックの例
12.4.3. CLI を使用した移行計画への移行フックの追加 リンクのコピーリンクがクリップボードにコピーされました!
Hook CR を使用すると、Migration Toolkit for Virtualization (MTV) CLI を使用して、既存の移行計画に移行前フックまたは移行後フックを追加できます。
たとえば、移行前に仮想マシンに cloud-init サービスをインストールし、ファイルを書き込むための Hook CR を作成できます。
移行計画ごとに、移行前フックを 1 つ、移行後フックを 1 つ、またはそれぞれを 1 つ実行できます。各フックには独自の Hook CR が必要ですが、Plan CR には使用するすべてのフックのデータが含まれます。
k8s モジュールを使用して、シークレットまたは ConfigMap に保存されている追加情報を取得できます。
前提条件
- 移行計画。
- 移行フックイメージまたはフックイメージを含む Playbook。
- ソースプロバイダーのシークレットを含むファイル。
- フックによって呼び出され、作業している namespace に対して少なくとも書き込みアクセス権がある Red Hat OpenShift サービスアカウント。
- 仮想マシンにインストールされた公開鍵を使用して移行する仮想マシンへの SSH アクセス。
- Microsoft Server 上でのみ実行されている仮想マシン: リモート実行が有効化されている。
関連情報
サービスアカウントを作成する手順については、サービスアカウントの概要および作成 を参照してください。
手順
必要に応じて、仮想マシンの SSH 秘密鍵でシークレットを作成します。
- 既存のキーを選択するか、キーペアを生成します。
- 仮想マシンに公開鍵をインストールします。
シークレット内の秘密鍵を base64 でエンコードします。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
ファイルを連結し、Base64 エンコード用にパイプすることで、Playbook をエンコードします。次に例を示します。
cat playbook.yml | base64 -w0
$ cat playbook.yml | base64 -w0Copy to Clipboard Copied! Toggle word wrap Toggle overflow Hook CR を作成します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記デフォルトの
hook-runnerイメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。注記アタッチされた Playbook をデコードするには、カスタム出力でリソースを取得して base64 にパイプします。以下に例を示します。
oc get -n konveyor-forklift hook playbook -o \ go-template='{{ .spec.playbook }}' | base64 -d$ oc get -n konveyor-forklift hook playbook -o \ go-template='{{ .spec.playbook }}' | base64 -dCopy to Clipboard Copied! Toggle word wrap Toggle overflow 移行の
PlanCR で、仮想マシンごとに、CR の末尾に次のセクションを追加します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- オプションは、移行前にフックを実行する
PreHookと、移行後にフックを実行するPostHookです。
PreHook を仮想マシンで実行するには、仮想マシンを起動し、SSH 経由で利用できるようにする必要があります。
次の移行フックの例では、SSH を使用して仮想マシンにアクセスできることを確認し、SSH 鍵を作成し、Maria データベースの停止とテキストファイルの生成の 2 つのタスクを実行します。
移行フックの例
第13章 Migration Toolkit for Virtualization のアップグレード リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、新しいバージョンをインストールすると、MTV Operator をアップグレードできます。
手順
- Red Hat OpenShift Web コンソールで、Operators → Installed Operators → Migration Toolkit for Virtualization Operator → Subscription をクリックします。
更新チャンネルを正しいリリースに変更します。
Red Hat OpenShift ドキュメントの 更新チャネルの変更 を参照してください。
Upgrade status が Up to date から Upgrade available に変わります。そうでない場合は、
CatalogSourcePod を再起動します。-
カタログソース (例:
redhat-operators) に注意してください。 コマンドラインで、カタログソース Pod を取得します。
oc get pod -n openshift-marketplace | grep <catalog_source>
$ oc get pod -n openshift-marketplace | grep <catalog_source>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Pod を削除します。
oc delete pod -n openshift-marketplace <catalog_source_pod>
$ oc delete pod -n openshift-marketplace <catalog_source_pod>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Upgrade status が Up to date から Upgrade available に変わります。
Subscriptions タブで Update approval を Automatic に設定すると、アップグレードが自動的に開始されます。
-
カタログソース (例:
Subscriptions タブで Update approval を Manual に設定すると、アップグレードが承認されます。
Red Hat OpenShift ドキュメントの 保留中のアップグレードの手動承認 を参照してください。
-
MTV 2.2 からアップグレードしており、VMware 移行元プロバイダーを定義している場合は、VDDK
initイメージを追加して、VMware プロバイダーを編集します。そうしないと、更新によって VMware プロバイダーの状態がCriticalに変更になります。詳細は、VMSphere 移行元プロバイダーの追加 を参照してください。 -
MTV 2.2 の Red Hat OpenShift 移行先プロバイダーで NFS にマッピングした場合は、NFS ストレージプロファイルで
AccessModesおよびVolumeModeパラメーターを編集します。そうしないと、アップグレードによって NFS マッピングが無効になります。詳細は、ストレージプロファイルのカスタマイズ を参照してください。
第14章 Migration Toolkit for Virtualization のアンインストール リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールまたはコマンドラインインターフェイス (CLI) を使用して、Migration Toolkit for Virtualization (MTV) をアンインストールできます。
14.1. Red Hat OpenShift Web コンソールを使用した MTV のアンインストール リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールを使用して、Migration Toolkit for Virtualization (MTV) をアンインストールできます。
前提条件
-
cluster-admin権限を持つユーザーとしてログインしている。
手順
- Red Hat OpenShift Web コンソールで、Operators > Installed Operators をクリックします。
Migration Toolkit for Virtualization Operator をクリックします。
Operator details ページで、Details タブが開きます。
- ForkliftController タブをクリックします。
Actions をクリックし、Delete ForkLiftController を選択します。
確認ウィンドウが開きます。
Delete をクリックします。
コントローラーが削除されます。
Details タブを開きます。
削除したコントローラーの代わりに Create ForkliftController ボタンが表示されます。クリックする必要はありません。
ページの右上にある Actions をクリックし、Uninstall Operator を選択します。
確認ウィンドウが開き、オペランドインスタンスが表示されます。
すべてのインスタンスを削除するには、Delete all operand instances for this operator チェックボックスをオンにします。デフォルトでは、チェックボックスはオフになっています。
重要Operator がクラスター外のリソースを設定した場合、これらは引き続き実行されるため、手動でクリーンアップする必要があります。
Uninstall をクリックします。
Installed Operators ページが開き、Installed Operators のリストから Migration Toolkit for Virtualization Operator が削除されます。
- Home > Overview をクリックします。
ページの Status セクションで、Dynamic Plugins をクリックします。
Dynamic Plugins ポップアップが開き、失敗したプラグインとして forklift-console-plugin がリストされます。forklift-console-plugin が失敗したプラグインとして表示されない場合は、Web コンソールを更新します。
forklift-console-plugin をクリックします。
ConsolePlugin details ページが Details タブで開きます。
ページの右上にある Actions をクリックし、リストから Delete ConsolePlugin を選択します。
確認ウィンドウが開きます。
Delete をクリックします。
このプラグインは、Overview ページの Dynamic plugins のリストから削除されます。プラグインがまだ表示される場合は、Overview ページを再起動します。
14.2. コマンドラインから MTV のアンインストール リンクのコピーリンクがクリップボードにコピーされました!
コマンドラインから Migration Toolkit for Virtualization (MTV) をアンインストールできます。
このアクションは、カスタムリソース定義 (CRD) およびカスタムリソース (CR) など、MTV Operator が管理するリソースは削除されません。MTV Operator をアンインストールした後にこれらを削除するには、MTV Operator CRD を手動で削除する必要がある場合があります。
前提条件
-
cluster-admin権限を持つユーザーとしてログインしている。
手順
以下のコマンドを実行して
forkliftコントローラーを削除します。oc delete ForkliftController --all -n openshift-mtv
$ oc delete ForkliftController --all -n openshift-mtvCopy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行して MTV Operator へのサブスクリプションを削除します。
oc get subscription -o name|grep 'mtv-operator'| xargs oc delete
$ oc get subscription -o name|grep 'mtv-operator'| xargs oc deleteCopy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行して MTV Operator の
clusterserviceversionを削除します。oc get clusterserviceversion -o name|grep 'mtv-operator'| xargs oc delete
$ oc get clusterserviceversion -o name|grep 'mtv-operator'| xargs oc deleteCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、プラグインコンソール CR を削除します。
oc delete ConsolePlugin forklift-console-plugin
$ oc delete ConsolePlugin forklift-console-pluginCopy to Clipboard Copied! Toggle word wrap Toggle overflow オプション: 次のコマンドを実行して、カスタムリソース定義 (CRD) を削除します。
oc get crd -o name | grep 'forklift.konveyor.io' | xargs oc delete
oc get crd -o name | grep 'forklift.konveyor.io' | xargs oc deleteCopy to Clipboard Copied! Toggle word wrap Toggle overflow オプション: 次のコマンドを実行して MTV プロジェクトを削除し、クリーンアップを実行します。
oc delete project openshift-mtv
oc delete project openshift-mtvCopy to Clipboard Copied! Toggle word wrap Toggle overflow
第15章 MTV パフォーマンスに関する推奨事項 リンクのコピーリンクがクリップボードにコピーされました!
このセクションの目的は、テストで確認できた結果に基づいて、Migration Toolkit for Virtualization (MTV) を使用して仮想マシン (VM) を効率的かつ効果的に移行するための推奨事項を共有することです。
ここで提供されるデータは Red Hat Labs でのテストから収集されたもので、参考目的でのみ提供されています。
全体として、これらの数値は最良のシナリオを示すものと考えるべきです。
確認できた移行のパフォーマンスは、これらの結果と異なる場合があり、いくつかの要因に依存します。
15.1. 高速なストレージとネットワーク速度を確保する リンクのコピーリンクがクリップボードにコピーされました!
VMware 環境と Red Hat OpenShift (OCP) 環境の両方で、高速なストレージとネットワーク速度を確保します。
高速移行を実行するには、VMware がデータストアへの読み取りアクセスが高速でなければなりません。 VMware ESXi ホスト間のネットワークは高速で、10 GiB のネットワーク接続を確保し、ネットワークのボトルネックを回避する必要があります。
- VMware ネットワークを OCP Workers Interface ネットワーク環境に拡張します。
- 受信速度が ESXi データストアの読み取り速度と一致するように、VMware ネットワークが高スループット (10 ギガビットイーサネット) と高速ネットワークを提供することが重要です。
- 移行プロセスでは大量のネットワーク帯域幅が使用され、移行ネットワークが利用されることに注意してください。他のサービスがそのネットワークを利用する場合、それらのサービスとその移行率に影響を及ぼす可能性があります。
-
たとえば、OCP インターフェイスへのデータ転送に関連する各 ESXi ホストの
vmnicからの平均ネットワーク転送速度は 200 - 325 MiB/秒でした。
15.2. データストアの読み取りの高速化、および効率的でパフォーマンスの高い移行を確保する リンクのコピーリンクがクリップボードにコピーされました!
データストアの読み取り速度は合計転送時間に影響するため、ESXi データストアから ESXi ホストへの高速読み取りをできるようにすることが重要です。
数字での例: 単一の ESXi サーバーの vSphere エンドポイントと ESXi エンドポイントの両方の平均読み取り速度は 200 - 300 MiB/秒でした。複数の ESXi サーバーを使用すると、データストアの読み取り速度が向上します。
15.3. エンドポイントの種類 リンクのコピーリンクがクリップボードにコピーされました!
MTV 2.6 では、以下の vSphere プロバイダーオプションを使用できます。
- ESXi エンドポイント (ESXi からのインベントリーおよびディスク転送)、MTV 2.6 で導入
- vCenter Server エンドポイント。ESXi ホスト用のネットワークはありません (vCenter からのインベントリーおよびディスク転送)
- vCenter エンドポイント。ESXi ネットワークが利用できます (vCenter からのインベントリー、ESXi からのディスク転送)。
複数の ESXi ホストに登録されている多数の仮想マシンを転送する場合は、vCenter エンドポイントと ESXi ネットワークを使用することを推奨します。
vSphere 7.0 以降では、ESXi ホストは NBD トランスポートに使用するネットワークにラベルを付けることができます。 これは、目的の仮想ネットワークインターフェイスカード (NIC) に適切な vSphereBackupNFC ラベルをタグ付けすることによって実現されます。 これが完了すると、ワーカーと ESXi ホストインターフェイスにアクセスできる限り、MTV は ESXi インターフェイスを利用して Openshift へのネットワーク転送を行うことができます。 これは、移行ユーザーが ESXi 認証情報にアクセスできない可能性があるにもかかわらず、移行に使用する ESXi インターフェイスを制御する必要がある場合に特に便利です。
詳細は、(MTV-1230) を参照してください。
NBD バックアップ用にインターフェイス vmk2 を指定する次の ESXi コマンドを使用できます。
esxcli network ip interface tag add -t vSphereBackupNFC -i vmk2
esxcli network ip interface tag add -t vSphereBackupNFC -i vmk2
15.4. ESXi ホストの BIOS プロファイルと ESXi ホストの電源管理の高パフォーマンス設定 リンクのコピーリンクがクリップボードにコピーされました!
可能であれば、移行に使用されるホストが、パフォーマンスが最大の BIOS プロファイルに設定されていることを確認します。 vSphere 内で制御されるホスト電源管理を使用するホストでは、High Performance が設定されていることを確認する必要があります。
テストの結果、BIOS とホスト電源管理の両方を適切に設定した状態で 10 個を超える仮想マシンを転送すると、移行によって平均データストア読み取り速度が 15 MiB 増加することがわかりました。
15.5. VMware ネットワークへの追加のネットワーク負荷を回避する リンクのコピーリンクがクリップボードにコピーされました!
ESXi エンドポイントを使用するときに移行ネットワークを選択すると、VMware ネットワークのネットワーク負荷を軽減できます。
MTV は仮想化プロバイダーを組み込むことで、仮想マシンを OCP に移行する目的で、ESXi ホスト上でアクセス可能な特定のネットワークを選択できるようになります。 MTV UI の ESXi ホストからこの移行ネットワークを選択すると、選択したネットワークを ESXi エンドポイントとして使用して転送が実行されるようになります。
選択したネットワークが OCP インターフェイスに接続できること、移行に十分な帯域幅があること、およびネットワークインターフェイスが飽和していないことを確認することが不可欠です。
10GbE ネットワークなどの高速ネットワークを備えた環境では、データの移行時に発生するネットワークの負荷が、ESXi データストアの読み取り速度と同じくらいになると予想されます。
15.6. ESXi ホストあたりの最大同時ディスク移行を制御する リンクのコピーリンクがクリップボードにコピーされました!
MAX_VM_INFLIGHT MTV 変数を設定して、ESXi ホストで対応できる同時仮想マシン転送の最大数を制御します。
MTV では、この変数を使用して同時実行性を制御できます。デフォルトでは 20 に設定されています。
MAX_VM_INFLIGHT を設定するときは、ESXi ホストに必要な最大同時仮想マシン転送の数を考慮してください。 同時に転送する移行の種類を考慮することが重要です。ウォーム移行: スケジュールされた時間内に移行される実行中の仮想マシンの移行によって定義されます。
ウォーム移行では、スナップショットを使用して、ディスクの以前のスナップショット間の差異のみを比較して移行します。 スナップショット間の差異の移行は、実行中の仮想マシンから OpenShift への最終的な切り替えが行われる前に、特定の間隔で行われます。
MTV 2.6 では、特定のスナップショットの現在の移行アクティビティーや単一の仮想マシンに属するディスクの数に関係なく、MAX_VM_INFLIGHT は仮想マシンごとに 1 つの転送スロットを予約します。 MAX_VM_INFLIGHT によって設定された合計は、ESXi ホストごとに許可される同時仮想マシン転送の数を示すために使用されます。
例
-
MAX_VM_INFLIGHT = 20で、プロバイダーに 2 つの ESXi ホストが定義されている場合、各ホストは 20 台の仮想マシンを転送できます。
15.7. 複数の仮想マシンを同時に移行する場合の移行時間を短縮する リンクのコピーリンクがクリップボードにコピーされました!
特定の ESXi ホストから複数の仮想マシンを移行する場合、複数の仮想マシンの同時移行を開始すると、移行時間が短縮されます。
テストでは、1 台のホストから 10 個の仮想マシン (それぞれ 35 GiB のデータを含み、合計サイズは 50 GiB) を移行する方が、同じ数の仮想マシンを 1 つずつ順番に移行するよりも大幅に高速であることが実証されました。
単一のホストから 10 台を超える仮想マシンへの同時移行を増やすことは可能ですが、大幅な改善は見られません。
例
- 1 台のディスク仮想マシンは 6 分、移行速度は 100 MiB/秒でした
- 10 枚の単一ディスク仮想マシンは 22 分、移行速度は 272 MiB/s でした
- 20 台の単一ディスクの仮想マシンは 42 分、移行速度は 284 MiB/s でした。
前述の例から、10 台の仮想マシンを同時に移行すると、同一の仮想マシンを順番に移行するよりも 3 倍高速になることがわかります。
10 台または 20 台の仮想マシンを同時に移行する場合の移行率はほぼ同じでした。
15.8. 複数のホストを使用する場合の移行時間を短縮する リンクのコピーリンクがクリップボードにコピーされました!
移行に使用する ESXi ホスト間で均等に分散された登録済み仮想マシンが含まれるホストを複数使用すると、移行時間が短縮されます。
テストの結果、合計 50 G のデータのうちそれぞれ 35 GiB を含む 10 個以上の単一ディスク仮想マシンを転送する場合、追加のホストを使用すると移行時間を短縮できることが示されました。
例
- 1 台のホストを使用して、それぞれ 35 GiB のデータを含む 80 台の単一ディスク仮想マシンを移行するのに 2 時間 43 分、移行速度は 294 MiB/秒でした。
- 8 台の ESXi ホストを使用して、それぞれ 35 GiB のデータを含む 80 個の単一ディスク仮想マシンを移行するのに 41 分、移行速度は 1,173 MiB/秒でした。
前述の例から、8 台の ESXi ホストから 80 個の仮想マシン (各ホストから 10 個ずつ) を同時に移行すると、単一の ESXi ホストから同じ仮想マシンを実行するよりも 4 倍高速になることがわかります。
8 台を超える ESXi ホストから多数の仮想マシンを同時に移行すると、パフォーマンスが向上する可能性があります。ただし、テストされていないため、推奨されません。
15.9. 単一の大規模な移行計画と比較した複数の移行計画 リンクのコピーリンクがクリップボードにコピーされました!
1 つの移行計画で参照できるディスクの最大数は 500 です。詳細は (MTV-1203) を参照してください。
単一の移行計画で多数の仮想マシンを移行しようとすると、すべての移行が開始されるまでに時間がかかることがあります。 1 つの移行計画を複数の移行計画に分割することで、移行を同時に開始することが可能になります。
移行の比較:
-
1 つのプランで 8 台の ESXi ホストを使用する 500 個の仮想マシンで、
max_vm_inflight=100を指定する場合、5 時間 10 分かかりました。 -
8 つのプランで 8 台の ESXi ホスト 8 台を使用する 800 個の仮想マシンで、
max_vm_inflight=100を指定する場合、57 分かかりました。
テストの結果、1 つの大規模なプランを複数の中規模のプラン (例: プランごとに 100 台の仮想マシン) に分割すると、移行の合計時間を短縮できることが示されました。
15.10. コールド移行でテストされた最大値 リンクのコピーリンクがクリップボードにコピーされました!
- テスト済みの ESXi ホストの最大数: 8
- 1 つの移行プラン内の仮想マシンの最大数: 500
- 1 回のテストで移行した仮想マシンの最大数: 5000
- 同時に実行した移行プランの最大数: 40
- 移行した最大ディスクサイズ: 6 T ディスク (3 Tb のデータを含む)
- 移行した単一の仮想マシン上のディスクの最大数: 50
- 単一の ESXi サーバーでの単一のデータストアの最高読み取り速度: 312 MiB/秒
- 8 台の ESXi サーバーと 2 つのデータストアを使用した場合の最高マルチデータストア読み取り速度: 1,242 MiB/秒
- OpenShift ワーカーへの仮想 NIC 転送速度の最高値: 327 MiB/秒
- 単一ディスクの最大移行転送速度: 162 MiB/秒 (1.5 Tb の使用データの非同時移行を転送するときに確認できた速度)
- 単一の ESXi ホストからの複数の仮想マシン (単一ディスク) の最大コールド移行転送速度: 294 MiB/秒 (単一の ESXi から 30 台の仮想マシンを同時に移行、35/50 GiB 使用)
- 複数の ESXi ホストからの複数の仮想マシン (単一ディスク) の最大コールド移行転送速度: 1173 MB/秒 (8 台の ESXi サーバーから 80 台の仮想マシンを同時に移行、35/50 GiB 使用、各 ESXi から 10 台の仮想マシン)
15.11. ウォーム移行の推奨事項 リンクのコピーリンクがクリップボードにコピーされました!
以下の推奨事項はウォーム移行に特有のものです。
15.11.1. 最大 400 ディスクを並行して移行する リンクのコピーリンクがクリップボードにコピーされました!
テストでは、8 台の ESXi ホストを使用してそれぞれ 2 つのディスクを持つ 200 台の仮想マシンを並行して移行し、合計 400 台のディスクを使用しました。400 台を超えるディスクを並行して移行する移行計画はテストが実行されていないため、この数のディスクを並行して移行することは推奨されません。
15.11.2. 最大 200 台のディスクを並行して移行し、最速の速度を実現する リンクのコピーリンクがクリップボードにコピーされました!
200、300、400 台のディスクを使用した並列ディスク移行のテストが正常に実行されました。200 台のディスクを移行するテストと 300 台および 400 台のディスクを移行するテストでは、プレコピー移行率が約 25% 減少しました。
したがって、プレコピーの速度が 25% 低下してもカットオーバー計画に影響がない限り、300 - 400 個のディスクではなく、200 個以下のディスクのグループで並列ディスク移行を実行することを推奨します。
15.11.3. 移行計画の開始直後にカットオーバー時間を設定する (可能な場合) リンクのコピーリンクがクリップボードにコピーされました!
ウォーム移行にかかる時間を短縮するには、移行計画の開始直後にカットオーバーが発生するように設定することを推奨します。これにより、MTV は仮想マシンごとに 1 つのプレコピーのみ を実行します。この推奨事項は、移行計画に含まれる仮想マシンの数に関係なく有効です。
15.11.4. スナップショット間のプレコピー間隔を増やす リンクのコピーリンクがクリップボードにコピーされました!
単一の仮想マシンで多数の移行計画を作成し、移行の開始とカットオーバーの間に十分な時間がある場合は、controller_precopy_interval パラメーターの値を 120 分から 240 分の範囲に増やします。設定を長くすると、カットオーバー前の仮想マシンあたりのスナップショットとディスク転送の合計数が減ります。
15.12. ウォーム移行でテストされた最大値 リンクのコピーリンクがクリップボードにコピーされました!
- テスト済みの ESXi ホストの最大数: 8
- ワーカーノードの最大数: 12
- 1 つの移行プラン内の仮想マシンの最大数: 200
- 並列ディスク転送の最大数: 400、仮想マシン 200 台、ESXi 6 台、転送速度 667 MB/秒
- 移行される単一の仮想マシン上のディスクの最大数: 3
- ESXi ホストあたりの並列ディスク転送の最大数: 68
- 同時移行のない単一ディスクの最大転送速度: 76.5 MB/秒
- 単一の ESXi ホストから複数のディスクで確認された最大転送速度: 253 MB/秒 (10 台の仮想マシン、各ディスク 1 台、ディスクあたり 35/50 GiB 使用)
- 8 台の ESXi ホストからの複数のディスク (210) で確認された合計転送速度: 802 MB/秒 (70 台の仮想マシン、各 3 台のディスクの同時移行、ディスクあたり 35/50 GiB 使用)
15.13. NBD トランスポートモードの非同期 I/O(AIO) サイズとバッファー数の増加 リンクのコピーリンクがクリップボードにコピーされました!
このドキュメントでは、Migration Toolkit for Virtualization (MTV) 製品を使用する際に、移行パフォーマンスを向上させるために NBD トランスポート NFC パラメーターを変更する方法を説明します。
AIO バッファーリングの使用は、コールド移行のユースケースにのみ適しています。
- ウォーム移行を初期化する前に、AIO 設定を無効にします。詳細は、AIO バッファー設定の無効化 を参照してください。
15.13.1. 主な調査結果 リンクのコピーリンクがクリップボードにコピーされました!
以下の値が指定された ESXi ホスト 1 台で複数の仮想マシン (10) を使用して移行すると、最適な移行のパフォーマンスが得られました。
-
VixDiskLib.nfcAio.Session.BufSizeIn64KB=16 -
vixDiskLib.nfcAio.Session.BufCount=4
-
AIO バッファー (非同期バッファーカウント) 設定を使用すると、次の改善が見られました。
-
移行時間は
0:24:32から0:16:54になり、31.1% 短縮されました。 -
読み取り速度は
347.83 MB/秒から504.93 MB/秒に向上しました。
-
移行時間は
- 単一の仮想マシンで AIO バッファー設定を使用した場合、大きな改善は見られませんでした。
- 複数のホストからの複数の仮想マシンで AIO バッファー設定を使用した場合、大きな改善は見られませんでした。
15.13.2. AIO バッファー設定の有効化 リンクのコピーリンクがクリップボードにコピーされました!
AIO 値に対するコントローラー Pod のサポートを検証する
openshift-mtvnamespace のforklift-controllerPod が AIO バッファー値をサポートしていることを確認します。Pod 名の接頭辞は動的であるため、まず次のコマンドを実行して Pod 名を確認します。
oc get pods -n openshift-mtv | grep forklift-controller | awk '{print $1}'oc get pods -n openshift-mtv | grep forklift-controller | awk '{print $1}'Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例は次のとおりです。
forklift-controller-667f57c8f8-qllnx
forklift-controller-667f57c8f8-qllnxCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記これは、
forklift-controller-667f57c8f8-qllnxなどの Pod 名の接頭辞です。以下を実行して Pod の環境変数を確認します。
oc get pod forklift-controller-667f57c8f8-qllnx -n openshift-mtv -o yaml
oc get pod forklift-controller-667f57c8f8-qllnx -n openshift-mtv -o yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力で次の行を確認します。
... \- name: VIRT\_V2V\_EXTRA\_ARGS \- name: VIRT\_V2V\_EXTRA\_CONF\_CONFIG\_MAP ...
... \- name: VIRT\_V2V\_EXTRA\_ARGS \- name: VIRT\_V2V\_EXTRA\_CONF\_CONFIG\_MAP ...Copy to Clipboard Copied! Toggle word wrap Toggle overflow
ForkliftController 設定の編集
openshift-mtvnamespace で、次のコマンドを実行してForkliftControllerオブジェクトを編集し、AIO バッファー値を含めます。oc edit forkliftcontroller -n openshift-mtv
oc edit forkliftcontroller -n openshift-mtvCopy to Clipboard Copied! Toggle word wrap Toggle overflow spec セクションに以下を追加します。
virt_v2v_extra_args: "--vddk-config /mnt/extra-v2v-conf/input.conf" virt_v2v_extra_conf_config_map: "perf"
virt_v2v_extra_args: "--vddk-config /mnt/extra-v2v-conf/input.conf" virt_v2v_extra_conf_config_map: "perf"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
perf という名前の ConfigMap の作成
次のコマンドを使用して必要な ConfigMap を作成します。
oc -n openshift-mtv create cm perf
oc -n openshift-mtv create cm perfCopy to Clipboard Copied! Toggle word wrap Toggle overflow
ConfigMap コンテンツの準備
目的のバッファー設定値を Base64 に変換します。たとえば、16/4 の場合:
echo -e "VixDiskLib.nfcAio.Session.BufSizeIn64KB=16\nvixDiskLib.nfcAio.Session.BufCount=4" | base64
echo -e "VixDiskLib.nfcAio.Session.BufSizeIn64KB=16\nvixDiskLib.nfcAio.Session.BufCount=4" | base64Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力は次のようになります。
Vml4RGlza0xpYi5uZmNBaW8uU2Vzc2lvbi5CdWZTaXplSW42NEtCPTE2CnZpeERpc2tMaWIubmZjQWlvLlNlc3Npb24uQnVmQ291bnQ9NAo=
Vml4RGlza0xpYi5uZmNBaW8uU2Vzc2lvbi5CdWZTaXplSW42NEtCPTE2CnZpeERpc2tMaWIubmZjQWlvLlNlc3Npb24uQnVmQ291bnQ9NAo=Copy to Clipboard Copied! Toggle word wrap Toggle overflow
ConfigMap の編集
以下のように、perf ConfigMap を
binaryDataセクションの Base64 文字列で更新します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Forklift Controller Pod の再起動
- 新しい設定を適用するには、forklift-controller Pod を再起動します。
-
VIRT_V2V_EXTRA_ARGS環境変数が更新された設定を反映していることを確認します。
移行ログの確認
移行計画を実行し、移行 Pod のログを確認します。AIO バッファー設定、特に
--vddk-config 値がパラメーターとして渡されていることを確認します。以下に例を示します。
exec: /usr/bin/virt-v2v … --vddk-config /mnt/extra-v2v-conf/input.conf
exec: /usr/bin/virt-v2v … --vddk-config /mnt/extra-v2v-conf/input.confCopy to Clipboard Copied! Toggle word wrap Toggle overflow サンプルログの抜粋:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記上記のログは
debug_level = 4を使用した場合のものです
ConfigMap の値のコンテンツが移行 Pod に含まれていることの確認
移行 Pod にログインし、次のコマンドを使用してバッファー設定を確認します。
cat /mnt/extra-v2v-conf/input.conf
cat /mnt/extra-v2v-conf/input.confCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例は次のとおりです。
VixDiskLib.nfcAio.Session.BufSizeIn64KB=16 vixDiskLib.nfcAio.Session.BufCount=4
VixDiskLib.nfcAio.Session.BufSizeIn64KB=16 vixDiskLib.nfcAio.Session.BufCount=4Copy to Clipboard Copied! Toggle word wrap Toggle overflow
デバッグの有効化 (オプション)
デバッグログを有効にするには、高ログレベルを含む設定を Base64 に変換します。
echo -e "`VixDiskLib.nfcAio.Session.BufSizeIn64KB=16\nVixDiskLib.nfcAio.Session.BufCount=4\nVixDiskLib.nfc.LogLevel=4`" | base64
echo -e "`VixDiskLib.nfcAio.Session.BufSizeIn64KB=16\nVixDiskLib.nfcAio.Session.BufCount=4\nVixDiskLib.nfc.LogLevel=4`" | base64Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記高いログレベルを追加するとパフォーマンスが低下しますが、これはデバッグ目的のみに使用されます。
15.13.3. AIO バッファー設定の無効化 リンクのコピーリンクがクリップボードにコピーされました!
AIO バッファー設定を無効にするには、次の手順を実行します。
ForkliftController オブジェクトを編集します。ForkliftController オブジェクトの spec セクションから以前に追加した行を削除します。
oc edit forkliftcontroller -n openshift-mtv
oc edit forkliftcontroller -n openshift-mtvCopy to Clipboard Copied! Toggle word wrap Toggle overflow 以下の行を削除します。
virt_v2v_extra_args: "`–vddk-config /mnt/extra-v2v-conf/input.conf`" virt_v2v_extra_conf_config_map: "`perf`"
virt_v2v_extra_args: "`–vddk-config /mnt/extra-v2v-conf/input.conf`" virt_v2v_extra_conf_config_map: "`perf`"Copy to Clipboard Copied! Toggle word wrap Toggle overflow ConfigMap を削除します。以前に作成した perf ConfigMap を削除します。
oc delete cm perf -n openshift-mtv
oc delete cm perf -n openshift-mtvCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Forklift Controller Pod を再起動します (オプション)。
必要に応じて、forklift-controller Pod を再起動して変更が有効になっていることを確認します。
15.13.4. AIO バッファー (非同期バッファーカウント) サポートの主な要件 リンクのコピーリンクがクリップボードにコピーされました!
VDDK および vSphere のバージョン
サポートは、次のバージョンを使用して実行されたテストに基づいています。
- vSphere : 7.0.3
- VDDK : 7.0.3
- その他の VDDK および vSphere バージョンは、公式 VMware ドキュメント の AIO バッファーサポートを確認してください。
第16章 トラブルシューティング リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、一般的な移行の問題をトラブルシューティングするための情報を提供します。
16.1. エラーメッセージ リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、エラーメッセージと、その解決方法を説明します。
warm import retry limit reached
VMware 仮想マシン (VM) が、プレコピーの段階で変更ブロックのトラッキング (CBT) スナップショットの最大数 (28) に達した場合は、ウォーム移行時に warm import retry limit reached エラーメッセージが表示されます。
この問題を解決するには、仮想マシンから CBT スナップショットの一部を削除して、移行計画を再起動します。
Unable to resize disk image to required size
ターゲットプロバイダーの仮想マシンがブロックストレージの EXT4 ファイルシステムで永続ボリュームを使用しているために移行が失敗すると、Unable to resize disk image to required size エラーメッセージが表示されます。この問題は、CDI が想定するデフォルトのオーバーヘッドに root パーティション用に予約された場所が完全に含まれていないために発生します。
この問題を解決するには、CDI のファイルシステムのオーバーヘッドを 10% 以上に増やします。
16.2. must-gather ツールの使用 リンクのコピーリンクがクリップボードにコピーされました!
must-gather ツールを使用して、MTV カスタムリソース (CR) のログおよび情報を収集できます。must-gather データファイルをすべてのカスタマーケースに割り当てる必要があります。
フィルタリングオプションを使用して、特定の namespace、移行計画、または仮想マシンのデータを収集できます。
フィルターされた must-gather コマンドで存在しないリソースを指定すると、アーカイブファイルは作成されません。
前提条件
-
cluster-adminロールを持つユーザーとして OpenShift Virtualization クラスターにログインしている。 -
Red Hat OpenShift CLI (
oc) がインストールされている。
ログおよび CR 情報の収集
-
must-gatherデータを保存するディレクトリーに移動します。 oc adm must-gatherコマンドを実行します。oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12
$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12Copy to Clipboard Copied! Toggle word wrap Toggle overflow データは
/must-gather/must-gather.tar.gzとして保存されます。このファイルを Red Hat カスタマーポータル で作成したサポートケースにアップロードできます。オプション:
oc adm must-gatherコマンドに以下のオプションを指定して実行し、フィルターされたデータを収集します。Namespace:
oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- NS=<namespace> /usr/bin/targeted
$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- NS=<namespace> /usr/bin/targetedCopy to Clipboard Copied! Toggle word wrap Toggle overflow 移行計画:
oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- PLAN=<migration_plan> /usr/bin/targeted
$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- PLAN=<migration_plan> /usr/bin/targetedCopy to Clipboard Copied! Toggle word wrap Toggle overflow 仮想マシン:
oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- VM=<vm_id> NS=<namespace> /usr/bin/targeted
$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- VM=<vm_id> NS=<namespace> /usr/bin/targeted1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
PlanCR に表示される仮想マシンの ID を指定します。
16.3. アーキテクチャー リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、MTV カスタムリソース、サービス、およびワークフローを説明します。
16.3.1. MTV カスタムリソースおよびサービス リンクのコピーリンクがクリップボードにコピーされました!
Migration Toolkit for Virtualization (MTV) は、Red Hat OpenShift Operator として提供されます。以下のカスタムリソース (CR) およびサービスを作成し、管理します。
MTV カスタムリソース
-
ProviderCR は、MTV がソースおよびターゲットプロバイダーに接続し、対話できるようにする属性を保存します。 -
NetworkMappingCR は、ソースおよびターゲットプロバイダーのネットワークをマッピングします。 -
StorageMappingCR は、ソースおよびターゲットプロバイダーのストレージをマッピングします。 -
PlanCR には、同じ移行パラメーターと関連するネットワークおよびストレージマッピングを持つ仮想マシンのリストが含まれます。 MigrationCR は移行計画を実行します。一度に実行できる
MigrationCR は、移行計画ごとに 1 つのみです。単一のPlanCR に複数のMigrationCR を作成できます。
MTV サービス
Inventoryサービスは以下のアクションを実行します。- 移行元プロバイダーおよびターゲットプロバイダーに接続します。
- マッピングおよび計画に関するローカルインベントリーを維持します。
- 仮想マシンの設定を保存します。
-
仮想マシンの設定の変更が検出されたら、
Validationサービスを実行します。
-
Validationサービスは、ルールを適用して移行の適合性を確認します。 Migration Controllerサービスは移行のオーケストレーションを行います。移行計画の作成時に、
Migration Controllerサービスは計画を検証し、ステータスラベルを追加します。計画の検証に失敗した場合には、計画のステータスはNot readyとなり、その計画を使用して移行を行うことができません。計画が検証をパスすると、計画のステータスはReadyとなり、移行を実行するために使用できます。移行に成功すると、Migration Controllerサービスは計画のステータスをCompletedに変更します。-
Populator Controllerサービスは、Volume Populator を使用して、ディスク転送を調整します。 -
Kubevirt ControllerおよびContainerized Data Import (CDI) Controllerサービスは、ほとんどの技術操作を処理します。
16.3.2. 移行ワークフローの概要 リンクのコピーリンクがクリップボードにコピーされました!
ワークフローの概要では、ユーザーの観点から移行プロセスを示しています。
- 移行元プロバイダー、ターゲットプロバイダー、ネットワークマッピング、およびストレージマッピングを作成します。
以下のリソースを含む
Planカスタムリソース (CR) を作成します。- 移行元プロバイダー
- ターゲットプロバイダー (MTV がターゲットクラスターにインストールされていない場合)
- ネットワークマッピング
- ストレージマッピング
- 1 つ以上の仮想マシン (VM)
PlanCR を参照するMigrationCR を作成して移行計画を実行します。何らかの理由ですべての仮想マシン移行できない場合は、すべての仮想マシンが移行されるまで、同じ
PlanCR に対して複数のMigrationCR を作成できます。-
PlanCR の仮想マシンごとに、Migration Controllerサービスは仮想マシン移行の進行状況をMigrationCR に記録します。 PlanCR 内の各仮想マシンのデータ転送が完了すると、Migration ControllerサービスによってVirtualMachineCR が作成されます。すべての仮想マシンが移行されると、
Migration ControllerサービスはPlanCR のステータスをCompletedに更新します。各ソース仮想マシンの電源状態は、移行後も維持されます。
16.3.3. 移行ワークフローの詳細 リンクのコピーリンクがクリップボードにコピーされました!
詳細な移行ワークフローを使用して、失敗した移行のトラブルシューティングを行うことができます。
ワークフローでは、以下の手順を説明します。
ウォームマイグレーションまたはリモート OpenShift クラスターへの移行:
Migrationカスタムリソース (CR) を作成して、移行計画を実行すると、Migration Controllerサービスはソース仮想マシンディスクごとにDataVolumeCR を作成します。各仮想マシンディスクで以下を実行します。
-
Containerized Data Importer (CDI) Controllerサービスは、DataVolumeCR で指定されるパラメーターに基づいて永続ボリューム要求 (PVC) を作成します。 -
StorageClassに動的プロビジョナーがある場合、永続ボリューム (PV) はStorageClassプロビジョナーによって動的にプロビジョニングされます。 -
CDI ControllerサービスはImporterPod を作成します。 ImporterPod は仮想マシンディスクを PV にストリーミングします。仮想マシンディスクの転送後に、以下を実行します。
Migration Controllerサービスは、VMWare からのインポート時に、PVC が接続されたconversionPod を作成します。conversionPod はvirt-v2vを実行して、ターゲット仮想マシンの PVC にデバイスドライバーをインストールし、設定します。-
Migration Controllerサービスは、PVC に接続されたソース仮想マシン (VM) ごとにVirtualMachineCR を作成します。 仮想マシンがソース環境で実行されている場合は、
Migration Controllerが仮想マシンの電源を入れ、KubeVirt Controllerサービスがvirt-launcherPod とVirtualMachineInstanceCR を作成します。virt-launcherPod は、仮想マシンディスクとして割り当てられた PVC でQEMU-KVMを実行します。
RHV または OpenStack からローカル OpenShift クラスターへのコールド移行:
Migrationカスタムリソース (CR) を作成して、移行計画を実行すると、Migration Controllerサービスはソース仮想マシンディスクごとにPersistentVolumeClaimCR を作成し、ソースが RHV の場合はOvirtVolumePopulatorを作成し、ソースが OpenStack の場合はOpenstackVolumePopulatorCR を作成します。各仮想マシンディスクで以下を実行します。
-
Populator Controllerサービスは一時的な永続ボリューム要求 (PVC) を作成します。 StorageClassに動的プロビジョナーがある場合、永続ボリューム (PV) はStorageClassプロビジョナーによって動的にプロビジョニングされます。-
Migration Controllerサービスは、ダミー Pod を作成して、すべての PVC をバインドします。Pod の名前にはpvcinitが含まれます。
-
-
Populator Controllerサービスは、populatorPod を作成します。 populatorPod は、ディスクデータを PV に転送します。仮想マシンディスクの転送後に、以下を実行します。
- 一時的な PVC は削除され、最初の PVC はデータを含む PV を指します。
-
Migration Controllerサービスは、PVC に接続されたソース仮想マシン (VM) ごとにVirtualMachineCR を作成します。 仮想マシンがソース環境で実行されている場合は、
Migration Controllerが仮想マシンの電源を入れ、KubeVirt Controllerサービスがvirt-launcherPod とVirtualMachineInstanceCR を作成します。virt-launcherPod は、仮想マシンディスクとして割り当てられた PVC でQEMU-KVMを実行します。
VMWare からローカル OpenShift クラスターへのコールドマイグレーション:
Migrationカスタムリソース (CR) を作成して、移行計画を実行すると、Migration Controllerサービスはソース仮想マシンディスクごとにDataVolumeCR を作成します。各仮想マシンディスクで以下を実行します。
-
Containerized Data Importer (CDI) Controllerサービスは、DataVolumeCR に指定されたパラメーターに基づいて、空の永続ボリューム要求 (PVC) を作成します。 -
StorageClassに動的プロビジョナーがある場合、永続ボリューム (PV) はStorageClassプロビジョナーによって動的にプロビジョニングされます。
すべての仮想マシンディスクの場合:
-
Migration Controllerサービスは、ダミー Pod を作成して、すべての PVC をバインドします。Pod の名前にはpvcinitが含まれます。 -
Migration Controllerサービスは、すべての PVC のconversionPod を作成します。 conversionPod はvirt-v2vを実行します。これにより、仮想マシンが KVM ハイパーバイザーに変換され、ディスクのデータが対応する PV に転送されます。仮想マシンディスクの転送後に、以下を実行します。
-
Migration Controllerサービスは、PVC に接続されたソース仮想マシン (VM) ごとにVirtualMachineCR を作成します。 仮想マシンがソース環境で実行されている場合は、
Migration Controllerが仮想マシンの電源を入れ、KubeVirt Controllerサービスがvirt-launcherPod とVirtualMachineInstanceCR を作成します。virt-launcherPod は、仮想マシンディスクとして割り当てられた PVC でQEMU-KVMを実行します。
16.3.4. MTV での virt-v2v ツールの使用方法 リンクのコピーリンクがクリップボードにコピーされました!
Migration Toolkit for Virtualization (MTV) は、virt-v2v ツールを使用して、仮想マシンのディスクイメージを OpenShift Virtualization と互換性のある形式に変換します。このツールは、変換された仮想マシンで準仮想化 VirtIO ドライバーを有効にし、可能な場合は QEMU ゲストエージェントをインストールするなど、仮想マシンが OpenShift Virtualization で動作するようにするために必要なタスクを自動的に実行するため、移行を容易にします。
virt-v2v は、Red Hat Enterprise Linux (RHEL) バージョン 7 以降に含まれています。
16.3.4.1. MTV 移行における virt-v2v の主な機能 リンクのコピーリンクがクリップボードにコピーされました!
移行時に、MTV は virt-v2v を使用して仮想マシンに関するメタデータを収集し、仮想マシンディスクに必要な変更を加え、仮想マシンを含むディスクを OpenShift Virtualization にコピーします。
virt-v2v は、VM ディスクに以下の変更を加えて、移行向けに準備します。
追加:
- VirtIO ドライバー (ネットワークやディスクドライバーなど) の注入。
- QEMU ゲストエージェントのインストールなど、ハイパーバイザー固有のツールまたはエージェントの準備。
- 更新されたブートローダーやブートエントリーなどのブート設定の変更。
削除:
- VMware ツールや VirtualBox の追加など、ハイパーバイザー固有の不要なファイルまたは以前のファイル。
- たとえば、VMware 固有の NIC ドライバーを削除するなど、古いネットワークドライバー設定。
- 古いブート設定など、ターゲットシステムと互換性のない設定。
VMware または OVA ファイルから移行する場合、virt-v2v は移行中または移行後の VM の初回の再起動時に IP アドレスも設定します。
MTV を使用して移行の前または後に、事前定義された Ansible フックを実行することもできます。詳細は、MTV 移行計画へのフックの追加 を参照してください。
これらのフックは virt-v2v を使用するとは限りません。
16.3.4.2. ファイルのカスタマイズ、削除、およびインストール リンクのコピーリンクがクリップボードにコピーされました!
MTV は、virt-v2v を使用して、以下のアクションなどの変換中に追加のゲストのカスタマイズを実行します。
- IP アドレスを保存するカスタマイズ
- ドライブ文字を保存するカスタマイズ
RHEL ベースのゲストの場合、virt-v2v は Red Hat レジストリーからゲストエージェントをインストールしようとします。移行がデタッチされた環境で実行される場合、インストーラーは失敗し、フックまたはその他の自動化を使用してゲストエージェントをインストールする必要があります。
詳細は、以下の man リファレンスページを参照してください。
16.3.4.3. パーミッションおよび virt-v2v リンクのコピーリンクがクリップボードにコピーされました!
virt-v2v は、実行中の仮想マシンに対して実行されず、VM のディスクに対してのみ実行されるため、virt-v2v は、ゲストオペレーティングシステム自体にパーミッションまたはアクセス認証情報を必要としません。
16.4. ログとカスタムリソース リンクのコピーリンクがクリップボードにコピーされました!
トラブルシューティングのためにログおよびカスタムリソース (CR) の情報をダウンロードできます。詳細は、詳細な移行ワークフロー を参照してください。
16.4.1. 収集されるログおよびカスタムリソース情報 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Web コンソールまたはコマンドラインインターフェイス (CLI) を使用すると、以下のターゲットのログとカスタムリソース (CR) yaml ファイルをダウンロードできます。
- 移行計画: Web コンソールまたは CLI。
- 仮想マシン: Web コンソールまたは CLI。
- namespace: CLI のみ。
must-gather ツールは、以下のログおよび CR ファイルをアーカイブファイルで収集します。
CR:
-
DataVolumeCR: 移行された仮想マシンにマウントされているディスクを表します。 -
VirtualMachineCR: 移行された仮想マシンを表します。 -
PlanCR: 仮想マシンおよびストレージおよびネットワークマッピングを定義します。 -
JobCR: オプション: 移行前のフック、移行後のフック、またはその両方を表します。
-
ログ:
-
importerPod: ディスクからデータへのボリューム変換ログ。importerPod の命名規則はimporter-<migration_plan>-<vm_id><5_char_id>です。たとえば、importer-mig-plan-ed90dfc6-9a17-4a8btnfhは、ed90dfc6-9a17-4a8が省略された RHV 仮想マシン ID、btnfhは生成された 5 文字の ID です。 -
conversionPod: 仮想マシンの変換ログ。conversionPod はvirt-v2vを実行します。これは、仮想マシンの PVC にデバイスドライバーをインストールし、設定します。conversionPod の命名規則は<migration_plan>-<vm_id><5_char_id>です。 -
virt-launcherPod: 仮想マシンランチャーログ。移行した仮想マシンの電源がオンになると、virt-launcherPod は仮想マシンディスクとして割り当てられた PVC でQEMU-KVMを実行します。 -
forklift-controllerPod: ログはmust-gatherコマンドで指定される移行計画、仮想マシン、または namespace に対してフィルター処理されます。 -
forklift-must-gather-apiPod: ログはmust-gatherコマンドで指定される移行計画、仮想マシン、または namespace に対してフィルター処理されます。 hook-jobPod: ログはフックジョブに対してフィルターされます。hook-jobの命名規則は、<migration_plan>-<vm_id><5_char_id>(例:plan2j-vm-3696-posthook-4mx85またはplan2j-vm-3696-prehook-mwqnl) です。注記空または除外されたログファイルは、
must-gatherアーカイブファイルには含まれません。
-
VMware 移行計画の must-gather アーカイブ構造の例
16.4.2. Web コンソールからのログおよびカスタムリソース情報のダウンロード リンクのコピーリンクがクリップボードにコピーされました!
完了、失敗、またはキャンセルされた移行計画、または移行された仮想マシン (VM) のカスタムリソース (CR) に関するログと情報を Red Hat OpenShift Web コンソールからダウンロードできます。
手順
- Red Hat OpenShift Web コンソールで、Migration → Plans for virtualization をクリックします。
- 移行計画名の横にある Get logs をクリックします。
Get logs ウィンドウで Get logs をクリックします。
ログが収集されます。
Log collection completeメッセージが表示されます。- Download logs をクリックしてアーカイブファイルをダウンロードします。
- 移行された仮想マシンのログをダウンロードするには、移行計画名をクリックして、仮想マシンの横にある Get logs をクリックします。
16.4.3. コマンドラインからのログとカスタムリソース情報へのアクセス リンクのコピーリンクがクリップボードにコピーされました!
must-gather ツールを使用して、コマンドラインからカスタムリソース (CR) に関するログと情報にアクセスできます。must-gather データファイルをすべてのカスタマーケースに割り当てる必要があります。
フィルターオプションを使用して、特定の namespace、完了、失敗、またはキャンセルされた移行計画、移行した仮想マシン (VM) のデータを収集できます。
フィルターされた must-gather コマンドで存在しないリソースを指定すると、アーカイブファイルは作成されません。
前提条件
-
cluster-adminロールを持つユーザーとして OpenShift Virtualization クラスターにログインしている。 -
Red Hat OpenShift CLI (
oc) がインストールされている。
手順
-
must-gatherデータを保存するディレクトリーに移動します。 oc adm must-gatherコマンドを実行します。oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12
$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12Copy to Clipboard Copied! Toggle word wrap Toggle overflow データは
/must-gather/must-gather.tar.gzとして保存されます。このファイルを Red Hat カスタマーポータル で作成したサポートケースにアップロードできます。オプション:
oc adm must-gatherコマンドに以下のオプションを指定して実行し、フィルターされたデータを収集します。Namespace:
oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- NS=<namespace> /usr/bin/targeted
$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- NS=<namespace> /usr/bin/targetedCopy to Clipboard Copied! Toggle word wrap Toggle overflow 移行計画:
oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- PLAN=<migration_plan> /usr/bin/targeted
$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- PLAN=<migration_plan> /usr/bin/targetedCopy to Clipboard Copied! Toggle word wrap Toggle overflow 仮想マシン:
oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- VM=<vm_name> NS=<namespace> /usr/bin/targeted
$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.7.12 \ -- VM=<vm_name> NS=<namespace> /usr/bin/targeted1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 仮想マシンの ID ではなく、
PlanCR に表示される仮想マシンの 名前 を指定する必要があります。
第17章 テレメトリー リンクのコピーリンクがクリップボードにコピーされました!
17.1. テレメトリー リンクのコピーリンクがクリップボードにコピーされました!
Red Hat はテレメトリーを使用して、Migration Toolkit for Virtualization (MTV) インストールから匿名の使用状況データを収集し、MTV の使いやすさと効率性の向上に役立てています。
MTV は以下のデータを収集します。
- 移行計画のステータス: 移行の数。失敗した移行、成功した移行、キャンセルされた移行が含まれます。
- プロバイダー: プロバイダーごとの移行数。Red Hat Virtualization、vSphere、OpenStack、OVA、OpenShift Virtualization プロバイダーが含まれます。
- モード: モード別の移行数。コールド移行とウォーム移行が含まれます。
- ターゲット: ターゲット別の移行数。ローカルおよびリモート移行が含まれます。
- プラン ID: 移行計画の ID 番号。番号は MTV によって割り当てられます。
メトリクスは 10 秒ごとに計算され、週ごと、月ごと、年ごとにレポートされます。
第18章 関連情報 リンクのコピーリンクがクリップボードにコピーされました!
18.1. MTV パフォーマンスアドオン リンクのコピーリンクがクリップボードにコピーされました!
ここで提供されるデータは Red Hat Labs でのテストから収集されたもので、参考目的でのみ提供されています。
全体として、これらの数値は最良のシナリオを示すものと考えるべきです。
確認できた移行のパフォーマンスは、これらの結果と異なる場合があり、いくつかの要因に依存します。
18.1.1. ESXi のパフォーマンス リンクのコピーリンクがクリップボードにコピーされました!
単一の ESXi パフォーマンス
同じ ESXi ホストを使用して移行をテストします。
反復するたびに、合計仮想マシンが増加し、同時移行が期間に与える影響が表示されます。
結果は、合計仮想マシン (50 GiB ディスク、使用率 70%) が増加すると、移行時間がディスク数や使用率に比例することを示しています。
ESXi あたりの仮想マシンの最適な数は 10 です。
| テストケースの説明 | MTV | VDDK | max_vm inflight | 移行タイプ | 合計所要時間 |
|---|---|---|---|---|---|
| コールド移行、10 台の仮想マシン、単一の ESXi、プライベートネットワーク [a] | 2.6 | 7.0.3 | 100 | コールド | 0:21:39 |
| コールド移行、20 台の仮想マシン、単一の ESXi、プライベートネットワーク | 2.6 | 7.0.3 | 100 | コールド | 0:41:16 |
| コールドマイグレーション、30 台の仮想マシン、単一の ESXi、プライベートネットワーク | 2.6 | 7.0.3 | 100 | コールド | 1:00:59 |
| コールドマイグレーション、40 台の仮想マシン、単一の ESXi、プライベートネットワーク | 2.6 | 7.0.3 | 100 | コールド | 1:23:02 |
| コールド移行、50 仮想マシン、単一の ESXi、プライベートネットワーク | 2.6 | 7.0.3 | 100 | コールド | 1:46:24 |
| コールドマイグレーション、80 台の仮想マシン、単一の ESXi、プライベートネットワーク | 2.6 | 7.0.3 | 100 | コールド | 2:42:49 |
| コールドマイグレーション、100 台の仮想マシン、単一の ESXi、プライベートネットワーク | 2.6 | 7.0.3 | 100 | コールド | 3:25:15 |
[a]
プライベートネットワークとは、管理ネットワーク以外のネットワークを指します。
| |||||
複数の ESXi ホストと単一のデータストア
反復するたびに ESXi ホストの数が増加し、ESXi ホストの数を増やすと移行時間が短縮されることが示されました (50 GiB ディスク、使用率 70%)。
| テストケースの説明 | MTV | VDDK | Max_vm inflight | 移行タイプ | 合計所要時間 |
|---|---|---|---|---|---|
| コールドマイグレーション、100 台の仮想マシン、単一の ESXi、プライベートネットワーク [a] | 2.6 | 7.0.3 | 100 | コールド | 3:25:15 |
| コールド移行、100 台の仮想マシン、4 台の ESX (ESX あたり 25 台の仮想マシン)、プライベートネットワーク | 2.6 | 7.0.3 | 100 | コールド | 1:22:27 |
| コールド移行、100 台の仮想マシン、5 台の ESX (ESX あたり 20 台の仮想マシン)、プライベートネットワーク、1 つのデータストア | 2.6 | 7.0.3 | 100 | コールド | 1:04:57 |
[a]
プライベートネットワークとは、管理ネットワーク以外のネットワークを指します。
| |||||
18.1.2. 異なる移行ネットワークパフォーマンス リンクのコピーリンクがクリップボードにコピーされました!
反復するたびに、移行ネットワーク は、移行に最も高速なネットワークが見つけるために プロバイダー を使用して変更されました。
その結果、すべてのインターフェイスとネットワーク速度が同じである場合、管理ネットワークを使用した場合と管理ネットワークを使用しない場合との間でパフォーマンスが低下しないことを示しています。
| テストケースの説明 | MTV | VDDK | max_vm inflight | 移行タイプ | 合計所要時間 |
|---|---|---|---|---|---|
| コールドマイグレーション、10 台の仮想マシン、単一の ESXi、MGMT ネットワーク | 2.6 | 7.0.3 | 100 | コールド | 0:21:30 |
| コールド移行、10 台の仮想マシン、単一の ESXi、プライベートネットワーク [a] | 2.6 | 7.0.3 | 20 | コールド | 0:21:20 |
| コールド移行、10 台の仮想マシン、単一の ESXi、デフォルトネットワーク | 2.6.2 | 7.0.3 | 20 | コールド | 0:21:30 |
[a]
プライベートネットワークとは、管理ネットワーク以外のネットワークを指します。
| |||||