Migration Toolkit for Virtualization のインストールおよび使用

手順

1. 一時ディレクトリーを作成し、これに移動します。

   $ mkdir /tmp/<dir_name> && cd /tmp/<dir_name>

2. ブラウザーで、VMware VDDK バージョン 8 ダウンロードページ に移動します。

3. バージョン 8.0.1 を選択し、Download をクリックします。

   注記

   OpenShift Virtualization 4.12 以前に移行するには、VDDK バージョン 7.0.3.2 を VMware VDDK バージョン 7 ダウンロードページ からダウンロードします。

4. VDDK アーカイブファイルを一時ディレクトリーに保存します。

5. VDDK アーカイブを展開します。

   $ tar -xzf VMware-vix-disklib-<version>.x86_64.tar.gz

6. Dockerfile を作成します。

   $ cat > Dockerfile <<EOF
   FROM registry.access.redhat.com/ubi8/ubi-minimal
   USER 1001
   COPY vmware-vix-disklib-distrib /vmware-vix-disklib-distrib
   RUN mkdir -p /opt
   ENTRYPOINT ["cp", "-r", "/vmware-vix-disklib-distrib", "/opt"]
   EOF

7. VDDK イメージをビルドします。

   $ podman build . -t <registry_route_or_server_path>/vddk:<tag>

8. VDDK イメージをレジストリーにプッシュします。

   $ podman push <registry_route_or_server_path>/vddk:<tag>

9. イメージが OpenShift Virtualization 環境からアクセスできることを確認します。

手順

1. root として ESXi ホストにログインします。

2. /etc/vmware/hostd/config.xml で maxMemory の値を 1000000000 に変更します。

   ...
         <nfcsvc>
            <path>libnfcsvc.so</path>
            <enabled>true</enabled>
            <maxMemory>1000000000</maxMemory>
            <maxStreamMemory>10485760</maxStreamMemory>
         </nfcsvc>
   ...

3. hostd を再起動します。

   # /etc/init.d/hostd restart

   ホストを再起動する必要はありません。

手順

1. Validation Pod のターミナルに接続します。

   $ oc rsh <validation_pod>

2. プロバイダーの OPA ポリシーディレクトリーに移動します。

   $ cd /usr/share/opa/policies/io/konveyor/forklift/<provider> 1

   1

   vmware または ovirt を指定します。

3. デフォルトポリシーを検索します。

   $ grep -R "default" *

手順

1. プロジェクトのルートを取得します。

   oc get route -n openshift-mtv

2. Inventory サービスルートを取得します。

   $ oc get route <inventory_service> -n openshift-mtv

3. アクセストークンを取得します。

   $ TOKEN=$(oc whoami -t)

4. HTTP GET リクエストをトリガーします (たとえば、Curl を使用):

   $ curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers -k

5. プロバイダーの UUID を取得します。

   $ curl -H "Authorization: Bearer $TOKEN"  https://<inventory_service_route>/providers/<provider> -k 1

   1

   プロバイダーに使用できる値は、vsphere、ovirt、および openstack です。

6. プロバイダーの VM を取得します。

   $ curl -H "Authorization: Bearer $TOKEN"  https://<inventory_service_route>/providers/<provider>/<UUID>/vms -k

