手順

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

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

2. ブラウザーで、VMware VDDK ダウンロードページ に移動します。
3. 最新の VDDK バージョンを選択し、Download をクリックします。
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
   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. VDDK イメージを HyperConverged CR に追加します。

   $ cat << EOF | oc apply -f -
   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
     namespace: openshift-cnv
   spec:
     vddkInitImage: <registry_route_or_server_path>/vddk:<tag> 1
   EOF

   1

   作成した VDDK イメージを指定します。

2. MTV Web コンソールで、Providers をクリックします。
3. Add provider をクリックします。
4. Type の一覧から VMware を選択します。

5. 以下のフィールドに入力します。

   • Name: プロバイダー一覧に表示する名前
   • Hostname or IP address: vCenter ホスト名または IP アドレス
   • Username: vCenter 管理ユーザー (例: administrator@vsphere.local)
   • Password: vCenter 管理パスワード
   • SHA-1 fingerprint: vCenter SHA-1 フィンガープリント

6. Add をクリックしてプロバイダーを追加し、保存します。

   移行元プロバイダーがプロバイダーのリストに表示されます。

手順

1. MTV Web コンソールで、Providers をクリックします。
2. Add provider をクリックします。
3. Type の一覧から Red Hat Virtualization を選択します。

4. 以下のフィールドに入力します。

   • Name: プロバイダー一覧に表示する名前
   • Hostname or IP address: Manager ホスト名または IP アドレス
   • Username: Manager ユーザー
   • Password: Manager パスワード
   • CA certificate: Manager の CA 証明書

5. Add をクリックしてプロバイダーを追加し、保存します。

   移行元プロバイダーがプロバイダーのリストに表示されます。

手順

1. MTV Web コンソールで、Providers をクリックします。
2. Add provider をクリックします。
3. Type の一覧から OpenShift Virtualization を選択します。

4. 以下のフィールドに入力します。

   • Cluster name: ターゲットプロバイダーの一覧で表示するクラスター名を指定します。
   • URL: クラスターの API エンドポイントを指定します。
   • Service account token: cluster-admin サービスアカウントトークンを指定します。
5. Check connection をクリックしてクレデンシャルを確認します。

6. Add をクリックします。

   プロバイダーがプロバイダーの一覧に表示されます。

手順

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. Inventory サービスルートを取得します。

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

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

   $ GET https://<inventory_service_route>/providers/<provider> 1

   1

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

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

   $ GET https://<inventory_service_route>/providers/<provider>/<UUID>/vms

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

   $ GET https://<inventory_service_route>/providers/<provider>/<UUID>/workloads/<vm>

   出力例

   {
       "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 です。

   2

   API エンドポイント URL を指定します (例: vSphere の場合は https://<vCenter_host>/sdk、RHV の場合は https://<engine_host>/ovirt-engine/api/)。

   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 サービスは VirtualMachine CR を作成し、Migration CR に VR の移行の進捗を記録します。

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

1. Migration カスタムリソース (CR) を作成して移行計画を実行すると、Migration Controller サービスはソース仮想マシン (VM) ごとに VirtualMachine CR を、ソース 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 サービスは、PVC が割り当てられた conversion Pod を作成します。

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

7. ターゲット 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.2.0

   データは /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.2.0 \
       -- NS=<namespace> /usr/bin/targeted

   • 移行計画:

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

   • 仮想マシン:

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

     1

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