7. VM の詳細を取得します。

   $ curl -H "Authorization: Bearer $TOKEN"  https://<inventory_service_route>/providers/<provider>/<UUID>/workloads/<vm> -k

   出力例

   {
       "input": {
           "selfLink": "providers/vsphere/c872d364-d62b-46f0-bd42-16799f40324e/workloads/vm-431",
           "id": "vm-431",
           "parent": {
               "kind": "Folder",
               "id": "group-v22"
           },
           "revision": 1,
           "name": "iscsi-target",
           "revisionValidated": 1,
           "isTemplate": false,
           "networks": [
               {
                   "kind": "Network",
                   "id": "network-31"
               },
               {
                   "kind": "Network",
                   "id": "network-33"
               }
           ],
           "disks": [
               {
                   "key": 2000,
                   "file": "[iSCSI_Datastore] iscsi-target/iscsi-target-000001.vmdk",
                   "datastore": {
                       "kind": "Datastore",
                       "id": "datastore-63"
                   },
                   "capacity": 17179869184,
                   "shared": false,
                   "rdm": false
               },
               {
                   "key": 2001,
                   "file": "[iSCSI_Datastore] iscsi-target/iscsi-target_1-000001.vmdk",
                   "datastore": {
                       "kind": "Datastore",
                       "id": "datastore-63"
                   },
                   "capacity": 10737418240,
                   "shared": false,
                   "rdm": false
               }
           ],
           "concerns": [],
           "policyVersion": 5,
           "uuid": "42256329-8c3a-2a82-54fd-01d845a8bf49",
           "firmware": "bios",
           "powerState": "poweredOn",
           "connectionState": "connected",
           "snapshot": {
               "kind": "VirtualMachineSnapshot",
               "id": "snapshot-3034"
           },
           "changeTrackingEnabled": false,
           "cpuAffinity": [
               0,
               2
           ],
           "cpuHotAddEnabled": true,
           "cpuHotRemoveEnabled": false,
           "memoryHotAddEnabled": false,
           "faultToleranceEnabled": false,
           "cpuCount": 2,
           "coresPerSocket": 1,
           "memoryMB": 2048,
           "guestName": "Red Hat Enterprise Linux 7 (64-bit)",
           "balloonedMemory": 0,
           "ipAddress": "10.19.2.96",
           "storageUsed": 30436770129,
           "numaNodeAffinity": [
               "0",
               "1"
           ],
           "devices": [
               {
                   "kind": "RealUSBController"
               }
           ],
           "host": {
               "id": "host-29",
               "parent": {
                   "kind": "Cluster",
                   "id": "domain-c26"
               },
               "revision": 1,
               "name": "IP address or host name of the vCenter host or RHV Engine host",
               "selfLink": "providers/vsphere/c872d364-d62b-46f0-bd42-16799f40324e/hosts/host-29",
               "status": "green",
               "inMaintenance": false,
               "managementServerIp": "10.19.2.96",
               "thumbprint": <thumbprint>,
               "timezone": "UTC",
               "cpuSockets": 2,
               "cpuCores": 16,
               "productName": "VMware ESXi",
               "productVersion": "6.5.0",
               "networking": {
                   "pNICs": [
                       {
                           "key": "key-vim.host.PhysicalNic-vmnic0",
                           "linkSpeed": 10000
                       },
                       {
                           "key": "key-vim.host.PhysicalNic-vmnic1",
                           "linkSpeed": 10000
                       },
                       {
                           "key": "key-vim.host.PhysicalNic-vmnic2",
                           "linkSpeed": 10000
                       },
                       {
                           "key": "key-vim.host.PhysicalNic-vmnic3",
                           "linkSpeed": 10000
                       }
                   ],
                   "vNICs": [
                       {
                           "key": "key-vim.host.VirtualNic-vmk2",
                           "portGroup": "VM_Migration",
                           "dPortGroup": "",
                           "ipAddress": "192.168.79.13",
                           "subnetMask": "255.255.255.0",
                           "mtu": 9000
                       },
                       {
                           "key": "key-vim.host.VirtualNic-vmk0",
                           "portGroup": "Management Network",
                           "dPortGroup": "",
                           "ipAddress": "10.19.2.13",
                           "subnetMask": "255.255.255.128",
                           "mtu": 1500
                       },
                       {
                           "key": "key-vim.host.VirtualNic-vmk1",
                           "portGroup": "Storage Network",
                           "dPortGroup": "",
                           "ipAddress": "172.31.2.13",
                           "subnetMask": "255.255.0.0",
                           "mtu": 1500
                       },
                       {
                           "key": "key-vim.host.VirtualNic-vmk3",
                           "portGroup": "",
                           "dPortGroup": "dvportgroup-48",
                           "ipAddress": "192.168.61.13",
                           "subnetMask": "255.255.255.0",
                           "mtu": 1500
                       },
                       {
                           "key": "key-vim.host.VirtualNic-vmk4",
                           "portGroup": "VM_DHCP_Network",
                           "dPortGroup": "",
                           "ipAddress": "10.19.2.231",
                           "subnetMask": "255.255.255.128",
                           "mtu": 1500
                       }
                   ],
                   "portGroups": [
                       {
                           "key": "key-vim.host.PortGroup-VM Network",
                           "name": "VM Network",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch0"
                       },
                       {
                           "key": "key-vim.host.PortGroup-Management Network",
                           "name": "Management Network",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch0"
                       },
                       {
                           "key": "key-vim.host.PortGroup-VM_10G_Network",
                           "name": "VM_10G_Network",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                       },
                       {
                           "key": "key-vim.host.PortGroup-VM_Storage",
                           "name": "VM_Storage",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                       },
                       {
                           "key": "key-vim.host.PortGroup-VM_DHCP_Network",
                           "name": "VM_DHCP_Network",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                       },
                       {
                           "key": "key-vim.host.PortGroup-Storage Network",
                           "name": "Storage Network",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                       },
                       {
                           "key": "key-vim.host.PortGroup-VM_Isolated_67",
                           "name": "VM_Isolated_67",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch2"
                       },
                       {
                           "key": "key-vim.host.PortGroup-VM_Migration",
                           "name": "VM_Migration",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch2"
                       }
                   ],
                   "switches": [
                       {
                           "key": "key-vim.host.VirtualSwitch-vSwitch0",
                           "name": "vSwitch0",
                           "portGroups": [
                               "key-vim.host.PortGroup-VM Network",
                               "key-vim.host.PortGroup-Management Network"
                           ],
                           "pNICs": [
                               "key-vim.host.PhysicalNic-vmnic4"
                           ]
                       },
                       {
                           "key": "key-vim.host.VirtualSwitch-vSwitch1",
                           "name": "vSwitch1",
                           "portGroups": [
                               "key-vim.host.PortGroup-VM_10G_Network",
                               "key-vim.host.PortGroup-VM_Storage",
                               "key-vim.host.PortGroup-VM_DHCP_Network",
                               "key-vim.host.PortGroup-Storage Network"
                           ],
                           "pNICs": [
                               "key-vim.host.PhysicalNic-vmnic2",
                               "key-vim.host.PhysicalNic-vmnic0"
                           ]
                       },
                       {
                           "key": "key-vim.host.VirtualSwitch-vSwitch2",
                           "name": "vSwitch2",
                           "portGroups": [
                               "key-vim.host.PortGroup-VM_Isolated_67",
                               "key-vim.host.PortGroup-VM_Migration"
                           ],
                           "pNICs": [
                               "key-vim.host.PhysicalNic-vmnic3",
                               "key-vim.host.PhysicalNic-vmnic1"
                           ]
                       }
                   ]
               },
               "networks": [
                   {
                       "kind": "Network",
                       "id": "network-31"
                   },
                   {
                       "kind": "Network",
                       "id": "network-34"
                   },
                   {
                       "kind": "Network",
                       "id": "network-57"
                   },
                   {
                       "kind": "Network",
                       "id": "network-33"
                   },
                   {
                       "kind": "Network",
                       "id": "dvportgroup-47"
                   }
               ],
               "datastores": [
                   {
                       "kind": "Datastore",
                       "id": "datastore-35"
                   },
                   {
                       "kind": "Datastore",
                       "id": "datastore-63"
                   }
               ],
               "vms": null,
               "networkAdapters": [],
               "cluster": {
                   "id": "domain-c26",
                   "parent": {
                       "kind": "Folder",
                       "id": "group-h23"
                   },
                   "revision": 1,
                   "name": "mycluster",
                   "selfLink": "providers/vsphere/c872d364-d62b-46f0-bd42-16799f40324e/clusters/domain-c26",
                   "folder": "group-h23",
                   "networks": [
                       {
                           "kind": "Network",
                           "id": "network-31"
                       },
                       {
                           "kind": "Network",
                           "id": "network-34"
                       },
                       {
                           "kind": "Network",
                           "id": "network-57"
                       },
                       {
                           "kind": "Network",
                           "id": "network-33"
                       },
                       {
                           "kind": "Network",
                           "id": "dvportgroup-47"
                       }
                   ],
                   "datastores": [
                       {
                           "kind": "Datastore",
                           "id": "datastore-35"
                       },
                       {
                           "kind": "Datastore",
                           "id": "datastore-63"
                       }
                   ],
                   "hosts": [
                       {
                           "kind": "Host",
                           "id": "host-44"
                       },
                       {
                           "kind": "Host",
                           "id": "host-29"
                       }
                   ],
                   "dasEnabled": false,
                   "dasVms": [],
                   "drsEnabled": true,
                   "drsBehavior": "fullyAutomated",
                   "drsVms": [],
                   "datacenter": null
               }
           }
       }
   }

手順

1. 以下の例に従って設定マップ CR を作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: <forklift-validation-config>
     namespace: openshift-mtv
   data:
     vmware_multiple_disks.rego: |-
       package <provider_package> 1
   
       has_multiple_disks { 2
         count(input.disks) > 1
       }
   
       concerns[flag] {
         has_multiple_disks 3
           flag := {
             "category": "<Information>", 4
             "label": "Multiple disks detected",
             "assessment": "Multiple disks detected on this VM."
           }
       }
   EOF

   1

   プロバイダーパッケージ名を指定します。使用できる値は、VMware の場合は io.konveyor.forklift.vmware、Red Hat Virtualization の場合は io.konveyor.forklift.ovirt です。

   2

   concerns の名前と Rego クエリーを指定します。

   3

   concerns の名前と flag パラメーターの値を指定します。

   4

   使用できる値は Critical、Warning、および Information です。

2. forklift-controller デプロイメントを 0 にスケーリングして、Validation Pod を停止します。

   $ oc scale -n openshift-mtv --replicas=0 deployment/forklift-controller

3. forklift-controller デプロイメントを 1 にスケーリングして、Validation Pod を起動します。

   $ oc scale -n openshift-mtv --replicas=1 deployment/forklift-controller

4. Validation Pod ログをチェックして、Pod が起動したことを確認します。

   $ oc logs -f <validation_pod>

   カスタムルールがデフォルトのルールと競合する場合、Validation Pod は起動しません。

5. ソースプロバイダーを削除します。

   $ oc delete provider <provider> -n openshift-mtv

6. ソースプロバイダーを追加して、新規ルールを適用します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <provider>
     namespace: openshift-mtv
   spec:
     type: <provider_type> 1
     url: <api_end_point> 2
     secret:
       name: <secret> 3
       namespace: openshift-mtv
   EOF

   1

   使用できる値は、ovirt、vsphere、および openstack です。

   2

   API エンドポイント URL を指定します。たとえば、vSphere の場合は https://<vCenter_host>/sdk、RHV の場合は https://<engine_host>/ovirt-engine/api/、OpenStack の場合は https://<identity_service>/v3 です。

   3

   プロバイダーの Secret CR の名前を指定します。

手順

1. 現在のルールバージョンを取得します。

   $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version 1

   出力例

   {
      "result": {
          "rules_version": 5
      }
   }

2. Validation Pod のターミナルに接続します。

   $ oc rsh <validation_pod>

3. /usr/share/opa/policies/io/konveyor/forklift/<provider>/rules_version.rego ファイルでルールバージョンを更新します。
4. Validation Pod ターミナルからログアウトします。

5. 更新されたルールバージョンを検証します。

   $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version 1

   出力例

   {
      "result": {
          "rules_version": 6
      }
   }

1. ソースプロバイダー、ターゲットプロバイダー、ネットワークマッピング、およびストレージマッピングを作成します。

2. 以下のリソースを含む Plan カスタムリソース (CR) を作成します。

   • ソースプロバイダー
   • ターゲットプロバイダー (MTV がターゲットクラスターにインストールされていない場合)
   • ネットワークマッピング
   • ストレージマッピング
   • 1 つ以上の仮想マシン (VM)

3. Plan CR を参照する Migration CR を作成して移行計画を実行します。

   何らかの理由ですべての VM 移行できない場合は、すべての VM が移行されるまで、同じ Plan CR に対して複数の Migration CR を作成できます。

4. Plan CR の VM ごとに、Migration Controller サービスは VM 移行の進行状況を Migration CR に記録します。

5. Plan CR 内の各 VM のデータ転送が完了すると、Migration Controller サービスによって VirtualMachine CR が作成されます。

   すべての VM が移行されると、Migration Controller サービスは Plan CR のステータスを Completed に更新します。各ソース VM の電源状態は、移行後も維持されます。

1. Migration カスタムリソース (CR) を作成して、移行計画を実行すると、Migration Controller サービスはソース VM ディスクごとに DataVolume CR を作成します。

   各仮想マシンディスクで以下を実行します。

2. Containerized Data Importer (CDI) Controller サービスは、DataVolume CR で指定されるパラメーターに基づいて永続ボリューム要求 (PVC) を作成します。


3. StorageClass に動的プロビジョナーがある場合、永続ボリューム (PV) は StorageClass プロビジョナーによって動的にプロビジョニングされます。
4. CDI Controller サービスは Importer Pod を作成します。

5. Importer Pod は VM ディスクを PV にストリーミングします。

   仮想マシンディスクの転送後に、以下を実行します。

6. Migration Controller サービスは、VMWare からのインポート時に、PVC が接続された conversion Pod を作成します。

   Conversion Pod は virt-v2v を実行して、ターゲット VM の PVC にデバイスドライバーをインストールし、設定します。

7. Migration Controller サービスは、PVC に接続されたソース仮想マシン (VM) ごとに VirtualMachine CR を作成します。

8. VM がソース環境で実行されている場合は、Migration Controller が VM の電源を入れ、KubeVirt Controller サービスが virt-launcher Pod と VirtualMachineInstance CR を作成します。

   virt-launcher Pod は、VM ディスクとして割り当てられた PVC で QEMU-KVM を実行します。

1. Migration カスタムリソース (CR) を作成して、移行計画を実行すると、Migration Controller サービスはソース VM ディスクごとに PersistentVolumeClaim CR を作成し、ソースが RHV の場合は OvirtVolumePopulator を作成し、ソースが OpenStack の場合は OpenstackVolumePopulator CR を作成します。

   各仮想マシンディスクで以下を実行します。

2. Populator Controller サービスは一時的な永続ボリューム要求 (PVC) を作成します。

3. StorageClass に動的プロビジョナーがある場合、永続ボリューム (PV) は StorageClass プロビジョナーによって動的にプロビジョニングされます。

   • Migration Controller サービスは、ダミー Pod を作成して、すべての PVC をバインドします。Pod の名前には pvcinit が含まれます。
4. Populator Controller サービスは、populator Pod を作成します。

5. populator Pod は、ディスクデータを PV に転送します。

   仮想マシンディスクの転送後に、以下を実行します。

6. 一時的な PVC は削除され、最初の PVC はデータを含む PV を指します。
7. Migration Controller サービスは、PVC に接続されたソース仮想マシン (VM) ごとに VirtualMachine CR を作成します。

8. VM がソース環境で実行されている場合は、Migration Controller が VM の電源を入れ、KubeVirt Controller サービスが virt-launcher Pod と VirtualMachineInstance CR を作成します。

   virt-launcher Pod は、VM ディスクとして割り当てられた PVC で QEMU-KVM を実行します。

1. Migration カスタムリソース (CR) を作成して、移行計画を実行すると、Migration Controller サービスはソース VM ディスクごとに DataVolume CR を作成します。

   各仮想マシンディスクで以下を実行します。

2. Containerized Data Importer (CDI) Controller サービスは、DataVolume CR に指定されたパラメーターに基づいて、空の永続ボリューム要求 (PVC) を作成します。


3. StorageClass に動的プロビジョナーがある場合、永続ボリューム (PV) は StorageClass プロビジョナーによって動的にプロビジョニングされます。

1. Migration Controller サービスは、ダミー Pod を作成して、すべての PVC をバインドします。Pod の名前には pvcinit が含まれます。
2. Migration Controller サービスは、すべての PVC の conversion Pod を作成します。

3. conversion Pod は virt-v2v を実行します。これにより、VM が KVM ハイパーバイザーに変換され、ディスクのデータが対応する PV に転送されます。

   仮想マシンディスクの転送後に、以下を実行します。

4. Migration Controller サービスは、PVC に接続されたソース仮想マシン (VM) ごとに VirtualMachine CR を作成します。

5. VM がソース環境で実行されている場合は、Migration Controller が VM の電源を入れ、KubeVirt Controller サービスが virt-launcher Pod と VirtualMachineInstance CR を作成します。

   virt-launcher Pod は、VM ディスクとして割り当てられた PVC で QEMU-KVM を実行します。

手順

1. Web コンソールで、Migration plans をクリックします。
2. 移行計画名の横にある Get logs をクリックします。

3. Get logs ウィンドウで Get logs をクリックします。

   ログが収集されます。Log collection complete メッセージが表示されます。

4. Download logs をクリックしてアーカイブファイルをダウンロードします。
5. 移行された VM のログをダウンロードするには、移行計画名をクリックして、VM の横にある Get logs をクリックします。

手順

1. must-gather データを保存するディレクトリーに移動します。

2. oc adm must-gather コマンドを実行します。

   $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.4.3

   データは /must-gather/must-gather.tar.gz として保存されます。このファイルを Red Hat カスタマーポータル で作成したサポートケースにアップロードすることができます。

3. オプション: oc adm must-gather コマンドに以下のオプションを指定して実行し、フィルターされたデータを収集します。

   • Namespace:

     $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.4.3 \
       -- NS=<namespace> /usr/bin/targeted

   • 移行計画:

     $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.4.3 \
       -- PLAN=<migration_plan> /usr/bin/targeted

   • 仮想マシン:

     $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.4.3 \
       -- VM=<vm_name> NS=<namespace> /usr/bin/targeted 1

     1

     VM ID ではなく、Plan CR に表示される VM の名前を指定する必要があります。